Azure DevOps

Azure DevOps 連接器可讓您對 Azure DevOps 資料執行插入、刪除、更新和讀取作業。

支援的版本

這個連接器支援下列 Azure DevOps 版本。

Azure DevOps 2022、2020、2019
Team Foundation Server 2018

事前準備

在 Google Cloud 專案中，執行下列工作：

確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
將 roles/connectors.admin IAM 角色授予設定連結器的使用者。
將 roles/secretmanager.viewer 和 roles/secretmanager.secretAccessor IAM 角色授予要用於連接器的服務帳戶。
啟用下列服務：
- secretmanager.googleapis.com (Secret Manager API)
- connectors.googleapis.com (Connectors API)
如要瞭解如何啟用服務，請參閱「啟用服務」。如果先前未啟用這些服務或權限，系統會在您設定連結器時提示啟用。

設定連接器

連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連結，請按照下列步驟操作：

在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。
前往「Connections」(連線) 頁面
按一下「+ 建立新項目」，開啟「建立連線」頁面。
在「位置」部分中，選擇連線的位置。
1. 區域：從下拉式清單中選取位置。
  如需所有支援區域的清單，請參閱「地點」一文。
2. 點按「下一步」。
在「連線詳細資料」部分，完成下列步驟：
1. 連接器：從可用連接器的下拉式清單中選取「Azure DevOps」。
2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。
  連線名稱必須符合下列條件：
  - 連線名稱可使用英文字母、數字或連字號。
  - 字母必須為小寫。
  - 連線名稱開頭必須是英文字母，結尾則須為英文字母或數字。
  - 連結名稱不得超過 49 個字元。
4. 視需要輸入連線執行個體的「Description」(說明)。
5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
6. 服務帳戶：選取具備必要角色的服務帳戶。
7. 視需要設定「連線節點設定」：
  - 節點數量下限：輸入連線節點數量下限。
  - 節點數量上限：輸入連線節點數量上限。
  節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連接器定價的影響，請參閱「連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。
8. Azure 租戶：提供 Azure DevOps 租戶的名稱或 ID。
9. 機構：提供使用 Azure DevOps 的機構或集合名稱。
10. 結構定義：輸入結構定義，例如資訊、專案。
11. 目錄：輸入目錄名稱。
12. 套用轉換：輸入以半形逗號分隔的轉換清單。
13. Azure DevOps 版本：輸入 Azure DevOps 版本。
14. Azure DevOps Service API：輸入 Azure DevOps 的 REST API 版本。
15. 網址：提供 Azure DevOps 執行個體的網址。
16. 包含自訂欄位：選取這個選項，即可在欄位清單中加入自訂欄位。
17. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
18. 點按「下一步」。
在「目的地」部分，輸入要連線的遠端主機 (後端系統) 詳細資料。
1. 目的地類型：選取目的地類型。
  - 如要指定目的地主機名稱或 IP 位址，請選取「主機位址」，然後在「主機 1」欄位中輸入位址。
  - 如要建立私人連線，請選取「主機位址」，並使用 HTTPS 通訊協定新增為 SAP Gateway 建立的端點附件。
  如要建立與後端系統的公開連線，並加強安全性，可以為連線設定靜態輸出 IP 位址，然後設定防火牆規則，只允許特定靜態 IP 位址。
  
  如要輸入其他目的地，請按一下「+新增目的地」。
2. 點按「下一步」。
在「Authentication」部分，輸入驗證詳細資料。
1. 選取「驗證類型」，然後輸入相關詳細資料。
  Azure DevOps 連線支援下列驗證類型：
  - AzureAD
  - 基本
2. 點按「下一步」。
檢查：檢查連結和驗證詳細資料。
點選「建立」。

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

AzureAD
- 「ClientID」(用戶端 ID)ClientID：輸入您所建立應用程式的用戶端 ID。
- 範圍：以半形逗號分隔指定所有範圍，例如 read、write。
- 用戶端密鑰：輸入 Secret Manager 密鑰，內含您建立的連結應用程式用戶端密鑰。
- 密鑰版本：選取上述所選密鑰的密鑰版本。
- 授權網址：提供用戶端的授權網址。

基本版
- 個人存取權杖：輸入產生的個人存取權杖。
- 密鑰版本：選取所輸入密鑰的密鑰版本。

連線設定範例

本節列出您在建立連線時設定的各個欄位範例值。

在 Azure DevOps 中，各種資料結構定義可用於整理及管理專案的不同面向。每個結構定義都著重於特定類型的資料，可根據專案需求有效建構資訊。

專案資料模型：定義專案相關資料 (例如項目、存放區、管道和團隊) 在 Azure DevOps 中的組織、連結和管理方式的結構定義。
資訊資料模型：定義文件、中繼資料和通訊構件在 Azure DevOps 專案中的結構、儲存和存取方式的結構定義。
存放區資料模型：定義如何在 Azure DevOps 中整理及管理程式碼存放區、分支、提交、提取要求和相關中繼資料的結構定義。
數據分析資料模型：可擷取及整理 Azure DevOps 歷史和即時資料的結構定義，用於報表、資訊主頁和進階數據分析。
所有資料模型：單一連線，可存取單一連線中的所有資料模型。

