Azure DevOps

連線設定範例

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

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

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

您可以使用下列連線屬性，管理從 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 中註冊用戶端應用程式」。

動作

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

CreateWorkItem 動作

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

CreateWorkItem 動作的輸入參數

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

UpdateWorkItem 動作

UpdateWorkItem 動作的輸入參數

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

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

GetPullRequestCommits 動作

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

GetPullRequestCommits 動作的輸入參數

GetPullRequestCommits 動作的輸出參數

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

PushChanges 動作

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

PushChanges 動作的輸入參數

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

DownloadReleaseLogs 動作

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

DownloadReleaseLogs 動作的輸入參數

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

DownloadTestAttachment 動作

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

DownloadTestAttachment 動作的輸入參數

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

SetProjectProperties 動作

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

SetProjectProperties 動作的輸入參數

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

DeleteTestCase 動作

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

DeleteTestCase 動作的輸入參數

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

RunPipeline 動作

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

RunPipeline 動作的輸入參數

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

CreatePullRequest 動作

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

CreatePullRequest 動作的輸入參數

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

UpdatePullRequest 動作

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

UpdatePullRequest 動作的輸入參數

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

GetPullRequestCommits 動作

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

GetPullRequestCommits 動作的輸入參數

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

AddBuildTag 動作

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

AddBuildTag 動作的輸入參數

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

DeleteBuildTag 動作

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

DeleteBuildTag 動作的輸入參數

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

DownloadBuildReports 動作

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

DownloadBuildReports 動作的輸入參數

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

DownloadBuildLogs 動作

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

DownloadBuildLogs 動作的輸入參數

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

UpdateUser 動作

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

UpdateUser 動作的輸入參數

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

CloneTestPlan 動作

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

CloneTestPlan 動作的輸入參數

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

CloneTestSuite 動作

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

CloneTestSuite 動作的輸入參數

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

CloneTestCase 動作

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

CloneTestCase 動作的輸入參數

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

DeletePullRequestAttachment 動作

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

DeletePullRequestAttachment 動作的輸入參數

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

動作範例

範例 - 建立工作項目

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CreateWorkItem 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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"。同樣地，您可以將值變更為「類型」：「工作」、「類型」：「使用者故事」、「類型」：「測試案例」、「類型」：「功能」或「類型」：「問題」，以建立對應的實體。

範例 - 更新工作項目

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 UpdateWorkItem 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

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

[{
"Success": "True"
}]

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

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetPullRequestCommits 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

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

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 PushChanges 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 下載版本的記錄

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DownloadReleaseLogs 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
   

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

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

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

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DownloadTestAttachment 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
   

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

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

範例 - 設定專案屬性

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 SetProjectProperties 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
   

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

[ { "Status": "Success" } ]

範例 - 刪除測試案例

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DeleteTestCase 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
   

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

[ { "Status": "Success" } ]

範例 - 執行專案的管道

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 RunPipeline 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 更新提取要求

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 UpdatePullRequest 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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 } ]

範例 - 建立提取要求

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CreatePullRequest 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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 } ]

範例 - 取得提取要求提交

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetPullRequestCommits 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 新增建構版本標記

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 AddBuildTag 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
   

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

[{ "Status": "Success" }]

範例 - 刪除建構標記

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DeleteBuildTag 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
   

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

[{ "Status": "Success" }] 

範例 - 下載建構版本報表

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DownloadBuildReports 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
   

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

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

