配置 Jira 网页触发器,以便在 Jira 项目中发生事件时触发操作。 此示例演示如何使用 Jira 网页触发器创建 任务机器人,以便当指定用户在指定的 Jira 项目中创建问题时,向 Microsoft 365 Outlook 邮箱发送电子邮件。

Jira 网页触发器监控名称为 ABCJira 项目中由名称为 XYZ 的用户创建的新问题(问题已创建事件)。 当用户创建一个问题时,触发器会启动后续的 Microsoft 365 Outlook 操作,将电子邮件发送到 Microsoft 365 Outlook 邮箱。 此电子邮件包含 Jira 摘要和描述,并以 Jira 问题 ID 作为主题。

先决条件

确保您满足以下先决条件:
  • Jira 网页触发器先决条件中提到的先决条件。
  • Jira 客户端密钥和 Credential Vault 中存储的 Microsoft 365 用户名。
  • 该项目可用的 Jira 实例和 Microsoft 365 Outlook 账户的 OAuth 连接。
  • 一个名称为 TriggerData 的记录变量。

过程

  1. 执行以下步骤以创建 任务机器人
    1. 在左侧窗格中,单击自动化
    2. 单击 创建 > 任务机器人
      创建任务机器人向导将会出现。
    3. 名称字段中为机器人输入一个合适的名称。
      默认情况下,所有机器人都存储在 <\Bots> 文件夹中。
    4. 可选: 描述字段中为机器人添加描述。
    5. 可选: 单击选择,并按照提示将机器人保存到其他文件夹。
    6. 单击创建和编辑
      机器人已创建,并显示机器人编辑器页面。
  2. 执行以下步骤以添加并配置 Jira 网页触发器。
    1. 单击触发器 > Jira ,然后双击或拖动网页触发器以将网页触发器添加到触发器部分。
    2. 监听事件下拉菜单中选择问题已创建
    3. 筛选条件中使用以下选项之一配置事件筛选条件:
      • 查询: 请输入以下 JQL 查询 project= "ABC" AND reporter= "XYZ"
      • 条件: 请按照以下步骤,使用条件生成器创建筛选条件。
        1. 选择AND > 添加条件
        2. 配置第一个条件,将 ID 作为条件类型等于作为选择操作ABC 作为
        3. 单击添加以添加该条件。
        4. 单击添加条件
        5. 配置第二个条件,将报告人作为条件类型等于作为选择操作XYZ 作为
        6. 单击添加以添加第二个条件。
      请参阅 Jira 网页触发器 中的筛选条件(可选)部分,了解有关如何构建筛选条件的更多信息。
    4. 单击选择以从选择一个 OAuth 连接模式中选择预配置的 OAuth 连接。
    5. 选择用于验证接收事件的客户端密钥 > 凭据 > 选择,并按照选择凭据模态框中的提示,选择在 Credential Vault 中可用的 Jira 客户端密钥
    6. 响应(可选)下拉列表中选择 TriggerData
      此记录变量捕获触发器响应数据。 触发器响应数据以键值对格式包含了发生更改的事件的所有信息。
  3. 执行以下步骤以添加并配置 Microsoft 365 Outlook 连接 操作。
    1. 单击操作 > Microsoft 365 Outlook ,然后双击或拖动连接操作,将其添加到操作部分。
    2. Azure 云: 选择 Azure Global
      如果您拥有 Microsoft 365 Outlook Government 版本,请选择 Azure US GCC High
    3. OAuth2 身份验证模式下拉菜单中选择 Control Room 托管
    4. 连接中单击选择,并按照选择 OAuth 连接模态框中的提示选择 Microsoft 365 Outlook 账户的 OAuth 连接。
    5. 用户名中单击凭据 > 选择,并按照选择凭据模态框中的提示选择 Microsoft 365 用户名。
    6. 可选: 创建 Microsoft 365 Outlook 会话中输入合适的会话名称。
      系统默认将 Microsoft365OutlookSession 设置为会话名称。
  4. 执行以下步骤以添加并配置Microsoft 365 Outlook 发送操作。
    1. 单击操作 > Microsoft 365 Outlook ,然后双击或拖动发送操作,将其添加到操作部分。
    2. 输入您在配置连接操作时输入的会话名称。
      如果保留默认名称,系统会将 Microsoft365OutlookSession 预填为 Microsoft 365 Outlook 会话
    3. 输入系统必须在收件人中转发 Jira 详细信息的电子邮件 ID。
    4. 主题中输入 $TriggerData{"issue.key"}$
      Jira 问题键被设置为电子邮件的主题。
    5. 选择 HTML 代码,并输入 摘要 - $TriggerData{"issue.fields.summary"}$。 描述:中的 $TriggerData{"issue.fields.description"}$ 电子邮件正文类型
      Jira 摘要和描述被设置为电子邮件的正文。
  5. 单击保存以保存自动化。
当您单击运行 > 使用触发器运行时,系统将激活触发器,并开始在受监控的 Jira 项目中监听问题已创建事件。 当用户 XYZJira 项目 ABC 中创建新问题时,触发器会启动已配置的操作。 Microsoft 365 Outlook 邮箱将收到一封包含 Jira 摘要和描述并以 Jira 问题 ID 作为主题的电子邮件。