配置 GitHub 存储库网页触发器,以便在存储库中发生事件时触发操作。 此示例演示如何使用 GitHub 存储库网页触发器创建 任务机器人,以在消息框中显示拉取请求的正文。

当设置中指定的用户在此存储库中创建拉取请求时,触发器将启动已配置的消息框操作。

先决条件

确保您满足以下要求:
  • 许可证和权限在 GitHub 网页触发器 中提及。
  • 一个有效的 GitHub 个人访问令牌,作为凭据存储在您的 Credential Vault 中。
  • 一个名称为 TriggerData 的记录变量。

过程

  1. 执行以下步骤以创建 任务机器人
    1. 在左侧窗格中,单击自动化
    2. 单击 创建 > 任务机器人
      创建任务机器人向导将会出现。
    3. 名称字段中为机器人输入一个合适的名称。
      默认情况下,所有机器人都存储在 \Bots 文件夹中。
    4. 可选: 描述字段中为机器人添加描述。
    5. 可选: 单击选择,并按照提示将机器人保存到其他文件夹。
    6. 单击创建和编辑
      机器人已创建,并显示编辑任务机器人页面。
  2. 请按照以下步骤添加并配置 GitHub 存储库网页触发器
    1. 单击触发器 > GitHub,然后双击存储库网页触发器以添加网页触发器。
    2. 监听事件下拉菜单中选择拉取请求
    3. 存储库名称字段中输入存储库名称。
      该触发器监控此存储库以检测该事件。
    4. 用户配置文件字段中输入 GitHub 配置文件名称。
      仅当具有此字段中指定的配置文件名称的用户创建或重新打开拉取请求时,触发器才会激活后续操作。
    5. 选择 个人访问令牌 > 凭据,然后单击 选择
    6. 请按照选择凭据弹窗中的提示操作,并在Credential Vault中选择存储的个人访问令牌
    7. 响应下拉列表中选择TriggerData
      此录制变量以键值对格式捕获关于发生更改事件的触发器响应数据。
  3. 执行以下步骤以添加并配置消息框操作。
    1. 单击操作 > 消息框,然后双击或拖动 消息框 以添加该操作。
    2. 为消息框输入合适的标题,在输入消息框窗口标题中填写。
    3. 输入要显示的消息中输入 $TriggerData{pull_request.body}$
      触发器响应数据中的 $TriggerData{pull_request.body}$ 键包含拉取请求的正文,作为对应值。
  4. 单击保存以保存配置。
当您单击运行 > 使用触发器运行时,系统将激活触发器,并且触发器会开始监听指定 GitHub 存储库中的拉取请求事件。 当具有指定配置文件名称的用户在此存储库中创建或重新打开拉取请求时,触发器将启动 消息框 操作。 消息框显示拉取请求的正文。