Jira Software模块

在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中的Create a connection字段。

在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模块中,单击connection字段旁边的​ Add

  2. 指定以下信息:

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

将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 Settings Jira设置图标 > Applications> Application links

  3. 在​ Enter the URL of the application you want to link ​字段中,输入

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

  5. 在​ Link applications ​窗口中,在​ Consumer key ​和​ Shared secret ​字段中输入值。

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

  6. 将​ Consumer key ​和​ Shared secret ​字段的值复制到安全位置。

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

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

    table 0-row-2 1-row-2 2-row-2 3-row-2
    字段 描述
    Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
    Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
    Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
  8. 选中​ Create incoming link ​复选框。

  9. 单击 Continue

  10. 在​ Link applications ​窗口中,填写以下字段:

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

  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模块中,单击connection字段旁边的​ Add

  2. 在Create a connection面板中,填写以下字段:

    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
    Connection name 输入连接的名称
    Environment 选择您使用的是生产环境还是非生产环境。
    Type 选择您使用的是服务帐户还是个人帐户。
    Consumer Key 将您复制的使用者密钥粘贴到中的安全位置在Jira中将客户端应用程序配置为使用者
    Private Key 粘贴您在中为Jira连接生成公钥和私钥的jira_privatekey.pcks8文件中的私钥。
    Service URL 输入您的Jira实例URL。 示例: yourorganization.atlassian.net
  3. 单击​ Continue ​以创建连接并返回模块。

Jira Software模块及其字段

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

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

映射切换

触发器

Watch for records

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

Webhook

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

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

  1. 单击 Add

  2. 输入webhook的名称。

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

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

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

    • Comment
    • Issue
    • Project
    • Sprint

操作

Add issue to sprint

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

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

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

Create a Record

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

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

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

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

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

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Custom API Call

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

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

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

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

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

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

Workfront Fusion 为您添加授权标头。

Query String

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

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

Body

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

注意:

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

Delete a record

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

您指定记录的ID。

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

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

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

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

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
输入或映射要删除的记录的ID或键。

Download an attachment

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

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

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

Read a record

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

您指定记录的ID。

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

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

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

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

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
选择要接收的输出。 输出选项基于“Record Type”字段中选择的记录类型可用。
ID
输入或映射您希望模块读取的记录的唯一Jira Software ID。

Update a record

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

您指定记录的ID。

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

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

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

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

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
输入或映射要更新的记录的ID或键,然后填写特定于该记录类型的其他字段显示在模块中。

搜索

List records

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

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

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

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

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

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
输入或映射您希望模块在每个方案执行周期中检索的最大记录数。

Search for records

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

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

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

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

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

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

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

  • Project

  • Project by issue

  • User

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