DevOps do Azure

Exemplos de configuração de conexão

Esta seção lista os valores de amostra para os vários campos que você configura ao criar a conexão.

No Azure DevOps, vários esquemas de dados são usados para organizar e gerenciar diferentes aspectos de um projeto. Cada esquema se concentra em um tipo específico de dados para estruturar as informações de maneira eficaz com base nas necessidades do projeto.

• Modelo de dados do projeto: um esquema que define como os dados relacionados ao projeto, como itens, repositórios, pipelines e equipes, são organizados, vinculados e gerenciados no Azure DevOps.
• Modelo de dados de informações: um esquema que define como a documentação, os metadados e os artefatos de comunicação são estruturados, armazenados e acessados em projetos do Azure DevOps.
• Modelo de dados do repositório: um esquema que define como repositórios de código, ramificações, commits, solicitações de envio e metadados relacionados são organizados e gerenciados no Azure DevOps.
• Modelo de dados de análise: um esquema que captura e organiza dados históricos e em tempo real do Azure DevOps para relatórios, dashboards e análises avançadas.
• Todos os modelos de dados: uma única conexão que fornece acesso a todos os modelos de dados.

Use as seguintes propriedades de conexão para gerenciar os dados extraídos do Azure DevOps.

Catálogo

Essa propriedade especifica o nome ou ID do projeto a que você quer se conectar. Para obter uma lista de IDs e nomes de projetos, execute uma consulta SELECT na tabela "Projetos".

• Para consultar dados de um projeto específico, defina Catálogo como o nome ou ID do projeto no formato Project_projectname.
  Se o nome do projeto for dev com o ID 2ee729d6-804d-4ece-84af-d5befa94abe8, defina Catalog como Project_dev ou Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
• Para consultar dados independentes de um projeto específico, defina Catálogo como Devops. Se o nome do catálogo for Devops, você poderá usar qualquer nome no lugar de Devops.

Esquema

Essa propriedade especifica o esquema a ser usado. Os esquemas disponíveis dependem do repositório especificado. Para receber uma lista de IDs e nomes de repositórios, execute uma consulta SELECT na tabela Repositórios.

• Se você definir Catálogo e Esquema como INFORMATION na configuração da conexão, terá acesso apenas ao esquema do modelo de dados de informações. Outros catálogos ou esquemas de projetos não serão expostos.
• Se Catálogo estiver definido como um catálogo de projetos, você poderá definir Esquema como um dos seguintes: Analytics, Project ou um dos esquemas do repositório. Depois de selecionar o esquema adequado, você pode consultar dados em um repositório específico.
  Para consultar dados de um repositório com o ID 3ee729d6-804d-4ece-84af-d5befa94abe8, defina Catálogo como Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

Para criar um aplicativo no portal do Azure/MS Entra e usar todos os parâmetros do aplicativo criado no nível da conexão do Azure AD, consulte Guia de início rápido: registrar um aplicativo com a plataforma de identidade da Microsoft e Registrar um aplicativo cliente no Microsoft Entra ID.

Ações

Esta seção lista as ações compatíveis com o conector. Para entender como configurar as ações, consulte Exemplos de ações.

Ação CreateWorkItem

Essa ação cria um item de trabalho.

Parâmetros de entrada da ação CreateWorkItem

Para ver um exemplo de como configurar a ação CreateWorkItem, consulte Exemplos.

Ação UpdateWorkItem

Parâmetros de entrada da ação UpdateWorkItem

Essa ação atualiza um item de trabalho.

Para ver um exemplo de como configurar a ação UpdateWorkItem, consulte Exemplos.

Ação GetPullRequestCommits

Essa ação recebe os commits da solicitação de envio especificada.

Parâmetros de entrada da ação GetPullRequestCommits

Parâmetros de saída da ação GetPullRequestCommits

Para ver um exemplo de como configurar a ação GetPullRequestCommits, consulte Exemplos.

Ação PushChanges

Essa ação envia as mudanças para um repositório na sua instância do Azure DevOps.

Parâmetros de entrada da ação PushChanges

Para ver um exemplo de como configurar a ação PushChanges, consulte Exemplos.

Ação DownloadReleaseLogs

Essa ação baixa os registros da versão específica.

Parâmetros de entrada da ação DownloadReleaseLogs

Para ver um exemplo de como configurar a ação DownloadReleaseLogs, consulte Exemplos.

Ação DownloadTestAttachment

Essa ação faz o download de um anexo de resultado/execução de teste.

