使用模板连接 Adobe Workfront Fusion 和 Jira
Adobe Workfront Fusion提供了可自动执行Fusion和Jira之间常用工作流的模板。
访问权限要求
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 包 |
任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包,且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| 产品 |
Workfront:如果贵组织具有不包含Workfront Automation and Integration的Select或Prime Workfront包,则必须购买Adobe Workfront Fusion。 Jira:您必须拥有Jira Cloud的许可证 |
| 访问级别配置 |
Workfront:创建用户、自定义表单和自定义字段的权限。 Jira:创建用户和自定义字段以及修改屏幕和Webhook的权限。 |
有关此表中信息的更多详细说明,请参阅文档中的访问权限要求。
先决条件
Workfront
-
您必须在Adobe Developer Console上拥有技术帐户。
有关信息和说明,请参阅Adobe文档中的技术帐户设置。
-
您必须在Adobe Admin Console产品配置文件区域将系统管理员权限应用到技术帐户。
有关信息和说明,请参阅使用Adobe Admin Console在Workfront中创建系统管理员
Jira
如果您使用Jira的OAuth2授权(推荐),则必须在https://developer.atlassian.com/console处设置OAuth2应用程序。 有关信息和说明,请参阅Jira模块文章中的创建与Jira的OAuth2连接。
假设
这些模块采用以下形式:
- Workfront是整个营销活动项目的真实来源
- Jira正被技术团队使用,完成在Workfront启动的项目的一部分。
- 并非所有Jira用户都可以访问Workfront,反之亦然。
- Workfront和Jira托管在云中。
数据模型(字段映射)
*这些字段配置为此集成设置的一部分。 有关说明,请参阅在Workfront、Jira和Workfront Fusion中配置先决条件。
在Workfront、Jira和Workfront Fusion中配置先决条件
要使用Jira集成模板,您必须执行以下配置:
配置Jira
要使用这些模块,必须在Jira中创建以下内容:
- 系统集成用户
- 三个特定的自定义字段
在Jira中创建系统集成用户
- 在Jira中,创建一个名为系统集成用户的特定用户。 此用户应仅由Workfront Fusion使用,而不应代表人类用户。 Workfront Fusion连接将使用此用户的凭据。
在Jira中创建必要的自定义字段
此集成要求它连接到的Jira帐户中包含三个特定字段。 如果没有这些字段,集成将失败
-
在Jira中,转到设置(齿轮图标)并选择工作项。
-
在左侧导航中,选择自定义字段。
-
在屏幕的右上角,单击创建自定义字段。
-
创建以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 字段名称 字段类型 WF ID 文本字段(单行) WF状态 文本字段(单行) WF链接 URL字段 有关在Jira中创建链接的信息,请参阅有关创建字段的Jira文档。
-
将新创建的字段添加到与您的Jira项目关联的屏幕。
有关Jira屏幕的信息,请参阅有关设置工作项屏幕的Jira文档。
配置Workfront
要使用这些模块,必须在Workfront中创建以下内容:
- 系统集成用户
- 特定自定义表单
在Workfront中创建系统集成用户
-
在Workfront中,创建系统集成用户。 此用户仅由Workfront Fusion使用,不代表人类用户。 分配给此用户的任务将触发将Workfront与Jira同步的方案。
有关说明,请参阅Workfront文档中的添加用户。
在Workfront中创建自定义表单
-
在Workfront中,开始创建自定义表单。
有关说明,请参阅Workfront文档中的创建自定义表单。
-
将表单命名为“JIRA字段”。
-
在自定义表单中包含以下字段:
- 添加您要在Jira和Workfront之间映射的任何其他字段。
- 保存自定义表单。
在Workfront Fusion中配置连接
在创建连接之前,您必须在Jira和Workfront中创建系统集成用户。
创建这些连接时,请确保使用已创建的系统集成用户的凭据。
如果需要,您可以在配置模板时创建这些连接。
- 有关创建与Workfront的连接的说明,请参阅Workfront模块一文中的将Workfront连接到Workfront Fusion。
- 有关创建与Jira连接的说明,请参阅“Jira软件模块”一文中的将Jira连接到Workfront Fusion。
场景
Jira的八个现成可用模板可帮助复制通用工作流并加快实施。 模板是完全可自定义的,可满足特定的业务需求,并且可以随着需求的发展而扩展。
您无需实施所有方案。 最低限度的实施将需要情景1,这将从Workfront的一项任务创建一个与JIRA问题的单向集成。 您可以添加其他场景,以在Workfront和JIRA之间增加稳健性和更双向的交互连接。 您还可以创建其他方案以处理项目到大型集成或JIRA问题到Workfront问题或任务等情况。
这些模板或这些模板的扩展的任何使用都被视为自定义配置,我们建议使用Adobe Professional Services或Adobe合作伙伴提供支持和实施。
- Workfront到Jira:从Workfront任务或问题分配创建JIRA问题
- JIRA到Workfront: JIRA到Workfront:将问题和评论的更新从Jira发送回Workfront
- Workfront到Jira:将Workfront任务更改为JIRA问题
- Workfront到Jira:将Workfront问题更改为JIRA问题
- Workfront到Jira:在有关Workfront任务或问题的新注释时在JIRA中创建评论
- Workfront到Jira:在JIRA中创建Workfront任务或问题已删除注释的评论
- 从Workfront到Jira:新建有关Workfront任务或问题的文档时,在JIRA中创建评论
- 从Workfront到Jira:在JIRA中创建Workfront任务或问题上已删除文档的评论
常规参数
配置这些模板时,请使用以下常规参数:
-
JiraBaseURL: Jira实例的基本URL。 示例:
https://myjira.atlassian.net/ -
wfBaseURL: Workfront实例的基本URL。 通常:
https://<domain>.my.workfront.com,其中<domain>是您的特定Workfront域名。 -
defaultJIRAReporterID: JIRA中发生问题的用户的ID。 (示例:
557058:5aedf933-2312-40bc-b328-0c21314167f0)
您可以通过执行以下操作之一来获取此ID:- 在JIRA中单击用户的个人资料,然后查看浏览器中的URL。
(示例https://myjira.atlassian.net/jira/people/<JiraUserID>) - 在您的JIRA实例上运行以下API调用,以获取JIRA中特定帐户的ID:
GET /rest/api/3/user/search?query=email@example.com
- 在JIRA中单击用户的个人资料,然后查看浏览器中的URL。
情景1:Workfront到Jira:从Workfront任务或问题分配创建JIRA问题
当将Workfront任务或问题分配给系统集成用户时,此方案会创建Jira问题。 该方案填写“摘要”、“描述”、“到期日”、“WF状态”和“WF ID”字段。 创建问题后,此方案还会上传与Workfront中的原始任务或问题相关的附件列表和注释历史记录。
如果分配了Workfront任务,则Jira中的问题为任务。 如果分配了Workfront问题,则Jira问题为错误。
配置触发器模块
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 Workfront to Jira:从Workfront任务或问题分配 模板创建JIRA问题。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
选择您在在Workfront Fusion中配置连接中创建的Workfront连接。
-
在 记录类型 字段中,选择
Assignment。 -
在 状态 字段中,选择
New state。 -
使用 And 选项通过以下操作配置筛选器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 assignedToID 等于 (输入系统集成用户的Workfront ID) 任务编号 已存在 projectID 等于 (输入希望webhook监视的一个或多个项目的ID) -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择“仅新建记录”。
-
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
将模板模块连接到Workfront和Jira
- 在每个 Workfront模块的连接字段中,选择您在在Workfront Fusion中配置连接中创建的Workfront连接,然后单击 确定 保存与该模块的连接。
- 在每个 Jira模块的“连接”字段中,选择您在在Workfront Fusion中配置连接中创建的Workfront连接,然后单击 确定 保存与该模块的连接。
- 继续更新常规参数模块。
更新常规参数模块
-
在模板的第二个模块(“设置环境详细信息”)中,对于以下每个变量,单击 添加项 并输入变量的名称和值
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 当Jira中不存在创建者用户时,输入默认用户的ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 输入您要连接的Jira帐户的基本URL。 wfBaseURL 输入您要连接的Workfront帐户的基本URL。
情景2:JIRA到Workfront:将问题和评论的更新从Jira发送回Workfront
在Jira中创建问题时,此方案会创建一个Workfront任务或问题。
若要对Jira使用OAuth2授权,您必须在https://developer.atlassian.com/console处设置OAuth2应用程序。 有关信息和说明,请参阅Jira文档。
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 第2部分:从JIRA到Workfront:将问题和评论的更新从Jira 模板发送回Workfront。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
选择使用系统集成用户凭据的连接,或使用系统集成凭据创建与Jira的连接。
- 有关创建与Jira连接的说明,请参阅“Jira软件模块”一文中的将Jira连接到Workfront Fusion。
-
配置webhook过滤器
在Jira中配置webhook
-
在Jira中,创建一个webhook。
有关说明,请参阅Jira文档中的Webhooks。
-
配置webhook时,请使用以下值:
- JQL:项目=“您的项目名称”(其中,您的项目名称= JIRA项目名称)
- 问题:已创建、已更新
- 评论:已创建,已删除
将模板模块连接到Workfront和Jira(模块2)
- 在每个 Workfront模块的连接字段中,选择您在在Workfront Fusion中配置连接中创建的Workfront连接,然后单击 确定 保存与该模块的连接。
- 在每个 Jira模块的“连接”字段中,选择您在在Workfront Fusion中配置连接中创建的Workfront连接,然后单击 确定 保存与该模块的连接。
场景3:将Workfront更改为Jira:将Workfront任务更改为JIRA问题
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 Part 3: Workfront to Jira: Changes to Workfront task to JIRA issue 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
单击模板以进入编辑器。
-
选择将拥有此方案的组织和团队。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Task。 -
在 状态 字段中,选择
New state。 -
使用 And 选项通过以下操作配置筛选器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 assignedToID 等于 输入系统集成用户的Workfront ID projectID 等于 输入希望webhook监视的一个或多个项目的ID。 DE: Jira键 已存在 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
Updated record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在 设置JIRA变量 模块中,设置以下变量,然后单击 确定 保存该模块。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。
场景4:将Workfront更改为Jira:将Workfront问题更改为JIRA问题
此方案会将Workfront问题中的更新发送到之前连接的JIRA问题。
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 方案4:WF到Jira的更改(问题) 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
单击模板以进入编辑器。
-
选择将拥有此方案的组织和团队。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Issues。 -
在 状态 字段中,选择
New state。 -
使用 And 选项通过以下操作配置筛选器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 assignedToID 等于 输入系统集成用户的Workfront ID projectID 等于 输入希望webhook监视的一个或多个项目的ID。 DE: Jira键 已存在 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
Updated record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在 设置JIRA变量 模块中,设置以下变量,然后单击 确定 保存该模块。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。
场景5:从Workfront到Jira:在有关Workfront任务或问题的新注释时在JIRA中创建评论
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 方案5:WF到Jira新注释(任务和问题) 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Note。 -
在 状态 字段中,选择
New state。 -
使用以下操作配置过滤器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 projectID
和
任务ID等于
存在输入希望webhook监视的一个或多个项目的ID。 或者 projectID
和
OpTaskID等于
存在输入希望webhook监视的一个或多个项目的ID。 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
New record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在 设置变量 模块中设置以下变量,然后单击 确定 保存该模块。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。
情景6:Workfront到Jira:在JIRA中创建Workfront任务或问题已删除注释的评论
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 方案6:WF-to-Jira删除注释(任务和问题) 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Note。 -
在 状态 字段中,选择
New state。 -
使用以下操作配置过滤器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 projectID
和
任务ID等于
存在输入希望webhook监视的一个或多个项目的ID。 或者 projectID
和
OpTaskID等于
存在输入希望webhook监视的一个或多个项目的ID。 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
Deleted record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在第二个模块中,设置以下变量,然后单击 确定 保存该模块。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。
场景7:从Workfront到Jira:新增有关Workfront任务或问题的文档时,在JIRA中创建评论
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 方案7:WF到Jira的新附件(任务和问题) 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Document。 -
在 状态 字段中,选择
New state。 -
使用 And 选项通过以下操作配置筛选器:
table 0-row-3 1-row-3 2-row-3 字段 操作员 值 assignedToID 等于 输入系统集成用户的Workfront ID projectID 等于 输入希望webhook监视的一个或多个项目的ID。 -
在第二个模块中,设置以下变量。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
New record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。
情景8:Workfront到Jira:在JIRA中创建Workfront任务或问题上的已删除文档的评论
-
单击左侧导航面板中的 模板 选项卡
。
-
使用屏幕左上角附近的搜索栏搜索模板。 您可以按模板名称或包含的应用程序进行搜索。
-
单击 方案8:WF到Jira删除附件(任务和问题) 模板。
此时将打开模板视图,显示信息以及数据流动画。
-
在第一个模块中,开始添加webhook。
-
在连接字段中,选择使用系统集成凭据的Workfront连接。
-
在 记录类型 字段中,选择
Document。 -
在 状态 字段中,选择
New state。 -
使用以下操作配置过滤器:
table 0-row-3 1-row-3 2-row-3 3-row-3 字段 操作员 值 projectID
和
任务ID等于
存在输入希望webhook监视的一个或多个项目的ID。 或者 projectID
和
OpTaskID等于
存在输入希望webhook监视的一个或多个项目的ID。 -
在 Set variables 模块中设置以下变量。
table 0-row-2 1-row-2 2-row-2 3-row-2 变量名称 变量值 defaultJiraReporterID 这是Jira中不存在创建者用户时的默认用户ID。 您可以通过单击用户配置文件并检查浏览器的URL来查找此用户ID。 示例: https://myjira.atlassian.net/jira/people/<JiraUserID>JiraBaseURL 要连接的Jira帐户的基本URL。 wfBaseURL 要连接的Workfront帐户的基本URL。 -
启用 排除此连接所做的更新 选项。
-
在 记录来源 字段中,选择
Deleted record only。 -
单击 保存 以保存webhook,然后单击 确定 以保存触发器模块。
-
在each Workfront模块的“连接”字段中,选择使用系统集成凭据的Workfront连接,然后单击 确定 以保存该模块。
-
在每个 Jira模块的“连接”字段中,选择使用系统集成凭据的Jira连接,然后单击 确定 保存模块。