Microsoft Dynamics 365 的 Web 资源
发布日期： 2017年1月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
Web 资源是存储在 Microsoft Dynamics 365 数据库中并可使用唯一 URL 地址进行检索的虚拟文件。
本主题内容
web资源功能
web资源类型
引用web资源
web资源功能
Web 资源表示可用于扩展 Microsoft Dynamics 365 Web 应用程序（如 html 文件）、JavaScript 和 Silverlight 应用程序的文件。 您可以在窗体自定义项、 SiteMap 或应用程序功能区中使用 Web 资源，因为它们可以通过使用 URL 语法加以引用。
Web 资源的 URL 语法允许进行相对路径引用。 通过开发工具，您可以使用与 Web 资源兼容的文件类型在开发服务器上创建一组相互依赖的文件。 然后，如果您使用一致的命名约定和相对路径引用，则当您将所有文件上载到 Microsoft Dynamics 365 中后，网站将运行。
因为 Web 资源存储在 Microsoft Dynamics 365 中并且是解决方案组件，所以可以轻松导出它们并将其安装到 Microsoft Dynamics 365 内部部署或 Microsoft Dynamics 365 (online) 中。 Web 资源还可供带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook 的用户脱机时使用，因为它们与用户数据同步。
可以使用窗体编辑器将支持窗体的 Web 资源添加到实体窗体中并对其进行配置。
因为 Web 资源在数据库中存储为记录，所以可以使用标准的创建、检索和更新记录技术，以编程方式管理它们。 可以在应用程序中编辑和保存基于文本的 Web 资源（JScript, CSS, XML, XSL, and HTML）。
web资源的局限性
没有任何类型的 Web 资源支持 ASP.NET(.aspx) 页面在服务器上执行代码。 Web 资源仅为静态文件或在浏览器中处理的文件。 Web 资源可以包含在浏览器中处理的代码，以便执行要与 Microsoft Dynamics 365 数据进行交互的 Web 服务调用。 有关详细信息，请参阅使用 Web 资源处理 Dynamics 365 数据。
只能通过 Microsoft Dynamics 365 Web 应用程序安全上下文来使用 Web 资源， 并且只有经许可且拥有必需权限的 Microsoft Dynamics 365 用户可以访问它们。
尺寸限制
可以上载的最大文件大小由 Organization.MaxUploadFileSize 属性确定。 该属性在 Dynamics 365 应用程序的“系统设置”的“电子邮件”选项卡中设置。 此设置限制可以附加到电子邮件、注释和 Web 资源的文件大小。 默认设置为 5 MB。
web资源类型
可以使用十种文件格式创建 Web 资源。 下表列出每种文件格式、允许的文件扩展名和您用于每种类型的类型值。
文件 |
文件扩展名 |
类型 |
|---|---|---|
网页 (HTML) |
.htm, .html |
1 |
样式表 (CSS) |
.css |
2 |
脚本 (JScript) |
.js |
3 |
数据 (XML) |
.xml |
4 |
图像 (PNG) |
.png |
5 |
图像 (JPG) |
.jpg |
6 |
图像 (GIF) |
.gif |
7 |
Silverlight (XAP) |
.xap |
8 |
样式表 (XSL) |
.xsl, .xslt |
9 |
图像 (ICO) |
.ico |
10 |
引用web资源
可以使用多种方法来引用 Web 资源。
备注
-
可能时，还可以使用 $webresource 指令。 只有在站点地图或功能区命令中使用 $webresource 指令的引用将建立依赖项。 在 Web 资源互相引用时，不创建依赖项。
-
若要在实体窗体或图表外显示 Silverlight Web 资源，请创建 HTML Web 资源作为 Silverlight Web 资源的宿主页。 然后使用 $webresource: 指令打开 HTML Web 资源。
$webresource 指令
在从功能区控件或 SiteMap 子区域引用 Web 资源时，应始终使用 $webresource 指令。 可在 XML 允许 URL 值的任何位置使用 $webresource 指令。 以下示例演示如何使用该指令。
$webresource:<name of Web Resource>
备注
在使用 $webresource 指令时，Microsoft Dynamics 365 将创建或更新解决方案依赖项。
Xrm.Utility.openWebResource
Xrm.Utility.openWebResource 函数将在具有参数的新窗口中打开 HTML Web 资源，以传递 Web 资源的名称、要在数据参数中传递的任何查询字符串数据，以及有关窗口高度和宽度的信息。
生成的 URL 包括唯一 GUID 令牌，以便可以加载缓存的 Web 资源。
相对 URL
在从不支持使用 $webresource: 指令的区域引用 Web 资源时，可以使用相对 URL。 为此，建议您对反映虚拟文件结构的 Web 资源使用一致的命名约定。 Web 资源名称的前缀将始终为解决方案发布商的自定义前缀。 这可以表示由该发布商添加的所有 Web 资源的虚拟“root”文件夹。 然后，可以使用正斜杠字符 (/) 模拟 Web 服务器将允许的文件夹结构。
对于其他 Web 资源，应始终使用相对 URLs 来互相引用。 例如，如果希望网页 Web 资源 new_/content/contentpage.htm 引用 CSS Web 资源 new_/Styles/styles.css，请创建以下链接：
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
如果希望网页 Web 资源 new_/content/contentpage.htm 打开网页 Web 资源 isv_/foldername/dialogpage.htm，请创建以下链接：
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
备注
请勿使用将 WebResources 文件夹用作 URL 根路径的相对 URL。 例如，不要使用以下路径：/WebResources/<name of web resource>。 当用户属于服务器上的多个组织时，此路径将始终引用用户默认组织。 如果用户没有使用其默认组织，并且预期 Web 资源不包括在用户的默认组织中，那么即使用户当前使用的组织中确实包括该 Web 资源，也会出现“找不到文件”错误。
完整 URL
以下示例显示可用于查看 Web 资源的 URL 样式：
<Microsoft CRM URL>/WebResources/<name of web resource>
应用程序将处理此 URL，并返回包含最新 Web 资源版本的文件。 此 URL 如下所示：
<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>
在您发布自定义项时，GUID 值会被更新并确保浏览器使用 Web 资源的最新缓存版本。 由于系统自动包括 GUID 值，因此，可能的话，可使用 Web 资源的相对路径或 Xrm.Utility.openWebResource 函数或 $webresource 指令。 对于大型 Web 资源（如 Silverlight Web 资源），如果不使用文件的缓存版本，则可能有很大的性能影响。
以下示例显示 Microsoft Dynamics 365 (online) 的 URL，其中 MyOrganization 是您的组织的名称，new_/test/test.htm 是 Web 资源名称：
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
备注
在 Web 资源名称中包括“/”字符和文件扩展名是一种可选的最佳做法。
以下示例显示内部部署 Microsoft Dynamics 365 的 URL，其中 myServer 是服务器名称：
http://myServer/MyOrganization/WebResources/new_/test/test.htm
在您编写代码来引用将需要用于 Microsoft Dynamics 365 (online) 或 Microsoft Dynamics 365 内部部署的 Web 资源时，应使用 getClientUrl 函数。
另请参阅
在客户端上扩展 Microsoft Dynamics 365
Microsoft Dynamics 365 的 JavaScript 库
创建可访问的 Web 资源
网页 (HTML) Web 资源
Silverlight (XAP) Web 资源
脚本 (JScript) Web 资源
图像（JPG、PNG、GIF、ICO）Web 资源
样式表 (XSL) Web 资源
数据 (XML) Web 资源
CSS Web 资源
WebResource 实体消息和方法
示例：通过 Data 参数向 Web 资源传递多个值
示例：Web 资源实用工具
示例：将文件作为 Web 资源导入
使用 Web 资源处理 Dynamics 365 数据
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权