Parâmetros de entrada da ação DownloadTestAttachment

Para ver um exemplo de como configurar a ação DownloadTestAttachment, consulte Exemplos.

Ação SetProjectProperties

Essa ação pode criar, atualizar e excluir propriedades do projeto de equipe.

Parâmetros de entrada da ação SetProjectProperties

Para ver um exemplo de como configurar a ação SetProjectProperties, consulte Exemplos.

Ação DeleteTestCase

Essa ação exclui o caso de teste.

Parâmetros de entrada da ação DeleteTestCase

Para ver um exemplo de como configurar a ação DeleteTestCase, consulte Exemplos.

Ação RunPipeline

Essa ação executa um pipeline com a configuração especificada.

Parâmetros de entrada da ação RunPipeline

Para ver um exemplo de como configurar a ação RunPipeline, consulte Exemplos.

Ação CreatePullRequest

Essa ação cria uma solicitação de envio com a configuração especificada.

Parâmetros de entrada da ação CreatePullRequest

Para ver um exemplo de como configurar a ação CreatePullRequest, consulte Exemplos.

Ação UpdatePullRequest

Essa ação atualiza uma solicitação de envio com a configuração especificada.

Parâmetros de entrada da ação UpdatePullRequest

Para ver um exemplo de como configurar a ação UpdatePullRequest, consulte Exemplos.

Ação GetPullRequestCommits

Essa ação recebe os commits da solicitação de envio especificada com a configuração especificada.

Parâmetros de entrada da ação GetPullRequestCommits

Para ver um exemplo de como configurar a ação GetPullRequestCommits, consulte Exemplos.

Ação AddBuildTag

Essa ação adiciona uma tag a um build.

Parâmetros de entrada da ação AddBuildTag

Para ver um exemplo de como configurar a ação AddBuildTag, consulte Exemplos.

Ação DeleteBuildTag

Essa ação exclui uma tag de um build.

Parâmetros de entrada da ação DeleteBuildTag

Para ver um exemplo de como configurar a ação DeleteBuildTag, consulte Exemplos.

Ação DownloadBuildReports

Essa ação faz o download de relatórios de build.

Parâmetros de entrada da ação DownloadBuildReports

Para ver um exemplo de como configurar a ação DownloadBuildReports, consulte Exemplos.

Ação DownloadBuildLogs

Essa ação baixa os registros de build.

Parâmetros de entrada da ação DownloadBuildLogs

Para ver um exemplo de como configurar a ação DownloadBuildLogs, consulte Exemplos.

Ação UpdateUser

Essa ação atualiza os detalhes de um usuário.

Parâmetros de entrada da ação UpdateUser

Para ver um exemplo de como configurar a ação UpdateUser, consulte Exemplos.

Ação CloneTestPlan

Essa ação clona um plano de teste.

Parâmetros de entrada da ação CloneTestPlan

Para ver um exemplo de como configurar a ação CloneTestPlan, consulte Exemplos.

Ação CloneTestSuite

Essa ação clona os detalhes do pacote de testes.

Parâmetros de entrada da ação CloneTestSuite

Para ver um exemplo de como configurar a ação CloneTestSuite, consulte Exemplos.

Ação CloneTestCase

Essa ação clona os detalhes do caso de teste.

Parâmetros de entrada da ação CloneTestCase

Para ver um exemplo de como configurar a ação CloneTestCase, consulte Exemplos.

Ação DeletePullRequestAttachment

Essa ação exclui os detalhes do anexo da solicitação de envio de extração.

Parâmetros de entrada da ação DeletePullRequestAttachment

Para ver um exemplo de como configurar a ação DeletePullRequestAttachment, consulte Exemplos.

Exemplos de ações

Exemplo: criar um item de trabalho

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CreateWorkItem e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CreateWorkItem terá um valor semelhante a este:

[{
"Success": "True"
}]

Para criar várias entidades, como tarefa, épico, história do usuário, caso de teste, recurso e problema, basta modificar o valor do campo "Tipo" no payload de entrada.
Para definir um tipo como épico, defina "Type": "Epic". Da mesma forma, você pode mudar o valor para "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature" ou "Type": "Issue" para criar a respectiva entidade.

Exemplo: atualizar um item de trabalho

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdateWorkItem e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa UpdateWorkItem terá um valor semelhante a este:

[{
"Success": "True"
}]

Exemplo: extrair uma solicitação de envio de um commit

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação GetPullRequestCommits e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa GetPullRequestCommits terá um valor semelhante a este:

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