欄位名稱	資訊模型	專案模型	存放區模型	Analytics 模型	所有模型	AzureAD 連線
位置	europe-west1	europe-west1	europe-west1	europe-west1	asia-east1	europe-west1
連接器	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps
連接器版本	1	1	1	1	1	1
連線名稱	azuredevops-informationmodel	azuredevops-projectmodel	azuredevops-repositorymodel	azuredevops-analyticsmodel	DevOps	azuredevops-oauth
啟用 Cloud Logging	是	是	是	是	是	是
記錄檔層級	偵錯	偵錯	偵錯	偵錯	偵錯	偵錯
服務帳戶	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount
Azure 租戶	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id
機構	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name
結構定義	資訊	專案	Repository__RepositoryId	數據分析		專案
目錄	Devops	Project_ProjectId	Project_ProjectId	Project_ProjectId		Project_ProjectId
Azure DevOps 版本	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online
Azure Dev Ops Service API	6.0	6.0	6.0	6.0	6.0	6.0
加入自訂欄位	是	是	是	是	是	是
CustomizedDefaultCatalogName	CustomizedDefaultCatalogName=Google				CustomizedDefaultCatalogName=Google
節點數量下限	2	2	2	2	2	2
節點數量上限	50	50	50	50	50	50
驗證	是	是	是	是	是	是
基本	是	是	是	是	是
API 權杖	應用程式提供的 API 權杖	應用程式提供的 API 權杖	應用程式提供的 API 權杖	應用程式提供的 API 權杖	應用程式提供的 API 權杖
密鑰版本	1	1	1	1	1	1
AzureAD						是
用戶端 ID						Client_Id
用戶端密鑰值						用戶端密鑰值
範圍						user_impersonation
授權網址						https://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

您可以使用下列連線屬性，管理從 Azure DevOps 擷取的資料。

這項屬性會指定您要連線的專案名稱或 ID。如要取得專案 ID 和名稱清單，請對 Projects 資料表執行 SELECT 查詢。

如要查詢特定專案的資料，請將「目錄」設為專案名稱或 ID，格式為 Project_projectname。
如果專案名稱為 dev，ID 為 2ee729d6-804d-4ece-84af-d5befa94abe8，請將「目錄」設為 Project_dev 或 Project_2ee729d6-804d-4ece-84af-d5befa94abe8。
如要查詢與特定專案無關的資料，請將「目錄」設為「Devops」。 如果目錄名稱為「Devops」，您可以將「Devops」替換為任何名稱。

結構定義

這項屬性會指定要使用的結構定義，可用結構定義取決於指定的存放區。如要取得存放區 ID 和名稱清單，請對「Repositories」(存放區) 資料表執行 SELECT 查詢。

如果在連線設定中將「目錄」和「結構定義」設為 INFORMATION，您就只能存取資訊資料模型結構定義。其他專案目錄或結構定義不會公開。
如果「目錄」設為專案目錄，則「結構定義」可以設為 Analytics、Project 或其中一個存放區結構定義。選取適當的結構後，即可查詢特定存放區中的資料。
如要查詢 ID 為 3ee729d6-804d-4ece-84af-d5befa94abe8 的存放區資料，請將「目錄」設為 Repository_3ee729d6-804d-4ece-84af-d5befa94abe8。

如要在 Azure 入口網站/MS Entra 建立應用程式，並在 Azure AD 連線層級使用所建應用程式的所有參數，請參閱「快速入門：向 Microsoft 身分識別平台註冊應用程式」和「在 Microsoft Entra ID 中註冊用戶端應用程式」。

系統限制

Azure DevOps 連接器每秒最多可處理 6 筆交易 (每個節點)，超過此限制的交易都會遭到節流。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

在整合中，使用 Azure DevOps 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

如要瞭解如何在 Apigee Integration 中建立及使用連接器工作，請參閱「連接器工作」。
如要瞭解如何在 Application Integration 中建立及使用連接器工作，請參閱「連接器工作」。

動作

本節列出連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

CreateWorkItem 動作

這項動作會建立工作項目。

CreateWorkItem 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
類型	字串	是	要建立的工作項目類型。
寄件者	字串	否	複製或移動作業的來源路徑。
Op	字串	是	修改工作項目的修補作業，例如新增、複製、移動、移除、取代或測試。
路徑	字串	是	作業的路徑。
值	字串	是	作業的值。

如要瞭解如何設定 CreateWorkItem 動作，請參閱範例。

UpdateWorkItem 動作

UpdateWorkItem 動作的輸入參數

這項動作會更新工作項目。

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
WorkItemId	字串	是	工作項目的 ID。
寄件者	字串	否	複製或移動作業的來源路徑。
Op	字串	是	修改工作項目的修補作業，例如新增、複製、移動、移除、取代或測試。
路徑	字串	是	作業的路徑。
值	字串	是	作業的值。

如要瞭解如何設定 UpdateWorkItem 動作，請參閱範例。

GetPullRequestCommits 動作

這項動作會取得指定提取要求的提交內容。

GetPullRequestCommits 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID 或名稱。如果未設定 ProjectId，則必須設定 RepositoryId。
PullRequestId	字串	是	提取要求的 ID。

