Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Web resources are virtual files that you store in the Microsoft Dataverse database and retrieve by using a unique URL address.
Note
Web resources and Power Apps component framework don't support IFRAMEing content that's behind an authentication boundary. Some embedded IFRAMEs might work in a browser client if the user directly logs into the external service, but this isn't supported in mobile or tablet applications. The specific scenario of embedding a form within an IFRAME, embedded in another form, isn't supported. Use form as a component for such scenarios.
In general, use Power Apps component framework and custom pages to build configurable, reusable, and tighter external integrations. More information: IFRAME component
Capabilities of web resources
Web resources represent files that you can use to extend the Dataverse web application, such as HTML files, JavaScript,
CSS, and several image formats. You can use web resources in form customizations, the SiteMap, or the application
ribbon because you can reference them by using URL syntax.
The URL syntax for web resources allows for relative path references. By using your development tools, you can create a group of interdependent files on a development server by using file types compatible with web resources. Then, if you use a consistent naming convention and relative path references, the website functions after you upload all the files into Dataverse.
Because Dataverse stores web resources and they're solution components, you can easily export and install them to other Dataverse orgs. Users of Dataverse for Microsoft Office Outlook with Offline Access can use web resources when offline because they synchronize with the user's data.
Use the form editor to add and configure form-enabled web resources into your forms.
Because Dataverse stores web resources as records in the database, you can manage them programmatically by using the standard techniques to create, retrieve, and update records. You can edit and save text-based web resources (JScript, CSS, XML, XSL, RESX, and HTML) in the application.
Limitations of web resources
No web resource type supports the capabilities of an ASP.NET (.aspx) page to execute code on the server. Web resources are limited to static files or files that the browser processes. A web resource can contain code that the browser processes to execute web service calls to interact with Dataverse data.
You can access web resources only by using the Dataverse web application security context. Only licensed Dataverse users who have the necessary privileges can access them.
Size limitations
The Organization.MaxUploadFileSize property determines the maximum size of files that you can upload. Set this property in the Email tab of the System Settings in the Dynamics 365 application. This setting limits the size of files that you can attach to email messages, notes, and web resources. The default setting is 5 MB. For more information, see environment settings and file size limits.
Web resource types
You can use 10 file formats to create web resources. The following table lists each file format, the allowed file extensions, and the type value that you use for each.
| File | File extensions | Type |
|---|---|---|
| Webpage (HTML) | .htm, .html | 1 |
| Style Sheet (CSS) | .css | 2 |
| Script (JScript) | .js | 3 |
| Data (XML) | .xml | 4 |
| Image (PNG) | .png | 5 |
| Image (JPG) | .jpg | 6 |
| Image (GIF) | .gif | 7 |
| Silverlight (XAP) | .xap | 8 |
| StyleSheet (XSL) | .xsl, .xslt | 9 |
| Image (ICO) | .ico | 10 |
| Vector format (SVG) | .svg | 11 |
| String (RESX) | .resx | 12 |
Reference web resources
Reference web resources by using several methods.
Note
When possible, use the $webresource directive. Only references that use the $webresource directive in the site map or
ribbon commands establish dependencies. Dependencies aren't created when web resources reference each other.
$webresource directive
Always use the $webresource directive when referencing a web resource from a ribbon control or from
a SiteMap sub area. Use the $webresource directive anywhere the XML allows a URL value. The following sample shows how to use it.
$webresource:<name of Web Resource>
Note
When you use the $webresource directive, Dataverse creates or updates solution dependencies.
Xrm.Navigation.openWebResource
The Xrm.Navigation.openWebResource function opens an HTML web resource in a new window with parameters to pass the name of the web resource, any query string data to pass in the data parameter, and information about height and width of the window.
The URL generated includes the unique GUID token so that the cached web resource loads.
Relative URL
When referencing a web resource from areas that don't support using the $webresource: directive, use a relative URL.
To enable this approach, use a consistent naming convention for the web resources that reflects a virtual file structure.
Include the solution publisher's customization prefix as a prefix to the name of the web resource.
This prefix can represent a virtual "root" folder for all web resources added by that publisher.
Use the forward slash character (/) to simulate a folder structure that the web server honors.
From another web resource, always use relative URLs to reference each other.
For example, for the web page web resource new_/content/contentpage.htm to reference the
CSS web resource new_/Styles/styles.css, create the link as follows:
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
For the web page web resource new_/content/contentpage.htm to open the webpage web resource isv_/foldername/dialogpage.htm,
create the link as follows:
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
Note
Don't use a relative URL that uses the WebResources folder as the root path for the URL.
For example, don't use: /WebResources/<name of web resource>. When a user belongs to more than one organization on a server,
this path refers to the user's default organization. If the user isn't using their default organization and the
expected web resource isn't included in the user's default organization, a "File Not Found" error occurs even though the
web resource does occur in the organization the user is currently working in.
Full URL
The following sample shows the style of URL you can use to view web resources.
<Dataverse Environment URL>/WebResources/<name of web resource>
The application processes this URL and returns the file that contains the latest version of the web resource. This URL looks like this:
<Dataverse Environment URL>/%7B<version value>%7D/WebResources/<name of web resource>
The version value updates when you publish customizations and ensures that the browser uses the latest cached version of the web resource. Because of this, use a relative path to a web resource, the Xrm.Navigation.openWebResource function, or the $webresource Directive (when possible) because the version value is included. For large web resources, not using the cached version of the file can have significant performance implications.
The following sample shows a URL for Dataverse, where MyOrganization is the name of your Dataverse Environment, and new_/test/test.htm
is the name of the web resource:
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
Note
Including the '/' character and a file name extension in the name of the web resource is an optional best practice. When you write code to reference a web resource that works for Dataverse, use the getClientUrl function.
Layout differences between the legacy web client and Unified Interface
A web resource control configured to use a certain number of rows has different heights in a Unified Client application compared to a web client application. This difference exists because there's a difference in the height of a row between Unified Interface and web client. If a form is needed in both the web client and Unified Interface, you can use different forms in the Unified Interface app and the web client app with the control configured to use the appropriate number of rows in each form.
Community tools
WebResources Manager is a tool that the XrmToolbox community developed for Dataverse. See the Developer tools article for community developed tools.
Note
The community tools aren't a product of Dataverse and Microsoft doesn't provide support for the community tools. If you have questions about the tool, contact the publisher. For more information, see XrmToolBox.
See also
Create Accessible web resources
Web Page (HTML) web resources
JavaScript web resources
Image web resources
Stylesheet (XSL) web resources
Data (XML) web resources
Style Sheet (CSS) web resources
Web resource table reference
Sample: Passing multiple values to a web resource through the data parameter
Sample: Importing files as web resources
Streamline web resource development using Fiddler Auto-Responder