Módulos do Azure DevOps
Em um cenário do Adobe Workfront Fusion, é possível automatizar fluxos de trabalho que usam Azure DevOps, bem como conectá-lo 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
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront |
Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration Workfront Ultimate Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion. |
| Licenças do Adobe Workfront |
Padrão Trabalho ou maior |
| Licença do Adobe Workfront Fusion |
Baseado em operação: disponível para organizações com licenças baseadas em operação Baseado em conector (legado): Workfront Fusion for Work Automation and Integration |
| Produto | Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.
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:
Conectar o Azure DevOps ao Workfront Fusion connect-azure-devops-to-workfront-fusion
Conectar o Azure DevOps ao Workfront Fusion usando o EntraApp
-
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.
note NOTE O Azure DevOps (EntraApp) permite solicitar todos os escopos para a conexão. -
Preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Connection name 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. ID do Aplicativo Insira a ID do aplicativo DevOps ao qual você está se conectando. Client Secret Insira o segredo do cliente para os aplicativos DevOps aos quais você está se conectando. Solicitar Todos os Escopos Se 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 da 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.
Conectar o Azure DevOps ao Workfront Fusion usando uma entidade de serviço
Você pode criar uma conexão que use uma entidade de serviço (uma conexão da API do aplicativo) em vez de uma conta pessoal. Isso é útil quando você deseja que a conexão seja executada como uma identidade de aplicativo ou serviço, em vez de uma pessoa específica. Isso pode ser útil para que a integração não seja interrompida se, por exemplo, essa pessoa sair da empresa ou alterar a senha.
Esse tipo de conexão está disponível para todos os módulos DevOps do Azure.
Pré-requisitos para conectar o Azure DevOps ao Workfront Fusion usando uma entidade de serviço
Para criar essa conexão, você precisa do seguinte:
- Acesso de Administrador Global ou Administrador de Aplicativos na Microsoft Entra ID para registrar o aplicativo. Se você não tiver esse acesso, peça a alguém da sua equipe de TI ou de identidade para concluir essa etapa para você.
- Acesso de Administrador da Coleção de Projetos na sua organização de DevOps da Azure, para adicionar a entidade de serviço como membro. Geralmente, essa é uma pessoa diferente da que gerencia a Microsoft Entra ID.
- O nome da sua organização DevOps da Azure. Você pode encontrar isso na URL do Azure DevOps:
dev.azure.com/<your organization name>.
Criar o registro do aplicativo na Microsoft Entra ID
- Entre no centro de administração Microsoft Entra.
- Ir para Registros de aplicativo > Novo registro.
- Dê ao aplicativo um nome claro e reconhecível. Por exemplo,
Workfront Fusion Azure DevOps Integration. - Deixe URI de redirecionamento em branco. Essa conexão não envolve fazer logon por meio de um navegador.
- Selecione Registrar.
- Continue em Criar um segredo de cliente.
Criar um segredo do cliente
- No novo registro do aplicativo, acesse Certificados e segredos.
- Selecione Novo segredo do cliente, adicione uma descrição e escolha um período de expiração.
- Selecione Adicionar.
- Copie o Valor do segredo imediatamente. É exibido apenas uma vez. Se você navegar para fora antes de copiá-lo, deverá criar um novo.
- Prossiga para Coletar detalhes da conexão.
Coletar detalhes da conexão
-
Na página Visão geral do registro do aplicativo, observe os seguintes valores. Você os insere ao criar a conexão no módulo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header ID de Locatário Na página Visão Geral, rotulada ID do Diretório (locatário). Client ID Na página Visão Geral, rotulada ID do Aplicativo (cliente). Client Secret O valor copiado em Criar um segredo de cliente. Organização O nome de sua organização Azure DevOps. Por exemplo, se a URL for dev.azure.com/yourorg, digiteyourorg.note NOTE Você pode ignorar a área Permissões de API do registro de aplicativo. Se você adicionar Azure DevOps lá, somente Permissões delegadas estarão disponíveis. Permissões de aplicativo aparecem esmaecidas. Isso é esperado, pois o Azure DevOps não oferece suporte à concessão de acesso dessa maneira. Em vez disso, o acesso é concedido diretamente no Azure DevOps, na próxima parte. -
Continue em Adicionar a entidade de serviço à sua organização de DevOps da Azure.
Adicionar a entidade de serviço à sua organização de DevOps da Azure
Registrar o aplicativo na Microsoft Entra ID cria apenas sua identidade. Ele ainda não dá ao aplicativo acesso aos dados de DevOps do Azure. Esse procedimento concede esse acesso.
-
Faça logon na sua organização Azure DevOps, em
dev.azure.com/<your organization name>. -
Selecione Configurações da organização no canto inferior esquerdo e selecione Usuários.
-
Selecione Adicionar usuários.
-
Na caixa de pesquisa, pesquise pelo nome de exibição do aplicativo, que é o nome que você deu a ele ao registrar o aplicativo. Não pesquise pela ID do cliente.
-
Selecione um nível de acesso:
- Básico geralmente é suficiente para ler e gravar itens de trabalho, quadros e repositórios.
- Se o fluxo de trabalho precisar procurar processos disponíveis, como modelos Agile, Scrum ou personalizados, como parte da configuração, adicione a entidade de serviço ao grupo Administradores da Coleção de Projetos. Esse é um nível mais amplo de acesso, portanto, conceda-o somente se você precisar desse recurso.
-
Atribua o principal de serviço ao projeto ou projetos específicos de que ele precisa, seguindo as práticas de acesso comuns da sua organização.
-
Selecione Adicionar.
-
Continue em Criar a conexão.
Criar a conexão
-
Na tela de configuração de conexão do módulo, selecione o tipo de conexão Entidade de Serviço.
-
Insira o seguinte:
- ID do inquilino
- ID do cliente
- Segredo do cliente
- Organização
-
Salve a conexão.
Se tudo estiver configurado corretamente, a conexão será validada com êxito.
Azure DevOps módulos e seus campos
Ao configurar módulos do Azure DevOps, o Workfront Fusion exibe os campos listados abaixo. Junto com eles, outros campos do Azure DevOps 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 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.
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.
Chamada de API personalizada
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API do 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 para a chamada de API na forma de um objeto JSON padrão.
Por exemplo: {"name":"something-urgent"}
Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão.
Observação:
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.
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 todos os 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.
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.