创建或编辑 Web 资源以扩展应用

此主题适用于 Dynamics 365 Customer Engagement (on-premises)。 有关此主题的 Power Apps 版本,请参阅: 创建或编辑模型驱动应用程序 Web 资源以扩展应用程序

开发人员通常使用 Web 资源用于扩展应用,这些应用程序使用 Web 开发中用到的文件。 应用用户可能需要管理由开发人员或设计器提供的 Web 资源。

小费

有关 Web 资源的深入讨论,请参阅 Customer Engagement 的 Web 资源

什么是 Web 资源?

Web 资源是存储在系统中的虚拟文件。 每个 Web 资源都有一个可以在 URL 中用来检索文件的唯一名称。 把它们认为是这样:如果访问过运行 Web 应用的实际 Web 服务器,您可以将文件复制到该网站。 但通过大多数联机服务,无法执行此操作。 相反,您可以使用 Web 资源将文件上载到系统然后使用名称来引用它们,请像将其复制为文件放到 Web 服务器上一样。

例如,如果创建了一个 HTML 页并将其作为一个 Web 资源命名为“new_myWebResource.htm”,就可以使用如下 URL 在浏览器中打开该页:

<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm

其中,<应用 URL> 是您通常用来打开应用的 URL。 由于 Web 资源是系统中的数据,所以只有您组织中的许可用户可以这样访问它们。 通常,Web 资源包含在窗体之中,而不能直接被引用。 最常见用法是对窗体脚本提供 JavaScript 库。

由于 Web 资源是系统中的数据,并且与解决方案相关,所以可以通过将它们作为解决方案的一部分进行导出并将该解决方案导入到另一个组织中,从而将其移至不同的组织。

创建和编辑 Web 资源

  1. 打开解决方案资源管理器,然后选择 Web 资源

  2. 组件下,选择Web 资源

  3. 若要创建 Web 资源,选择新建

    若要编辑 Web 资源,双击要编辑的 Web 资源。

  4. Web 资源窗体具有以下字段和功能:

    标签 说明
    名字 必需。 这是此 Web 资源特有的名称。 保存 Web 资源之后,就不能对此进行更改。

    此名称只能包含字母、数字、句点和不连续的正斜杠(“/”)字符。

    解决方案发布商的自定义前缀将附加到该 Web 资源的名称上。
    显示名称 如果您查看 Web 资源列表,则会显示该名称。
    说明 Web 资源说明。
    类型 必需。 这是 Web 资源的类型。 保存 Web 资源之后,就不能对此进行更改。
    文本编辑器 当 Web 资源类型表示一种文本文件时,请选择此按钮打开一个页面,使用文本编辑器编辑其内容。
    语言 允许选择一种语言。 此选项仅标记存储 Web 资源数据的记录。 它不更改 Web 资源的行为。
    上载文件 选择浏览… 按钮以选择要上传为 Web 资源的文件。

    在创建新 Web 资源或要覆盖现有的 Web 资源时,可上载文件。

    文件的文件名扩展必须与允许使用的扩展相匹配。

    默认情况下,可以上载为 Web 资源的最大文件大小为 5MB。 可在 Dynamics 365 Customer Engagement (on-premises) 中使用系统设置>电子邮件选项卡 >设置附件的文件大小限制设置来修改此值。 更多信息:“系统设置”对话框 -“电子邮件”选项卡
    URL 保持 Web 资源之后,此处会显示访问该 Web 资源的 URL。 选择该链接,在浏览器中查看该 Web 资源。
  5. 添加了您的更改之后,选择保存,然后选择发布

备注

发布自定义项会干扰常规系统运行。 我们建议您以对用户造成的干扰最少为宗旨,合理发布自定义项。

正确使用文本编辑器

Web 资源的应用程序中提供的文本编辑器只能用于简单的文本文件的编辑。 您可以使用它创建和编辑 HTML Web 资源,但是,您只能编辑使用文本编辑器编辑的 HTML Web 资源。 文本编辑器适用于非常简单的 HTML 内容。 如果 HTML Web 资源的内容并不是使用文本编辑器来创建的,就不要使用文本编辑器对其进行编辑。

文本编辑器使用的控件可以以准许的编辑方式来修改 HTML 资源。 这些更改可以使浏览器中页面的表现行为有所不同,并导致更为复杂的代码停止工作。 使用文本编辑器打开一个 HTML Web 资源并将其不加任何更改地进行保存,这可能会破坏某些 HTML Web 资源。