Exemplo: enviar mudanças para um repositório

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação PushChanges e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa PushChanges terá um valor semelhante a este:

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

Exemplo: fazer o download dos registros de um lançamento

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadReleaseLogs e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DownloadReleaseLogs terá um valor semelhante a este:

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

Exemplo: baixar um anexo de resultado/execução de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadTestAttachment e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DownloadTestAttachment terá um valor semelhante a este:

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

Exemplo: definir propriedades de um projeto

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação SetProjectProperties e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa SetProjectProperties terá um valor semelhante a este:

[ { "Status": "Success" } ]

Exemplo: excluir um caso de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeleteTestCase e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DeleteTestCase terá um valor semelhante a este:

[ { "Status": "Success" } ]

Exemplo: executar um pipeline para um projeto

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação RunPipeline e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa RunPipeline terá um valor semelhante a este:

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

Exemplo: atualizar uma solicitação de envio

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdatePullRequest e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa UpdatePullRequest terá um valor semelhante a este:

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

Exemplo: criar uma solicitação de envio

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CreatePullRequest e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CreatePullRequest terá um valor semelhante a este:

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

Exemplo: receber um commit de solicitação de envio

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação GetPullRequestCommits e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa GetPullRequestCommits terá um valor semelhante a este:

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

Exemplo: adicionar uma tag de build

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação AddBuildTag e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa AddBuildTag terá um valor semelhante a este:

[{ "Status": "Success" }]

Exemplo: excluir uma tag de build

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeleteBuildTag e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DeleteBuildTag terá um valor semelhante a este:

[{ "Status": "Success" }] 

Exemplo: baixar um relatório de build

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadBuildReports e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DownloadBuildReports terá um valor semelhante a este:

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

Exemplo: fazer o download dos registros de build

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadBuildLogs e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DownloadBuildLogs terá um valor semelhante a este:

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

Exemplo: atualizar um usuário

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdateUser e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Update User terá um valor semelhante a este:

[ { "Status": "Success" } ]

Exemplo: clonar um plano de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestPlan e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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 a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CloneTestPlan terá um valor semelhante a este:

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

Exemplo: clonar um pacote de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestSuite e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CloneTestSuite terá um valor semelhante a este:

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

Exemplo: clonar um caso de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestCase e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CloneTestCase terá um valor semelhante a este:

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

Exemplo: excluir um anexo de solicitação de envio

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeletePullRequestAttachment e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Essa ação retorna uma mensagem de confirmação de "DeletePullRequestAttachment". Se a ação for concluída, o parâmetro de resposta connectorOutputPayload da tarefa DeletePullRequestAttachment terá um valor semelhante a este:

[ { "Status": "Success" } ]

Exemplos de operações de entidade

Recuperar todos os painéis em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Dashboards na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com a exigência do cliente. Confira a seção "Observação" abaixo

O valor de filterClause sempre precisa ser transmitido entre aspas simples (') neste formato.
Você pode usar a filterClause para filtrar um determinado conjunto de registros com base em qualquer coluna.

Exemplo: recuperar um único painel usando o ID dele

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Dashboards na lista Entity.
3. Selecione a operação Get e clique em Concluído.
4. Defina o ID da entidade como "2f671e29-e48f-4d26-8869-859e154b5f20", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e digite "2f671e29-e48f-4d26-8869-859e154b5f20" no campo Input Value. Escolha EntityId como variável local.

   O valor do ID da entidade precisa ser transmitido diretamente, como "2f671e29-e48f-4d26-8869-859e154b5f20". Aqui, "2f671e29-e48f-4d26-8869-859e154b5f20" é o valor exclusivo da chave primária, que é transmitido.

   Em alguns casos, transmitir um único ID de entidade pode causar um erro porque a entidade tem duas chaves compostas. Nesses casos, você pode usar a filterClause e transmitir o valor, como id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Exemplo: remover um painel usando o ID

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Dashboards na lista Entity.
3. Selecione a operação Delete e clique em Concluído.
4. Defina o ID da entidade como "2f671e29-e48f-4d26-8869-859e154b5f20", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e digite "2f671e29-e48f-4d26-8869-859e154b5f20" no campo Input Value. Escolha EntityId como variável local.

   Se a entidade tiver duas chaves primárias ou de negócios compostas, em vez de especificar o entityId, defina a filterClause como id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Exemplo: criar um painel em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Dashboard na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar um novo direito de usuário em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Users na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar uma consulta em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Queries na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "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 a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar um pipeline em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Pipelines na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "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 a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": 9 }
   

Exemplo: criar um grupo de implantação em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione DeploymentGroups na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": 139 }
   

Exemplo: criar uma nova configuração de teste em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestPlan na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "Name": "Googlecloud_TestPlan" }
   

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": 106 }
   

