Jira模块

NOTE
这些说明适用于Jira连接器的新版本,它简单地标记为Jira。 有关旧版Jira Cloud和Jira服务器连接器的说明,请参阅Jira软件模块

在Adobe Workfront Fusion场景中,您可以自动使用Jira的工作流,并将其连接到多个第三方应用程序和服务。

Jira连接器可用于Jira云和Jira数据服务器。

有关创建方案的说明,请参阅创建方案:文章索引下的文章。

有关模块的信息,请参阅模块:文章索引下的文章。

访问要求

展开以查看本文中各项功能的访问要求。

您必须具有以下权限才能使用本文中的功能:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront包 任何
Adobe Workfront许可证

新增:标准

当前:工作或更高

Adobe Workfront Fusion许可证**

当前:无Workfront Fusion许可证要求

旧版:Workfront Fusion for Work Automation and Integration

产品

新:

  • 选择或Prime Workfront包:您的组织必须购买Adobe Workfront Fusion。
  • Ultimate Workfront包:其中包含Workfront Fusion。

当前:您的组织必须购买Adobe Workfront Fusion。

有关此表中信息的更多详细信息,请参阅文档中的访问要求。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion许可证

先决条件

要使用Jira模块,您必须具有Jira帐户。

将Jira连接到Workfront Fusion

创建所需的凭据

要创建与Jira的连接,您将需要以下各项:

连接类型
帐户类型
需要凭据
OAuth 2
任何
客户端ID和客户端密码
基本
Jira Cloud
Jira API令牌
基本
Jira数据中心
Jira个人访问令牌(PAT)

有关创建其中任何内容的说明,请参阅Jira文档。

创建这些凭据时,您将需要以下信息:

  • 对于OAuth 2:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    融合数据中心 重定向 URL
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    欧盟 https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • 对于个人访问令牌(PAT):

    table 0-row-2 1-row-2 2-row-2 3-row-2
    融合数据中心 重定向 URL
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira
    欧盟 https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    要使用PAT,必须在文件jira/bin/WEB-INF/classes的文件jira-config.properties中启用以下内容:
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    如果此文件不存在,则必须创建它。

在Workfront Fusion中创建与Jira的连接

要在Workfront Fusion中创建连接,请执行以下操作:

  1. 在任意Jira模块中,单击“连接”字段旁边的​ 添加

  2. 配置以下字段:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    连接类型 选择是创建基本连接还是OAuth 2连接。
    连接名称 输入新连接的名称。
    服务URL 输入您的Jira实例URL。 这是您用于访问Jira的URL。
    Jira帐户类型 选择您是连接到Jira云还是Jira数据中心。
    客户端 ID 如果要创建OAuth 2连接,请输入您的Jira客户端ID
    客户端密码 如果要创建OAuth 2连接,请输入您的Jira客户端密钥
    电子邮件 如果您正在创建与Jira Cloud的基本连接,请输入您的电子邮件地址。
    api令牌 如果您正在创建与Jira Cloud的基本连接,请输入您的API令牌。
    个人访问令牌 如果您正在创建与Jira数据中心的基本连接,请输入您的个人访问令牌。
    API版本 选择您希望此连接连接到的Jira API版本。
  3. 单击​ 继续 ​以创建连接并返回模块。

Jira模块及其字段

配置Jira模块时,Workfront Fusion会显示以下列出的字段。 除此以外,还可能会显示其他Jira字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块

映射切换

触发器

留意记录

此触发器模块在添加、更新或删除记录时启动方案。

Webhook

选择要用于监视记录的webhook,或创建新的webhook。

要创建新的webhook,请执行以下操作:

  1. 单击 添加

  2. 输入webhook的名称。

  3. 选择要用于webhook的连接。

    有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion

  4. 选择要软件监视的记录类型:

    • 问题
    • 评论
    • 工作日志
    • 项目
    • Sprint
    • 附件
  5. 选择一个或多个将触发此方案的事件类型。

  6. 输入此模块的Jira查询语言过滤器。

    有关JQL的详细信息,请参阅Atlassian帮助网站上的JQL

  7. 单击 保存 以保存webhook。

操作

将问题添加到冲刺

此操作模块向冲刺添加一个或多个问题。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
冲刺ID
输入或映射要添加问题的冲刺(sprint)的Sprint ID。
问题ID
对于要添加到冲刺的每个问题或键,单击 添加项 并输入问题ID或键。 在一个模块中最多可输入50个。

创建记录

此操作模块在Jira中创建新记录。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
记录类型

选择要模块创建的记录类型。

  • 附件
  • 评论
  • 问题
  • 项目
  • Sprint
  • 工作日志
  • 用户
  • 展示板
  • 类别
  • 筛选条件
其他字段
填写其他字段。 字段可用,具体取决于所选的记录类型。

自定义API调用

通过此操作模块,您可以对Jira API进行经过身份验证的自定义调用。

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
URL
输入相对路径<Instance URL>/rest/api/2/
方法
标头

以标准JSON对象的形式添加请求的标头。

例如, {"Content-type":"application/json"}

Workfront Fusion会为您添加授权标头。

查询字符串

以标准JSON对象的形式添加API调用的查询。

例如: {"name":"something-urgent"}

正文

以标准JSON对象的形式添加API调用的正文内容。

注释:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

删除记录

此操作模块删除指定的记录。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
记录类型

选择要模块删除的记录类型。

  • 评论
  • 问题
  • 项目
  • Sprint
  • 工作日志
  • 附件
  • 展示板
  • 类别
  • 筛选条件
(记录类型)ID
输入或映射要删除的记录的ID或键。

下载附件

此操作模块下载指定的附件。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
ID
输入或映射要下载的附件的ID。

读取记录

此操作模块从Jira中的指定记录读取数据。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
记录类型

选择您希望模块读取的Jira记录的类型。

  • 附件
  • 评论
  • 问题
  • 项目
  • Sprint
  • 工作日志
  • 用户
  • 展示板
  • 类别
  • 筛选条件
输出
选择要接收的输出。 根据在“记录类型”字段中选择的记录类型,输出选项可用。
(记录类型)ID
输入或映射您希望模块读取的记录的唯一Jira ID。

更新记录

此操作模块更新现有记录,如问题或项目。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
记录类型

选择您希望模块更新的记录类型。 选择记录类型后,该记录类型特有的其他字段将显示在模块中。

  • 评论
  • 问题
  • 项目
  • Sprint
  • 过渡问题
  • 类别
  • 筛选条件
ID或密钥
输入或映射要更新的记录的ID或键。
其他字段
填写其他字段。 字段可用,具体取决于所选的记录类型。

搜索

搜索记录

此搜索模块在Jira中查找与您指定的搜索查询匹配的对象中的记录。

您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

连接
有关将Jira帐户连接到Workfront Fusion的说明,请参阅本文中的将Jira连接到Workfront Fusion
记录类型

选择要模块搜索的记录类型。 选择记录类型后,该记录类型特有的其他字段将显示在模块中。

  • 问题
  • 项目
  • 用户
  • Sprint
  • 展示板
  • 工作日志
  • 评论
  • 过渡问题
  • 类别
最大结果
输入或映射您希望模块在每个方案执行周期中检索的最大记录数。
偏移
输入或映射要检索其详细信息的第一个项目的ID。 这是对记录进行分页的一种方式。 如果输入第5000个项目作为抵销,则模块将返回项目5000-9999。
其他字段
填写其他字段。 字段可用,具体取决于所选的记录类型。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3