Jira Software模組

在Adobe Workfront Fusion案例中,您可以自動化使用Jira Software的工作流程,並將其連線至多個協力廠商應用程式和服務。

如果您需要有關建立案例的指示,請參閱在 Adobe Workfront Fusion中建立案例。

如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權

先決條件

若要使用Jira模組,您必須有Jira帳戶。

Jira API資訊

Jira聯結器使用下列專案:

Jira Cloud
Jira伺服器
apiVersion
2
2
apiVersionAgile
1.0
1.0
API標籤
1.7.29
1.0.19

將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權杖

  1. 前往https://id.atlassian.com/manage/api-tokens並登入。

  2. 按一下​ 建立API權杖

  3. 輸入權杖的名稱,例如​ Workfront Fusion

  4. 使用​ 複製到剪貼簿 ​按鈕複製Token。

    note important
    IMPORTANT
    關閉此對話方塊後,您無法再次檢視權杖。

    1. 將產生的Token儲存在安全的地方。

  5. 繼續在 Workfront Fusion中設定 Jira API Token。

在Workfront Fusion中設定Jira API權杖

  1. 在Workfront Fusion中,將Jira模組新增至情境以開啟​ 建立連線 ​方塊。

  2. 指定下列資訊:

    • 服務URL: ​這是您用來存取Jira帳戶的基本URL。 範例: yourorganization.atlassian.net
    • 使用者名稱
    • API Token: ​這是您在本文章的在 Jira區段中建立API Token所建立的API Token。
  3. 按一下繼續以建立連線並返回模組。

將Jira Server連線至Workfront Fusion

若要授權Workfront Fusion與Jira Server之間的連線,您需要您的消費者金鑰、私密金鑰和服務URL。 您可能需要連絡您的Jira管理員以取得此資訊。

為您的Jira連線產生公開和私密金鑰

