Jira Software módulos
Em um cenário Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam Jira Software, 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:
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 Jira é necessário ter uma conta do Jira.
Informações da API Jira
O conector Jira usa o seguinte:
Conectar Jira Software a Workfront Fusion
O método de conexão é baseado no uso do Jira Cloud ou do Jira Server.
Conectar Jira Cloud a Workfront Fusion
Conectar Jira Cloud a Workfront Fusion
Para conectar Jira Software a Workfront Fusion, você deve criar um token de API e inseri-lo junto com a URL de Serviço e o Nome de Usuário no campo Criar uma conexão em Workfront Fusion.
Criar um token de API em Jira
-
Vá para https://id.atlassian.com/manage/api-tokens e faça logon.
-
Clique em Criar token de API.
-
Digite um nome para o token, como Workfront Fusion.
-
Copie o token usando o botão Copiar para a área de transferência.
note important IMPORTANT Você não poderá exibir o token novamente depois de fechar esta caixa de diálogo. 1. Armazene o token gerado em um local seguro.
-
Continuar com Configurar o token de API Jira em Workfront Fusion.
Configurar o token de API Jira em Workfront Fusion
-
Em Workfront Fusion, adicione um módulo Jira a um cenário para abrir a caixa Criar uma conexão.
-
Especifique as seguintes informações:
- URL do Serviço: Esta é a URL base que você usa para acessar sua conta Jira. Exemplo:
yourorganization.atlassian.net - Nome de usuário
- Token de API: Este é o token de API criado na seção Criar um token de API Jira deste artigo.
- URL do Serviço: Esta é a URL base que você usa para acessar sua conta Jira. Exemplo:
-
Clique em Continuar para criar a conexão e retornar ao módulo.
Conectar Jira Server a Workfront Fusion
Para autorizar uma conexão entre Workfront Fusion e Jira Server, você precisa de sua Chave do Consumidor, Chave Privada e URL do Serviço. Talvez seja necessário contatar o administrador do Jira para obter essas informações.
Gerar chaves públicas e privadas para sua conexão Jira
Para adquirir uma chave privada para sua conexão Workfront Fusion Jira, você precisa gerar chaves públicas e privadas.
-
No terminal, execute os seguintes comandos
openssl.-
openssl genrsa -out jira_privatekey.pem 1024Esse comando gera uma chave privada de 1024 bits.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365Este comando cria um certificado X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Este comando extrai a chave privada (formato PKCS8) para o
jira_privatekey.pcks8
arquivo. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemEste comando extrai a chave pública do certificado para o arquivo
jira_publickey.pem.note note NOTE Se você estiver usando o Windows, talvez precise salvar manualmente a chave pública no arquivo jira_publickey.pem:-
No terminal, execute o seguinte comando:
openssl x509 -pubkey -noout -in jira_publickey.cer -
Copiar a saída do terminal (incluindo
-------BEGIN PUBLIC KEY--------e-------END PUBLIC KEY-------- -
Cole a saída do terminal em um arquivo chamado
jira_publickey.pem.
-
-
-
Prossiga para Configurar o aplicativo cliente como consumidor em Jira
Configure o aplicativo cliente como um consumidor no Jira
-
Faça logon na instância do Jira.
-
No painel de navegação esquerdo, clique em JiraConfigurações
-
No campo Insira a URL do aplicativo que deseja vincular, digite
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
Clique em Criar novo link. Ignore a mensagem de erro "Nenhuma resposta foi recebida do URL inserido".
-
Na janela Vincular aplicativos, insira valores nos campos Chave do consumidor e Segredo compartilhado.
Você pode escolher os valores desses campos.
-
Copie os valores dos campos Chave do consumidor e Segredo compartilhado para um local seguro.
Esses valores serão necessários posteriormente no processo de configuração.
-
Preencha os campos URL da seguinte maneira:
table 0-row-2 1-row-2 2-row-2 3-row-2 Campo Descrição URL do token de solicitação <Jira base url>/plugins/servlet/oauth/request-tokenURL de autorização <Jira base url>/plugins/servlet/oauth/authorizeURL do token de acesso <Jira base url>/plugins/servlet/oauth/access-token -
Marque a caixa de seleção Criar link de entrada.
-
Clique em Continuar.
-
Na janela Vincular aplicativos, preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Chave do Consumidor Cole a chave do consumidor que você copiou para um local seguro. Nome do consumidor Insira um nome de sua escolha. Este nome é para sua própria referência. Chave pública Cole a chave pública do arquivo jira_publickey.pem. -
Clique em Continuar.
-
Continue para Criar uma conexão com Jira Server ou Jira Data Center em Workfront Fusion
Criar uma conexão com Jira Server ou Jira Data Center em Workfront Fusion
-
Em qualquer módulo Jira Server em Workfront Fusion, clique em Adicionar ao lado do campo conexão.
-
No painel Criar uma conexão, preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Nome da Conexão Insira um nome para a conexão Chave do Consumidor Cole a chave do consumidor que você copiou em um local seguro no Configure o aplicativo cliente como um consumidor no Jira Private Key Cole a chave privada do arquivo jira_privatekey.pcks8criado em Gerar chaves públicas e privadas para sua conexão Jira.Service URL Insira a URL da instância do Jira. Exemplo: yourorganization.atlassian.net -
Clique em Continuar para criar a conexão e voltar para o módulo.
Jira Software módulos e seus campos
Ao configurar módulos do Jira Software, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Jira Software 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
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.
Ao configurar esse módulo, os campos a seguir são exibidos.
Criar um Registro
Este módulo de ação cria um novo registro no Jira.
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.
Chamada de API personalizada
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API Jira Software. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Jira Software.
Ao configurar esse módulo, os campos a seguir são exibidos.
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.
<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"}
Workfront Fusion O 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.
Nota:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Excluir um registro
Esse módulo de ação exclui um registro específico.
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.
Baixar um anexo
Este módulo de ação baixa um anexo específico.
Ao configurar esse módulo, os campos a seguir são exibidos.
Ler um registro
Este módulo de ação lê dados de um único registro em Jira Software.
Especifique a ID do registro.
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.
Atualizar um registro
Esse módulo de ação atualiza um registro existente, como um problema ou projeto,.
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.
Pesquisas
Listar registros
Este módulo de pesquisa recupera todos os itens de um tipo específico que correspondam à sua consulta de pesquisa
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.
Pesquisar registros
Este módulo de pesquisa procura registros em um objeto em Jira Software 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.