我们建议您使用外部编辑器编辑文本文件,然后将它们保存在本地,之后再使用上载文件按钮将它们上载。 如果需要返回到早期版本,使用这种方法就可以保留 Web 资源的副本。 可使用类似记事本的简单编辑器,但是,强烈建议您使用具有更加高级的功能的文本编辑器。 Visual Studio Express 免费,它为编辑基于文本的 Web 资源所使用的文件提供强大的功能。

在窗体中创建和编辑 Web 资源

您可以添加或编辑表单上的 web 资源,使其对用户而言更具吸引力或更有用。 确保您具有系统管理员安全角色或等效权限。

备注

不能在窗体页眉或页脚中包括 Web 资源。

  1. 打开解决方案资源管理器。

  2. 组件下,展开实体,然后展开工作时所需实体。

  3. 选择窗体,在列表中找到“主要”类型窗体,然后双击或点按打开和编辑窗体。

  4. 要添加 Web 资源,选择您要在其上进行插入的选项卡(例如常规注释),然后在插入选项卡上,选择 Web 资源
    -或-
    若要编辑 Web 资源,请选择窗体选项卡和要编辑的 Web 资源,然后在主页选项卡上选择更改属性

  5. 添加 Web 资源Web 资源属性对话框中的常规选项卡,在所需字段中输入相应信息。 特别应注意以下问题:

    • Web 资源对话框中,选择您所要使用的图像、HTML 或 Silverlight Web 资源。

      备注

      在您核实一项 Web 资源后,Web 资源属性部分出现在该选项卡的底部,提供基于您所添加的 web 资源类型的选项。 这些选项包括指定自定义参数,传递记录对象类型代码作为参数或指定描述资源的替代文本或图像,可使图像对于所有用户更易于访问。 下面是一些重要属性。 有关完整列表,请参阅:Web 资源属性。 - 在名称框中,输入字段的唯一名称。 该名称只能包含字母数字字符和下划线。

    • 标签字段自动填充您所指定的名称的变量,但是请确保提出的标签能满足您的需求或能相应地更新。
  6. 格式化选项卡,显示的选项更改基于插入的 Web 资源类型。 这些选项包含指定列和行显示边框的数目,查看边框是否显示及其滚动行为。

  7. 如果依赖项选项卡在添加 Web 资源Web 资源属性对话框中显示,则从可用字段列表选择 Web 资源所需的字段,选择添加所选记录按钮将所选字段移至“从属字段”列表,然后选择确定关闭对话框。

  8. 窗体编辑完成后,请在主页选项卡上,选择保存并关闭以关闭窗体。 预览主窗体的显示方式以及事件的运行方式:

    • 主页选项卡上,选择预览,然后选择创建表单更新表单只读表单
    • 若要关闭“预览”表单,请在文件菜单上,选择关闭
  9. 完成自定义后,发布自定义项:

    • 若只为您当前编辑的组件发布自定义项,在导航窗格中,选择您一直在处理的实体,然后选择发布
    • 若要同时为所有未发布组件发布自定义项,在导航窗格中,选择实体,然后在操作工具栏上选择发布所有自定义项

添加或编辑图像 Web 资源

Web 资源是多格式虚拟文件,例如 html 文件、JavaScript 和 Silverlight 应用程序,使用唯一的 URL 地址存储在系统中并可进行检索。

  1. 打开解决方案资源管理器。

  2. 若要创建新的 Web 资源,请选择组件>Web 资源,然后在“操作”工具栏上,选择新建

  3. 键入或更改在文本框中的信息。

    • 名称文本框中,输入名称。此名称将和文件扩展名一起构成其文件名。

    • 输入显示名称文本框中的名称将显示在显示名称中。

    • 类型下拉框中,选择所需的文件类型。

  4. 选择浏览来选择并上载本地计算机上的文件。

    • 预览上载的图像 Web 资源:选择 Web 资源>预览

    • 编辑文本 Web 资源:选择文本编辑器

    • 预览文本 Web 资源:选择 Web 资源>预览

  5. 当准备保存数据时,选择保存并关闭

  6. 发布自定义项。

    • 仅编辑的部分:请选择主页上的保存>发布

    • 若要同时发布所有未发布的组件,请选择发布所有自定义项

备注

安装解决方案或发布自定义项会干扰常规的系统操作。 我们建议您以对用户造成的干扰最少为宗旨,合理安排解决方案导入时间。

另请参见

Web 资源属性
创建和设计窗体
自定义入门
适用于 Customer Engagement 的 Web 资源