範例 - 下載建構作業記錄

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DownloadBuildLogs 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   { "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
   

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

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

範例 - 更新使用者

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 UpdateUser 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 複製測試計畫

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CloneTestPlan 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 複製測試套件

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CloneTestSuite 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 複製測試案例

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CloneTestCase 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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" } ]

範例 - 刪除提取要求附件

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 DeletePullRequestAttachment 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

這項動作會傳回 DeletePullRequestAttachment 的確認訊息。如果動作成功，DeletePullRequestAttachment 工作 connectorOutputPayload 回應參數的值會類似以下內容：

[ { "Status": "Success" } ]

實體作業範例

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

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

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

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Dashboards。
3. 選取「Get」作業，然後按一下「完成」。
4. 將實體 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 移除資訊主頁

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

   如果實體有兩個複合式商家或主鍵，您可以設定 filterClause 為 id='2f671e29-e48f-4d26-8869-859e154b5f20'，不必指定 entityId。

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Dashboard。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
   

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

   { "Id": "a2402c49-6c17-43a9-bfc4-3701d07bcfee" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Queries。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Pipelines。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 DeploymentGroups。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "Deployment group 2 Googlecloud" }
   

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

   { "Id": 139 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestPlan。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "Googlecloud_TestPlan" }
   

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

   { "Id": 106 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestSuite。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
   

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

   { "Id": 22264 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestRun。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "TestRun_Googlecloud1"}
   

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

   { "Id": 46 }
   

範例 - 建立新專案

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Projects。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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'。

範例 - 在專案中建立團隊

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Teams。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Name": "M new team"}
   

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

   { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
   

範例 - 在專案中建立環境

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Environments。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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" }
   

範例 - 在資訊主頁中建立新小工具

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Widgets。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "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" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 PullRequestReviewers。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 VariableGroups。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   {
     "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"}
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 BuildDefinition。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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"}
   

範例 - 在專案中建立版本

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Releases。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分，按一下 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" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Teams。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "M new team update" }
   

5. 在資料對應工具中，將實體 ID 設為 Teams 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 5285fb98-a1bc-42e1-9668-3c2780061367。

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

   { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
   

範例 - 更新專案中的查詢

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Queries。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "Update Queries" }
   

5. 在資料對應工具中，將實體 ID 設為查詢的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 81797017-624d-4967-bc85-842a817bff48。

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

   { "Id": "81797017-624d-4967-bc85-842a817bff48" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Dashboard。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": " update from googlecloud" }
   

5. 在資料對應工具中，將實體 ID 設為資訊主頁的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 139。

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

   { "Id": "139" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestSuite。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "UPdated_Suite", "ParentSuiteId": 108 }
   

5. 在資料對應工具中，將實體 ID 設為 TestSuite 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 22264。

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

   { "Id": "22264" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 DeploymentGroups。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "Deployment" }
   

5. 在資料對應工具中，將實體 ID 設為 DeploymentGroups 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 138。

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

   { "Id": "138" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestPlan。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "TestPlan_Update" }
   

5. 在資料對應工具中，將實體 ID 設為 TestPlan 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 104。

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

   { "Id": "104" }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 TestRuns。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
   

5. 在資料對應工具中，將實體 ID 設為 TestRuns 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 46。

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

   { "Id": "46" }
   

範例 - 更新專案

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Projects。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "Projects Update" }
   

5. 在資料對應工具中，將實體 ID 設為專案的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }。

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

   { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }
   

範例 - 更新專案中的環境

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Environments。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Name": "Environment Update M", "Description": "Update environment " }
   

5. 在資料對應工具中，將實體 ID 設為環境的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 { "Id": "9" }。

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

   { "Id": 9 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 VariableGroups。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 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"
   }
   

5. 在資料對應工具中，將實體 ID 設為 VariableGroups 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 { "Id": "12" }。

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

   { "Id": 12 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 BuildDefinition。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 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 }
   

5. 在資料對應工具中，將實體 ID 設為 BuildDefinition 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇「EntityId/ConnectorInputPayload/FilterClause」做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}。

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

   { "Id": 25 }
   

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

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 PullRequestReviewers。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   {"isFlagged": true}
   

5. 在資料對應工具中，將實體 ID 設為 PullRequestReviewers 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇「EntityId/ConnectorInputPayload/FilterClause」做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}。

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

   { "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81","PullRequestId": null}
   

範例 - 更新專案中的版本

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Releases。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」部分中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   { "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
   

5. 在資料對應工具中，將實體 ID 設為發行內容的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇「EntityId/ConnectorInputPayload/FilterClause」做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 {"Id": 13}。

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

   {"Id": 13 }