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 適用於工作自動化與整合

產品

目前產品需求:如果您有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 帳戶。

Connect Jira Software 至 Workfront Fusion

您的連線方法取決於您是否使用 Jira Cloud 或 Jira Server.

Connect Jira Cloud 至 Workfront Fusion

Connect Jira Cloud 至 Workfront Fusion

若要連線 Jira Software 至 Workfront Fusion,您必須建立API權杖,並將其與服務URL和使用者名稱一起插入 建立連線 中的欄位 Workfront Fusion.

在中建立API權杖 Jira

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

  2. 按一下 建立API權杖.

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

  4. 使用複製權杖 複製到剪貼簿 按鈕。

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

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

  5. 繼續使用 設定 Jira 中的API權杖 Workfront Fusion.

設定 Jira 中的API權杖 Workfront Fusion

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

  2. 指定下列資訊:

  3. 按一下 繼續 以建立連線並返回模組。

Connect 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. 繼續至 建立與的連線 Jira Server 或 Jira Data Center 在 Workfront Fusion

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

NOTE
使用 Jira Server 要連線的應用程式 Jira Server 或 Jira Data Center.
  1. 在任何 Jira Server 中的模組 Workfront Fusion,按一下 新增 旁邊 連線 欄位。
  2. 在 建立連線 填入下列欄位:
連線名稱
輸入連線的名稱
使用者金鑰
貼入您複製至中安全位置的消費者金鑰 將使用者端應用程式設定為中的消費者 Jira
Private Key
從貼入私密金鑰 jira_privatekey.pcks8 您在中建立的檔案 為您的產生公開和私密金鑰 Jira 連線.
Service URL
輸入您的 Jira 執行個體URL。
  1. 按一下 繼續 以建立連線並返回模組。

Jira Software 模組及其欄位

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

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

觸發器

留意記錄

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

Webhook

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

若要新增新的webhook:

  1. 按一下 新增

  2. 輸入webhook的名稱。

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

    如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。

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

    • 註解
    • 問題
    • 專案
    • Sprint

動作

新增問題至衝刺(sprint)

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
Sprint ID
輸入或對應您想要新增問題的衝刺(sprint)的Sprint ID。
問題ID或金鑰
針對您想要新增至衝刺的每個問題,新增問題ID或金鑰。

建立記錄

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

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

  • 附件
  • 註解
  • 問題
  • 專案
  • Sprint
  • 工作記錄檔

自訂API呼叫

此動作模組可讓您對 Jira Software API。 如此一來,您就可以建立其他人無法完成的資料流程自動化 Jira Software 模組。

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

td>

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
URL
輸入相對於<Instance URL>/rest/api/2/
方法
標頭

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

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

Workfront Fusion 為您新增授權標頭。

查詢字串

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

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

內文

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

備註:

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

刪除記錄

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

您指定記錄的ID。

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

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

下載附件

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
ID
輸入或對應您要下載之附件的ID。

讀取記錄

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

您指定記錄的ID。

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

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

更新記錄

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

您指定記錄的ID。

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

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

搜尋

清單記錄

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

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

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

搜尋記錄

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

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

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

連線
如需有關連線您的電腦的指示, Jira Software 帳戶至 Workfront Fusion,請參閱 Connect Jira Software 至 Workfront Fusion 本文章內容。
記錄型別

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

  • 問題

  • Issues by JQL (Jira查詢語言)

    如需JQL的詳細資訊,請參閱 JQL 在Atlassian說明網站。

  • 專案

  • [!UICONTROL專案(按問題)

  • 使用者

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