Exemplo: criar um conjunto de testes em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestSuite na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": 22264 }
   

Exemplo: criar uma execução de teste em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestRun na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "Name": "TestRun_Googlecloud1"}
   

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": 46 }
   

Exemplo: criar um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Projects na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Projects terá um valor semelhante a este:

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

O ID gerado após a execução da operação "Create" em um projeto não é o ID real do projeto.
Para recuperar os detalhes exatos do projeto, execute a operação "List" com o nome do projeto como uma condição de filtro, como Name= 'Google Project Integration'.

Exemplo: criar uma equipe em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Teams na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "Name": "M new team"}
   

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar um ambiente em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Environments na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": "9" }
   

Exemplo: criar um widget em um painel

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Widgets na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Este exemplo demonstra como adicionar widgets. Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: adicionar um revisor a uma solicitação de envio em um repositório

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione PullRequestReviewers na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar um grupo de variáveis em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione VariableGroups na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   {
     "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 a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {"Id": "12"}
   

Exemplo: criar uma definição de build em um repositório

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione BuildDefinition na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {"Id": "25"}
   

Exemplo: criar um lançamento em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Releases na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   { "Id": "13" }
   

Exemplo: atualizar o nome ou a descrição de uma equipe em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Teams na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade do Teams. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 5285fb98-a1bc-42e1-9668-3c2780061367.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: atualizar uma consulta em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Queries na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   { "Name": "Update Queries" }
   

5. Defina o ID da entidade no Data Mapper como a entidade das consultas. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 81797017-624d-4967-bc85-842a817bff48.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: atualizar um painel em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Dashboard na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   { "Name": " update from googlecloud" }
   

5. Defina o ID da entidade no Data Mapper como a entidade do painel. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 139.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": "139" }
   

Exemplo: atualizar um conjunto de testes em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestSuite na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade do TestSuite. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 22264.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": "22264" }
   

Exemplo: atualizar um grupo de implantação em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione DeploymentGroups na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   { "Name": "Deployment" }
   

5. Defina o ID da entidade no Data Mapper como a entidade do DeploymentGroups. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 138.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": "138" }
   

Exemplo: atualizar um plano de teste em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestPlan na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   { "Name": "TestPlan_Update" }
   

5. Defina o ID da entidade no Data Mapper como a entidade do TestPlan. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 104.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": "104" }
   

Exemplo: atualizar uma execução de teste em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TestRuns na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade do TestRuns. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como 46.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": "46" }
   

Exemplo: atualizar um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Projects na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   { "Name": "Projects Update" }
   

5. Defina o ID da entidade no Data Mapper como a entidade dos projetos. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: atualizar um ambiente em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Environments na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade dos ambientes. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como { "Id": "9" }.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": 9 }
   

Exemplo: atualizar um grupo de variáveis em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione VariableGroups na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   {
     "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. Defina o ID da entidade no Data Mapper como a entidade do VariableGroups. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como { "Id": "12" }.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": 12 }
   

Exemplo: atualizar uma definição de build em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione BuildDefinition na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade da BuildDefinition. Para definir o ID da entidade, clique em Open Data Mapping Editor, insira um valor semelhante ao seguinte no campo Input Value e escolha "EntityId/ConnectorInputPayload/FilterClause" como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   { "Id": 25 }
   

Exemplo: atualizar um revisor de solicitação de envio em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione PullRequestReviewers na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   {"isFlagged": true}
   

5. Defina o ID da entidade no Data Mapper como a entidade do PullRequestReviewers. Para definir o ID da entidade, clique em Open Data Mapping Editor, insira um valor semelhante ao seguinte no campo Input Value e escolha "EntityId/ConnectorInputPayload/FilterClause" como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: atualizar uma versão em um projeto

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Releases na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

5. Defina o ID da entidade no Data Mapper como a entidade das versões. Para definir o ID da entidade, clique em Open Data Mapping Editor, insira um valor semelhante ao seguinte no campo Input Value e escolha "EntityId/ConnectorInputPayload/FilterClause" como variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como {"Id": 13}.

   A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

   {"Id": 13 }