创建或编辑模型驱动应用程序 Web 资源以扩展应用程序
开发人员通常使用 Web 资源用于扩展应用,这些应用程序使用 Web 开发中用到的文件。 应用用户可能需要管理由开发人员或设计器提供的 Web 资源。
提示
有关 Web 资源的深入讨论,请参阅开发人员文档:模型驱动应用的 Web 资源。
什么是 Web 资源?
Web 资源是存储在系统中的虚拟文件。 每个 Web 资源都有一个可以在 URL 中用来检索文件的唯一名称。 把它们认为是这样:如果访问过运行 Web 应用的实际 Web 服务器,您可以将文件复制到该网站。 但通过大多数联机服务,无法执行此操作。 相反,您可以使用 Web 资源将文件上载到系统然后使用名称来引用它们,请像将其复制为文件放到 Web 服务器上一样。
例如,如果创建了一个 HTML 页并将其作为一个 Web 资源命名为“new_myWebResource.htm”,就可以使用如下 URL 在浏览器中打开该页:
<base URL>/WebResources/new_myWebResource.htm
其中 <base URL> 是您用于查看以 dynamics.com
结尾的应用的 URL 的一部分。 由于 Web 资源是系统中的数据,所以只有您组织中的许可用户可以这样访问它们。 通常,Web 资源包含在窗体之中,而不能直接被引用。 最常见用法是对窗体脚本提供 JavaScript 库。
由于 Web 资源是系统中的数据,并且与解决方案相关,所以可以通过将它们作为解决方案的一部分进行导出并将该解决方案导入到另一个组织中,从而将其移至不同的组织。 您必须使用解决方案资源管理器来处理 Web 资源。
解决方案发布商前缀
您创建的任何 Web 资源的名称中包含解决方案发布商前缀。 这是根据您在其中工作的解决方案的解决方案发布商设置的。 请确保在非托管解决方案中工作,其中的发布商前缀是您需要用于此 Web 资源的前缀。 详细信息:解决方案发布商
将 Web 资源添加到解决方案中
- 登录 Power Apps,然后在左侧导航窗格中选择解决方案。 如果项目不在侧面板窗格中,请选择 …更多,然后选择所需项目。
- 打开一个非托管解决方案,在命令栏上选择添加现有,指向更多,然后选择 Web 资源。 将显示可用 Web 资源的列表。
- 若要向非托管解决方案中添加 Web 资源,请选择该 Web 资源,然后选择添加。
为解决方案创建或编辑 Web 资源
登录 Power Apps,然后在左侧导航窗格中选择解决方案。 如果项目不在侧面板窗格中,请选择 …更多,然后选择所需项目。
打开非托管解决方案。
要编辑属于非托管解决方案的现有 Web 资源,请选择它以显示编辑 Web 资源窗格。 要创建新资源,在命令栏中选择新建,指向更多,然后选择 Web 资源。
填写右侧 Web 资源窗格中的字段创建或编辑 Web 资源:
列 步骤 上载文件 选择上载文件按钮选择要上载为 Web 资源的文件。
• 在创建新 Web 资源或要覆盖现有的 Web 资源时,可上载文件。
• 文件的文件名扩展必须与允许使用的扩展相匹配。
•默认情况下,可以上载为 Web 资源的最大文件大小为 5MB。 可使用系统设置 > 电子邮件选项卡 > 设置附件的文件大小限制设置来修改此值。 更多信息:“系统设置”对话框 -“电子邮件”选项卡显示名称 如果您查看 Web 资源列表,则会显示该名称。 Name 必需。 此 Web 资源的唯一名称。 保存 Web 资源之后,就不能对此进行更改。
• 此名称只能包含字母、数字、句点和不连续的正斜杠 (“/”) 字符。
• 解决方案发布商的自定义前缀将附加到该 Web 资源的名称上。类型 必需。 这是 Web 资源的类型。 保存 Web 资源之后,就不能对此进行更改。 描述 Web 资源说明。 高级选项 展开高级选项以显示语言字段,该字段允许选择语言。 此选项仅标记存储 Web 资源数据的行。 它不更改 Web 资源的行为。 添加了您的更改之后,选择保存,然后选择发布。 保存 Web 资源后,Web 资源的 URL 将显示在 Web 资源定义中。 选择该链接,在浏览器中查看该 Web 资源。
备注
对 Web 资源进行的更改不会显示在应用程序中,除非您发布它。
将 Web 资源添加到模型驱动应用窗体中
打开要在其中添加 Web 资源以进行编辑的窗体。
选择组件窗格,展开显示,然后选择所需的 Web 资源类型:
HTML Web 资源。 可用于创建客户端扩展的用户界面元素的网页 (HTML)。 详细信息:网页 (HTML) Web 资源
图像 Web 资源。 使用图像 Web 资源使图像可在模型驱动应用中使用。 支持的图像格式包括:PNG、JPG、GIF、ICO 和 SGA(矢量格式)。 详细信息:图像 Web 资源
从列表中选择 Web 资源,然后选择添加。 或者,请选择新建 Web 资源以创建所需的 Web 资源。 详细信息:模型驱动应用窗体的 Web 资源属性
备注
不能将 Web 资源添加到窗体页眉或页脚。
向应用添加 Web 资源(预览版)
[本主题是预发行文档,有可能会有所更改。]
您可以将 Web 资源添加为模型驱动应用中的子区域类型。 Web 资源是可用于扩展模型驱动应用的文件。 Web 资源子区域可以是 HTML 代码或 HTML 文件,如 .htm 或 .html。 当用户选择子区域时,HTML 将显示在应用中。
备注
默认情况下,禁用 Web 资源子区域。 要启用,请转到导航窗格选项。
在模型驱动应用程序设计器中,选择导航 > 添加 > 子区域。
在子区域属性中,输入以下信息:
- 内容类型:Web 资源。
- URL:从列表中选择一个 HTML Web 资源文件名以添加 Web 资源的 URL。 详细信息:创建或编辑模型驱动应用程序 Web 资源以扩展应用程序
- 标题:输入将出现在应用中子区域的标题。
选择保存,然后选择发布。
使用经典解决方案资源管理器编辑 Web 资源
- 打开非托管解决方案并选择 Web 资源。
- 选择垂直省略号 > 编辑 > 在经典模式下编辑。
- 完成此窗体以创建 Web 资源:
列 | 步骤 |
---|---|
名称 | 必需。 这是此 Web 资源特有的名称。 在保存 Web 资源后,就无法更改它。 • 此名称只能包含字母、数字、句点和不连续的正斜杠 (“/”) 字符。 • 解决方案发布商的自定义前缀将附加到该 Web 资源的名称上。 |
显示名称 | 如果您查看 Web 资源列表,则会显示该名称。 |
说明 | Web 资源说明。 |
类型 | 必需。 Web 资源的类型。 保存 Web 资源之后,就不能对此进行更改。 |
文本编辑器 | 当 Web 资源类型表示一种文本文件时,请选择此按钮打开一个页面,使用文本编辑器编辑其内容。 详细信息:正确使用文本编辑器 |
语言 | 允许选择一种语言。 此选项仅标记存储 Web 资源数据的行。 它不更改 Web 资源的行为。 |
上载文件 | 选择选择文件按钮选择要上载为 Web 资源的文件。 • 在创建新 Web 资源或要覆盖现有的 Web 资源时,可上载文件。 • 文件的文件名扩展必须与允许使用的扩展相匹配。 • 默认情况下,可以作为 Web 资源上传的最大文件大小为 5 MB。 可使用系统设置 > 电子邮件选项卡 > 设置附件的文件大小限制设置来修改此值。 更多信息:“系统设置”对话框 -“电子邮件”选项卡 |
URL | 保持 Web 资源之后,此处会显示访问该 Web 资源的 URL。 选择该链接,在浏览器中查看该 Web 资源。 |
- 添加了您的更改之后,选择保存,然后选择发布。
正确使用文本编辑器
Web 资源的应用程序中提供的文本编辑器只能用于简单的文本文件的编辑。 您可以使用它创建和编辑 HTML Web 资源,但是,您只能编辑使用文本编辑器编辑的 HTML Web 资源。 文本编辑器适用于非常简单的 HTML 内容。
重要
如果 HTML Web 资源的内容并不是使用文本编辑器来创建的,就不要使用文本编辑器对其进行编辑。
文本编辑器使用的控件可以以准许的编辑方式来修改 HTML 资源。 这些更改可以使浏览器中页面的表现行为有所不同,并导致更为复杂的代码停止工作。 使用文本编辑器打开一个 HTML Web 资源并将其不加任何更改地进行保存,这可能会破坏某些 HTML Web 资源。
我们建议您使用外部编辑器编辑文本文件,然后将它们保存在本地,之后再使用上载文件按钮将它们上载。 如果需要返回到早期版本,使用这种方法就可以保留 Web 资源的副本。 可使用类似记事本的简单编辑器,但是,强烈建议您使用具有更加高级的功能的文本编辑器。 Visual Studio 社区和 Visual Studio Code 是免费的,它为编辑 Web 资源所使用的基于文本的文件提供强大的功能。
在窗体上使用解决方案资源管理器创建和编辑 Web 资源
添加或编辑窗体上的 Web 资源,使其对用户而言更具吸引力或更有用。
打开非托管解决方案
在 Power Apps 左侧导航窗格中选择解决方案,然后在工具栏上选择切换到经典。 如果项目不在侧面板窗格中,请选择 …更多,然后选择所需项目。
在所有解决方案列表中,打开要使用的非托管解决方案。
导航到窗体
打开解决方案资源管理器,在组件下,展开实体,然后展开工作时所需表。
选择窗体,在列表中找到“主要”类型窗体,然后双击或点按打开和编辑窗体。
在窗体中添加或编辑 Web 资源
请参阅 Web 资源属性了解您可以在窗体中为 Web 资源设置的属性的信息。
预览
预览主窗体的显示方式以及事件的运行方式:
- 在主页选项卡上,选择预览,然后选择创建表单、更新表单或只读表单。
- 若要关闭“预览”表单,请在文件菜单上,选择关闭。
保存
窗体编辑完成后,请在主页选项卡上,选择保存并关闭以关闭窗体。
Publish
完成自定义后,发布自定义项:
- 若要只为您当前编辑的组件发布自定义项,请在导航窗格中,选择您一直在处理的表,然后选择发布。
- 若要同时为所有未发布组件发布自定义项,在导航窗格中,选择实体,然后在操作工具栏上选择发布所有自定义项。