Azure DevOps

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

In Azure DevOps, vengono utilizzati vari schemi di dati per organizzare e gestire diversi aspetti di un progetto. Ogni schema si concentra su un tipo specifico di dati per strutturare le informazioni in modo efficace in base alle esigenze del progetto.

• Modello dei dati del progetto: uno schema che definisce come vengono organizzati, collegati e gestiti i dati correlati al progetto, come elementi, repository, pipeline e team, all'interno di Azure DevOps.
• Modello dei dati delle informazioni: uno schema che definisce come vengono strutturati, archiviati e accessibili la documentazione, i metadati e gli artefatti di comunicazione nei progetti Azure DevOps.
• Modello dei dati del repository: uno schema che definisce come vengono organizzati e gestiti i repository di codice, i rami, i commit, le richieste di pull e i metadati correlati in Azure DevOps.
• Modello dei dati di Analytics: uno schema che acquisisce e organizza i dati storici e in tempo reale di Azure DevOps per report, dashboard e analisi avanzate.
• Tutti i modelli di dati: una singola connessione che fornisce l'accesso a tutti i modelli di dati in una singola connessione.

Puoi utilizzare le seguenti proprietà di connessione per gestire i dati recuperati da Azure DevOps.

Catalogo

Questa proprietà specifica il nome o l'ID del progetto a cui vuoi connetterti. Per ottenere un elenco di ID e nomi dei progetti, esegui una query SELECT sulla tabella Projects.

• Per eseguire query sui dati di un progetto specifico, imposta Catalogo sul nome del progetto o sul relativo ID nel formato Project_projectname.
  Se il nome del progetto è dev con l'ID 2ee729d6-804d-4ece-84af-d5befa94abe8, imposta Catalog su Project_dev o Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
• Per eseguire query sui dati indipendenti da un progetto specifico, imposta Catalogo su DevOps. Se il nome del catalogo è Devops, puoi utilizzare qualsiasi nome al posto di Devops.

Schema

Questa proprietà specifica lo schema da utilizzare. Gli schemi disponibili dipendono dal repository specificato. Per ottenere un elenco di ID e nomi dei repository, esegui una query SELECT sulla tabella Repository.

• Se imposti Catalogo e Schema su INFORMATION nella configurazione della connessione, avrai accesso solo allo schema Information Data Model. Altri cataloghi o schemi di progetti non verranno esposti.
• Se Catalogo è impostato su un catalogo di progetti, puoi impostare Schema su uno dei seguenti valori: Analytics, Project o uno degli schemi del repository. Dopo aver selezionato lo schema appropriato, puoi eseguire query sui dati all'interno di un repository specifico.
  Per eseguire query sui dati di un repository con l'ID 3ee729d6-804d-4ece-84af-d5befa94abe8, imposta Catalogo su Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

Per creare un'applicazione nel portale Azure/MS Entra e utilizzare tutti i parametri dell'applicazione creata a livello di connessione Azure AD, consulta Guida introduttiva: registra un'applicazione con la piattaforma Microsoft Identity e Registra un'applicazione client in Microsoft Entra ID.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CreateWorkItem

Questa azione crea un elemento di lavoro.

Parametri di input dell'azione CreateWorkItem

Per un esempio di come configurare l'azione CreateWorkItem, consulta Esempi.

Azione UpdateWorkItem

Parametri di input dell'azione UpdateWorkItem

Questa azione aggiorna un elemento di lavoro.

Per un esempio di come configurare l'azione UpdateWorkItem, consulta Esempi.

Azione GetPullRequestCommits

Questa azione recupera i commit per la pull request specificata.

Parametri di input dell'azione GetPullRequestCommits

Parametri di output dell'azione GetPullRequestCommits

Per un esempio di come configurare l'azione GetPullRequestCommits, consulta Esempi.

Azione PushChanges

Questa azione esegue il push delle modifiche a un repository nell'istanza Azure DevOps.

Parametri di input dell'azione PushChanges

Per un esempio di come configurare l'azione PushChanges, consulta Esempi.

Azione DownloadReleaseLogs

Questa azione scarica i log per la release specifica.

Parametri di input dell'azione DownloadReleaseLogs

