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.

Se você precisar de instruções sobre como criar um cenário, consulte Criar um cenário Adobe Workfront Fusion.

Para obter informações sobre módulos, consulte Módulos em Adobe Workfront Fusion.

Requisitos de acesso

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o plano Select ou Prime Adobe Workfront, sua organização deve comprar Adobe Workfront Fusion e Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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 Adicionar ao lado do campo Conexão.

  3. No campo Tipo de Conexão, selecione Azure DevOps.

    note important
    IMPORTANT
    O tipo de conexão Azure DevOps (Solicitar Todos os Escopos) 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
    Nome da Conexão Insira um nome para a conexão que você está criando.
    Organização Digite o nome da organização sob a qual você criou o aplicativo Azure DevOps.
  5. 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 em Adobe Workfront Fusion.

Triggers

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.

Webhook

Selecione ou adicione um webhook para o módulo.

Para obter mais informações sobre webhooks em módulos de acionadores, consulte Acionadores instantâneos (webhooks) em Adobe Workfront Fusion.

Para obter informações sobre como criar um webhook, consulte Webhooks.

Ações

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.

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

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

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

Versão da API
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.
Método
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 em Adobe Workfront Fusion.
Cabeçalhos

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

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

Cadeia de Consulta

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

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

Corpo

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.

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.

Conexão
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Tipo de registro

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 Escolher um Processo 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.

Baixar um anexo

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

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

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

Vincular itens de trabalho

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

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.

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

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

Para obter mais informações, consulte Referência de Tipo de Link na Documentação do Azure DevOps.

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

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.

Conexão
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Tipo de registro

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.

Saídas
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.

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.

Conexão
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Projeto
Selecione o projeto que contém o item de trabalho que você deseja atualizar.
Tipo de Item de Trabalho
Selecione o tipo de item de trabalho que você deseja atualizar.
Outros Campos
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.
ID de item de trabalho
Informe ou mapeie a ID do item de trabalho que você deseja atualizar.

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.

Conexão
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Projeto
Selecione o projeto no qual deseja fazer upload de um anexo.
ID de item de trabalho
Insira ou mapeie a ID do item de trabalho para o qual você deseja fazer upload de um anexo.
Comentário
Insira o texto de um comentário que deseja adicionar ao anexo carregado.
arquivo Source
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

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.

Conexão
Para obter instruções sobre como conectar sua conta do Azure DevOps ao Workfront Fusion, consulte Conectar Azure DevOps ao Workfront Fusion neste artigo.
Projeto
Selecione o projeto do qual deseja recuperar itens de trabalho.
Tipo de item de trabalho
Selecione o tipo de item de trabalho que deseja recuperar.
Saídas
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.
Limite
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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43