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:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
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:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

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 connect-azure-devops-to-workfront-fusion

  1. Adicione um módulo Azure DevOps ao seu cenário.

  2. Clique em Add ao lado do campo Connection.

  3. No campo Connection Type, selecione Azure DevOps.

    note important
    IMPORTANT
    O tipo de conexão Azure DevOps (Request All Scopes) será descontinuada em breve. Portanto, não recomendamos usá-lo.
  4. Preencha os seguintes campos:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Insira um nome para a conexão que você está criando.
    Organization Digite o nome da organização sob a qual você criou o aplicativo Azure DevOps.
  5. 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.

  6. Clique em Continue para concluir a configuração da conexão e continuar criando seu cenário.

Azure DevOps 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.

Alternância de mapa

Acionadores

Watch for work items

Este módulo de disparador instantâneo executa um cenário quando um registro é adicionado, atualizado ou excluído em Azure DevOps.

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.

Webhook

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

Create a record

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Record type

Selecione se deseja criar um item de trabalho ou um projeto.

  • Project

    Preencha os seguintes campos:

    • Name: insira ou mapeie um nome para o novo projeto.

    • Description: insira ou mapeie uma descrição para o novo projeto.

    • Visibility: selecione se deseja que o 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.

    • Version control: selecione se deseja que o projeto use Git ou Team Foundation Version Control (TFCV) para controle de versão.

    • Work item process: selecione o processo de trabalho que deseja usar para o projeto. As opções são Basic, Scrum, Capability Maturity Model Integration (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.

  • Work item

    Preencha os seguintes campos:

    • Project: selecione o projeto no qual deseja criar o item de trabalho.

    • Work item type: selecione o tipo de item de trabalho que deseja criar.

    • Other fields: 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.

Custom API Call

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Base URL
Selecione ou mapeie a URL base que você usa para se conectar à sua conta Azure DevOps
Relative URL

Insira o URL relativo ao qual você deseja se conectar para esta chamada de API.

Exemplo: {organization}/_apis[/{area}]/{resource}

API Version
Selecione ou mapeie a versão da API Azure DevOps à qual você deseja se conectar para esta chamada de API. Se nenhuma versão for selecionada, o Workfront Fusion se conectará ao Azure DevOps API versão 5.1.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

Query String

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

Por exemplo: {"name":"something-urgent"}

Body

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.

Download an attachment

Este módulo de ação baixa um anexo.

O módulo retorna o conteúdo do arquivo do anexo.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Attachment URL
Insira ou mapeie o URL do anexo que você deseja baixar.

Esse módulo de ação vincula dois itens de trabalho e define a relação entre eles.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Work item ID
Insira ou mapeie a ID do item de trabalho principal ao qual você deseja vincular outro item de trabalho.
Linked work item ID
Insira ou mapeie a ID do item de trabalho que você deseja vincular ao item de trabalho principal.
Link Type

Defina a relação entre os itens de trabalho que deseja vincular.

Para obter mais informações, consulte Guia de referência para tipos de link na Documentação Azure DevOps.

Comment
Insira ou mapeie o texto de um comentário. Isso é útil para explicar o raciocínio ou a intenção do link.

Read record

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Record type

Selecione se você deseja ler um projeto ou um item de trabalho

  • Project: selecione o projeto que deseja ler.

  • Work item: selecione o projeto que contém o item de trabalho que você deseja ler e selecione o tipo de item de trabalho.

Outputs
Selecione as informações que deseja incluir no pacote de saída deste módulo. Os campos disponíveis dependem do tipo de item de trabalho.
ID
Insira ou mapeie a ID do registro que deseja ler.

Update a work item

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Project
Selecione o projeto que contém o item de trabalho que você deseja atualizar.
Work Item Type
Selecione o tipo de item de trabalho que você deseja atualizar.
Other Fields
Em cada um desses 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.
Work item ID
Informe ou mapeie a ID do item de trabalho que você deseja atualizar.

Upload an attachment

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Project
Selecione o projeto no qual deseja fazer upload de um anexo.
Work item ID
Insira ou mapeie a ID do item de trabalho para o qual você deseja fazer upload de um anexo.
Comment
Insira o texto de um comentário que deseja adicionar ao anexo carregado.
Source file
Selecione um arquivo de origem de um módulo anterior ou insira ou mapeie o nome e o conteúdo do arquivo de origem.

Pesquisas

List work items

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.

Connection
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Project
Selecione o projeto do qual deseja recuperar itens de trabalho.
Work item type
Selecione o tipo de item de trabalho que deseja recuperar.
Outputs
Selecione as propriedades que você deseja que apareçam na saída do módulo. Os campos disponíveis dependem do tipo de item de trabalho que você deseja recuperar. Você deve selecionar pelo menos uma propriedade.
Limit
Insira ou mapeie o número máximo de itens de trabalho que Workfront Fusion retorna durante um ciclo de execução.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3