Azure DevOps

O conetor do Azure DevOps permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do Azure DevOps.

Versões suportadas

Este conector suporta as seguintes versões do Azure DevOps.

• Azure DevOps 2022, 2020 e 2019
• Team Foundation Server 2018

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

• Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
• Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
• Conceda as funções de IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que quer usar para o conector.
• Ative os seguintes serviços:
  • secretmanager.googleapis.com (Secret Manager API)
  • connectors.googleapis.com (API Connectors)

  Para saber como ativar serviços, consulte o artigo Ativar serviços. Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

   Aceda à página Ligações

2. Clique em + CRIAR NOVO para abrir a página Criar associação.
3. Na secção Localização, escolha a localização para a ligação.
   1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

   2. Clique em SEGUINTE.
4. Na secção Detalhes da associação, conclua o seguinte:
   1. Conetor: selecione Azure DevOps na lista pendente de conetores disponíveis.
   2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
   3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
   4. Opcionalmente, introduza uma Descrição para a instância de associação.
   5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
   6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
   7. Opcionalmente, configure as definições do nó de associação:
      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

   Nota: só pode personalizar os valores dos nós de associação se for cliente de pagamento conforme o uso.
   8. Inquilino do Azure: indique o nome ou o ID do inquilino do Azure DevOps.
   9. Organização: indique o nome da organização ou da coleção que usa o Azure DevOps.
   10. Esquema: introduza o esquema, como informações, projeto.
   11. Catálogo: introduza o nome do catálogo.
   12. Aplicar transformação: introduza uma lista de transformações separada por vírgulas.
   13. Edição do Azure DevOps: introduza a edição do Azure DevOps.
   14. API Azure DevOps Service: introduza a versão da API REST do Azure DevOps.
   15. URL: indique o URL da instância do Azure DevOps.
   16. Incluir campos personalizados: selecione esta opção para incluir campos personalizados na lista de colunas.
   17. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
   18. Clique em SEGUINTE.
5. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
   1. Tipo de destino: selecione um Tipo de destino.
      • Para especificar o nome de anfitrião ou o endereço IP de destino, selecione Endereço do anfitrião e introduza o endereço no campo Anfitrião 1.
      • Para estabelecer uma ligação privada, selecione Anexo do ponto final e escolha o anexo necessário na lista Anexo do ponto final.
        Nota: para saber como criar uma associação de ponto final, consulte Associação de serviço do PSC e Associação de ponto final. Depois de criar a associação do ponto final, esta fica visível na lista Associação do ponto final.

      Se quiser estabelecer uma ligação pública aos seus sistemas de back-end com segurança adicional, pode considerar configurar endereços IP estáticos de saída para as suas ligações e, em seguida, configurar as regras da firewall para permitir apenas os endereços IP estáticos específicos.

      Para introduzir destinos adicionais, clique em +ADICIONAR DESTINO.

   2. Clique em SEGUINTE.
6. Na secção Autenticação, introduza os detalhes de autenticação.
   1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Azure DevOps:

      • AzureAD
      • Básico

   Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

   2. Clique em SEGUINTE.
7. Rever: reveja os detalhes da ligação e da autenticação.
8. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

• AzureAD
  • ClientID: introduza o ID de cliente da app que criou.
  • Âmbitos: especifique todos os âmbitos separados por vírgulas, como leitura e escrita.
  • Segredo do cliente: introduza o segredo do gestor de segredos que contém o segredo do cliente para a app associada que criou.
  • Versão do Secret: selecione a versão do Secret para o Secret selecionado acima.
  • URL de autorização: indique o URL de autorização do cliente.

• Básico
  • Token de acesso pessoal: introduza o token de acesso pessoal gerado.
  • Versão do Secret: selecione a versão do Secret para o segredo introduzido.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo para os vários campos que configura quando cria a associação.

No Azure DevOps, são usados vários esquemas de dados para organizar e gerir diferentes aspetos de um projeto. Cada esquema centra-se num tipo específico de dados para estruturar as informações de forma eficaz com base nas necessidades do projeto.

