Jira 问题事件触发器 - Jira 问题事件触发器使您能够根据在 Jira 实例中发生的事件自动处理任务。 事件触发器监听在 Jira 问题中发生的特定事件，并在事件发生时启动下游操作。

Automation 360

Jira 问题事件触发器使您能够根据在 Jira 实例中发生的事件自动处理任务。 事件触发器监听在 Jira 问题中发生的特定事件，并在事件发生时启动下游操作。

概览

Jira 问题事件触发器基于诸如问题创建、更新和删除等基于问题的事件，以及诸如评论添加、更新和删除等基于评论的事件。 配置触发器以订阅一个或多个事件，然后在自动化中添加所需的下游操作。 当您使用“通过触发器运行”选项运行自动化时，触发器会连接到 Jira API，并开始监听已订阅的事件。 当这些事件中的任何一个发生时，触发器将启动自动化中的下游操作。

触发器以键值对格式接收来自 Jira API 的响应数据。 您可以将此响应数据保存在单个记录变量或任意类型的多个变量中，并在自动化中的任何下游操作中使用此响应数据。 当自动化运行时完成后，您可以在 审核日志 页面上查看由触发器运行的机器人事件类型中的响应数据。 有关 Jira webhook 事件的详细信息，请参阅 Jira webhook event types。

身份验证

Jira 问题事件触发器使用客户端密钥配置 OAuth 连接，并验证用户身份以及触发器正在监听的接收到的事件。 客户端密钥可防止未经授权的用户访问传入的 Jira 数据以创建和触发自动化。

有关生成和管理客户端密钥的信息，请参阅 OAuth 2.0 (3LO) apps 中的启用 OAuth 2.0 部分。

您可以将此客户端密钥存储在 Credential Vault。 有关在 Credential Vault 中存储和维护凭据的信息，请参阅 Credential Vault 中的凭据和 存储柜。

有关创建和配置 OAuth 连接，请参阅 创建 OAuth 连接。

注： Jira 问题事件触发器仅支持一个订阅账户。

先决条件

确保满足以下先决条件：

  • Bot Creator 或 平民开发者 许可证。
  • 查看我的机器人和 EVENT TRIGGERS 权限。
  • 用于自动化所在文件夹的签入和签出权限。
  • Jira 客户端密钥。
  • Jira 实例的活动 OAuth 连接。

支持的事件

Jira 问题事件触发器支持以下事件：

事件 描述
问题已创建 在 Jira 实例中创建问题时。
问题已更新 当更新 Jira 实例中的现有问题时。
问题已删除 从 Jira 实例中删除问题时。
评论已创建 在 Jira 实例中添加评论时。
评论已更新 当更新 Jira 实例中的现有评论时。
评论已删除 删除 Jira 实例中的评论时。

设置

以下设置适用于 Jira 问题事件触发器：

监听事件
指定要订阅的事件。 从以下选项中选择一个或多个事件：
  • 已创建问题
  • 已更新问题
  • 已删除问题
  • 已创建注释
  • 已更新注释
  • 已删除注释
筛选条件（可选）
使用查询选项或条件选项指定触发器配置的筛选条件。
查询
使用 JQL 查询指定筛选条件，以监控特定的 Jira 问题。 您可以输入已在 Jira 实例中定义的 JQL 查询，或直接输入新的 JQL 查询。 有关构建 JQL 查询的更多信息，请参阅 Use advanced search with Jira Query Language (JQL)。

例如： 输入项目 (ABC) 和状态（“进行中”、“待办”），可搜索在名称为 ABC 的项目中状态为进行中或待办的问题。

条件
使用条件生成器并通过 And 和 Or 运算符指定新条件。 选择适当的运算符并单击添加条件。 请按照添加条件模态框中的提示，使用所选运算符配置条件。 支持以下条件类型：
  • ID： 使用此选项可定义基于 Jira 问题 ID 的条件。
  • 项目： 使用此选项可根据 Jira 项目名称或 ID 定义条件。
  • 负责人： 使用此选项可根据负责人姓名定义条件。 您可以指定 Jira 中显示的负责人姓名，或者负责人的电子邮件地址。
  • 报告人： 使用此选项可根据报告人姓名定义条件。 您可以指定报告人在 Jira 中显示的姓名，或报告人的电子邮件地址。
  • 状态： 使用此选项可定义基于 Jira 问题状态的条件。
  • 优先级： 使用此选项可根据 Jira 问题的优先级定义条件。

选择条件类型后，请选择其中一个运算符并为该条件输入适当的值。 以下运算符可用于定义条件类型：

  • 等于
  • 不等于
  • 在
  • 不在
Control Room OAuth 连接
指定用于连接并验证自动化会话的 OAuth 连接。 使用选择选项，并按照选择 OAuth 连接模态框中的提示，选择 Jira 实例的 OAuth 连接。 有关配置 OAuth 连接的更多信息，请参阅 创建 OAuth 连接。
用于验证事件响应的客户端密钥
指定用于身份验证的 Jira 客户端密钥。
  • 凭据： 使用选择选项，并按照选择凭据模态框中的提示操作，以选择 Credential Vault 中保存的 Jira 客户端密钥。
  • 不安全字符串： 使用不安全字符串选项以纯文本格式输入 Jira 客户端密钥。 在不安全字段中输入客户端密钥会暴露证书。
响应
指定用于存储响应数据的变量。 您可以使用以下任一选项：
  • 多个变量： 创建并指定单独的变量以存储特定的响应数据。

    使用添加变量映射选项来指定键和值对应的变量类型，以存储特定的响应数据。

  • 记录： 创建并指定一个记录变量以存储完整的响应数据。