Jira Software模块

NOTE
这些说明适用于旧版Jira云和Jira服务器连接器。 有关新版本的Jira连接器(仅标记为Jira)的说明,请参阅Jira模块

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

这些说明适用于Jira Cloud和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 API信息

Jira连接器使用以下对象:

Jira Cloud
Jira服务器
apiVersion
2
2
apiVersionAgile
1.0
1.0
API标记
1.7.29
1.0.19

将Jira Software连接到Workfront Fusion

您的连接方法基于您使用的是Jira Cloud还是Jira Server。

将Jira Cloud连接到Workfront Fusion

将Jira Cloud连接到Workfront Fusion

要将Jira Software连接到Workfront Fusion,您必须创建一个API令牌,并将其与您的服务URL和用户名一起插入到Workfront Fusion中的创建连接字段中。

在Jira中创建API令牌

  1. 在Jira中创建API令牌。

    有关说明,我们建议您在Jira文档中搜索“创建API令牌”。

  2. 创建令牌后,将令牌复制到安全位置。

    note important
    IMPORTANT
    关闭此对话框后,无法再次查看令牌。

    1. 将生成的令牌存储在安全位置。

  3. 继续在Workfront Fusion Jira 中配置API令牌。

在Workfront Fusion中配置Jira API令牌

  1. 在Workfront Fusion的任何Jira Cloud模块中,单击​ 连接 ​字段旁边的添加。

  2. 指定以下信息:

    • 环境
    • 类型
    • 服务URL: ​这是用于访问Jira帐户的基本URL。 示例:yourorganization.atlassian.net
    • 用户名
    • API令牌: ​这是您在在此文章的 Jira部分中创建API令牌的API令牌。
  3. 单击继续以创建连接并返回模块。

将Jira Server连接到Workfront Fusion

要授权Workfront Fusion与Jira Server之间的连接,您需要消费者密钥、私钥和服务URL。 您可能需要联系Jira管理员以获取此信息。

为您的Jira连接生成公钥和私钥

要获取Workfront Fusion Jira连接的私钥,您需要生成公钥和私钥。 这是通过计算机终端完成的。 您可以通过在“开始”菜单或计算机搜索栏(不是浏览器搜索栏)中搜索终端来查找终端。

  1. 在终端中,运行以下openssl命令。

    • openssl genrsa -out jira_privatekey.pem 1024

      此命令生成1024位私钥。

    • openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

      此命令创建X509证书。

    • openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

      此命令将私钥(PKCS8格式)提取到jira_privatekey.pcks8文件。

    • openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

      此命令将公钥从证书提取到jira_publickey.pem文件。

      note note
      NOTE
      如果您使用的是Windows,您可能需要手动将公钥保存到jira_publickey.pem文件:
      1. 在终端中,运行以下命令:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. 复制终端输出,包括-------BEGIN PUBLIC KEY---------------END PUBLIC KEY--------

      3. 将终端输出粘贴到名为jira_publickey.pem的文件中。

  2. 继续将客户端应用程序配置为 Jira中的消费者

在Jira中将客户端应用配置为消费者

  1. 登录到您的Jira实例。

  2. 在左侧导航面板中,单击​ Jira设置 Jira设置图标 > 应用程序> 应用程序链接

  3. 在​ 输入要链接的应用程序的URL ​字段中,输入

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. 单击​ 新建链接。 忽略“No received from the URL you entered(从输入的URL未收到任何响应)”错误消息。

  5. 在​ 链接应用程序 ​窗口中,在​ 使用者密钥 ​和​ 共享密钥 ​字段中输入值。

    您可以选择这些字段的值。

  6. 将​ 使用者密钥 ​和​ 共享密钥 ​字段的值复制到安全位置。

    在配置过程的后续步骤中,您将需要这些值。

  7. 按如下方式填写URL字段:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    字段 描述
    请求令牌URL <Jira base url>/plugins/servlet/oauth/request-token
    授权URL <Jira base url>/plugins/servlet/oauth/authorize
    访问令牌URL <Jira base url>/plugins/servlet/oauth/access-token
  8. 选中​ 创建传入链接 ​复选框。

  9. 单击​ 继续

  10. 在​ 链接应用程序 ​窗口中,填写以下字段:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    使用者密钥 将您复制的使用者密钥粘贴到安全位置。
    使用者名称 输入您选择的名称。 此名称供您参考。
    公钥 jira_publickey.pem文件中粘贴公钥。
  11. 单击​ 继续

  12. 继续在Workfront Fusion Jira Server 中创建与 Jira Data Center 或的连接

在Workfront Fusion中创建与Jira Server或Jira Data Center的连接

NOTE
使用Jira Server应用连接到Jira Server或Jira Data Center。
  1. 在Workfront Fusion的任何Jira Server模块中,单击​ 连接 ​字段旁边的添加。

  2. 在创建连接面板中,填写以下字段:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    连接名称 输入连接的名称。
    环境 选择您使用的是生产环境还是非生产环境。
    类型 选择您使用的是服务帐户还是个人帐户。
    使用者密钥 将您复制的使用者密钥粘贴到中的安全位置在Jira中将客户端应用程序配置为使用者
    Private Key 粘贴您在jira_privatekey.pcks8中为连接Jira生成公钥和私钥的文件中的私钥。
    Service URL 输入您的Jira实例URL。 示例: yourorganization.atlassian.net
  3. 单击​ 继续 ​以创建连接并返回模块。

Jira Software模块及其字段

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

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

映射切换

触发器

观看记录

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

Webhook

选择要用于监视记录的webhook。

要添加新的webhook,请执行以下操作:

  1. 单击 添加

  2. 输入webhook的名称。

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

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

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

    • Comment
    • 问题
    • 项目
    • Sprint

操作

将问题添加到冲刺

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

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

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

创建记录

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

该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

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

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

选择您希望模块创建的记录类型,然后填写特定于此记录类型的其他字段显示在模块中。

  • 附件
  • Comment
  • 问题
  • 项目
  • Sprint
  • Worklog

自定义API调用

此操作模块允许您对Jira Software API进行经过身份验证的自定义调用。 使用此模块创建其他Jira Software模块无法实现的数据流自动化。

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

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

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

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

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

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

查询字符串

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

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

Body

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

注释:

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

删除记录

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

您指定记录的ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

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

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

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

  • 附件
  • Comment
  • 问题
  • 项目
  • Sprint
ID或密钥
输入或映射要删除的记录的ID或键。

下载附件

此操作模块下载特定附件。

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

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

读取记录

此操作模块从Jira Software中的单个记录读取数据。

您指定记录的ID。

该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

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

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

选择要模块读取的Jira记录的类型。

  • 附件
  • 问题
  • 项目
  • Sprint
  • 用户
输出
选择要接收的输出。 根据“记录类型”字段中选择的记录类型,输出选项可用。
ID
输入或映射您希望模块读取的记录的唯一Jira Software ID。

更新记录

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

您指定记录的ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

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

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

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

  • Comment
  • 问题
  • 项目
  • Sprint
  • 过渡问题
ID或密钥
输入或映射要更新的记录的ID或键,然后填写特定于该记录类型的其他字段显示在模块中。

搜索

列出记录

此搜索模块可检索与您的搜索查询匹配的特定类型的所有项目

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

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

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

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

  • Comment
  • 问题
  • 项目
  • Sprint问题
  • Worklog
最大结果
输入或映射您希望模块在每个方案执行周期中检索的最大记录数。

搜索记录

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

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

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

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

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

  • Issues

  • Issues by JQL (Jira查询语言)

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

  • 项目

  • [!UICONTROL项目(按问题)

  • 用户

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3