• Modelo de dados do projeto: um esquema que define como os dados relacionados com o projeto, como itens, repositórios, pipelines e equipas, são organizados, associados e geridos no Azure DevOps.
• Modelo de dados de informações: um esquema que define como os artefactos de documentação, metadados e comunicação são estruturados, armazenados e acedidos nos projetos do Azure DevOps.
• Modelo de dados do repositório: um esquema que define como os repositórios de código, os ramos, as confirmações, os pedidos de obtenção e os metadados relacionados são organizados e geridos no Azure DevOps.
• Modelo de dados do Analytics: um esquema que capta e organiza dados históricos e em tempo real do Azure DevOps para relatórios, painéis de controlo e estatísticas avançadas.
• Todos os modelos de dados: uma única associação que fornece acesso a todos os modelos de dados numa única associação.

Nome do campo	Modelo de informações	Modelo de projeto	Modelo de repositório	Modelo do Analytics	Todos os modelos	Ligação do AzureAD
Localização	europe-west1	europe-west1	europe-west1	europe-west1	asia-east1	europe-west1
Conetor	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps
Versão do conetor	1	1	1	1	1	1
Nome da ligação	azuredevops-informationmodel	azuredevops-projectmodel	azuredevops-repositorymodel	azuredevops-analyticsmodel	devops	azuredevops-oauth
Ative o Cloud Logging	Sim	Sim	Sim	Sim	Sim	Sim
Nível de registo	Depurar	Depurar	Depurar	Depurar	Depurar	Depurar
Conta de serviço	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount
Inquilino do Azure	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id
Organização	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name
Esquema	Informações	Projeto	Repository__RepositoryId	Google Analytics		Projeto
Catálogo	DevOps	Project_ProjectId	Project_ProjectId	Project_ProjectId		Project_ProjectId
Azure Dev Ops Edition	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online
Azure Dev Ops Service API	6.0	6.0	6.0	6.0	6.0	6.0
Inclua campos personalizados	Sim	Sim	Sim	Sim	Sim	Sim
CustomizedDefaultCatalogName	CustomizedDefaultCatalogName=Google				CustomizedDefaultCatalogName=Google
Número mínimo de nós	2	2	2	2	2	2
Número máximo de nós	50	50	50	50	50	50
Autenticação	Sim	Sim	Sim	Sim	Sim	Sim
Básico	Sim	Sim	Sim	Sim	Sim
Chave da API	Símbolo da API fornecido pela sua app	Símbolo da API fornecido pela sua app	Símbolo da API fornecido pela sua app	Símbolo da API fornecido pela sua app	Símbolo da API fornecido pela sua app
Versão do Secret	1	1	1	1	1	1
AzureAD						Sim
ID do cliente						Client_Id
Valor do segredo do cliente						Valor do segredo do cliente
Âmbitos						user_impersonation
URL de autorização						https://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

Pode usar as seguintes propriedades de associação para gerir os dados obtidos do Azure DevOps.

Catálogo

Esta propriedade especifica o nome ou o ID do projeto ao qual quer estabelecer ligação. Para obter uma lista de IDs e nomes de projetos, execute uma consulta SELECT na tabela Projects.

• Para consultar dados de um projeto específico, defina Catálogo para o nome do projeto ou o respetivo ID 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, pode usar qualquer nome em vez de Devops.

Esquema

Esta propriedade especifica o esquema a usar. Os esquemas disponíveis dependem do repositório especificado. Para obter uma lista de IDs e nomes de repositórios, execute uma consulta SELECT na tabela Repositories.

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

Para criar uma aplicação no portal do Azure/MS Entra e usar todos os parâmetros da aplicação criada ao nível da ligação do Azure AD, consulte o Início rápido: registe uma aplicação na plataforma de identidade da Microsoft e Registe uma aplicação cliente no Microsoft Entra ID.

Limitações do sistema

O conetor do Azure DevOps pode processar um máximo de 6 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Nota: o número de nós de conectores de integração é dimensionado automaticamente de forma dinâmica com base na sua utilização. No entanto, se quiser reservar capacidade para grandes volumes sem esperar pela escalabilidade automática, pode ajustar o valor mínimo de nós para uma ligação. São necessários mais nós para processar mais transações para uma associação. Por outro lado, são necessários menos nós se uma associação processar menos transações. Para configurar os valores dos nós, faça o seguinte:

• Se for cliente de pagamento conforme o uso, configure o valor mínimo e máximo do nó na página de edição da associação.
• Se for cliente com base numa subscrição, contacte o apoio técnico.

O número máximo de transações que um nó pode processar depende de vários fatores. Assim, antes de ajustar os nós mínimos para um melhor débito, é recomendável verificar se os seus sistemas de back-end estão configurados de forma ideal para processar o tráfego necessário.

Use a associação do Azure DevOps numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

• Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
• Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Ações

Esta secção apresenta as ações suportadas pelo conetor. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação CreateWorkItem

Esta ação cria um item de trabalho.

Parâmetros de entrada da ação CreateWorkItem

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
Tipo	String	Sim	O tipo de item de trabalho a criar.
De	String	Não	O caminho de origem da operação de cópia ou movimento.
Op	String	Sim	A operação de patch que modifica o item de trabalho, como adicionar, copiar, mover, remover, substituir ou testar.
Caminho	String	Sim	O caminho para a operação.
Valor	String	Sim	O valor da operação.

Por exemplo, para saber como configurar a ação CreateWorkItem, consulte os exemplos.

Ação UpdateWorkItem

Introduza os parâmetros da ação UpdateWorkItem

Esta ação atualiza um item de trabalho.

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
WorkItemId	String	Sim	O ID do item de trabalho.
De	String	Não	O caminho de origem da operação de cópia ou movimento.
Op	String	Sim	A operação de patch que modifica o item de trabalho, como adicionar, copiar, mover, remover, substituir ou testar.
Caminho	String	Sim	O caminho para a operação.
Valor	String	Sim	O valor da operação.

Por exemplo, para saber como configurar a ação UpdateWorkItem, consulte os exemplos.

Ação GetPullRequestCommits

Esta ação obtém as confirmações do pedido de envio especificado.

Parâmetros de entrada da ação GetPullRequestCommits

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID ou o nome do repositório. Se o ProjectId não estiver definido, tem de definir o RepositoryId.
PullRequestId	String	Sim	O ID do pedido de obtenção.

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

Por exemplo, para saber como configurar a ação GetPullRequestCommits, consulte os exemplos.

Ação PushChanges

Esta ação envia alterações para um repositório na sua instância do Azure DevOps.

Introduza os parâmetros da ação PushChanges

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID ou o nome do repositório. Se o ProjectId não estiver definido, tem de definir o RepositoryId.
BranchRefName	String	Sim	O nome da ramificação do Git.
OldObjectId	String	Sim	O ID do objeto atual da ramificação.
CommitComment	String	Sim	Especifica o comentário incluído na confirmação.
ChangesAggregate	String	Sim	Um objeto agregado que contém detalhes de cada alteração na confirmação.

Por exemplo, para saber como configurar a ação PushChanges, consulte os exemplos.

Ação DownloadReleaseLogs

Esta ação transfere os registos da versão específica.

Parâmetros de entrada da ação DownloadReleaseLogs

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
ReleaseId	Número inteiro	Sim	O ID do lançamento.
FileLocation	String	Não	A localização do ficheiro.
Codificação	String	Não	O tipo de codificação de entrada FileData. Os valores permitidos são NONE e BASE64. O valor predefinido é BASE64.
FileStream	String	Não	Uma instância de uma stream de saída onde os dados dos ficheiros são escritos. Apenas usado se FileLocation não for fornecido.

Por exemplo, para saber como configurar a ação DownloadReleaseLogs, consulte os exemplos.

Ação DownloadTestAttachment

Esta ação transfere um anexo de resultado/execução de teste.

Introduza os parâmetros da ação DownloadTestAttachment

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
ResultId	Número inteiro	Não	O ID do resultado do teste.
RunId	Número inteiro	Sim	O ID da execução do teste.
AttachmentId	String	Não	O ID do anexo.
FileLocation	String	Não	A localização do ficheiro.
Codificação	String	Não	O tipo de codificação de entrada FileData. Os valores permitidos são NONE e BASE64. O valor predefinido é BASE64.
FileStream	String	Não	Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Apenas usado se FileLocation não for fornecido.