GetPullRequestCommits 動作的輸出參數

如要瞭解如何設定 GetPullRequestCommits 動作，請參閱範例。

PushChanges 動作

這項操作會將變更推送至 Azure DevOps 執行個體中的存放區。

PushChanges 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID 或名稱。如果未設定 ProjectId，則必須設定 RepositoryId。
BranchRefName	字串	是	Git 分支名稱。
OldObjectId	字串	是	分店目前的物件 ID。
CommitComment	字串	是	指定要納入提交的註解。
ChangesAggregate	字串	是	匯總物件，內含提交中每項變更的詳細資料。

如要瞭解如何設定 PushChanges 動作，請參閱範例。

DownloadReleaseLogs 動作

這項操作會下載特定版本的記錄。

DownloadReleaseLogs 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
ReleaseId	整數	是	發行內容的 ID。
FileLocation	字串	否	檔案位置。
編碼	字串	否	FileData 輸入編碼類型。允許的值為 NONE 和 BASE64。預設值為 BASE64。
FileStream	字串	否	輸出串流的例項，用於寫入檔案資料。只有在未提供 FileLocation 時才會使用。

如要瞭解如何設定 DownloadReleaseLogs 動作，請參閱範例。

DownloadTestAttachment 動作

這項操作會下載測試結果/執行作業附件。

DownloadTestAttachment 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
ResultId	整數	否	測試結果的 ID。
RunId	整數	是	測試執行的 ID。
AttachmentId	字串	否	附件的 ID。
FileLocation	字串	否	檔案位置。
編碼	字串	否	FileData 輸入編碼類型。允許的值為 NONE 和 BASE64。預設值為 BASE64。
FileStream	字串	否	檔案資料寫入的輸出串流例項。只有在未提供 FileLocation 時才會使用。

如要瞭解如何設定 DownloadTestAttachment 動作，請參閱範例。

SetProjectProperties 動作

這個動作可建立、更新及刪除團隊專案屬性。

SetProjectProperties 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
寄件者	字串	否	移動或複製作業的來源路徑。
Op	字串	是	修改專案屬性的修補作業，例如新增、複製、移動、移除、取代或測試。
路徑	字串	是	作業的路徑。
值	字串	是	作業的值。

如要瞭解如何設定 SetProjectProperties 動作，請參閱範例。

DeleteTestCase 動作

這項操作會刪除測試案例。

DeleteTestCase 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
TestcaseId	整數	是	測試案例的 ID。

如要瞭解如何設定 DeleteTestCase 動作，請參閱範例。

RunPipeline 動作

這項動作會使用指定的設定執行管道。

RunPipeline 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
PipelineId	整數	是	管道的 ID。
PipelineVersion	整數	否	要執行的管道版本。
資源	字串	是	執行作業所需的資源。
變數	字串	否	管道執行期間使用的變數和值清單。
StagesToSkip	字串	否	要略過的階段名稱陣列。
TemplateParameters	字串	否	管道執行期間使用的參數鍵/值對應。

如要瞭解如何設定 RunPipeline 動作，請參閱範例。

CreatePullRequest 動作

這項動作會使用指定的設定建立提取要求。

CreatePullRequest 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID。
標題	字串	是	提取要求的標題。
說明	字串	否	提取要求的說明。
SourceRefName	字串	是	提取要求的來源分支名稱。
TargetRefName	字串	是	提取要求的目標分支名稱。
CompletionOptions	字串	否	這些選項會影響提取要求完成時的合併方式。
IsDraft	布林值	否	草稿 / WIP 提取要求。
標籤	字串	否	與提取要求相關聯的標籤。
MergeOptions	字串	否	執行提取要求合併時使用的選項。
Reviewers	字串	否	提取要求審查員清單。
WorkItemRefs	字串	否	與這項提取要求相關聯的任何工作項目參照。

如要瞭解如何設定 CreatePullRequest 動作，請參閱範例。

UpdatePullRequest 動作

這項動作會使用指定的設定更新提取要求。

UpdatePullRequest 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID。
PullRequestId	字串	是	提取要求的 ID。
標題	字串	否	提取要求的標題。
說明	字串	否	提取要求的說明。
狀態	字串	否	提取要求的狀態。
TargetRefName	字串	否	提取要求的目標分支名稱。只有在啟用 PR 重新指定目標功能時才可使用。
CompletionOptions	字串	否	這些選項會影響提取要求完成時的合併方式。
MergeOptions	字串	否	執行提取要求合併時使用的選項。
AutoCompleteSetById	字串	否	啟用自動完成功能的使用者 ID。

如要瞭解如何設定 UpdatePullRequest 動作，請參閱範例。

GetPullRequestCommits 動作

這項動作會取得指定提取要求的提交內容，並採用指定設定。

GetPullRequestCommits 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID。
PullRequestId	字串	是	提取要求的 ID。

如要瞭解如何設定 GetPullRequestCommits 動作，請參閱範例。

AddBuildTag 動作

這項動作會將標記新增至建構版本。

AddBuildTag 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
BuildId	字串	是	建構版本的 ID。
標記	字串	是	要新增至建構版本的標記。

