定义触发器

以下为定义触发器时使用的触发器组件：

  • 触发器事件类型
  • 触发器的局部变量、静态变量、宏和事件变量
  • 触发器设置
  • 触发器动作，包括动作之间的成功和失败路径。

定义触发器时，可为触发器命名，标识事件类型（数据、计划、按需等），定义事件参数，然后配置一个或多个动作。您将能够验证触发器，以检查其正确性和完整性。保存触发器后，系统会将其写入节点上的内部数据库文件。

定义触发器的应用逻辑后，可以多次编辑、验证和保存触发器定义。可以使用触发器报告功能生成触发器执行报告，从而了解触发器的动作执行进度以及动作成功和失败路径。

定义示例触发器

此示例将快速引导您逐步定义和执行示例触发器。各触发器组件的概念和参考信息将在对应部分中介绍，此快速示例不会涵盖所有详细信息和变体。

向画布添加动作

  1. 选择并展开要在其中定义和执行触发器的节点。
  2. 单击触发器将要驻留的项目。
    此示例假定您将使用在项目中定义的项目。
  3. 单击项目选项卡右侧窗格底部的 New（新建）按钮，开始定义新触发器。
    随即显示新 Trigger（触发器）窗口。

  4. 为 Name（名称）输入 MyFirstTrigger。
  5. 为 Trigger Event Type（触发器事件类型）选择 On-demand（按需）。
  6. 在左侧窗格的动作列表中，展开 Internal（内部）类别
  7. 单击并将 Log Message（日志消息）动作放置在画布中，将其置于 Start（启动）块下方
    或者也可拖动（单击并按住）该动作，确定其位置后进行放置（释放鼠标按钮）。
  8. 在左侧窗格中，单击Wait（等待）动作并将其放置在画布上的 Log Message（记录消息）动作下方。
  9. 在左侧窗格中，单击 Log Message（记录消息）动作并将其放置在 Wait（等待）动作下方。
  10. 在左侧窗格上方的工具栏中，选择 End Execution (Success)（结束执行（成功））动作，并将其放置在画布上第二个 Log Message（记录消息）动作下方。
  11. 在左侧窗格上方的工具栏中，选择 End Execution (Failure)（结束执行（失败））动作，并将其放置在画布上 End Execution (Success)（结束执行（成功））动作右侧。
  12. 在左侧窗格上方的工具栏中，选择 Comment（注释）块，并将其放置在画布上 Start（启动）块右侧。在 Comment（注释）块中输入 This is a comment for my first trigger

画布应如下图所示：

为每个动作输入参数详细信息

两个 Log Message（记录消息）动作和 Wait（等待）动作都有需要输入的参数。
要为动作输入参数信息，请在画布区域中双击该动作。

对相应动作执行以下步骤：

  1. 双击第一个 Log Message（记录消息）动作。
    动作的参数详细信息随即显示在窗口中。
  2. 在 Message（消息）参数中，删除 $(Message) 文本，然后输入 Hello World。

  3. 在 Details（详细信息）选项卡中，为此动作输入注释。
  4. 通过选择窗口右上角的红色关闭图标 (X) 关闭窗口。
  5. 双击 Wait（等待）动作。
  6. 在 Time to Wait(ms)（等待时间 (ms)）参数中，输入 5000 表示 5000 毫秒（5 秒）。
  7. 通过选择红色关闭图标 (X) 关闭窗口。
  8. 双击第二个 Log Message（记录消息）动作。
  9. 在 Message（消息）参数中，输入 $(Message) from trigger $(trigger) in project $(project)。
    $( ) 中括入的各替换参数会变为 Input（输入）选项卡上的输入参数。
  10. 为每个输入参数输入变量，如下所示：

  11. 通过选择红色关闭图标 (X) 关闭窗口。

为每个动作指定路径

动作和块需要为每个输入和输出端口指定路径。

对相应路径执行以下步骤：

  1. 单击并按住 Start（启动）块底部的输出端口，然后将鼠标光标拖动至第一个 Log Message（记录消息）动作顶部的输入端口。
    当输入端口从蓝色变为黄色时，松开鼠标按钮。
    应在 Start（启动）块和第一个 Log Message（记录消息）动作之间绘制一条路径连接线。
  2. 从第一个 Log Message（记录消息）动作底部到 Wait（等待）动作顶部绘制一条连接线。
  3. 从 Wait（等待）动作底部到第二个 Log Message（记录消息）动作顶部绘制一条连接线。
  4. 从第二个 Log Message（记录消息）动作底部到 End Execution (Success)（结束执行（成功））动作顶部绘制一条连接线。
  5. 从 Wait（等待）动作红色侧面出口到 End Execution (Failure)（结束执行（失败））动作顶部绘制一条连接线。

完成后画布应如下图所示：

验证并保存触发器

  1. 单击右侧窗格底部的 Validate（验证）。验证功能将检查每个动作的正确性和完整性。
    如果发现错误，会显示在窗口中以供检查和更正。如果触发器并未查出任何错误及作出更正，则触发器验证成功。
  2. 单击右侧窗格底部的 Save（保存）以保存触发器定义并关闭触发器画布编辑器。
    触发器将列在项目选项卡的触发器列表中，并处于 Stopped（已停止）状态

启动并执行触发器

  1. 单击要启动的触发器。
  2. 执行以下操作之一：
    1. 单击 Start（启动）或右键单击触发器，然后选择 Start（启动）选项。
    2. 以管理员身份运行触发器 - 右键单击触发器并选择 Start as Admin（以管理员身份启动），以管理员身份运行触发器。
      为了以管理员身份运行触发器，管理员需提供进行访问所必要的个人资料。在 Policy（策略）中，应启用 Elevate（提升）> Run Trigger as Admin（以管理员身份运行触发器），以便以管理员身份启动触发器。

      有关设置策略的更多信息，请参见 策略选项卡。
  3. 触发器状态应为 Started（已启动），触发器状况应为 Loaded（已加载）。
    如果触发器状况为 Unloaded（已卸载），则需要启动项目。为此，请右键单击项目选项卡以显示弹出菜单，然后选择 Start（启动）选项。项目状态应为 Started（已启动），触发器则应为 Started（已启动）并 Loaded（已加载）。
  4. 右键单击触发器，然后选择 Fire Trigger（激发触发器）选项。
  5. 触发器（On-demand（按需）事件类型）将执行。
    您可能会看到 In Progress（正在进行）计数变为 1，随后应看到 Successes（成功）计数也变为 1。
  6. 选择 Refresh（刷新）按钮若干次，直至看到触发器执行完毕。
  7. 您会注意到 Last Triggered（上次激发）和 Avg Time (ms)（平均时间 (ms)）值发生更新。
  8. 由于此触发器向 Exceptions Log（异常日志）添加消息，我们将浏览该日志以查看消息。
  9. 在左侧窗格中，选择此节点的 Logs & Reports（日志和报告）图标。
  10. 在右侧窗格中，选择 Exceptions Log（异常日志）选项卡。
    随即显示 Exceptions Log（异常日志）消息，包括此触发器中的两则消息：

  11. 还可以浏览审核日志，查看事件发生时系统记录的审核消息类型。
  • 可以使用触发器列表编辑器来代替触发器画布编辑器。
  • 示例触发器的逻辑很简单，较为复杂的触发器则可能包括对设备变量的访问、对企业应用的访问、与物联网设备管理门户的交互等等。

以上就是示例触发器的内容。后续部分将介绍各触发器组件的详细信息。

具体内容