Por exemplo, para saber como configurar a ação DownloadTestAttachment, consulte os exemplos.

Ação SetProjectProperties

Esta ação pode criar, atualizar e eliminar propriedades de projetos de equipa.

Parâmetros de entrada da ação SetProjectProperties

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
De	String	Não	O caminho de origem para a operação de movimento ou cópia.
Op	String	Sim	A operação de patch que modifica as propriedades do projeto, como adicionar, copiar, mover, remover, substituir ou testar.
Caminho	String	Sim	O caminho para a operação.
Valor	String	Sim	O valor da operação.

Por exemplo, para saber como configurar a ação SetProjectProperties, consulte os exemplos.

Ação DeleteTestCase

Esta ação elimina o exemplo de teste.

Parâmetros de entrada da ação DeleteTestCase

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
TestcaseId	Número inteiro	Sim	O ID do conjunto de testes.

Por exemplo, para saber como configurar a ação DeleteTestCase, consulte os exemplos.

Ação RunPipeline

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

Introduza os parâmetros da ação RunPipeline

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
PipelineId	Número inteiro	Sim	O ID do pipeline.
PipelineVersion	Número inteiro	Não	A versão do pipeline a executar.
Recursos	String	Sim	Os recursos necessários para a execução.
Variáveis	String	Não	A lista de variáveis e valores para utilização durante a execução do pipeline.
StagesToSkip	String	Não	A matriz de nomes artísticos a ignorar.
TemplateParameters	String	Não	Um mapa de chave-valor de parâmetros usados durante a execução do pipeline.

Por exemplo, para saber como configurar a ação RunPipeline, consulte os exemplos.

Ação CreatePullRequest

Esta ação cria um pedido de obtenção com a configuração especificada.

Parâmetros de entrada da ação CreatePullRequest

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID do repositório.
Título	String	Sim	Título do pedido de envio.
Descrição	String	Não	A descrição do pedido de envio.
SourceRefName	String	Sim	O nome da ramificação de origem do pedido de obtenção.
TargetRefName	String	Sim	O nome do ramo de destino do pedido de envio.
CompletionOptions	String	Não	Opções que afetam a forma como o pedido de obtenção vai ser unido quando estiver concluído.
IsDraft	Booleano	Não	Pedido de envio de rascunho / trabalho em curso.
Etiquetas	String	Não	As etiquetas associadas ao pedido de obtenção.
MergeOptions	String	Não	Opções usadas quando a união do pedido de obtenção é executada.
Revisores	String	Não	Uma lista de revisores no pedido de envio.
WorkItemRefs	String	Não	Quaisquer referências de itens de trabalho associadas a este pedido de obtenção.

Por exemplo, para saber como configurar a ação CreatePullRequest, consulte os exemplos.

Ação UpdatePullRequest

Esta ação atualiza um pedido de obtenção com a configuração especificada.

Parâmetros de entrada da ação UpdatePullRequest

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID do repositório.
PullRequestId	String	Sim	O ID do pedido de obtenção.
Título	String	Não	Título do pedido de envio.
Descrição	String	Não	A descrição do pedido de envio.
Estado	String	Não	Estado do pedido de envio.
TargetRefName	String	Não	O nome do ramo de destino do pedido de envio. Apenas disponível quando a funcionalidade de reorientação de RP está ativada.
CompletionOptions	String	Não	Opções que afetam a forma como o pedido de obtenção vai ser unido quando estiver concluído.
MergeOptions	String	Não	Opções usadas quando a união do pedido de obtenção é executada.
AutoCompleteSetById	String	Não	ID do utilizador que ativou o preenchimento automático.

Por exemplo, para saber como configurar a ação UpdatePullRequest, consulte os exemplos.

Ação GetPullRequestCommits

Esta ação obtém as confirmações do pedido de envio especificado com a configuração especificada.

Parâmetros de entrada da ação GetPullRequestCommits

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID do repositório.
PullRequestId	String	Sim	ID do pedido de envio.

Por exemplo, para saber como configurar a ação GetPullRequestCommits, consulte os exemplos.

