Azure DevOps módulos
Em um cenário Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam Azure DevOps, bem como conectá-los a vários aplicativos e serviços de terceiros.
Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo.
Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.
Requisitos de acesso
Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
| Pacote do Adobe Workfront | Qualquer |
| Licença do Adobe Workfront |
Novo: Padrão Ou Atual: trabalho ou superior |
| Licença do Adobe Workfront Fusion** |
Atual: nenhum requisito de licença do Workfront Fusion Ou Herdados: Automação e integração do Workfront Fusion for Work |
| Produto |
Novo:
Ou Atual: sua organização deve comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Pré-requisitos
Para usar módulos do Azure DevOps, você deve ter uma conta DevOps do Azure.
Informações da API Azure DevOps
O conector DevOps do Azure usa o seguinte:
| Versão da API | v5.1 |
| Tag da API | v1.29.33 |
Conectar Azure DevOps a Workfront Fusion
-
Adicione um módulo Azure DevOps ao seu cenário.
-
Clique em Adicionar ao lado do campo Conexão.
-
No campo Tipo de Conexão, selecione o tipo de conexão que deseja usar.
NOTEO Azure DevOps (EntraApp) permite solicitar todos os escopos para a conexão. -
Preencha os seguintes campos:
Nome da ConexãoInsira um nome para a conexão que você está criando.OrganizaçãoDigite o nome da organização sob a qual você criou o aplicativo Azure DevOps.ID do AplicativoInsira a ID do aplicativo DevOps ao qual você está se conectando.Segredo do ClienteInsira o segredo do cliente para os aplicativos DevOps aos quais você está se conectando.Solicitar Todos os EscoposSe você estiver usando o tipo de conexão Azure DevOps (EntraApp), habilite essa opção para solicitar todos os escopos para a conexão. -
Para inserir uma ID de Aplicativo DevOps do Azure ou um Segredo do Cliente, clique em Mostrar configurações avançadas e insira-as nos campos abertos.
-
Clique em Continuar para concluir a configuração da conexão e continuar criando seu cenário.
DevOps do Azure módulos e seus campos
Ao configurar módulos do Azure DevOps, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Azure DevOps adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.
Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.
Acionadores
Fique atento aos itens de trabalho
Este módulo de disparador instantâneo executa um cenário quando um registro é adicionado, atualizado ou excluído no DevOps do Azure.
O módulo retorna quaisquer campos padrão associados ao registro, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Selecione ou adicione um webhook para o módulo.
Para obter mais informações sobre webhooks em módulos de acionador, consulte Acionadores instantâneos (webhooks).
Para obter informações sobre como criar um webhook, consulte Webhooks.
Ações
Criar um registro
Este módulo de ação cria um novo projeto ou item de trabalho.
O módulo gera a ID do objeto para o item de trabalho recém-criado ou o URL e o código de status de um projeto recém-criado.
Selecione se deseja criar um item de trabalho ou um projeto.
-
Projeto
Preencha os seguintes campos:
-
Name: Insira ou mapeie um nome para o novo projeto.
-
Descrição: Insira ou mapeie uma descrição para o novo projeto.
-
Visibility: Selecione se você deseja que seu projeto seja público ou privado. Os usuários devem estar conectados à sua organização e ter acesso ao projeto para interagir com um projeto privado. Os projetos públicos estão visíveis para usuários que não estão conectados à sua organização.
-
Controle de Versão: Selecione se você deseja que o projeto use Git ou Controle de Versão do Team Foundation (TFCV) para controle de versão.
-
Processo de item de trabalho: selecione o processo de trabalho que deseja usar para o projeto. As opções são Básico, Scrum, Integração de Modelo de Maturidade de Recursos (CMMI) e Agile.
Para obter mais informações sobre Azure DevOps processos, consulte Processos e modelos de processo padrão na Documentação Azure DevOps.
-
-
Item de trabalho
Preencha os seguintes campos:
-
Projeto: Selecione o projeto no qual deseja criar o item de trabalho.
-
Tipo de item de trabalho: selecione o tipo de item de trabalho que deseja criar.
-
Outros campos: nesses campos, insira o valor que você deseja que o item de trabalho tenha para uma determinada propriedade. Os campos disponíveis dependem do tipo de item de trabalho.
-
Chamada de API personalizada
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API Azure DevOps. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Azure DevOps.
Ao configurar esse módulo, os campos a seguir são exibidos.
Insira o URL relativo ao qual você deseja se conectar para esta chamada de API.
Exemplo: {organization}/_apis[/{area}]/{resource}
Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.
Por exemplo, {"Content-type":"application/json"}
Adicione a consulta da chamada à API na forma de um objeto JSON padrão.
Por exemplo: {"name":"something-urgent"}
Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.
Nota:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Baixar um anexo
Este módulo de ação baixa um anexo.
O módulo retorna o conteúdo do arquivo do anexo.
Vincular itens de trabalho
Esse módulo de ação vincula dois itens de trabalho e define a relação entre eles.
Defina a relação entre os itens de trabalho que deseja vincular.
Para obter mais informações, consulte o Guia de referência para tipos de link na Documentação do Azure DevOps.
Ler registro
Este módulo de ação lê dados de um único registro em Azure DevOps.
Especifique a ID do registro.
O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Selecione se você deseja ler um projeto ou um item de trabalho
-
Projeto: Selecione o projeto que você deseja ler.
-
Item de trabalho: selecione o projeto que contém o item de trabalho que você deseja ler e selecione o tipo de item de trabalho.
Atualizar um item de trabalho
Este módulo de ação atualiza um item de trabalho existente usando sua ID.
O módulo retorna a ID do item de trabalho atualizado.
Carregar um anexo
Este módulo de ação carrega um arquivo e o anexa a um item de trabalho.
O módulo retorna a ID do anexo e um URL de download para o anexo.
Pesquisas
Listar itens de trabalho
Este módulo de ação recupera todos os itens de trabalho de um tipo específico em um projeto Azure DevOps.
O módulo retorna a ID do item de trabalho principal e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.