客户端脚本简介
客户端脚本允许您在 Power Apps 模型驱动应用中使用 JavaScript 实现自定义业务逻辑。 当声明性业务规则不符合要求时,应将客户端脚本作为替代方法。 客户端脚本在模型驱动窗体上运行,以对窗体事件作出响应。 以下是您可以为其使用事件处理程序的常见事件:
窗体加载
列中的数据发生更改
窗体已保存
此外,您还可以配置命令栏按钮,在按下按钮时调用客户端脚本函数。
您可使用客户端脚本完成的一些常见任务包括:
获取或设置窗体上的列值。
显示和隐藏用户界面元素。
每列引用多个控件。
当有多个窗体可用于一个表时,在不同窗体之间切换。
打开窗体、视图、对话框和报表。
与业务流程流控件交互。
使用所提供的客户端脚本 API,您可以实现与数据的交互、更改窗体内容或修改应用行为。 如果以 JavaScript 编辑逻辑,请务必注意,尽管窗体使用的是标准 HTML,但不支持直接操作窗体内容。 客户端脚本为对象模型提供了用于与各种窗体组件交互的方法。 这种方法可确保,窗体呈现中使用的布局或特定 HTML 发生任何变化时,不会影响您的业务逻辑。 还有一点同样重要,请只使用记录的对象和功能,而不能使用您发现的任意对象和功能,因为它们可能会随时更改甚至不再可用。 有关受支持和不受支持的自定义的详细信息,请参阅 Dataverse 开发人员指南中的 Microsoft Dataverse 应用生成实践 - Power Apps。
这是客户端脚本 API 对象模型和命名空间的整体结构:
应用 - 允许为任何应用级别通知添加事件处理程序。
设备 - 允许在获得同意后访问设备内容,如图像、视频、音频、位置等。
编码 - 快速访问 HTML 编码/解码功能。
导航 - 提供独立于平台的导航功能,包括打开对话框、窗体、文件和 URL。
面板 - 在侧窗格的静态区域中显示由 URL 表示的网页,该窗格显示在模型驱动应用 Web 客户端的所有页面上。
实用工具 - 实用工具函数集合,包括对元数据和多个上下文对象的访问权限。
WebAPI - 提供属性和函数,以使用 Web API 创建和管理记录并执行 Web API 操作和功能。
另一个关键高级别概念是上下文对象,这些对象作为事件处理程序参数提供或可通过特殊方法检索到。 这些上下文对象有助于避免编写硬线连接到特定窗体控件布局或特定控件的代码。 以下是您可使用的上下文:
执行 - 定义在其中执行代码的事件上下文。 在窗体或网格上发生事件时传递执行上下文,您可以在事件处理程序中使用该上下文执行各种任务,例如确定 FormContext 或 gridContext,或管理保存事件。
窗体 - 提供对执行当前代码的窗体或窗体上的项目的引用,例如快速视图控件或可编辑网格中的行。 窗体上下文通过使用执行上下文的 getFormContext() 方法进行检索,或在从功能区操作执行代码时作为参数包括在内。 窗体上下文中包含以下密钥命名空间:
data - 此命名空间提供对窗体上显示的表行的数据的访问权限,包括保存和刷新等函数。 使用此方法的一个示例是:formContext.data.entity.save("saveandnew");
ui - 此命名空间允许您操作窗体上的控件,例如选项卡、部分和控件。 常见任务包括隐藏、显示和将字段设定为必需或非必需。 使用此方法的一个示例是:formContext.ui.refreshRibbon(true);
网格 - 向窗体上的子网格上注册的事件处理程序提供上下文信息。
您可从这些简要描述中看出,使用客户端脚本 API 使您能够十分灵活地实现客户端逻辑。 请务必记住,只有在用户使用应用程序时,使用客户端脚本实现的逻辑才会强制执行您的逻辑。 在许多情况下,客户端脚本必须与服务器端实现配对,以确保逻辑始终运行,而不管采用何种方法访问数据和功能。 本模块的其余部分会更加详细地介绍如何使用客户端脚本。