Per un esempio di come configurare l'azione DownloadReleaseLogs, consulta Esempi.

Azione DownloadTestAttachment

Questa azione scarica un allegato di risultato/esecuzione del test.

Parametri di input dell'azione DownloadTestAttachment

Per un esempio di come configurare l'azione DownloadTestAttachment, consulta Esempi.

Azione SetProjectProperties

Questa azione può creare, aggiornare ed eliminare le proprietà del progetto di gruppo.

Parametri di input dell'azione SetProjectProperties

Per un esempio di come configurare l'azione SetProjectProperties, consulta Esempi.

Azione DeleteTestCase

Questa azione elimina lo scenario di test.

Parametri di input dell'azione DeleteTestCase

Per un esempio di come configurare l'azione DeleteTestCase, consulta Esempi.

Azione RunPipeline

Questa azione esegue una pipeline con la configurazione specificata.

Parametri di input dell'azione RunPipeline

Per un esempio di come configurare l'azione RunPipeline, consulta Esempi.

Azione CreatePullRequest

Questa azione crea una richiesta di pull con la configurazione specificata.

Parametri di input dell'azione CreatePullRequest

Per un esempio di come configurare l'azione CreatePullRequest, consulta Esempi.

Azione UpdatePullRequest

Questa azione aggiorna una richiesta di pull con la configurazione specificata.

Parametri di input dell'azione UpdatePullRequest

Per un esempio di come configurare l'azione UpdatePullRequest, consulta Esempi.

Azione GetPullRequestCommits

Questa azione recupera i commit per la pull request specificata con la configurazione specificata.

Parametri di input dell'azione GetPullRequestCommits

Per un esempio di come configurare l'azione GetPullRequestCommits, consulta Esempi.

Azione AddBuildTag

Questa azione aggiunge un tag a una build.

Parametri di input dell'azione AddBuildTag

Per un esempio di come configurare l'azione AddBuildTag, consulta Esempi.

Azione DeleteBuildTag

Questa azione elimina un tag da una build.

Parametri di input dell'azione DeleteBuildTag

Per un esempio di come configurare l'azione DeleteBuildTag, consulta Esempi.

Azione DownloadBuildReports

Questa azione scarica i report di build.

Parametri di input dell'azione DownloadBuildReports

Per un esempio di come configurare l'azione DownloadBuildReports, consulta Esempi.

Azione DownloadBuildLogs

Questa azione scarica i log di build.

Parametri di input dell'azione DownloadBuildLogs

Per un esempio di come configurare l'azione DownloadBuildLogs, consulta Esempi.

Azione UpdateUser

Questa azione aggiorna i dettagli di un utente.

Parametri di input dell'azione UpdateUser

Per un esempio di come configurare l'azione UpdateUser, consulta Esempi.

Azione CloneTestPlan

Questa azione clona un piano di test.

Parametri di input dell'azione CloneTestPlan

Per un esempio su come configurare l'azione CloneTestPlan, consulta Esempi.

Azione CloneTestSuite

Questa azione clona i dettagli della suite di test.

Parametri di input dell'azione CloneTestSuite

Per un esempio di come configurare l'azione CloneTestSuite, consulta Esempi.

Azione CloneTestCase

Questa azione clona i dettagli dello scenario di test.

Parametri di input dell'azione CloneTestCase

Per un esempio di come configurare l'azione CloneTestCase, consulta Esempi.

Azione DeletePullRequestAttachment

Questa azione elimina i dettagli degli allegati delle richieste di pull.

Parametri di input dell'azione DeletePullRequestAttachment

Per un esempio di come configurare l'azione DeletePullRequestAttachment, consulta Esempi.

Esempi di azioni

Esempio: crea un elemento di lavoro

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateWorkItem, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro CreateWorkItem della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "True"
}]

Per creare varie entità come attività, epic, user story, scenario di test, funzionalità e problema, devi solo modificare il valore del campo "Tipo" nel payload di input.
Per impostare un tipo su Epica, puoi impostare "Type": "Epic". Allo stesso modo, puoi modificare il valore in "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature" o "Type": "Issue" per creare l'entità corrispondente.

