为表单配置事件处理程序

此主题适用于 Dynamics 365 Customer Engagement (on-premises)。 有关此主题的 Power Apps 版本,请参阅:配置模型驱动应用窗体事件处理程序

可以为表单中的以下区域配置 Dynamics 365 Customer Engagement (on-premises) 表单的表单事件处理程序:

元素 事件 / 活动 DESCRIPTION
表格 OnLoad 窗体加载时发生本事件。
OnSave 保存数据时发生本事件。
选项卡 TabStateChange 展开或折叠选项卡时发生本事件。
领域 OnChange 当字段中的数据发生更改并且控件失去焦点时出现。
IFRAME OnReadyStateComplete IFRAME 内容加载时会发生此情况。

事件处理程序包括一个对 JavaScript Web 资源的引用,以及一个在 Web 资源内定义的将在事件发生时执行的函数。 每个元素最多可配置 50 个单独的事件处理程序。

重要

错误地配置事件处理程序可能会导致脚本错误,从而导致表单无法正确加载或运行。 如果您不是脚本的开发人员,请确保您完全了解脚本需要哪些配置选项。

不要使用不来自您信任的源的库来配置脚本事件处理程序。 脚本可用于执行用户可能执行的任何作,而编写不佳的脚本可能会严重损害表单的性能。

配置事件处理程序后,请始终对其进行测试以验证其是否正常工作。

配置事件处理程序

  1. 在表单编辑器中,选择包含要为其配置处理程序的事件的元素。

  2. 主页 选项卡编辑 组中,选择 更改属性 或直接双击该元素。

  3. 在元素属性对话框中,选择 Events 选项卡。

  4. 展开 Form Libraries 区域。 如果尚未列出包含要设置为事件处理程序的函数的库,请添加该库。

  5. 要将表单库添加到事件处理程序中:

    1. Event ListForm Libraries 部分中,选择 Add.

    2. 在可用 Web 资源列表中找到 JavaScript Web 资源。 选择它,然后选择 Add

      如果您需要的 JavaScript Web 资源不存在,请选择 新建 以打开一个新的 Web 资源表单并创建一个。

    3. 要创建 JavaScript Web 资源,请执行以下作:

      1. 在 Web 资源表单中,设置以下属性:

        资产 价值
        名称 必需。 键入 Web 资源的名称。
        显示名称 必需。 键入要在 Web 资源列表中显示的名称。
        DESCRIPTION 可选。 键入 Web 资源的描述。
        类型 必需。 选择 Script(JScript)
        语言 可选。 选择适用于您的组织的一种语言。
      2. 如果您已获得脚本,我们强烈建议您使用 Browse 按钮找到文件并上传它。

        或者,您可以选择 Text Editor 按钮,然后在 Edit Content 对话框中粘贴或键入脚本的内容。

        注释

        因为这个简单的文本编辑器没有提供任何功能来检查脚本的正确性,所以通常您应该始终尝试使用单独的应用程序(如 Visual Studio)来编辑脚本,然后上传它们。

      3. 选择 保存 并关闭 Web 资源对话框。

      4. 您创建的 Web 资源现在已在 Look Up Record (查找记录 ) 对话框中处于选中状态。 选择 Add 以关闭对话框。

  6. Event Handlers (事件处理程序) 部分中,选择要为其设置事件处理程序的事件。

  7. 选择 Add 以打开 Handler Properties 对话框。

  8. Details (详细信息 ) 选项卡上,选择相应的库,然后键入应为事件执行的函数的名称。

  9. 默认情况下,事件处理程序处于启用状态。 如果您不想启用此事件,请清除 Enabled 复选框。

    某些函数需要将执行上下文传递给函数。 如果需要,请选择传递执行上下文作为第一个参数

    某些函数可以接受一组参数来控制函数的行为。 如果需要这些参数,请在 将传递给函数的逗号分隔参数列表中输入它们。

  10. Dependencies 选项卡上,将脚本依赖的任何字段添加到 Dependent Fields 区域。

  11. 选择确定以关闭处理程序属性对话框。

  12. 输入事件处理程序后,您可以通过使用绿色箭头向上或向下移动函数来调整函数相对于任何其他函数的执行顺序。

  13. 选择 确定 关闭元素属性对话框。

  14. 选择 保存 以保存更改。 选择 发布 以发布表单。

注释

虽然用户界面 (UI) 允许您使用向上和向下绿色箭头来调整脚本的加载顺序,但脚本实际上并不是按顺序加载的。

另请参阅

使用“主”窗体及其组件