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 |
产品 |
新增:
或 当前:您的组织必须购买Adobe Workfront Fusion。 |
有关此表中信息的更多详细信息,请参阅文档🔗中的访问要求。
有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证。
先决条件
要使用Jira模块,您必须具有Jira帐户。
Jira API信息
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中的Create a connection字段。
在Jira中创建API令牌
-
在Jira中创建API令牌。
有关说明,我们建议您在Jira文档中搜索“创建API令牌”。
-
创建令牌后,将令牌复制到安全位置。
note important IMPORTANT 关闭此对话框后,无法再次查看令牌。 1. 将生成的令牌存储在安全位置。
-
继续在 Workfront Fusion中配置 Jira API令牌。
在Workfront Fusion中配置Jira API令牌
-
在Workfront Fusion中的任意Jira Cloud模块中,单击connection字段旁边的 Add。
-
指定以下信息:
- 环境
- 类型
- Service URL: 这是用于访问Jira帐户的基本URL。 示例:
yourorganization.atlassian.net
- Username
- API token: 这是您在在此文章的 Jira部分中创建API令牌时创建的API令牌。
-
单击Continue以创建连接并返回模块。
将Jira Server连接到Workfront Fusion
要授权Workfront Fusion与Jira Server之间的连接,您需要消费者密钥、私钥和服务URL。 您可能需要联系Jira管理员以获取此信息。
为您的Jira连接生成公钥和私钥
要获取Workfront Fusion Jira连接的私钥,您需要生成公钥和私钥。
-
在终端中,运行以下
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
文件:-
在终端中,运行以下命令:
openssl x509 -pubkey -noout -in jira_publickey.cer
-
复制终端输出,包括
-------BEGIN PUBLIC KEY--------
和-------END PUBLIC KEY--------
。 -
将终端输出粘贴到名为
jira_publickey.pem
的文件中。
-
-
-
继续将客户端应用程序配置为 Jira中的消费者
在Jira中将客户端应用配置为消费者
-
登录到您的Jira实例。
-
在左侧导航面板中,单击 Jira Settings
-
在 Enter the URL of the application you want to link 字段中,输入
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
单击 Create new link。忽略“No received from the URL you entered(从输入的URL未收到任何响应)”错误消息。
-
在 Link applications 窗口中,在 Consumer key 和 Shared secret 字段中输入值。
您可以选择这些字段的值。
-
将 Consumer key 和 Shared secret 字段的值复制到安全位置。
在配置过程的后续步骤中,您将需要这些值。
-
按如下方式填写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
-
选中 Create incoming link 复选框。
-
单击 Continue。
-
在 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
文件中粘贴公钥。 -
单击 Continue。
-
继续在 Workfront Fusion中创建与 Jira Server 或 Jira Data Center 的连接
在Workfront Fusion中创建与Jira Server或Jira Data Center的连接
-
在Workfront Fusion中的任意Jira Server模块中,单击connection字段旁边的 Add。
-
在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
-
单击 Continue 以创建连接并返回模块。
Jira Software模块及其字段
配置Jira Software模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Jira Software字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。
如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块。
触发器
Watch for records
此触发器模块在添加、更新或删除记录时启动方案。
操作
Add issue to sprint
此操作模块向冲刺添加一个或多个问题。
配置此模块时,会显示以下字段。
Create a Record
此操作模块在Jira中创建新记录。
该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
Custom API Call
此操作模块允许您对Jira Software API进行经过身份验证的自定义调用。 使用此模块创建其他Jira Software模块无法实现的数据流自动化。
配置此模块时,会显示以下字段。
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法。
Delete a record
此操作模块删除指定的记录。
您指定记录的ID。
该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
Download an attachment
此操作模块下载特定附件。
配置此模块时,会显示以下字段。
Read a record
此操作模块从Jira Software中的单个记录读取数据。
您指定记录的ID。
该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
Update a record
此操作模块更新现有记录,如问题或项目。
您指定记录的ID。
该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
搜索
List records
此搜索模块可检索与您的搜索查询匹配的特定类型的所有项目
您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
Search for records
此搜索模块在Jira Software中查找与您指定的搜索查询匹配的对象中的记录。
您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。