Esempio: aggiornamento di un elemento di lavoro

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdateWorkItem, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro UpdateWorkItem della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "True"
}]

Esempio: recupera una richiesta di pull di un commit

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetPullRequestCommits, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro GetPullRequestCommits della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: eseguire il push delle modifiche a un repository

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione PushChanges, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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 }" }
   

Se l'azione ha esito positivo, il parametro PushChanges della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: scaricare i log di una release

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadReleaseLogs, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadReleaseLogs della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: scaricare un allegato di test/esecuzione

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadTestAttachment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadTestAttachment della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: impostare le proprietà di un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione SetProjectProperties, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro SetProjectProperties della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[ { "Status": "Success" } ]

Esempio: elimina uno scenario di test

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteTestCase, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DeleteTestCase della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[ { "Status": "Success" } ]

Esempio: esegui una pipeline per un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RunPipeline, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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 }" }
   

Se l'azione ha esito positivo, il parametro RunPipeline della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: aggiornare una richiesta di pull

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdatePullRequest, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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" }
   

Se l'azione ha esito positivo, il parametro UpdatePullRequest della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: creare una richiesta di pull

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreatePullRequest, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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" }
   

Se l'azione ha esito positivo, il parametro CreatePullRequest della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: recuperare un commit di una richiesta di pull

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetPullRequestCommits, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro GetPullRequestCommits della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: aggiungere un tag di build

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddBuildTag, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro AddBuildTag della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{ "Status": "Success" }]

Esempio: eliminare un tag di build

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteBuildTag, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DeleteBuildTag della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{ "Status": "Success" }] 

Esempio: scaricare un report sulla build

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadBuildReports, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadBuildReports della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: scaricare i log di build

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadBuildLogs, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadBuildLogs della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: aggiornare un utente

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdateUser, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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 }}" }
   

Se l'azione ha esito positivo, il parametro Update User della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[ { "Status": "Success" } ]

Esempio: clona un piano di test

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CloneTestPlan, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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 }
   

Se l'azione ha esito positivo, il parametro CloneTestPlan della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: clona una suite di test

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CloneTestSuite, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   { "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
   

Se l'azione ha esito positivo, il parametro CloneTestSuite della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: clona uno scenario di test

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CloneTestCase, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   { "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
   

Se l'azione ha esito positivo, il parametro CloneTestCase della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: eliminare un allegato di una richiesta di pull

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeletePullRequestAttachment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Questa azione restituisce il messaggio di conferma di DeletePullRequestAttachment. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività DeletePullRequestAttachment avrà un valore simile al seguente:

[ { "Status": "Success" } ]

Esempi di operazioni sulle entità

Recupera tutte le dashboard in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dashboards dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente. Consulta la sezione Note di seguito.

Il valore di filterClause deve essere sempre passato tra virgolette singole ("'") in questo formato.
Puoi utilizzare filterClause per filtrare un determinato insieme di record in base a qualsiasi colonna.

Esempio: recupera una singola dashboard utilizzando il relativo ID

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dashboards dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Imposta l'ID entità su "2f671e29-e48f-4d26-8869-859e154b5f20", ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci "2f671e29-e48f-4d26-8869-859e154b5f20" nel campo Valore di input e scegli EntityId come variabile locale.

   Il valore dell'ID entità deve essere passato direttamente, ad esempio "2f671e29-e48f-4d26-8869-859e154b5f20". In questo caso, "2f671e29-e48f-4d26-8869-859e154b5f20" è il valore univoco della chiave primaria, che viene passato.

   In alcuni casi, il passaggio di un singolo ID entità può causare un errore perché l'entità ha due chiavi composite. In questi casi, puoi utilizzare filterClause e trasmettere il valore, ad esempio id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Esempio: rimuovere una dashboard utilizzando il relativo ID

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dashboards dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Imposta l'ID entità su "2f671e29-e48f-4d26-8869-859e154b5f20", ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci "2f671e29-e48f-4d26-8869-859e154b5f20" nel campo Valore di input e scegli EntityId come variabile locale.

   Se l'entità ha due chiavi aziendali o primarie composite, anziché specificare entityId, puoi impostare filterClause su id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Esempio: creare una nuova dashboard in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dashboard dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: crea un nuovo diritto utente in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Users dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": "5e373a81-073d-4d64-a2c5-23d0b6cc287f" }
   

Esempio: crea una nuova query in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Queries dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: creare una nuova pipeline in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Pipelines dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": 9 }
   

Esempio: crea un gruppo di deployment in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DeploymentGroups dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": 139 }
   

Esempio: crea una nuova configurazione di test in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestPlan dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "Name": "Googlecloud_TestPlan" }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": 106 }
   

Esempio: creare una suite di test in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestSuite dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": 22264 }
   

Esempio: crea un test run in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestRun dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "Name": "TestRun_Googlecloud1"}
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": 46 }
   

