Jira Software模块
在Adobe Workfront Fusion方案中,您可以自动使用Jira Software的工作流,并将其连接到多个第三方应用程序和服务。
如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。
有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。
访问要求
您必须具有以下权限才能使用本文中的功能:
要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。
有关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中的创建连接字段。
在Jira中创建API令牌
-
单击 创建API令牌。
-
键入令牌的名称,如 Workfront Fusion。
-
使用 复制到剪贴板 按钮复制令牌。
note important IMPORTANT 关闭此对话框后,无法再次查看令牌。 1. 将生成的令牌存储在安全位置。
-
继续在 Workfront Fusion中配置 Jira API令牌。
在Workfront Fusion中配置Jira API令牌
-
在Workfront Fusion中,将Jira模块添加到方案以打开 创建连接 框。
-
指定以下信息:
- 服务URL: 这是用于访问Jira帐户的基本URL。 示例:
yourorganization.atlassian.net
- 用户名
- API令牌: 这是您在在此文章的 Jira部分中创建API令牌的API令牌。
- 服务URL: 这是用于访问Jira帐户的基本URL。 示例:
-
单击继续以创建连接并返回模块。
将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设置 > 应用程序> 应用程序链接。
-
在 输入要链接的应用程序的URL 字段中,输入
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
单击 新建链接。 忽略“No received from the URL you entered(从输入的URL未收到任何响应)”错误消息。
-
在 链接应用程序 窗口中,在 使用者密钥 和 共享密钥 字段中输入值。
您可以选择这些字段的值。
-
将 使用者密钥 和 共享密钥 字段的值复制到安全位置。
在配置过程的后续步骤中,您将需要这些值。
-
按如下方式填写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
-
选中 创建传入链接 复选框。
-
单击 继续。
-
在 链接应用程序 窗口中,填写以下字段:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header 使用者密钥 将您复制的使用者密钥粘贴到安全位置。 使用者名称 输入您选择的名称。 此名称供您参考。 公钥 从 jira_publickey.pem
文件中粘贴公钥。 -
单击 继续。
-
继续在 Workfront Fusion中创建与 Jira Server 或 Jira Data Center 的连接
在Workfront Fusion中创建与Jira Server或Jira Data Center的连接
-
在Workfront Fusion中的任何Jira Server模块中,单击连接字段旁边的 添加。
-
在创建连接面板中,填写以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 连接名称 输入连接的名称 使用者密钥 将您复制的使用者密钥粘贴到中的安全位置在Jira中将客户端应用程序配置为使用者 Private Key 粘贴您在中为Jira连接生成公钥和私钥的 jira_privatekey.pcks8
文件中的私钥。Service URL 输入您的Jira实例URL。 示例: yourorganization.atlassian.net
-
单击 继续 以创建连接并返回模块。
Jira Software模块及其字段
配置Jira Software模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Jira Software字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。
如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。
触发器
观看记录
此触发器模块在添加、更新或删除记录时启动方案。
操作
将问题添加到冲刺
此操作模块向冲刺添加一个或多个问题。
配置此模块时,会显示以下字段。
创建记录
此操作模块在Jira中创建新记录。
该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
自定义API调用
此操作模块允许您对Jira Software API进行经过身份验证的自定义调用。 这样,您可以创建其他Jira Software模块无法实现的数据流自动化。
配置此模块时,会显示以下字段。
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。
删除记录
该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
下载附件
此操作模块下载特定附件。
配置此模块时,会显示以下字段。
读取记录
此操作模块从Jira Software中的单个记录读取数据。
您指定记录的ID。
该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
更新记录
此操作模块更新现有记录,如问题或项目。
您指定记录的ID。
该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
搜索
列出记录
此搜索模块可检索与您的搜索查询匹配的特定类型的所有项目
您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。
搜索记录
此搜索模块在Jira Software中查找与您指定的搜索查询匹配的对象中的记录。
您可以在场景的后续模块中映射此信息。
配置此模块时,会显示以下字段。