Jira Software 模組

NOTE
這些指示適用於舊版Jira Cloud和Jira伺服器聯結器。 如需新版Jira聯結器(僅標籤為Jira)的說明,請參閱Jira模組

在 Adobe Workfront Fusion 情境中,您可以將使用 Jira Software 的工作流程自動化,以及將其連接至多個第三方應用程式和服務。

這些指示適用於Jira Cloud和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 授權

標準

工作或更高層級

Adobe Workfront Fusion 授權

作業型:無 Workfront Fusion 授權要求

連接器型 (舊版):Workfront Fusion for Work Automation and Integration

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。

若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。

關於 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. 在Jira中建立API權杖。

    如需指示,我們建議您在Jira檔案中搜尋「建立API權杖」。

  2. 建立權杖後,將權杖複製到安全位置。

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

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

  3. 繼續進行在Workfront Fusion Jira 中設定API Token。

在Workfront Fusion中設定Jira API權杖

  1. 在Workfront Fusion的任何Jira Cloud模組中,按一下​ 連線 ​欄位旁的新增。

  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設定 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 4-row-2 5-row-2 layout-auto html-authored no-header
    連線名稱 輸入此連線的名稱。
    環境 選取您使用生產或非生產環境。
    類型 選取您是使用服務帳戶還是個人帳戶。
    消費者金鑰 貼入您複製到中安全位置的消費者金鑰在Jira中將使用者端應用程式設定為消費者
    Private Key 從您在jira_privatekey.pcks8產生您連線的公開和私密金鑰Jira中建立的檔案貼上私密金鑰。
    Service URL 輸入您的Jira執行個體URL。 範例: yourorganization.atlassian.net
  3. 按一下「繼續」來建立連線並返回模組。

Jira Software 模組及其欄位

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

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

對應切換

觸發程序

觀看記錄

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

Webhook

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

若要新增webhook:

  1. 按一下新增

  2. 輸入webhook的名稱。

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

    關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion

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

    • 註解
    • 問題
    • 專案
    • Sprint

動作

新增問題至衝刺

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
Sprint ID
輸入或對應您想要新增問題的衝刺(Sprint)的Sprint ID。
問題ID或金鑰
對於您想要檢視體驗的每個問題或金鑰,請按一下 新增專案 並輸入問題ID或金鑰。 在一個模組中最多可輸入50個。

建立記錄

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

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

選取您要模組建立的記錄型別,然後填寫專屬於該記錄型別的其他欄位,顯示在模組中。

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

自訂 API 呼叫

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

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
URL
輸入相對於<Instance URL>/rest/api/2/
方法
標頭

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

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

Workfront Fusion會為您新增授權標頭。

查詢字串

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

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

正文

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

注意:

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

刪除記錄

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

您指定記錄的 ID。

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

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

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

下載附件

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
ID
輸入或對應您要下載之附件的ID。

讀取記錄

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

您指定記錄的 ID。

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

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

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

更新記錄

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

您指定記錄的 ID。

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

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

  • 註解
  • 問題
  • 專案
  • Sprint
  • 轉換問題
ID或金鑰
輸入或對應您要更新之記錄的ID或金鑰,然後填寫專屬於該記錄型別的其他欄位,即會顯示在模組中。

搜尋

IMPORTANT
舊版Jira聯結器使用的搜尋模組可能會導致以下錯誤:
[410] The requested API has been removed. Please migrate to the /rest/api/3/search/jql API. A full migration guideline is available at https://developer.atlassian.com/changelog/#CHANGE-2046
這是因為Jira端已棄用。
如果您遇到此錯誤,您可以使用新聯結器的搜尋模組來取代舊版Jira聯結器的搜尋模組。 請注意,新的聯結器可讓您選取使用的API版本。 建立連線時,請務必選取V3。
新Jira聯結器中的 API版本選項
請注意:
  • 只有搜尋模組會受到影響。 目前,Fusion聯結器使用的其他Jira API端點不會受到此淘汰的影響。

  • 地理轉出可能會導致不一致。 Atlassian正在地區範圍內推出這項變更,這表示有些Jira Cloud執行個體可能仍會暫時支援較舊的端點。 這可能會導致環境間的行為不一致。

清單記錄

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

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

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

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

搜尋記錄

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

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

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

連線
關於將您的 Jira Software 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 Jira Software 連接至 Workfront Fusion
記錄類型

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

  • 問題

  • Issues by JQL (Jira查詢語言)

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

  • 專案

  • [!UICONTROL專案(按問題)

  • 使用者

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3