如要瞭解如何設定 AddBuildTag 動作，請參閱範例。

DeleteBuildTag 動作

這項操作會從建構作業中刪除標記。

DeleteBuildTag 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
BuildId	字串	是	建構版本的 ID。
標記	字串	是	要從建構版本中移除的標記。

如要瞭解如何設定 DeleteBuildTag 動作，請參閱範例。

DownloadBuildReports 動作

這項操作會下載建構報表。

DownloadBuildReports 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
BuildId	整數	是	建構版本的 ID。
FileLocation	字串	否	檔案位置。
編碼	字串	否	FileData 輸入編碼類型。允許的值為 NONE 和 BASE64。預設值為 BASE64。
FileStream	字串	否	檔案資料寫入的輸出串流例項。只有在未提供 FileLocation 時才會使用。

如要瞭解如何設定 DownloadBuildReports 動作，請參閱範例。

DownloadBuildLogs 動作

這項操作會下載建構記錄。

DownloadBuildLogs 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	是	Azure DevOps 專案的 ID。
BuildId	整數	是	建構的 ID。
LogId	整數	是	記錄的 ID。
StartLine	整數	否	建構的起始行。
EndLine	整數	否	建構的結尾行。
FileLocation	字串	否	檔案位置。
編碼	字串	否	FileData 輸入編碼類型。允許的值為 NONE 和 BASE64。預設值為 BASE64。
FileStream	字串	否	檔案資料寫入的輸出串流例項。只有在未提供 FileLocation 時才會使用。

如要瞭解如何設定 DownloadBuildLogs 動作，請參閱範例。

UpdateUser 動作

這項操作會更新使用者詳細資料。

UpdateUser 動作的輸入參數

參數名稱	資料類型	必填	說明
UserId	字串	是	使用者 ID。
寄件者	字串	否	移動或複製作業的來源路徑。
Op	字串	是	修改使用者的修補作業，例如新增、複製、移動、移除、取代或測試。
路徑	字串	否	作業的路徑。
值	字串	否	作業的值。

如要瞭解如何設定 UpdateUser 動作，請參閱範例。

CloneTestPlan 動作

這項操作會複製測試計畫。

CloneTestPlan 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	否	Azure DevOps 專案的 ID。
DeepClone	布林值	否	並複製所有相關聯的測試案例。
CloneRequirements	布林值	否	如果設為 true，系統會複製需求。預設值為 false。
CopyAllSuites	布林值	否	從來源方案複製所有套件。
CopyAncestorHierarchy	布林值	否	複製祖先階層。
DestinationWorkItemType	字串	否	複製項目的工作項目類型名稱。
OverrideParameters	字串	否	鍵/值組合，其中每個鍵的值都會遭到指定值覆寫。
RelatedLinkComment	字串	否	在複製的測試計畫中新增註解。
DestinationPlanAreaPath	字串	否	測試計畫的領域。
DestinationPlanBuildId	字串	否	建構待測試版本。
DestinationPlanDescription	字串	否	測試計畫說明。
DestinationPlanEndDate	字串	否	測試計畫的結束日期。
DestinationPlanIteration	字串	否	測試計畫的疊代路徑。
DestinationPlanName	字串	是	測試計畫名稱。
DestinationPlanOwnerId	字串	否	測試計畫擁有者的使用者 ID。
DestinationPlanProject	字串	否	目的地的專案名稱。
DestinationPlanStartDate	字串	否	測試計畫的開始日期。
DestinationPlanState	字串	否	測試計畫的狀態。
DestinationPlanSync	布林值	否	指定測試計畫中各套件的重複測試行為。
SourceTestPlanId	整數	是	來源測試計畫的 ID。
SourceTestPlanSuiteId	整數	否	以半形逗號分隔的測試套件 ID 清單，用於在來源測試計畫中複製測試套件。

如要瞭解如何設定 CloneTestPlan 動作，請參閱「範例」。

CloneTestSuite 動作

這項操作會複製測試套件詳細資料。

CloneTestSuite 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	否	Azure DevOps 專案的 ID。
DeepClone	布林值	否	複製所有相關聯的測試案例。
CloneRequirements	布林值	否	如果設為 true，系統會複製需求。預設值為 false。
CopyAllSuites	布林值	否	從來源方案複製所有套件。
CopyAncestorHierarchy	布林值	否	複製上層階層。
DestinationWorkItemType	字串	否	要複製的工作項目類型名稱。
OverrideParameters	字串	否	鍵/值組合，其中每個鍵的值都會遭到指定值覆寫。
RelatedLinkComment	字串	否	在複製的測試套裝組合中新增註解。
DestinationTestSuiteId	整數	是	目的地測試套件的 ID。
DestinationProjectName	字串	否	目的地的專案名稱。
SourceTestSuiteId	整數	是	來源測試套件的 ID。

如要瞭解如何設定 CloneTestSuite 動作，請參閱範例。

CloneTestCase 動作

這項操作會複製測試案例詳細資料。