Esempio: crea un nuovo progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Projects dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Projects avrà un valore simile al seguente:

   { "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
   

L'ID generato dopo l'esecuzione dell'operazione di creazione di un progetto non è l'ID progetto effettivo.
Per recuperare i dettagli esatti del progetto, devi eseguire l'operazione List con il nome del progetto come condizione di filtro, ad esempio Name= 'Integrazione progetto Google'.

Esempio: creare un team in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Teams dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "Name": "M new team"}
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: crea un ambiente in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Environments dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": "9" }
   

Esempio: crea un nuovo widget in una dashboard

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Widgets dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Questo esempio mostra come aggiungere un widget. Se l'integrazione va a buon fine, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: aggiunta di un revisore a una richiesta di pull in un repository

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona PullRequestReviewers dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: crea un gruppo di variabili in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona VariableGroups dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {"Id": "12"}
   

Esempio: creare una nuova definizione di build in un repository

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona BuildDefinition dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {"Id": "25"}
   

Esempio: creare una release in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Releases dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   { "Id": "13" }
   

Esempio: aggiornare il nome o la descrizione di un team in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Teams dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di Teams. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 5285fb98-a1bc-42e1-9668-3c2780061367.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

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

Esempio: aggiornare una query in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Queries dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": "Update Queries" }
   

5. Imposta l'ID entità in Data Mapper sull'entità delle query. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 81797017-624d-4967-bc85-842a817bff48.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

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

Esempio: aggiornare una dashboard in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dashboard dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": " update from googlecloud" }
   

5. Imposta l'ID entità in Data Mapper sull'entità della dashboard. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 139.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": "139" }
   

Esempio: aggiorna una suite di test in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestSuite dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di TestSuite. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 22264.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": "22264" }
   

Esempio: aggiorna un gruppo di deployment in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DeploymentGroups dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": "Deployment" }
   

5. Imposta l'ID entità in Data Mapper sull'entità di DeploymentGroups. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 138.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": "138" }
   

Esempio: aggiornare un piano di test in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestPlan dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": "TestPlan_Update" }
   

5. Imposta l'ID entità in Data Mapper sull'entità di TestPlan. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 104.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": "104" }
   

Esempio: aggiorna un test run in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona TestRuns dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di TestRuns. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 46.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": "46" }
   

Esempio: aggiorna un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Projects dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": "Projects Update" }
   

5. Imposta l'ID entità in Data Mapper sull'entità dei progetti. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

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

Esempio: aggiorna un ambiente in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Environments dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità degli ambienti. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su { "Id": "9" }.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": 9 }
   

Esempio: aggiorna un gruppo di variabili in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona VariableGroups dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
     "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. Imposta l'ID entità in Data Mapper sull'entità di VariableGroups. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su { "Id": "12" }.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": 12 }
   

Esempio: aggiorna una definizione di build in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona BuildDefinition dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   { "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
   

5. Imposta l'ID entità in Data Mapper sull'entità di BuildDefinition. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   { "Id": 25 }
   

Esempio: aggiornare un revisore di richieste di pull in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona PullRequestReviewers dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {"isFlagged": true}
   

5. Imposta l'ID entità in Data Mapper sull'entità PullRequestReviewers. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

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

Esempio: aggiornare una release in un progetto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Releases dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità delle uscite. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su {"Id": 13}.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

   {"Id": 13 }