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.
Essas instruções se aplicam aos módulos Jira Cloud e Jira 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:
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 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 sua URL de Serviço e Nome de Usuário no campo Create a connection em Workfront Fusion.
Criar um token de API em Jira
-
Crie um token de API no Jira.
Para obter instruções, recomendamos pesquisar por "Criar um token de API" na documentação do Jira.
-
Depois de criar o token, copie-o em um local seguro.
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 qualquer módulo Jira Cloud em Workfront Fusion, clique em Add ao lado do campo connection.
-
Especifique as seguintes informações:
- Ambiente
- Tipo
- Service URL: Esta é a URL base que você usa para acessar sua conta Jira. Exemplo:
yourorganization.atlassian.net
- Username
- API token: Este é o token de API criado na seção Criar um token de API Jira deste artigo.
-
Clique em Continue 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 1024
Esse comando gera uma chave privada de 1024 bits.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
Este comando cria um certificado X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
Este comando extrai a chave privada (formato PKCS8) para o arquivo
jira_privatekey.pcks8
. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
Este comando extrai a chave pública do certificado para o arquivo
jira_publickey.pem
.note note NOTE Se estiver usando o Windows, talvez seja necessário 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
-
Copie 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 no Jira Settings
-
No campo Enter the URL of the application you want to link, digite
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
Clique em Create new link. Ignore a mensagem de erro "Nenhuma resposta foi recebida do URL inserido".
-
Na janela Link applications, insira valores nos campos Consumer key e Shared secret.
Você pode escolher os valores desses campos.
-
Copie os valores dos campos Consumer key e Shared secret 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 Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
-
Marque a caixa de seleção Create incoming link.
-
Clique em Continue.
-
Na janela Link applications, preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Consumer Key Cole a chave do consumidor que você copiou para um local seguro. Consumer name Insira um nome de sua escolha. Este nome é para sua própria referência. Public key Cole a chave pública do arquivo jira_publickey.pem
. -
Clique em Continue.
-
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 Add ao lado do campo connection.
-
No painel Create a connection, preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Connection name Insira um nome para a conexão Environment Selecione se você está usando um ambiente de produção ou não produção. Type Selecione se você está usando uma conta de serviço ou uma conta pessoal. Consumer Key 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.pcks8
criado 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 Continue 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.
Acionadores
Watch for records
Este módulo de acionamento inicia um cenário quando um registro é adicionado, atualizado ou excluído.
Ações
Add issue to 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.
Create a Record
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.
Custom API Call
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API Jira Software. Use este módulo para criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos 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.
Delete a record
Este módulo de ação exclui o registro especificado.
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.
Download an attachment
Este módulo de ação baixa um anexo específico.
Ao configurar esse módulo, os campos a seguir são exibidos.
Read a record
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.
Update a record
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
List records
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.
Search for records
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.