設定Adobe Workfront for Jira
您可以使用Adobe Workfront for Jira來整合您的Jira和Workfront系統。
安裝附加元件後,您可以在建立Jira個工作專案時,定義自動建立Workfront問題的工作流程。 兩個應用程式中的專案會變成連結,而且其部分資訊會在兩個系統中自動更新。
Workfront和Jira中的所有使用者都可以受益於這項整合。 他們只需要最常使用的系統授權,而不需要兩個系統的授權。
此附加元件適用於軟體的伺服器和OnDemand (或雲端Jira)版本。
如需Jira目前支援的Workfront for Jira版本清單,請參閱Workfront for Jira的 Atlassian Marketplace。
存取需求
您必須具備下列條件:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Adobe Workfront 計畫 |
新增:任何 或 目前: Pro或更高版本 |
Adobe Workfront 授權 |
新增:Standard 或 目前: 計畫 |
Jira 存取 |
系統管理員存取權 重要:建議您在Jira和Workfront中建立個別的系統管理員帳戶以專用於此整合,而不使用可能附加至使用者的現有帳戶。 |
存取層級設定 | 您必須是Workfront管理員。 |
如需有關此表格的詳細資訊,請參閱Workfront檔案中的存取需求。
先決條件
設定Workfront for Jira之前,您必須:
- 安裝Workfront for Jira。
如需安裝Workfront for Jira的說明,請參閱安裝 Adobe Workfront for Jira。
設定Workfront for Jira
透過設定Workfront for Jira,您可以:
- 定義將在建立Jira個專案時建立Workfront個專案的觸發器。
- 指定在Jira和Workfront之間連結的專案之間應同步處理哪些欄位。
- 在您的Workfront for Jira環境中設定Jira後,所有Jira使用者都會在所有Workfront專案上看到Jira右側面板。 面板包含可能從Workfront連結之專案的相關資訊,或指定沒有Workfront專案連結至Jira專案。
- 使用Jira Server安裝時,只有與識別為Workfront整合觸發器的專案關聯的問題才會顯示Workfront面板。 如需為Workfront to Jira工作流程設定觸發程式的詳細資訊,請參閱設定觸發程式,以自動連結 Jira 與 Workfront之間的專案。
若要設定Workfront for Jira:
-
以Jira管理員身分登入Jira。
-
在主 功能表中按一下 設定Jira。
-
按一下 附加元件,然後按一下 管理附加元件。
-
展開 Workfront 附加元件。
-
按一下 設定。
-
依照提示登入Workfront。
note note NOTE 使用者必須在 apiKey
Workfront中擁有有效的,才能建立成功的連線。您必須以Workfront管理員身分登入Workfront才能繼續設定。
note note NOTE - Workfront使用OAuth 2.0連線至Jira,這是大部分的網頁式整合所使用的標準,用於驗證及授權使用者。
- 當系統提示您輸入Workfront帳戶的網域時,請使用此格式輸入它: yourCompany'sDomain.my.workfront.com。 您公司的網域通常是您公司的名稱。
- 增強式驗證必須由Workfront系統管理員針對這項整合啟用才能使用。
-
在Jira中,選取 觸發器 索引標籤,當建立新的Jira專案時,設定自動建立Workfront專案。
如需設定Workfront至Jira工作流程觸發程式的詳細資訊,請參閱設定自動連結 Jira 與 Workfront之間專案的觸發程式。
-
選取「設定」標籤,以設定連結Jira與Workfront專案之間的欄位同步化。
如需設定Jira與Workfront之間欄位同步化的詳細資訊,請參閱設定 Jira 與 Workfront 專案之間的欄位同步化。
note note NOTE 定義兩個應用程式之間的觸發器和欄位同步之後,任何可以建立任務或問題的Workfront使用者都可能觸發在Jira中建立專案。 如果使用者建立專案的條件符合Jira中的觸發程式,即使使用者沒有Jira授權,使用者也可以建立專案。 此外,任何Jira使用者都可以立即開始處理Jira專案,且可在Workfront中看到其更新,而無需擁有Workfront授權。 Workfront中的任何更新也會顯示在Jira個專案上。 -
(選擇性)選取 活動記錄 標籤,以檢閱整合期間可能發生的任何錯誤。
如需活動記錄的詳細資訊,請參閱檢視 Jira 活動記錄。
設定在Jira和Workfront之間自動連結專案的觸發程式
作為Jira系統管理員,您可以定義在Jira中的專案符合特定條件時,在Workfront中自動建立問題的觸發程式。
當已建立Jira個專案,在設定觸發建立Workfront專案時,請考量下列事項:
- 整合是單向的:您只能觸發您在Workfront中建立的專案,使其自動在Jira中建立。 您無法觸發您在Jira中建立的專案,使其自動在Workfront中建立。
- 您可以使用的觸發器數量沒有限制。
- 如果您在Workfront中建立的專案符合多個觸發程式,則在Jira中只會建立一個專案。 專案是根據第一個觸發程式在Jira中建立(按照它們在Jira中定義的順序)。 忽略所有其他觸發程式。
- 在Workfront中只有一個專案可以連結到Jira中的一個專案。 您永遠無法將一個Workfront專案連結至多個Jira問題,或一個Jira問題連結至多個Workfront專案。
若要設定在Jira中自動建立專案的觸發程式:
-
以系統管理員身分登入Jira。
-
在主 功能表中按一下 設定Jira。
-
按一下 附加元件,然後按一下 管理附加元件。
-
展開 Workfront 附加元件。
-
按一下 設定。
-
以系統管理員身分登入Workfront。
Jira預設會選取 觸發器 標籤。
-
按一下 新增觸發器 以新增觸發器。
-
在 Workfront團隊/使用者/角色 欄位中,指定Workfront團隊、使用者或工作角色的名稱,然後按一下以在清單中顯示時選取它。
note note NOTE 同一個團隊、使用者或角色不能有多個觸發程式。 當有人建立任務或問題並將其指派給其中一個實體時,問題會自動在Jira中建立。
-
在 Jira專案 欄位中,開始輸入Jira專案的名稱,然後按一下以在清單中顯示時選取它。
建立Jira問題時,它會放置在您在此處選擇的專案上。
-
從下拉式功能表中選取 I問題型別。
這表示當符合此觸發器的條件時,根據Jira中該特定專案的設定,在Jira中建立的問題型別。
-
按一下「儲存」。
使用此設定,每當Workfront使用者建立符合指定觸發器的專案時,Jira中就會建立新問題。
設定Jira和Workfront專案之間的欄位同步處理
作為Jira管理員,您可以定義哪些欄位應該自動同步處理Workfront和Jira之間連結的專案。 某些欄位可以從Workfront同步到Jira專案,而其他欄位則可以從Jira同步到Workfront。
若要定義應在兩個應用程式之間連結的專案上自動同步化的欄位:
-
以Jira管理員身分登入Jira。
-
在主 功能表中按一下 設定Jira。
-
按一下 附加元件,然後按一下 管理附加元件。
-
展開 Workfront 附加元件。
-
按一下 設定。
-
以Workfront管理員身分登入Workfront。
-
在Jira中,按一下 設定 標籤。
-
在 從Workfront同步到Jira 區段中,選取在Workfront中更新欄位時,您要在Jira中更新的欄位。
-
選取下列任何與欄位同步化的頻率:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header 建立時 在Workfront中建立專案時,您指定的欄位會在連結的Workfront和Jira專案之間同步。 Always 在Workfront中更新欄位時,您指定的欄位會在連結的Workfront和Jira專案之間同步。 從不 您指定的欄位永遠不會在連結的Workfront和Jira專案之間同步。 Jira中沒有表示欄位已在Workfront中更新。 -
選取下列任一項,同步處理從Workfront到Jira的欄位:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 名稱 Workfront中任務或問題的名稱會變成Jira中連結問題的名稱。
注意:在Jira中自動建立新專案時,Workfront名稱一律會在Jira專案上更新,無論此處是否啟用此欄位。 當Jira專案手動連結至Workfront專案時,當您選取Workfront一律同步Jira此欄位時,專案的名稱只會在 中更新。 如需手動或自動連結專案的詳細資訊,請參閱在Adobe Workfront和Jira之間連結專案。
說明 Workfront中任務或問題的描述會變成它在Jira中連結到的問題的描述。 文件 附加至Workfront中之任務或問題的檔案也會附加至Jira中連結的問題。 來自Workfront的新檔案版本會新增為個別檔案至Jira,並附加 _v<version number> 以表示Workfront中的編號版本。
例如,如果Workfront中檔案的名稱是 Main Ad,而您在Workfront中新增新版本,則新版本會以名稱為JiraMain Ad_v2 的新檔案形式傳輸至。
重要:
同步檔案時,請考量下列事項:
-
大於5MB的檔案不會同步。 如果檔案同步因為檔案太大而失敗,活動記錄中會記錄一個錯誤。
如需活動記錄檔的詳細資訊,請參閱檢視Jira活動記錄檔。
-
連結到外部伺服器之任務和問題的檔案未傳輸到Jira專案。 只有直接在任務上上傳的檔案或Workfront中的問題才會傳輸到Jira中的連結問題。
-
若要從檔案建立校訂,您必須在Workfront中產生校訂。
計畫完成日期 Workfront中任務或問題的規劃完成日期成為Jira中連結之問題的到期日。
注意:請確定您在 個問題上顯示 到期日Jira,以便同步處理此值。
-
-
-
在 從Jira同步至Workfront 區段中,選取在Workfront中更新欄位時,您要在Jira中更新的欄位。
-
選取下列任何與欄位同步化的頻率:
table 0-row-2 1-row-2 layout-auto html-authored no-header Always 在Workfront中更新欄位時,您指定的欄位一律會在連結的Jira和Jira專案之間同步。 從不 您指定的欄位永遠不會在連結的Workfront和Jira專案之間同步。 Workfront中沒有表示欄位已在Jira中更新。
注意:當您選取[永不]時,仍可以從Workfront問題左側Jira面板的Workfront手動更新Jira欄位。 這些更新只會顯示在Workfront和Jira中的Workfront個專案上,不會顯示在Jira個專案上。
-
選取以同步處理從Jira到Workfront的下列任何欄位:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 狀態 Jira中問題的狀態會變成Workfront中連結至的任務或問題的狀態。
如需Workfront狀態的詳細資訊,請參閱建立或編輯狀態。受託人 Jira中問題的受指派人會成為Workfront中連結至該問題或任務的受指派人。
重要:當您將Jira中的專案指派給沒有Workfront帳戶的使用者時,整合僅當Workfront使用者沒有 帳戶Workfront設定為JiraAlwaysWorkfront時, 在 中自動建立使用者時,才會在 中建立新的作用中使用者。 此使用者未佔用Workfront授權。 可將作用中的使用者指派給Workfront中的工作專案,但不能包含在更新中。
附件 Jira中問題的附件也附加至它在Workfront中連結的任務或問題。 註解 Jira問題的註解也會張貼在更新區域中連結的Workfront專案上。 相反地,針對Workfront任務或問題在更新區域張貼的註解,會同步至Jira的連結問題原生註解流。
預設會設為 一直。 如果您在這裡選取 Never,您仍可在Workfront或Jira中手動在連結專案上張貼註解。
-
-
在 OTHER 區段中,選取連結專案之間應更新的其他欄位。
-
選取選項,以決定您指定的欄位在修改時,是在 或 中的 一律 或Jira永不Workfront更新。
-
從下列欄位和更新中選取:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header [!UICONTROL複製Workfront中右側面板中的Jira自訂資料 顯示Workfront右側面板中專案的Workfront自訂資料。
注意:自訂表單區段會顯示在具有Workfront系統管理員存取層級的Workfront右側面板中。
[!UICONTROL複製Workfront中右側面板的Jira優先順序 顯示Workfront右側面板中專案的Workfront優先順序。 [!UICONTROL在「Workfront Updates」索引標籤中新增有關「Jira」中到期日變更的更新 當連結的Workfront專案中的到期日變更時,在Jira專案的Update索引標籤中新增註解。 如果Workfront使用者沒有Jira帳戶,則在Workfront中自動建立使用者 存在下列情況:
-
當您選取 Always 時,您啟用整合,以便在每次沒有Jira帳戶的Workfront使用者對連結的Jira問題執行下列動作時,建立新的Workfront使用者:
-
已指派給Jira問題
-
將時間記錄到Jira問題
此新使用者未佔用Workfront授權。 預設設定為「一律」。 在Workfront中以此方式建立的使用者已將「Jira」新增至其名稱。
-
-
當您選取 Never 時,會發生下列情況:
- 您無法在Jira個專案上看到任何Workfront指派。 在此情況下,只有在Workfront中完成的指派會顯示在Workfront個專案上。
- 沒有Jira帳戶的使用者登入已連結Workfront問題的時間不會自動傳輸至已連結的Workfront專案。 您仍然可以在Workfront問題的右側面板中的Jira專案上記錄時間。
-
-
-
按一下「儲存」。
現在,每當使用者更新此設定中在Jira或Workfront中專案上指定的任何欄位時,其他應用程式中的連結專案也會更新。
疑難排解
無法在Jira中建立專案,因為找不到標示為""的觸發欄位
問題
當Workfront for Jira應用程式發生錯誤時,Workfront會停用觸發程式以避免進一步的複雜性。 當這些觸發程式停用時,會顯示為"找不到"。
解決方案
找出停用觸發程式的錯誤。 您可以在Workfront for Jira 活動記錄中找到錯誤。
發生此行為的最常見原因是錯誤''無法設定'duedate'欄位。 不在適當的熒幕上,或未知。」
此錯誤表示您正嘗試將"規劃完成日期"從Workfront同步至Jira。 若要這麼做,您必須確定您的Jira物件有一個名為"到期日"的欄位。 如果他們沒有此欄位,Workfront將無法從Workfront同步計畫完成日期,並停用您的觸發器。
若要解決此錯誤,請嘗試下列方法之一:
- 請要求您的Jira管理員更新受影響的Jira物件,以確保它們有到期日欄位。
- 在Workfront Workfront安裝程式頁面中停用計畫完成日期的同步處理。