为窗体配置事件处理程序

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

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

元素 事件 说明
表单 OnLoad 在加载窗体时发生。
OnSave 在保存数据时发生。
选项卡 TabStateChange 在展开或折叠选项卡时发生。
字段 OnChange 在字段中的数据发生变化以及控件失去焦点时发生。
IFRAME OnReadyStateComplete 在 IFRAME 的内容加载时发生。

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

重要提示

事件处理程序配置不正确可能导致脚本错误,从而可能导致窗体无法正确加载或正常运行。 如果您不是脚本的开发者,请确保完全了解脚本所需的配置选项。

不要使用来自不是您信任的来源的库来配置脚本事件处理程序。 可以使用脚本执行用户能执行的任何操作,而编写得不好的脚本可能会极大地降低窗体的性能。

在配置了事件处理程序之后,务必对其进行测试以确认其正常工作。

配置事件处理程序

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

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

  3. 元素属性对话框中,选择“事件”选项卡。

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

  5. 若要将窗体库添加到事件处理程序:

    1. 事件列表窗体库部分,选择添加

    2. 在可用的 JavaScript Web 资源列表中查找 Web 资源。 选择它,然后选择添加

      如果需要的 JavaScript Web 资源不存在,请选择新建打开一个新 Web 资源窗体,创建一个 Web 资源。

    3. 若要创建 JavaScript 资源:

      1. 在 Web 资源窗体中,设置以下属性:

        属性
        姓名 必需。 键入 Web 资源的名称。
        显示名称 必需。 键入要在 Web 资源列表中显示的名称。
        说明 (可选) 键入对 Web 资源的说明。
        类型 必需。 选择脚本 (JScript)
        语言 (可选) 选择可用于您的组织的语言之一。
      2. 如果您已经有了一个脚本,我们强烈建议您使用浏览 按钮查找该文件并将其上载。

        或者,您也可以选择文本编辑器按钮,然后在编辑内容对话框中粘贴或键入该脚本的内容。

        备注

        由于这个简单的文本编辑器不提供任何可检查脚本正确性的功能,因此,一般情况下,应始终尽量使用 Visual Studio 之类的单独应用程序来编辑脚本,然后再上载脚本。

      3. 选择保存,然后关闭该 Web 资源对话框。

      4. 您创建的 Web 资源当前在查找记录 对话框中处于选中状态。 选择添加关闭该对话框。

  6. 事件处理程序 分区中,选择要为其设置事件处理程序的事件。

  7. 选择添加以打开处理程序属性对话框。

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

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

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

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

  10. 依赖项选项卡上,将脚本依赖的所有字段添加到从属字段区域。

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

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

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

  14. 选择保存以保存您所做的更改。 选择发布发布窗体。

备注

虽然用户界面 (UI) 让您可以使用向上和向下绿色箭头调整脚本加载的顺序,但脚本实际不按顺序进行加载。

另请参阅

使用“主”窗体及其组件