Ação AddBuildTag

Esta ação adiciona uma etiqueta a uma compilação.

Parâmetros de entrada da ação AddBuildTag

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
BuildId	String	Sim	O ID da compilação.
Etiqueta	String	Sim	A etiqueta a adicionar à compilação.

Por exemplo, para saber como configurar a ação AddBuildTag, consulte os exemplos.

Ação DeleteBuildTag

Esta ação elimina uma etiqueta de uma compilação.

Introduza os parâmetros da ação DeleteBuildTag

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
BuildId	String	Sim	O ID da compilação.
Etiqueta	String	Sim	A etiqueta a remover da compilação.

Por exemplo, para saber como configurar a ação DeleteBuildTag, consulte os exemplos.

Ação DownloadBuildReports

Esta ação transfere relatórios de compilação.

Introduza os parâmetros da ação DownloadBuildReports

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
BuildId	Número inteiro	Sim	O ID da compilação.
FileLocation	String	Não	A localização do ficheiro.
Codificação	String	Não	O tipo de codificação de entrada FileData. Os valores permitidos são NONE e BASE64. O valor predefinido é BASE64.
FileStream	String	Não	Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Apenas usado se FileLocation não for fornecido.

Por exemplo, para saber como configurar a ação DownloadBuildReports, consulte os exemplos.

Ação DownloadBuildLogs

Esta ação transfere registos de compilação.

Parâmetros de entrada da ação DownloadBuildLogs

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Sim	O ID do projeto do Azure DevOps.
BuildId	Número inteiro	Sim	ID da compilação.
LogId	Número inteiro	Sim	O ID do registo.
StartLine	Número inteiro	Não	A linha de partida da construção.
EndLine	Número inteiro	Não	A linha final da compilação.
FileLocation	String	Não	A localização do ficheiro.
Codificação	String	Não	O tipo de codificação de entrada FileData. Os valores permitidos são NONE e BASE64. O valor predefinido é BASE64.
FileStream	String	Não	Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Apenas usado se FileLocation não for fornecido.

Por exemplo, para saber como configurar a ação DownloadBuildLogs, consulte os exemplos.

Ação UpdateUser

Esta ação atualiza os detalhes de um utilizador.

Introduza os parâmetros da ação UpdateUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
Id do utilizador	String	Sim	O ID do utilizador.
De	String	Não	O caminho de origem para a operação de movimento ou cópia.
Op	String	Sim	A operação de patch que modifica o utilizador, como adicionar, copiar, mover, remover, substituir ou testar.
Caminho	String	Não	O caminho para a operação.
Valor	String	Não	O valor da operação.

Por exemplo, para saber como configurar a ação UpdateUser, consulte os exemplos.

Ação CloneTestPlan

Esta ação clona um plano de teste.

Introduza os parâmetros da ação CloneTestPlan

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Não	O ID do projeto do Azure DevOps.
DeepClone	Booleano	Não	Clona também todos os casos de teste associados.
CloneRequirements	Booleano	Não	Se estiver definida como verdadeira, os requisitos são clonados. O valor predefinido é false.
CopyAllSuites	Booleano	Não	Copia todos os conjuntos de um plano de origem.
CopyAncestorHierarchy	Booleano	Não	Copiar hierarquia de antecessores.
DestinationWorkItemType	String	Não	Nome do tipo de item de trabalho do clone.
OverrideParameters	String	Não	Pares de chave-valor em que o valor de cada chave é substituído pelo valor especificado.
RelatedLinkComment	String	Não	Adiciona um comentário ao plano de teste clonado.
DestinationPlanAreaPath	String	Não	Área do plano de teste.
DestinationPlanBuildId	String	Não	Criar para ser testada.
DestinationPlanDescription	String	Não	A descrição do plano de teste.
DestinationPlanEndDate	String	Não	A data de fim do plano de teste.
DestinationPlanIteration	String	Não	O caminho de iteração do plano de teste.
DestinationPlanName	String	Sim	O nome do plano de teste.
DestinationPlanOwnerId	String	Não	O ID do utilizador proprietário do plano de teste.
DestinationPlanProject	String	Não	O nome do projeto do destino.
DestinationPlanStartDate	String	Não	A data de início do plano de teste.
DestinationPlanState	String	Não	O estado do plano de teste.
DestinationPlanSync	Booleano	Não	Especifica como os testes duplicados em conjuntos num plano de teste se devem comportar.
SourceTestPlanId	Número inteiro	Sim	O ID do plano de teste de origem.
SourceTestPlanSuiteId	Número inteiro	Não	Uma lista de IDs de conjuntos de testes separados por vírgulas a clonar no plano de teste de origem.

