使用範本來連結 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 Automation and Integration 封裝 Workfront Ultimate Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。 |
| Adobe Workfront 授權 |
標準 工作或更高層級 |
| 產品 |
Workfront:如果您的組織有Select或Prime Workfront套件,但不包含Workfront Automation和Integration,則您的組織必須購買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中建立問題的使用者識別碼。 (範例:
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問題。 此情境填寫「摘要」、「說明」、「到期日」、「工作流程狀態」和「工作流程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) 任務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。 -
繼續在Jira中對應自訂欄位
案例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中,建立webhook。
如需指示,請參閱Jira檔案中的Webhooks。
-
設定webhook時,請使用下列值:
- JQL:專案= "yourProjectName" (其中yourProjectName =您的JIRA專案名稱)
- 問題:已建立、已更新
- 註解:已建立、已刪除
將範本模組連線至Workfront和Jira (模組2)
- 在每個 Workfront模組的「連線」欄位中,選取您在在Workfront Fusion中設定連線中所建立的Workfront連線,然後按一下 確定 以儲存與該模組的連線。
- 在每個 Jira模組的「連線」欄位中,選取您在在Workfront Fusion中設定連線中所建立的Workfront連線,然後按一下 確定 以儲存與該模組的連線。
案例3:Workfront變更為Jira:Workfront任務變更為JIRA問題
-
按一下左側導覽面板中的 範本 索引標籤
。
-
使用畫面左上角附近的搜尋列來搜尋範本。 您可以依範本名稱或包含的應用程式來搜尋。
-
按一下 第3部分:Workfront到Jira:Workfront任務變更為JIRA問題 範本。
範本的檢視隨即開啟,顯示資訊和資料流程的動畫。
-
按一下範本以輸入編輯器。
-
選取將擁有此情境的組織和團隊。
-
在第一個模組中,開始新增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。 -
在每個 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。 -
在每個 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 欄位 運算子 價值 專案ID
和
任務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。 -
在每個 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 欄位 運算子 價值 專案ID
和
任務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。 -
在每個 Workfront模組的「連線」欄位中,選取使用系統整合認證的Workfront連線,然後按一下 確定 以儲存模組。
-
在每個 Jira模組的「連線」欄位中,選取使用系統整合認證的Jira連線,然後按一下 確定 以儲存模組。
情節7:Workfront對Jira:當有關Workfront任務或問題的新檔案時,在JIRA中建立評論
-
按一下左側導覽面板中的 範本 索引標籤
。
-
使用畫面左上角附近的搜尋列來搜尋範本。 您可以依範本名稱或包含的應用程式來搜尋。
-
按一下 案例7:WF-to-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,然後按一下[確定]儲存觸發程式模組。
-
在每個 Workfront模組的「連線」欄位中,選取使用系統整合認證的Workfront連線,然後按一下 確定 以儲存模組。
-
在每個 Jira模組的「連線」欄位中,選取使用系統整合認證的Jira連線,然後按一下 確定 以儲存模組。
情節8:Workfront至Jira:在JIRA中就Workfront任務或問題上的已刪除檔案建立評論
-
按一下左側導覽面板中的 範本 索引標籤
。
-
使用畫面左上角附近的搜尋列來搜尋範本。 您可以依範本名稱或包含的應用程式來搜尋。
-
按一下 案例8:WF-to-Jira移除附件(任務和問題) 範本。
範本的檢視隨即開啟,顯示資訊和資料流程的動畫。
-
在第一個模組中,開始新增webhook。
-
在「連線」欄位中,選取使用系統整合憑證的Workfront連線。
-
在 記錄型別 欄位中,選取
Document。 -
在 狀態 欄位中,選取
New state。 -
使用下列操作設定篩選器:
table 0-row-3 1-row-3 2-row-3 3-row-3 欄位 運算子 價值 專案ID
和
任務ID等於
存在輸入您希望webhook觀看的一或多個專案的ID。 或 projectID
和
OpTaskID等於
存在輸入您希望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。 -
啟用 排除此連線所做的更新 選項。
-
在 記錄來源 欄位中,選取
Deleted record only。 -
按一下[儲存] 儲存webhook,然後按一下[確定]儲存觸發程式模組。
-
在每個 Workfront模組的「連線」欄位中,選取使用系統整合認證的Workfront連線,然後按一下 確定 以儲存模組。
-
在每個 Jira模組的「連線」欄位中,選取使用系統整合認證的Jira連線,然後按一下 確定 以儲存模組。