CloneTestCase 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	否	Azure DevOps 專案的 ID。
IncludeAttachments	布林值	否	如果設為 true，則包含測試案例的附件，預設值為 false。
IncludeLinks	布林值	否	如果設為 true，系統就會加入連結。預設值為 false。
RelatedLinkComment	字串	否	在複製的測試案例中新增註解。
DestinationTestPlanId	整數	是	目的地測試計畫的 ID。
DestinationTestSuiteId	整數	是	目的地測試套件的 ID。
SourceTestPlanId	整數	是	來源測試計畫的 ID。
SourceTestSuiteId	整數	是	來源測試套件的 ID。
TestCaseId	整數	是	以半形逗號分隔的測試案例 ID 清單，用於複製測試案例。

如要瞭解如何設定 CloneTestCase 動作，請參閱範例。

DeletePullRequestAttachment 動作

這項操作會刪除提取要求附件詳細資料。

DeletePullRequestAttachment 動作的輸入參數

參數名稱	資料類型	必填	說明
ProjectId	字串	否	Azure DevOps 專案的 ID。
RepositoryId	字串	是	存放區的 ID。
PullRequestId	整數	是	提取要求的 ID。
FileName	字串	是	附件名稱。

如要瞭解如何設定 DeletePullRequestAttachment 動作，請參閱範例。

動作範例

範例 - 建立工作項目

在 Configure connector task 對話方塊中，按一下 Actions。
選取 CreateWorkItem 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }

CreateWorkItem

connectorOutputPayload

[{
"Success": "True"
}]

如要建立各種實體 (例如工作、史詩、使用者故事、測試案例、功能和問題)，您只需要修改輸入酬載中的「Type」欄位值。
如要將「類型」設為「史詩」，請設定 "Type": "Epic"。同樣地，您可以將值變更為「Type」：「Task」、「Type」：「User Story」、「Type」：「Test Case」、「Type」：「Feature」或「Type」：「Issue」，以建立對應的實體。

範例 - 更新工作項目

在 Configure connector task 對話方塊中，按一下 Actions。
選取 UpdateWorkItem 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }

如果動作成功，UpdateWorkItem 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[{
"Success": "True"
}]

範例 - 取得提交的提取要求

在 Configure connector task 對話方塊中，按一下 Actions。
選取 GetPullRequestCommits 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
```

如果動作成功，GetPullRequestCommits 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "CommitId": "7299b6623d7d146751d8cf280af301f9a345ff05", "AuthorName": "jeffersonloveshi.k", "AuthorEmail": "jeffersonloveshiking@gmail.com", "AuthoredDate": "2024-08-12 11:25:23.0", "CommitterName": "lakshminarayana.k", "CommitterEmail": "jeffersonloveshiking@gmail.com", "CommittedDate": "2024-08-12 11:25:23.0", "Comment": "Added sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/7299b6623d7d146751d8cf280af301f9a345ff05" } ]

範例 - 將變更推送至存放區

在 Configure connector task 對話方塊中，按一下 Actions。
選取 PushChanges 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "BranchRefName": "refs/heads/US_Googlecloud_Push1", "OldObjectId": "4d66aafb75efda2bbdda7a2b609b152b1b715b7e", "CommitComment": "Googlecloud PUSH Changes", "ChangesAggregate": "{\n \"changeType\": \"edit\",\n \"item\": {\n \"path\": \"/tasks.md\"\n },\n \"newContent\": {\n \"content\": \"# Tasks\\n\\n* Item 1\\n* Item 2\",\n \"contentType\": \"rawtext\"\n }\n }" }

如果動作成功，PushChanges 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "NewObjectId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitTreeId": "7e7394dcfc5b4d4cf2c8c21d70a96fe34f8eaf3e", "AuthorName": "Charlie Cruz", "AuthorEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "AuthoredDate": "2024-11-19 07:04:42.0", "CommitterName": "Charlie Cruz", "CommitterEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "CommittedDate": "2024-11-19 07:04:42.0", "CommitUrl": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/commits/949e4710336bc5bdc779ca6b334e029c2f50a029", "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "RepositoryName": "refs/heads/US_Googlecloud_Push1", "PushId": "193", "PushDate": "2024-11-19T07:04:42.5793751Z", "PushURL": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/pushes/193" } ]

範例 - 下載版本的記錄

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DownloadReleaseLogs 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
```

如果動作成功，DownloadReleaseLogs 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "FileData": "{Base64encodedvalue}]

範例 - 下載測試結果/執行附件

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DownloadTestAttachment 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
```

如果動作成功，DownloadTestAttachment 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "FileData": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAABlSURBVDhP7cxBCsAgDERR739pG/CnGJI0FopQ8O2cjNP6R85QbeNQU7wT1dkijaQ3vkZoWElaoTeJojW01cYh0jwfgiFBV/lEjOZtacijN/nLkOBHhIaVDgn+Wdycp6FXzlCl9wt0Y0cAzHo/zgAAAABJRU5ErkJggg==" } ]

範例 - 設定專案屬性

在 Configure connector task 對話方塊中，按一下 Actions。
選取 SetProjectProperties 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
```

如果動作成功，SetProjectProperties 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success" } ]