Por exemplo, para saber como configurar a ação CloneTestPlan, consulte os exemplos.

Ação CloneTestSuite

Esta ação clona os detalhes do conjunto de testes.

Introduza os parâmetros da ação CloneTestSuite

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Não	O ID do projeto do Azure DevOps.
DeepClone	Booleano	Não	Clona todos os casos de teste associados.
CloneRequirements	Booleano	Não	Se estiver definida como verdadeira, os requisitos são clonados. O valor predefinido é false.
CopyAllSuites	Booleano	Não	Copia todos os conjuntos de um plano de origem.
CopyAncestorHierarchy	Booleano	Não	Copia a hierarquia principal.
DestinationWorkItemType	String	Não	O nome do tipo de item de trabalho para o clone.
OverrideParameters	String	Não	Pares de chave-valor em que o valor de cada chave é substituído pelo valor especificado.
RelatedLinkComment	String	Não	Adiciona um comentário ao conjunto de testes clonado.
DestinationTestSuiteId	Número inteiro	Sim	O ID do conjunto de testes de destino.
DestinationProjectName	String	Não	O nome do projeto no destino.
SourceTestSuiteId	Número inteiro	Sim	O ID do conjunto de testes de origem.

Por exemplo, para saber como configurar a ação CloneTestSuite, consulte os exemplos.

Ação CloneTestCase

Esta ação clona os detalhes do exemplo de teste.

Introduza os parâmetros da ação CloneTestCase

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Não	O ID do projeto do Azure DevOps.
IncludeAttachments	Booleano	Não	Inclui anexos de um teste de exemplo se estiver definido como verdadeiro. O valor predefinido está definido como falso.
IncludeLinks	Booleano	Não	Se estiver definida como verdadeira, os links são incluídos. O valor predefinido é false.
RelatedLinkComment	String	Não	Para adicionar um comentário ao exemplo de teste clonado.
DestinationTestPlanId	Número inteiro	Sim	O ID do plano de teste de destino.
DestinationTestSuiteId	Número inteiro	Sim	O ID do conjunto de testes de destino.
SourceTestPlanId	Número inteiro	Sim	O ID do plano de teste de origem.
SourceTestSuiteId	Número inteiro	Sim	O ID do conjunto de testes de origem.
TestCaseId	Número inteiro	Sim	Uma lista de IDs de casos de teste separados por vírgulas a clonar.

Por exemplo, para saber como configurar a ação CloneTestCase, consulte os exemplos.

Ação DeletePullRequestAttachment

Esta ação elimina os detalhes dos anexos de pedidos de obtenção.

Parâmetros de entrada da ação DeletePullRequestAttachment

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ProjectId	String	Não	O ID do projeto do Azure DevOps.
RepositoryId	String	Sim	O ID do repositório.
PullRequestId	Número inteiro	Sim	O ID do pedido de obtenção.
FileName	String	Sim	O nome do anexo.

Por exemplo, para saber como configurar a ação DeletePullRequestAttachment, consulte os 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, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:CreateWorkItemconnectorOutputPayload

[{
"Success": "True"
}]

Para criar várias entidades, como uma tarefa, uma épica, uma história do utilizador, um exemplo de teste, uma funcionalidade e um problema, só tem de modificar o valor do campo "Tipo" no payload de entrada.
Para definir um Tipo como Épico, pode definir "Type": "Epic". Da mesma forma, pode alterar o valor para "Tipo": "Tarefa", "Tipo": "História do utilizador", "Tipo": "Caso de teste", "Tipo": "Funcionalidade" ou "Tipo": "Problema" para criar a entidade respetiva.

