Silverlight (XAP) web resources

Applies To: Dynamics CRM 2013

Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM Online support adding Silverlight 4.0 web resources to entity forms. You can display Silverlight 5.0 web resources within an HTML web resource using a hosting <object> element that is configured for that version.

In This Topic

Creating Silverlight web resources

Accessing context data

Passing data from a form to an embedded Silverlight web resource

Writing and testing Silverlight web resources

Debugging Silverlight web resources

Creating Silverlight web resources

Silverlight web resources are easily created using the web resource form by entering a name, a display name, selecting Silverlight (XAP) as the type, and uploading the .xap file. The web resource must be published before you can use it. However, because Silverlight web resources typically provide some interaction with contextual data in Microsoft Dynamics CRM, you should plan how you create your web resources.

Accessing context data

When you use the Preview button in the web resources form or just browse to the URL provided, the Silverlight application is hosted in a generic HTML page without context information. If your Silverlight application does not require contextual information, you can use this URL to view your Silverlight web resource.

If you do require contextual information, you must either:

1. Add your Silverlight web resource to an entity form.

2. View your Silverlight web resource using an HTML web resource configured to provide context information.

If your Silverlight web resource is designed to be viewed in an entity form, the form has an Xrm.Page.context object you can use to access contextual information. For more information, see Client-side context (client-side reference)

If you need your Silverlight application to appear outside the context of the form you must configure an HTML web resource to provide this context information by adding a reference to the ClientGlobalContext.js.aspx page. After this reference is added, your Silverlight application can access contextual information in the same way it can in an entity form. The following sample shows how to call the getClientUrl function from the Xrm.Page.context object.

private string clientUrl = "";
ScriptObject xrm = (ScriptObject)HtmlPage.Window.GetProperty("Xrm");
ScriptObject page = (ScriptObject)xrm.GetProperty("Page");
ScriptObject pageContext = (ScriptObject)page.GetProperty("context");
clientUrl = (string)pageContext.Invoke("getClientUrl");

Passing data from a form to an embedded Silverlight web resource

When you add a Silverlight web resource to a form you can select the Pass record object-type code and unique identifier as parameters option. You also have the option to enter text as a custom parameter.

These values are passed to the Silverlight control as a InitParams, a dictionary of key/value pairs.

The values passed are described in the following table.

These values can be accessed at run time using the syntax in the following example:

string entityTypeName = App.Current.Host.InitParams["typename"];

Writing and testing Silverlight web resources

If your Silverlight web resource is independent of any contextual data from Microsoft Dynamics CRM, you can write and test your Silverlight application as you typically would. After you create a new web resource by uploading your .xap file, you can test it by using the Preview button in the web resource form after you have saved and published the web resource.

However, it is more likely that your Silverlight application has contextual data dependencies that cannot be fully simulated outside of Microsoft Dynamics CRM.

The process of creating a Silverlight web resource that includes form or context dependencies is as follows:

1. Create your Silverlight application project.

   You should select to create a web application with your project.

2. Write and test as much of the application as you can without requiring contextual data from Microsoft Dynamics CRM.

3. Create web resources by uploading the .xap and .htm files as Silverlight and HTML web resources.

4. Write code in your Silverlight application project.

5. Build your Silverlight application project.

6. Upload the built version of the .xap file from the web application project ClientBin folder to update the Silverlight web resource you created in step 3.

7. Test your Silverlight web resource by either:

   • Viewing it using the Preview button of the host HTML web resource you created.

   • Viewing it in the context of an entity form that you have added it to.

     Use this option is your Silverlight application has dependencies on Form elements or context information.

8. Repeat steps 4 through 7 until you are finished.

Debugging Silverlight web resources

Silverlight web resources that do not rely on contextual data from Microsoft Dynamics CRM can be debugged in Microsoft Visual Studio. However, if the Silverlight web resource requires contextual data to perform the functions, you will have to use a different procedure.

1. Build your Silverlight application.

2. Upload the built version of the .xap file from the web application project ClientBin folder.

3. View your Silverlight application in the context it is designed to be used in.

4. In your Silverlight application project, from the Visual Studio menu, select Debug and then Attach To Process.

5. In the Attach to Process dialog box, find an iexplore.exe process where the Type column value is Silverlight, x86.

6. Select that process and press Attach to close the dialog box and start debugging.

7. In your Silverlight application project, set a breakpoint.

8. Refresh the browser window or, in the Silverlight application, perform the action that you need to test your code.

See Also

Create accessible web resources
Web resources for Microsoft Dynamics CRM 2013
Webpage (HTML) web resources
CSS web resources
Script (JScript) web resources
Data (XML) Web resources
Image (JPG, PNG, GIF, ICO) web resources
Stylesheet (XSL) web resources