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

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

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:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

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:

Jira Cloud
Servidor Jira
apiVersion
2
2
apiVersionAgile
1,0
1,0
Tag da API
1.7.29
1.0.19

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

  1. Crie um token de API no Jira.

    Para obter instruções, recomendamos pesquisar por "Criar um token de API" na documentação do Jira.

  2. 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.

  3. Continuar com Configurar o token de API Jira em Workfront Fusion.

Configurar o token de API Jira em Workfront Fusion

  1. Em qualquer módulo Jira Cloud em Workfront Fusion, clique em Add ao lado do campo connection.

  2. 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.
  3. 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.

  1. 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:
      1. No terminal, execute o seguinte comando:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Copie a saída do terminal, incluindo -------BEGIN PUBLIC KEY-------- e -------END PUBLIC KEY--------.

      3. Cole a saída do terminal em um arquivo chamado jira_publickey.pem.

  2. Prossiga para Configurar o aplicativo cliente como consumidor em Jira

Configure o aplicativo cliente como um consumidor no Jira

  1. Faça logon na instância do Jira.

  2. No painel de navegação esquerdo, clique no Jira Settings ícone de configurações do Jira > Applications> Application links.

  3. 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
    
  4. Clique em Create new link. Ignore a mensagem de erro "Nenhuma resposta foi recebida do URL inserido".

  5. Na janela Link applications, insira valores nos campos Consumer key e Shared secret.

    Você pode escolher os valores desses campos.

  6. 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.

  7. 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
  8. Marque a caixa de seleção Create incoming link.

  9. Clique em Continue.

  10. 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.
  11. Clique em Continue.

  12. 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

NOTE
Use o aplicativo Jira Server para se conectar a Jira Server ou Jira Data Center.
  1. Em qualquer módulo Jira Server em Workfront Fusion, clique em Add ao lado do campo connection.

  2. 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
  3. 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.

Alternância de mapa

Acionadores

Watch for records

Este módulo de acionamento inicia um cenário quando um registro é adicionado, atualizado ou excluído.

Webhook

Selecione o webhook que deseja usar para observar registros.

Para adicionar um novo webhook:

  1. Clique em Add

  2. Insira um nome para o webhook.

  3. Selecione a conexão que deseja usar com seu webhook.

    Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.

  4. Selecione o tipo de registro que você deseja que o software assista:

    • Comment
    • Issue
    • Project
    • Sprint

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Sprint ID
Insira ou mapeie a ID de velocidade da velocidade à qual você deseja adicionar um problema.
Issue ID or Keys
Para cada problema ou chave que você deseja ver a experiência, clique em Add item e insira a ID ou chave do problema. Você pode inserir até 50 em um módulo.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja que o módulo crie e preencha os outros campos específicos desse tipo de registro que aparecem no módulo.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
URL
Insira um caminho relativo a<Instance URL>/rest/api/2/
Method
Headers

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ê.

Query String

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

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

Body

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.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja que o módulo exclua.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Insira ou mapeie a ID ou a Chave do registro que deseja excluir.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
ID
Insira ou mapeie a ID do anexo que deseja baixar.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro Jira que deseja que o módulo leia.

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Selecione as saídas que deseja receber. As opções de saída estão disponíveis com base no tipo de registro selecionado no campo "Record Type".
ID
Insira ou mapeie a ID Jira Software exclusiva do registro que você deseja que o módulo leia.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja que o módulo atualize. Quando você seleciona um tipo de registro, outros campos específicos desse tipo de registro aparecem no módulo.

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Insira ou mapeie a ID ou a Chave do registro que deseja atualizar e, em seguida, preencha os outros campos específicos desse tipo de registro que aparecem no módulo.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja que o módulo liste. Quando você seleciona um tipo de registro, outros campos específicos desse tipo de registro aparecem no módulo.

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
Insira ou mapeie o número máximo de registros que você deseja que o módulo recupere durante cada ciclo de execução de cenário.

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.

Connection
Para obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja que o módulo procure. Quando você seleciona um tipo de registro, outros campos específicos desse tipo de registro aparecem no módulo.

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    Para obter mais informações sobre JQL, consulte JQL no site de ajuda da Atlassian.

  • Project

  • Project by issue

  • User

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3