若要取得您Workfront Fusion Jira連線的私密金鑰,您必須產生公開和私密金鑰。

  1. 在您的終端機中,執行下列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檔案:
      1. 在終端機中,執行以下命令:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. 複製終端機輸出(包括-------BEGIN PUBLIC KEY---------------END PUBLIC KEY--------

      3. 將終端機輸出貼到名為jira_publickey.pem的檔案中。

  2. 繼續將使用者端應用程式設定為 Jira中的消費者

在Jira中將使用者端應用程式設定為消費者

  1. 登入您的Jira執行個體。

  2. 在左側導覽面板中,按一下​ Jira設定 > 應用程式> 應用程式連結

  3. 在​ 輸入您要連結的應用程式URL ​欄位中,輸入

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. 按一下​ 建立新連結。 忽略「沒有從您輸入的URL收到回應」錯誤訊息。

  5. 在​ 連結應用程式 ​視窗中,在​ 消費者金鑰 ​與​ 共用機密 ​欄位中輸入值。

    您可以選擇這些欄位的值。

  6. 將​ 消費者金鑰 ​和​ 共用機密 ​欄位的值複製到安全位置。

    您稍後在設定過程中會需要這些值。

  7. 請依照以下說明填寫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
  8. 選取​ 建立連入連結 ​核取方塊。

  9. 按一下​ 繼續

  10. 在​ 連結應用程式 ​視窗中,填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    消費者金鑰 將您複製的消費者金鑰貼入安全位置。
    消費者名稱 輸入您選擇的名稱。 此名稱僅供您參考。
    公開金鑰 從您的jira_publickey.pem檔案貼入公開金鑰。
  11. 按一下​ 繼續

  12. 繼續在 Workfront Fusion中建立與 Jira Server 或 Jira Data Center 的連線

在Workfront Fusion中建立與Jira Server或Jira Data Center的連線

NOTE
使用Jira Server應用程式連線至Jira Server或Jira Data Center。
  1. 在Workfront Fusion的任何Jira Server模組中,按一下連線欄位旁的​ 新增

  2. 在建立連線面板中,填寫下列欄位:

    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
  3. 按一下​ 繼續 ​以建立連線並返回模組。

Jira Software模組及其欄位

當您設定Jira Software模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他Jira Software欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱在 Adobe Workfront Fusion中將資訊從一個模組對應到另一個模組。

觸發器

觀看記錄

此觸發模組會在新增、更新或刪除記錄時啟動案例。

Webhook

選取您要用來監視記錄的webhook。

若要新增webhook:

  1. 按一下 新增

  2. 輸入webhook的名稱。

  3. 選取您要用於webhook的連線。

    如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion

  4. 選取您要軟體監視的記錄型別:

    • 註解
    • 問題
    • 專案
    • Sprint

動作

新增問題至衝刺

此動作模組會將一或多個問題新增至衝刺。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
Sprint ID
輸入或對應您想要新增問題的衝刺(Sprint)的Sprint ID。
問題ID或金鑰
針對您想要新增至衝刺的每個問題,新增問題ID或金鑰。

建立記錄

此動作模組會在Jira中建立新記錄。

模組會傳回與記錄相關聯的任何標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
記錄型別

選取您要模組建立的記錄型別。 當您選取記錄型別時,該記錄型別專屬的其他欄位會出現在模組中。

  • 附件
  • 註解
  • 問題
  • 專案
  • Sprint
  • Worklog

自訂API呼叫

此動作模組可讓您對Jira Software API進行自訂的已驗證呼叫。 如此一來,您就可以建立其他Jira Software模組無法完成的資料流程自動化。

當您設定此模組時,會顯示下列欄位。

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
URL
輸入相對於<Instance URL>/rest/api/2/
方法
Headers

以標準JSON物件的形式新增請求的標頭。

例如, {"Content-type":"application/json"}

Workfront Fusion 為您新增授權標頭。

查詢字串

以標準JSON物件的形式新增API呼叫的查詢。

例如: {"name":"something-urgent"}

Body

以標準JSON物件的形式新增API呼叫的內文內容。

注意:

在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

刪除記錄

此動作模組會刪除特定記錄。

您指定記錄的ID。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion

記錄型別

選取您要模組刪除的記錄型別。

  • 附件
  • 註解
  • 問題
  • 專案
  • Sprint
ID或金鑰
輸入或對應您要刪除之記錄的ID或金鑰。

下載附件

此動作模組會下載特定附件。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
ID
輸入或對應您要下載之附件的ID。

讀取記錄

此動作模組從Jira Software中的單一記錄讀取資料。

您指定記錄的ID。

模組會傳回與記錄相關聯的任何標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
記錄型別

選取您希望模組讀取的Jira記錄型別。

  • 附件
  • 問題
  • 專案
  • Sprint
  • 使用者
輸出
選取您要接收的輸出。 根據「記錄型別」欄位中選取的記錄型別,可使用輸出選項。
ID
輸入或對應您要模組讀取之記錄的唯一Jira Software識別碼。

更新記錄

此動作模組會更新現有記錄,例如問題或專案。

您指定記錄的ID。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
記錄型別

選取您要模組更新的記錄型別。 當您選取記錄型別時,該記錄型別專屬的其他欄位會出現在模組中。

  • 註解
  • 問題
  • 專案
  • Sprint
  • 轉換問題
ID或金鑰
輸入或對應您要更新的記錄ID或金鑰。

搜尋

清單記錄

此搜尋模組會擷取符合您搜尋查詢的特定型別的所有專案

您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
記錄型別

選取您要模組列出的記錄型別。 當您選取記錄型別時,該記錄型別專屬的其他欄位會出現在模組中。

  • 註解
  • 問題
  • 專案
  • Sprint問題
  • Worklog
最大結果
輸入或對應您希望模組在每個案例執行週期中擷取的記錄數上限。

搜尋記錄

此搜尋模組會在Jira Software中尋找符合您指定之搜尋查詢的物件記錄。

您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
記錄型別

選取您要模組搜尋的記錄型別。 當您選取記錄型別時,該記錄型別專屬的其他欄位會出現在模組中。

  • 問題

  • Issues by JQL (Jira查詢語言)

    如需有關JQL的詳細資訊,請參閱Atlassian說明網站上的JQL

  • 專案

  • [!UICONTROL專案(按問題)

  • 使用者

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43