Azure DevOps 模組
在 Adobe Workfront Fusion 情境中，您可以將使用 Azure DevOps 的工作流程自動化，以及將其連接至多個第三方應用程式和服務。
關於建立情境的說明，請參閱建立情境：文章索引之下的文章。
關於模組的資訊，請參閱模組：文章索引之下的文章。
存取權要求
| 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 for Work Automation and Integration |
| 產品 | 如果您的組織擁有 Select 或 Prime Workfront 封裝，但不包括 Workfront Automation and Integration，則您的組織必須購買 Adobe Workfront Fusion。 |
若要詳細了解此表格中的資訊，請參閱🔗文件中的存取權要求。
關於 Adobe Workfront Fusion 授權的資訊，請參閱 Adobe Workfront Fusion 授權。
先決條件
若要使用Azure DevOps模組，您必須有Azure DevOps帳戶。
Azure DevOps API資訊
Azure DevOps聯結器使用下列專案：
將 Azure DevOps 連接至 Workfront Fusion connect-azure-devops-to-workfront-fusion
使用EntraApp將Azure DevOps連線至Workfront Fusion
-
將Azure DevOps模組新增至您的情境。
-
按一下連線欄位旁的新增。
-
在連線型別欄位中，選取您要使用的連線型別。
note NOTE Azure DevOps (EntraApp)可讓您要求連線的所有領域。 -
填寫下列欄位：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 連線名稱 輸入您正在建立的連線名稱。 組織 輸入您建立Azure DevOps應用程式的組織名稱。 應用程式ID 輸入您要連線的DevOps應用程式ID。 用戶端密碼 輸入您要連線之DevOps應用程式的使用者端密碼。 要求所有範圍 如果您使用Azure DevOps (EntraApp)連線型別，請啟用此選項以要求連線的所有範圍。 -
若要輸入Azure DevOps應用程式ID或使用者端密碼，請按一下[顯示進階設定] ，然後在開啟的欄位中輸入這些設定。
. 按一下 繼續 完成連線的設定並繼續建立您的情境。
*### 使用服務主體將Azure DevOps連線至Workfront Fusion您可以建立使用服務主體（應用程式API連線）而不是個人帳戶的連線。 如果您希望連線以應用程式或服務身分而非特定人員的身分執行，這會很有用。 這可能會很有用，舉例來說，若某人離開公司或變更密碼，整合就不會中斷。此連線型別適用於所有Azure DevOps模組。 NOTE服務主體驗證不支援所有Azure DevOps功能。 少數管理員層級的動作（例如管理使用者授權）仍需要個人帳戶連線。 如果您只需要工作專案、面板、存放庫或管道的驗證，請使用服務主體驗證。 使用服務主體將Azure DevOps連線至Workfront Fusion的先決條件
- 在Microsoft Entra ID中建立應用程式註冊
- 建立使用者端密碼
- 收集您的連線詳細資料
- 將服務主體新增至您的Azure DevOps組織
- 建立連線#### 使用服務主體將Azure DevOps連線至Workfront Fusion的先決條件若要建立此連線，您需要下列專案：* 在Microsoft Entra ID中 全域管理員 或 應用程式管理員 存取權，以註冊應用程式。 如果您沒有此存取權，請要求您IT或身分團隊中的某人為您完成該步驟。
- 在您的Azure DevOps組織中 專案集合管理員 存取權，以將服務主體新增為成員。 管理Microsoft Entra ID的人通常不是這個人。
- Azure DevOps組織的名稱。 您可以在Azure DevOps URL中找到此專案：
dev.azure.com/<your organization name>。#### 在Microsoft Entra ID中建立應用程式註冊1) 登入Microsoft Entra系統管理中心。
-
移至應用程式註冊 > 新註冊。
-
為應用程式提供一個清晰且可辨識的名稱。 例如
Workfront Fusion Azure DevOps Integration。 -
將 重新導向URI 保留空白。 此連線不涉及透過瀏覽器登入。
-
選取註冊。
-
繼續建立使用者端密碼。#### 建立使用者端密碼1) 在您的新應用程式註冊中，移至憑證與密碼。
-
選取新增使用者端密碼、新增說明，並選擇到期期間。
-
選取新增。
-
立即複製密碼的值。 它只會顯示一次。 如果您在複製它之前瀏覽離開，則必須建立一個新的專案。
-
繼續收集您的連線詳細資料。#### 收集您的連線詳細資料1) 從應用程式註冊的 總覽 頁面，請注意下列值。 在模組中建立連線時，請輸入這些連線。
租使用者ID
在概觀頁面上，標示為目錄（租使用者） ID。
用戶端 ID
在概觀頁面上，標示為應用程式（使用者端） ID。
用戶端密碼
組織
您的Azure DevOps組織名稱。 例如，若您的URL為
dev.azure.com/yourorg，請輸入yourorg。NOTE
您可以略過應用程式註冊的 API許可權 區域。 如果您在那裡新增Azure DevOps，則只有 委派許可權 可用。 應用程式許可權顯示為灰色。 這是預期中的情形，因為Azure DevOps不支援以這種方式授與存取權。 取而代之的是，存取權會在下一部分直接在Azure DevOps中授予。
-
繼續將服務主體新增至您的Azure DevOps組織。#### 將服務主體新增至您的Azure DevOps組織在Microsoft Entra ID中註冊應用程式只會建立其身分識別。 應用程式尚未取得您Azure DevOps資料的任何存取權。 此程式會授予該存取權。1) 在
dev.azure.com/<your organization name>登入您的Azure DevOps組織。 -
選取左下方的組織設定，然後選取使用者。
-
選取新增使用者。
-
在搜尋方塊中，依應用程式的顯示名稱（您在註冊應用程式時提供的名稱）進行搜尋。 請勿依據使用者端ID進行搜尋。
-
選取存取層級：
- Basic通常足以讀取和寫入工作專案、展示板和存放庫。
- 如果您的工作流程需要在設定過程中瀏覽可用的程式，例如，敏捷、Scrum或自訂範本，請改為將服務主體新增到 專案集合管理員 群組。 這是更廣的存取層級，因此僅在您需要該功能時授與它。
-
按照您組織的一般存取實務，將服務主體指派給所需的特定專案。
-
選取新增。
-
繼續建立連線。#### 建立連線1) 在模組的連線設定畫面中，選取 服務主體 連線型別。
-
輸入下列：
- 租使用者識別碼
- 使用者端識別碼
- 使用者端密碼
- 組織
-
儲存連線。
如果一切設定正確，連線都會成功驗證。## Azure DevOps模組及其欄位當您設定 Azure DevOps 模組時，Workfront Fusion 會顯示下列欄位。 除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Azure DevOps 欄位。 在模組中，粗體標題表示那是必要欄位。若在欄位或函式上方看到對應按鈕，可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊，請參閱將資訊從一個模組對應到另一個模組。
-
搜尋### 觸發程序#### 觀看工作專案此即時觸發模組會在Azure DevOps中新增、更新或刪除記錄時執行案例。模組會傳回與記錄相關聯的任何標準欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。當您設定此模組時，會顯示下列欄位。Webhook選取或新增模組的webhook。如需有關觸發程式模組中webhook的詳細資訊，請參閱即時觸發程式(webhook)。如需如何建立Webhook的詳細資訊，請參閱Webhook。### 動作* 建立記錄
-
上傳附件#### 建立記錄此動作模組會建立新專案或工作專案。模組會輸出新建立工作專案的物件ID，或新建立專案的URL和狀態代碼。連線如需有關將您的Azure DevOps帳戶連線到Workfront Fusion的說明，請參閱本文中的將Azure DevOps連線到Workfront Fusion。記錄類型選取您要建立工作專案或專案。* 專案
填寫下列欄位：
-
名稱：輸入或對應新專案的名稱。
-
描述：輸入或對應新專案的描述。
-
可見性：選取您要將專案設為公開或私人。 使用者必須登入您的組織，且必須已被授予專案的存取權，才能與私人專案互動。 未登入您組織的使用者可看見公用專案。
-
版本控制：選取您要專案使用Git或Team Foundation版本控制(TFCV)進行版本控制。
-
工作專案程式：選取您要用於專案的工作程式。 選項為Basic、Scrum、Capability Maturity Model Integration (CMMI)及Agile。
如需Azure DevOps流程的詳細資訊，請參閱Azure DevOps檔案中的預設流程與流程範本。
-
-
工作專案
填寫下列欄位：
-
專案：選取您要建立工作專案的專案。
-
工作專案型別：選取您要建立的工作專案型別。
-
其他欄位：在這些欄位中，輸入您想要工作專案對於指定屬性具有的值。 可用欄位取決於工作專案型別。#### 自訂 API 呼叫您可以利用此動作模組，對 Azure DevOps API 進行已驗證的自訂呼叫。 如此一來，您就可以建立其他 Azure DevOps 模組無法完成的資料流程自動化。當您設定此模組時，會顯示下列欄位。連線如需有關將您的Azure DevOps帳戶連線到Workfront Fusion的說明，請參閱本文中的將Azure DevOps連線到Workfront Fusion。基底URL選取或對應您用來連線至Azure DevOps帳戶的基本URL相對URL輸入此API呼叫要連線的相對URL。範例：
{organization}/_apis[/{area}]/{resource}API 版本選取或對應您要連線至此API呼叫的Azure DevOps API版本。 如果未選取版本，Workfront Fusion會連線至Azure DevOps API 5.1版。方法選取您設定 API 呼叫所需的 HTTP 要求方法。 如需詳細資訊，請參閱 HTTP 要求方法。標頭以標準 JSON 物件的形式新增要求標頭。例如，{"Content-type":"application/json"}查詢字串以標準 JSON 物件的形式新增 API 呼叫的查詢。例如：{"name":"something-urgent"}正文以標準 JSON 物件的形式新增 API 呼叫的正文內容。注意：在 JSON 中使用條件陳述式 (例如if) 時，請將引號放在條件陳述式的外面。
-
-
工作專案：選取包含您要讀取之工作專案的專案，然後選取工作專案型別。輸出選取要包含在此模組的輸出組合包中的資訊。 可用欄位取決於工作專案型別。ID輸入或對應您要讀取之記錄的ID。#### 更新工作專案此動作模組使用其ID更新現有工作專案。模組會傳回已更新工作專案的識別碼。連線如需有關將您的Azure DevOps帳戶連線到Workfront Fusion的說明，請參閱本文中的將Azure DevOps連線到Workfront Fusion。專案選取包含您要更新之工作專案的專案。工作專案型別選取您要更新的工作專案型別。其他欄位在每個欄位中，輸入您想要工作專案對於指定屬性具有的值。 可用欄位取決於工作專案型別。工作專案ID輸入或對應您要更新的工作專案ID。#### 上傳附件此動作模組會上傳檔案並將其附加至工作專案。模組會傳回附件的附件ID和下載URL。連線如需有關將您的Azure DevOps帳戶連線到Workfront Fusion的說明，請參閱本文中的將Azure DevOps連線到Workfront Fusion。專案選取您要上傳附件的專案。工作專案ID輸入或對應您要上傳附件之工作專案的ID。註解輸入要新增至已上傳附件的註解文字。來源檔案從先前的模組中選取來源檔案，或輸入或對應來源檔案的名稱和內容。### 搜尋#### 列出工作專案此動作模組會擷取Azure DevOps專案中所有特定型別的工作專案。模組會傳回主要工作專案的ID及任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。當您設定此模組時，會顯示下列欄位。連線如需有關將您的Azure DevOps帳戶連線到Workfront Fusion的說明，請參閱本文中的將Azure DevOps連線到Workfront Fusion。專案選取您要從中擷取工作專案的專案。工作專案型別選取您要擷取的工作專案型別。輸出選取您要顯示在模組輸出中的屬性。 可用欄位取決於您要擷取的工作專案型別。 您必須至少選取一個屬性。限制輸入或對映Workfront Fusion在一個執行週期內傳回的最大工作專案數。**