Web resource properties

Applies to Dynamics 365 for Customer Engagement apps version 9.x (on-premises)

You can add or edit web resources on a form to make it more appealing or useful to app users. Form enabled web resources are images, HTML files, or Silverlight controls.

You can access Form properties by opening solution explorer. Under Components, expand Entities, expand the entity you want, and then select Forms. In the list of forms, open the form of type Main. Then on the Insert tab, select Web Resource to view web resource properties.


For step-by-step instructions, see Create and edit web resources.

Tab Property Description
General Web resource Required: The image, HTML, or Silverlight web resource that you want.
Name Required: A unique name for the field. The name can contain only alphanumeric characters and underscores.
Label Required: A label to display for the web resource.
Visible by default Showing the web resource is optional and can be controlled using scripts. More information: Visibility options
Enable for mobile Select the checkbox to enable the iFrame for mobile.
Formatting Select the number of columns the control occupies When the section containing the web resource has more than one column you can set the field to occupy up to the number of columns that the section has.
Select the number of rows the control occupies You can control the height of the web resource by specifying a number of rows.
Automatically expand to use available space You can allow the web resource height to expand to available space.
Select the scrolling type for the IFRAME An HTML web resource is added to the form using an IFRAME.

- As Necessary: Show scrollbars when the size of the web resource is larger than the available.
- Always: Always show scrollbars.
- Never: Never show scrollbars.
Display border Display a border around the web resource.
Dependencies Dependent fields A web resource may interact with fields in the form using script. If a field is removed from the form the script in the web resource may break. Add any fields referenced by scripts in the web resource to the Dependent fields so that they cannot be removed accidentally.

Pass parameters to web resources

An HTML or Silverlight web resource can accept parameters to be passed as query string parameters.

Information about the record can be passed by enabling the Pass record object-type code and unique identifiers as parameters option. If information is typed into the Custom Parameter(data) field it will be passed using the data parameter. The values passed are:

Parameter Description
data This parameter is only passed when text is provided for Custom Parameter(data).
orglcid The Organization default language LCID.
orgname The name of the organization.
userlcid The user’s preferred language LCID
type The entity type code. This value can be different for custom entities in different organizations. Use entity type name instead.
typename The entity type name.
id The id value of the record. This parameter has no value until the entity record is saved.

Any other parameters are not allowed and the web resource will not open if other parameters are used. If you need to pass multiple values, the data parameter can be overloaded to include more parameters within it.

See also

Use the Main form and its components