範例 - 刪除測試案例

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DeleteTestCase 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
```

如果動作成功，DeleteTestCase 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success" } ]

範例 - 執行專案的管道

在 Configure connector task 對話方塊中，按一下 Actions。
選取 RunPipeline 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "PipelineId": 7, "Resources": "{\n \"repositories\": {\n \"self\": {\n \"refName\": \"refs/heads/main\" // Specify the branch or tag\n }\n }\n }" }

RunPipeline

connectorOutputPayload

[ { "State": "inProgress", "RunId": "16", "RunName": "20241113.2", "RunHref": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/pipelines/7/runs/16", "CreatedDate": "2024-11-13 12:07:38.9237296" } ]

範例 - 更新提取要求

在 Configure connector task 對話方塊中，按一下 Actions。
選取 UpdatePullRequest 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": "26", "Description": "updated pull req", "Title": "Googlecloud M pull request" }

如果動作成功，UpdatePullRequest 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "PullRequestId": 26 } ]

範例 - 建立提取要求

在 Configure connector task 對話方塊中，按一下 Actions。
選取 CreatePullRequest 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "Title": "Googlecloud M pull request", "SourceRefName": "refs/heads/Test_Branch", "TargetRefName": "refs/heads/main" }

如果動作成功，CreatePullRequest 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "PullRequestId": 26 } ]

範例 - 取得提取要求提交

在 Configure connector task 對話方塊中，按一下 Actions。
選取 GetPullRequestCommits 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
```

如果動作成功，GetPullRequestCommits 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "CommitId": "ebb720c5b93c52341cb86ccfb42258bb562a8406", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:24:19.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:24:19.0", "Comment": "Updated sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/ebb720c5b93c52341cb86ccfb42258bb562a8406" }, { "CommitId": "353f74b48ada83111449b922f4660a338e058989", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:23:01.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:23:01.0", "Comment": "Updated bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/353f74b48ada83111449b922f4660a338e058989" }, { "CommitId": "50a74dee46f8bcad4637d730994144f944c7d589", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:21:59.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:21:59.0", "Comment": "Added bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/50a74dee46f8bcad4637d730994144f944c7d589" }, { "CommitId": "9813f562b0548144006f773314704db274c757c4", "AuthorName": "Alex amal", "AuthorEmail": "cloudysanfrancisco@gmail.com", "AuthoredDate": "2024-11-26 11:19:29.0", "CommitterName": "Alex amal", "CommitterEmail": "cloudysanfrancisco@gmail.com", "CommittedDate": "2024-11-26 11:19:29.0", "Comment": "hello", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/9813f562b0548144006f773314704db274c757c4" } ]

範例 - 新增建構版本標記

在 Configure connector task 對話方塊中，按一下 Actions。
選取 AddBuildTag 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
```

如果動作成功，AddBuildTag 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[{ "Status": "Success" }]

範例 - 刪除建構標記

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DeleteBuildTag 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
```

如果動作成功，DeleteBuildTag 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[{ "Status": "Success" }]

範例 - 下載建構版本報表

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DownloadBuildReports 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
```

如果動作成功，DownloadBuildReports 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "FileData": "Base64-format data" } ]

範例 - 下載建構作業記錄

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DownloadBuildLogs 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
```

如果動作成功，DownloadBuildLogs 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success", "FileData": "Base64-format data" } ]

範例 - 更新使用者

在 Configure connector task 對話方塊中，按一下 Actions。
選取 UpdateUser 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "UserId": "088a8c28-1b83-4538-9c74-b7ca97eb4ef2", "Op": "add", "Path": "/projectEntitlements/50fac9d4-37aa-4a13-a81a-887d12be7b9f", "Value": "{ \"projectRef\": {\n \"id\": \"50fac9d4-37aa-4a13-a81a-887d12be7b9f\",\n \"name\": \"Postman_Testing_Project\"\n }, \n \"group\": {\n \"groupType\": \"projectContributor\"\n }}" }

如果動作成功，Update User 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "Status": "Success" } ]

範例 - 複製測試計畫

在 Configure connector task 對話方塊中，按一下 Actions。
選取 CloneTestPlan 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "CloneRequirements": true, "CopyAllSuites": true, "RelatedLinkComment": "Cloned from existing test plan googlecloud", "DestinationPlanName": "TestPlan 2", "DestinationPlanAreaPath": "GCPTesting_New_Project", "DestinationPlanIteration": "GCPTesting_New_Project", "DestinationPlanProject": "GCPTesting_New_Project", "SourceTestPlanId": 1, "CopyAncestorHierarchy": true }

