Módulos do Jira
Em um cenário do Adobe Workfront Fusion, é possível automatizar workflows que usam o Jira, bem como conectá-lo a vários aplicativos e serviços de terceiros.
O conector Jira pode ser usado para o Jira Cloud e o Jira Data Server.
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
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 menu:
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 licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.
Pré-requisitos
Para usar módulos Jira, você deve ter uma conta Jira.
Conectar o Jira ao Workfront Fusion
Criar as credenciais necessárias
Para criar conexões com o Jira, você precisará do seguinte:
Para obter instruções sobre como criar qualquer um desses, consulte a documentação do Jira.
Ao criar essas credenciais, você precisará das seguintes informações:
-
Para OAuth 2:
table 0-row-2 1-row-2 2-row-2 3-row-2 Data center Fusion Redirecionar URL EUA https://app.workfrontfusion.com/oauth/cb/workfront-jira2UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2 -
Para Tokens de acesso pessoal (PATs):
table 0-row-2 1-row-2 2-row-2 3-row-2 Data center Fusion Redirecionar URL EUA https://app.workfrontfusion.com/oauth/cb/workfront-jiraUE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jiraAzure https://app-az.workfrontfusion.com/oauth/cb/workfront-jiranote important IMPORTANT Para usar um PAT, você deve habilitar o seguinte nos arquivos jira/bin/WEB-INF/classes, no arquivojira-config.properties:jira.rest.auth.allow.basic = truejira.rest.csrf.disabled = true
Se este arquivo não existir, você deve criá-lo.
Criar a conexão com o Jira no Workfront Fusion
Para criar a conexão no Workfront Fusion:
-
Em qualquer módulo Jira, clique em Adicionar ao lado do campo Conexão.
-
Configure os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header Tipo de conexão Selecione se você está criando uma conexão básica ou uma conexão OAuth 2. Nome da conexão Insira um nome para a nova conexão. URL do serviço Insira o URL da instância do Jira. Este é o endereço que você usa para acessar o Jira. Tipo de conta Jira Selecione se você está se conectando ao Jira Cloud ou ao Jira Data Center. ID do cliente Se você estiver criando uma conexão OAuth 2, insira sua ID de cliente Jira Segredo do cliente Se você estiver criando uma conexão OAuth 2, digite o segredo do cliente Jira Email Se estiver criando uma conexão básica com o Jira Cloud, insira seu endereço de email. Token de API Se estiver criando uma conexão básica com o Jira Cloud, insira o token da API. Token de acesso pessoal Se estiver criando uma conexão básica com o data center Jira, insira o token de acesso pessoal. Versão da API Selecione a versão da API Jira à qual você deseja que essa conexão se conecte. -
Clique em Continuar para criar a conexão e voltar para o módulo.
Módulos Jira e seus campos
Ao configurar módulos Jira, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos adicionais do Jira 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
Observar registros
Este módulo de acionamento inicia um cenário quando um registro é adicionado, atualizado ou excluído.
Ações
Adicionar problema ao sprint
Este módulo de ação adiciona um ou mais problemas a um sprint.
Criar um registro
Este módulo de ação cria um novo registro no Jira.
Chamada de API personalizada
Esse módulo de ação permite fazer uma chamada autenticada personalizada para a API Jira.
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.
<Instance URL>/rest/api/2/Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.
Por exemplo, {"Content-type":"application/json"}
O Workfront Fusion adiciona os cabeçalhos de autorização para você.
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.
Observação:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Excluir um registro
Este módulo de ação exclui o registro especificado.
Baixar um anexo
Este módulo de ação baixa o anexo especificado.
Ler um registro
Este módulo de ação lê os dados do registro especificado no Jira.
Atualizar um registro
Este módulo de ação atualiza um registro existente, como um problema ou projeto.
Pesquisas
Pesquisar registros
Este módulo de pesquisa procura registros em um objeto no Jira que correspondam à consulta de pesquisa especificada.
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.