Exemplo: atualize um item de trabalho

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdateWorkItem e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:UpdateWorkItemconnectorOutputPayload

[{
"Success": "True"
}]

Exemplo: obter um pedido de envio de uma confirmação

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação GetPullRequestCommits e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:GetPullRequestCommitsconnectorOutputPayload

[ { "CommitId": "7299b6623d7d146751d8cf280af301f9a345ff05", "AuthorName": "jeffersonloveshi.k", "AuthorEmail": "[e-mail]", "AuthoredDate": "2024-08-12 11:25:23.0", "CommitterName": "lakshminarayana.k", "CommitterEmail": "[e-mail]", "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 alterações para um repositório

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação PushChanges e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:PushChangesconnectorOutputPayload

[ { "NewObjectId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitTreeId": "7e7394dcfc5b4d4cf2c8c21d70a96fe34f8eaf3e", "AuthorName": "Charlie Cruz", "AuthorEmail": "[e-mail]", "AuthoredDate": "2024-11-19 07:04:42.0", "CommitterName": "Charlie Cruz", "CommitterEmail": "[e-mail]", "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: transfira os registos de um lançamento

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadReleaseLogs e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DownloadReleaseLogsconnectorOutputPayload

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

Exemplo: transferir 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, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DownloadTestAttachmentconnectorOutputPayload

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

Exemplo: defina as propriedades de um projeto

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação SetProjectProperties e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:SetProjectPropertiesconnectorOutputPayload

[ { "Status": "Success" } ]

Exemplo: elimine um registo de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeleteTestCase e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DeleteTestCaseconnectorOutputPayload

[ { "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, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:RunPipelineconnectorOutputPayload

[ { "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: atualize um pedido de obtenção

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdatePullRequest e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:UpdatePullRequestconnectorOutputPayload

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

Exemplo: crie um pedido de obtenção

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CreatePullRequest e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:CreatePullRequestconnectorOutputPayload

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

Exemplo: obtenha um commit de um pedido de envio

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação GetPullRequestCommits e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:GetPullRequestCommitsconnectorOutputPayload

[ { "CommitId": "ebb720c5b93c52341cb86ccfb42258bb562a8406", "AuthorName": "dani.dana", "AuthorEmail": "[e-mail]", "AuthoredDate": "2024-11-26 11:24:19.0", "CommitterName": "dani.dana", "CommitterEmail": "[e-mail]", "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": "[e-mail]", "AuthoredDate": "2024-11-26 11:23:01.0", "CommitterName": "dani.dana", "CommitterEmail": "[e-mail]", "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": "[e-mail]", "AuthoredDate": "2024-11-26 11:21:59.0", "CommitterName": "dani.dana", "CommitterEmail": "[e-mail]", "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": "[e-mail]", "AuthoredDate": "2024-11-26 11:19:29.0", "CommitterName": "Alex amal", "CommitterEmail": "[e-mail]", "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: adicione uma etiqueta de compilação

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação AddBuildTag e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:AddBuildTagconnectorOutputPayload

[{ "Status": "Success" }]

Exemplo: elimine uma etiqueta de compilação

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeleteBuildTag e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DeleteBuildTagconnectorOutputPayload

[{ "Status": "Success" }] 

Exemplo: transfira um relatório de compilação

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadBuildReports e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DownloadBuildReportsconnectorOutputPayload

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

Exemplo: transferir registos de compilação

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadBuildLogs e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:DownloadBuildLogsconnectorOutputPayload

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

Exemplo: atualize um utilizador

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UpdateUser e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:Update UserconnectorOutputPayload

[ { "Status": "Success" } ]

Exemplo: clone um plano de teste

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestPlan e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:CloneTestPlanconnectorOutputPayload

[ { "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": "[e-mail]", "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": "[e-mail]", "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: clone um conjunto de testes

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestSuite e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:CloneTestSuiteconnectorOutputPayload

[ { "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: clone um conjunto de testes

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CloneTestCase e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 da tarefa terá um valor semelhante ao seguinte:CloneTestCaseconnectorOutputPayload

[ { "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: elimine um anexo de pedido de obtenção

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeletePullRequestAttachment e, de seguida, clique em Concluído.
3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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" }
   

Esta ação devolve uma mensagem de confirmação de DeletePullRequestAttachment. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DeletePullRequestAttachment terá um valor semelhante ao seguinte:

[ { "Status": "Success" } ]

Exemplos de operações de entidades

Recupere todos os painéis de controlo num 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, de seguida, clique em Concluído.
4. Na secção Task Input da tarefa Connectors, pode definir o filterClause de acordo com o requisito do cliente. Verifique a secção de notas abaixo

O valor de filterClause deve ser sempre transmitido entre aspas simples (') neste formato.
Pode usar o filterClause para filtrar um determinado conjunto de registos com base em quaisquer colunas.

Exemplo: obtenha um único painel de controlo através do respetivo ID

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, de seguida, 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 secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "2f671e29-e48f-4d26-8869-859e154b5f20" no campo Valor de entrada e escolha EntityId como variável local.

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

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

Exemplo: remova um painel de controlo através do respetivo 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, de seguida, 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 secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "2f671e29-e48f-4d26-8869-859e154b5f20" no campo Valor de entrada e escolha EntityId como variável local.

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

Exemplo: crie um novo painel de controlo num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: crie uma nova autorização de utilizador num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

   { "UserPrincipalName": "[e-mail]", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
   

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

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

Exemplo: crie uma nova consulta num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: crie um novo pipeline num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": 9 }
   

Exemplo: crie um grupo de implementação num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": 139 }
   

Exemplo: crie uma nova configuração de teste num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": 106 }
   

Exemplo: crie um conjunto de testes num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": 22264 }
   

Exemplo: crie uma execução de teste num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": 46 }
   

Exemplo: criar um novo 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 da tarefa ProjectsconnectorOutputPayload terá um valor semelhante ao seguinte:

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

O ID gerado após a execução da operação Create num projeto não é o ID do projeto real.
Para obter os detalhes exatos do projeto, tem de executar a operação List com o nome do projeto como condição de filtro, como Name= "Google Project Integration".

Exemplo: crie uma equipa num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: crie um ambiente num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": "9" }
   

Exemplo: crie um novo widget num painel de controlo

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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 da tarefa do conector tem um valor semelhante ao seguinte:connectorOutputPayload

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

Exemplo: adicione um revisor a um pedido de obtenção num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: crie um grupo de variáveis num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   {"Id": "12"}
   

Exemplo: crie uma nova definição de compilação num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   {"Id": "25"}
   

Exemplo: crie um lançamento num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

   { "Id": "13" }
   

Exemplo: atualize o nome ou a descrição de uma equipa num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade do Teams. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

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

Exemplo: atualize uma consulta num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade das consultas. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

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

Exemplo: atualize um painel de controlo num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade do painel de controlo. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": "139" }
   

Exemplo: atualize um conjunto de testes num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade do TestSuite. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": "22264" }
   

Exemplo: atualize um grupo de implementação num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade dos DeploymentGroups. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": "138" }
   

Exemplo: atualize um plano de teste num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade do TestPlan. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": "104" }
   

Exemplo: atualizar uma execução de teste num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade de TestRuns. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": "46" }
   

Exemplo: atualize 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade dos projetos. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

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

Exemplo: atualize um ambiente num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade dos ambientes. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": 9 }
   

Exemplo: atualize um grupo de variáveis num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade dos VariableGroups. Para definir o ID da entidade, clique em Open Data Mapping Editor e, em seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": 12 }
   

Exemplo: atualize uma definição de compilação num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade de BuildDefinition. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   { "Id": 25 }
   

Exemplo: atualize um revisor de pedido de obtenção num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 mapeador de dados para a entidade de PullRequestReviewers. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   Em vez de especificar o entityId, 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 devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

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

Exemplo: atualize um lançamento num 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, de seguida, clique em Concluído.
4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 Mapeador de dados para a entidade dos lançamentos. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

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

   {"Id": 13 }
   

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?

• Compreenda como suspender e retomar uma associação.
• Compreenda como monitorizar a utilização do conector.
• Compreenda como ver os registos do conetor.