如果動作成功，CloneTestPlan 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "CloneOperationId": null, "CloneOperationState": "queued", "sourcetestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestplan_project_name": "GCPTesting_New_Project", "sourcetestplan_project_state": "unchanged", "sourcetestplan_project_visibility": "unchanged", "sourcetestplan_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestplan_id": "1", "sourcetestplan_name": "Test Plan 1", "destinationtestplan_id": "15", "destinationtestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestplan_project_name": "GCPTesting_New_Project", "destinationtestplan_project_state": "unchanged", "destinationtestplan_project_visibility": "unchanged", "destinationtestplan_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestplan_updateddate": "2025-01-07T14:02:31.247Z", "destinationtestplan_updatedby_displayname": "Charlie Cruz", "destinationtestplan_updatedby_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_updatedby_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_rootsuite_id": "16", "destinationtestplan_rootsuite_name": "TestPlan 2", "destinationtestplan__links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15", "destinationtestplan__links_clienturl_href": "mtms://dev.azure.com:443/sunitavenkata2024/p:GCPTesting_New_Project/Testing/testplan/connect?id=15", "destinationtestplan__links_rootsuite_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15/Suites/16", "destinationtestplan_revision": "1", "destinationtestplan_name": "TestPlan 2", "destinationtestplan_areapath": "GCPTesting_New_Project", "destinationtestplan_startdate": "2025-01-07T14:02:31.0878913Z", "destinationtestplan_enddate": "2025-01-14T14:02:31.0878913Z", "destinationtestplan_iteration": "GCPTesting_New_Project", "destinationtestplan_owner_displayname": "sunita m V", "destinationtestplan_owner_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_owner_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_state": "Active", "destinationtestplan_testoutcomesettings_syncoutcomeacrosssuites": "false", "cloneoptions_relatedlinkcomment": "Cloned from existing test plan gcp", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "true", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/0" } ]

範例 - 複製測試套件

在 Configure connector task 對話方塊中，按一下 Actions。
選取 CloneTestSuite 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
```

CloneTestSuite

connectorOutputPayload

[ { "CloneOperationId": 2, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_id": "18", "sourcetestsuite_name": "Test Plan 3", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "2", "destinationtestsuite_name": "Test Plan 1", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "false", "cloneoperationresponse_opid": "2", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Suites/CloneOperation/2" } ]

範例 - 複製測試案例

在 Configure connector task 對話方塊中，按一下 Actions。
選取 CloneTestCase 動作，然後按一下「完成」。
在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{ "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
```

如果動作成功，CloneTestCase 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[ { "CloneOperationId": 3, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_testcaseids": "3", "sourcetestsuite_id": "2", "sourcetestsuite_name": "Test Plan 1", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "21", "destinationtestsuite_name": "Test Plan 4", "cloneoptions_includelinks": "false", "cloneoptions_includeattachments": "false", "cloneoperationresponse_opid": "3", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/3" } ]

範例 - 刪除提取要求附件

在 Configure connector task 對話方塊中，按一下 Actions。
選取 DeletePullRequestAttachment 動作，然後按一下「完成」。

在「連線器」任務的「任務輸入內容」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }

DeletePullRequestAttachment

connectorOutputPayload

[ { "Status": "Success" } ]

實體作業範例

擷取專案中的所有資訊主頁

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Dashboards」。
選取「List」作業，然後按一下「完成」。
在「連線器」工作的「工作輸入」部分，您可以根據客戶需求設定 filterClause。請參閱下方的「注意」一節

filterClause 的值一律應以單引號 (') 括住，並採用這種格式。
您可以根據任何資料欄，使用 filterClause 篩選特定記錄集。

範例 - 使用 ID 擷取單一資訊主頁

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Dashboards」。
選取「Get」作業，然後按一下「完成」。
將實體 ID 設為「2f671e29-e48f-4d26-8869-859e154b5f20」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "2f671e29-e48f-4d26-8869-859e154b5f20"，並選擇 EntityId 做為本機變數。
應直接傳遞實體 ID 的值，例如「2f671e29-e48f-4d26-8869-859e154b5f20」。其中「2f671e29-e48f-4d26-8869-859e154b5f20」是傳遞的專屬主鍵值。

在某些情況下，傳遞單一實體 ID 可能會導致錯誤，因為實體有兩個複合鍵。在這種情況下，您可以使用 filterClause 並傳遞值，例如 id='2f671e29-e48f-4d26-8869-859e154b5f20'。

範例 - 使用 ID 移除資訊主頁

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Dashboards」。
選取「Delete」作業，然後按一下「完成」。
將實體 ID 設為「2f671e29-e48f-4d26-8869-859e154b5f20」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "2f671e29-e48f-4d26-8869-859e154b5f20"，並選擇 EntityId 做為本機變數。
如果實體有兩個複合式商家或主鍵，您可以設定 filterClause 為 id='2f671e29-e48f-4d26-8869-859e154b5f20'，不必指定 entityId。

範例 - 在專案中建立新資訊主頁

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Dashboard」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "a2402c49-6c17-43a9-bfc4-3701d07bcfee" }
```

範例 - 在專案中建立新的使用者授權

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Users」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "5e373a81-073d-4d64-a2c5-23d0b6cc287f" }
```

範例 - 在專案中建立新查詢

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Queries」。
選取「Create」作業，然後按一下「完成」。

在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

{ "Name": "New Queries Googlecloud", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "IsFolder": true, "Wiql": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] = 'New' ORDER BY [System.ChangedDate] DESC", "ParentQueryId": "df947cf9-dbbe-43bc-93a4-3e4d7287adb8" }

如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

{ "Id": "cf4a25e8-d2d2-48b7-a483-dd901c78293b" }

範例 - 在專案中建立新管道

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Pipelines」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": 9 }
```

範例 - 在專案中建立部署作業群組

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「DeploymentGroups」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "Deployment group 2 Googlecloud" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": 139 }
```

