Jira Software模組

在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授權

新增:標準

目前:工作或以上

Adobe Workfront Fusion授權**

目前:無Workfront Fusion授權需求。

舊版:Workfront Fusion for Work Automation and Integration

產品

新增:

  • 選取或Prime Workfront套件:您的組織必須購買Adobe Workfront Fusion。
  • Ultimate Workfront套件:包含Workfront Fusion。

目前:您的組織必須購買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中的Create a connection欄位。

在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模組中,按一下connection欄位旁的​ Add

  2. 指定下列資訊:

    • 環境
    • 型別
    • Service URL: ​這是您用來存取Jira帳戶的基本URL。 範例: yourorganization.atlassian.net
    • Username
    • API token: ​這是您在本文章的 Jira🔗區段建立API權杖中建立的API權杖。
  3. 按一下Continue以建立連線並返回模組。

將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 Settings Jira設定圖示 > Applications> Application links

  3. 在​ Enter the URL of the application you want to link ​欄位中,輸入

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

  5. 在​ Link applications ​視窗的​ Consumer key ​與​ Shared secret ​欄位中輸入值。

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

  6. 將​ Consumer key ​和​ Shared secret ​欄位的值複製到安全位置。

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

  7. 請依照以下說明填寫URL欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    欄位 說明
    Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
    Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
    Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
  8. 選取​ Create incoming link ​核取方塊。

  9. 按一下​ Continue

  10. 在​ Link applications ​視窗中,填寫下列欄位:

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

  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模組中,按一下connection欄位旁的​ Add

  2. 在Create a connection面板中,填寫下列欄位:

    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
    Connection name 輸入連線的名稱
    Environment 選取您使用生產或非生產環境。
    Type 選取您是使用服務帳戶還是個人帳戶。
    Consumer Key 貼入您複製到中安全位置的消費者金鑰在Jira中將使用者端應用程式設定為消費者
    Private Key 從您在產生您連線Jira的公開和私密金鑰中建立的jira_privatekey.pcks8檔案貼上私密金鑰。
    Service URL 輸入您的Jira執行個體URL。 範例: yourorganization.atlassian.net
  3. 按一下​ Continue ​以建立連線,並返回模組。

Jira Software模組及其欄位

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

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

地圖切換

觸發程序

Watch for records

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

Webhook

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

若要新增webhook:

  1. 按一下 Add

  2. 輸入webhook的名稱。

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

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

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

    • Comment
    • Issue
    • Project
    • Sprint

動作

Add issue to sprint

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

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

Connection
如需有關將您的Jira Software帳戶連線到Workfront Fusion的說明,請參閱本文中的將Jira Software連線到Workfront Fusion
Sprint ID
輸入或對應您想要新增問題的衝刺(Sprint)的Sprint ID。
Issue ID or Keys
對於您想要檢視體驗的每個問題或金鑰,按一下「Add item」並輸入問題ID或金鑰。 在一個模組中最多可輸入50個。

Create a Record

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

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

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

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

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

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Custom API Call

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

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

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

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

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

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

Workfront Fusion 為您新增授權標頭。

Query String

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

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

Body

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

注意:

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

Delete a record

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

您指定記錄的ID。

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

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

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

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

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
輸入或對應您要刪除之記錄的ID或金鑰。

Download an attachment

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

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

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

Read a record

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

您指定記錄的ID。

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

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

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

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

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
選取您要接收的輸出。 根據"Record Type"欄位中選取的記錄型別,可使用輸出選項。
ID
輸入或對應您要模組讀取之記錄的唯一Jira Software識別碼。

Update a record

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

您指定記錄的ID。

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

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

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

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

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
輸入或對應您要更新之記錄的ID或金鑰,然後填寫專屬於該記錄型別的其他欄位,即會顯示在模組中。

搜尋

List records

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

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

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

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

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

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
輸入或對應您希望模組在每個案例執行週期中擷取的記錄數上限。

Search for records

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

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

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

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

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

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

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

  • Project

  • Project by issue

  • User

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