Jira Software模块

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

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

访问要求

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

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

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

先决条件

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

将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. 转到https://id.atlassian.com/manage/api-tokens并登录。

  2. 单击​ 创建API令牌

  3. 键入令牌的名称,如​ Workfront Fusion

  4. 使用​ 复制到剪贴板 ​按钮复制令牌。

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

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

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

在Workfront Fusion中配置Jira API令牌

  1. 在Workfront Fusion中,将Jira模块添加到方案以打开​ 创建连接 ​框。

  2. 指定以下信息:

    • 服务URL
    • 用户名
    • 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设置 > 应用程序> 应用程序链接

  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. 在创建连接面板中,填写以下字段:
连接名称
输入连接的名称
使用者密钥
将您复制的使用者密钥粘贴到中的安全位置在Jira中将客户端应用程序配置为使用者
Private Key
粘贴您在中为Jira连接生成公钥和私钥的jira_privatekey.pcks8文件中的私钥。
Service URL
输入您的Jira实例URL。
  1. 单击​ 继续 ​以创建连接并返回模块。

Jira Software模块及其字段

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

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

触发器

观看记录

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

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或密钥。

创建记录

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

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

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

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

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

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

自定义API调用

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

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

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的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和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

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

有关将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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43