範例 - 在專案中建立新的測試設定

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestPlan」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "Googlecloud_TestPlan" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": 106 }
```

範例 - 在專案中建立測試套件

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestSuite」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": 22264 }
```

範例 - 在專案中建立測試執行

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestRun」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "TestRun_Googlecloud1"}
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": 46 }
```

範例 - 建立新專案

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Projects」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
```
如果整合成功，Projects 工作的 connectorOutputPayload 回應參數值會類似以下內容：
```
{ "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
```

對專案執行「建立」作業後產生的 ID 並非實際的專案 ID。
如要擷取確切的專案詳細資料，您需要以專案名稱做為篩選條件執行 List 作業，例如 Name= 'Google Project Integration'。

範例 - 在專案中建立團隊

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Teams」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "M new team"}
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
```

範例 - 在專案中建立環境

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Environments」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "9" }
```

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Widgets」。
選取「Create」作業，然後按一下「完成」。

{ "Name": "Widget 2", "DashboardId": "6cb82f8d-393c-422e-b4e3-563d5e34fc31", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1", "RowPosition": 4, "ColumnPosition": 4, "RowSpanSize": 1, "ColumnSpanSize": 2, "ContributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.OtherLinksWidget" }

本範例說明如何新增小工具。整合成功後，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

{ "Id": "7d049ae2-d995-4b3e-9ebd-662d94a53cc8" }

範例 - 在存放區中為提取要求新增審查人員

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「PullRequestReviewers」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "PullRequestId": null }
```

範例 - 在專案中建立變數群組

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「VariableGroups」。
選取「Create」作業，然後按一下「完成」。

{
  "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc",
  "Type": "Vsts",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"Variable Group new test\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"Googlecloud-Demo-Project\"\n      }\n    }\n  ]",
  "Name": "Variable Group new test"
}

如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

{"Id": "12"}

範例 - 在存放區中建立新的建構定義

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「BuildDefinition」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{"Id": "25"}
```

範例 - 在專案中建立版本

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Releases」。
選取「Create」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
```
如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：
```
{ "Id": "13" }
```

範例 - 更新專案中的團隊名稱或說明

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Teams」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "M new team update" }
```
在資料對應工具中，將實體 ID 設為 Teams 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 5285fb98-a1bc-42e1-9668-3c2780061367，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
```

範例 - 更新專案中的查詢

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Queries」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Update Queries" }
```
在資料對應工具中，將實體 ID 設為查詢的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 81797017-624d-4967-bc85-842a817bff48，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "81797017-624d-4967-bc85-842a817bff48" }
```

範例 - 更新專案中的資訊主頁

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Dashboard」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": " update from googlecloud" }
```
在資料對應工具中，將實體 ID 設為資訊主頁的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 139，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "139" }
```

範例 - 更新專案中的測試套件

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestSuite」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "UPdated_Suite", "ParentSuiteId": 108 }
```
在資料對應工具中，將實體 ID 設為 TestSuite 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 22264，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "22264" }
```

範例 - 更新專案中的部署群組

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「DeploymentGroups」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Deployment" }
```
在資料對應工具中，將實體 ID 設為 DeploymentGroups 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 138，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "138" }
```

範例 - 更新專案中的測試計畫

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestPlan」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "TestPlan_Update" }
```
在資料對應工具中，將實體 ID 設為 TestPlan 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 104，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "104" }
```

範例 - 更新專案中的測試執行

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「TestRuns」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
```
在資料對應工具中，將實體 ID 設為 TestRuns 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 46，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "46" }
```

範例 - 更新專案

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Projects」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Projects Update" }
```
在資料對應工具中，將實體 ID 設為「專案」的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在「Input Value」欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }
```

範例 - 更新專案中的環境

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Environments」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Environment Update M", "Description": "Update environment " }
```
在資料對應工具中，將實體 ID 設為環境的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 { "Id": "9" }，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": 9 }
```

範例 - 更新專案中的變數群組

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「VariableGroups」。
選取「Update」作業，然後按一下「完成」。

在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

{
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"New VariableGroup googlecloud updated\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"GoogleCloud-Demo-Project\"\n      }\n    }\n  ]",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "Name": "Variable Group new test updated"
}

在資料對應工具中，將實體 ID 設為 VariableGroups 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 { "Id": "12" }，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": 12 }
```

範例 - 更新專案中的建構定義

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「BuildDefinition」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
```
在資料對應工具中，將實體 ID 設為 BuildDefinition 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": 25 }
```

範例 - 更新專案中的提取要求審查者

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「PullRequestReviewers」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{"isFlagged": true}
```
在資料對應工具中，將實體 ID 設為 PullRequestReviewers 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{ "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81","PullRequestId": null}
```

範例 - 更新專案中的版本

在 Configure connector task 對話方塊中，按一下 Entities。
從「Entity」清單中選取「Releases」。
選取「Update」作業，然後按一下「完成」。
在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
```
{ "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
```
在資料對應工具中，將實體 ID 設為發行內容的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
您也可以將 filterClause 設為 {"Id": 13}，而非指定 entityId。

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似以下的回應：
```
{"Id": 13 }
```

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟

瞭解如何暫停及恢復連線。
瞭解如何監控連接器用量。
瞭解如何查看連接器記錄。