Jira Software módulos

Última atualização: 5 de março de 2025
  • Tópicos:

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:

Pacote do Adobe WorkfrontQualquer
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 CloudServidor Jira
apiVersion22
apiVersionAgile1,01,0
Tag da API1.7.291.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 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

  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.

    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 Adicionar ao lado do campo conexão.

  2. Especifique as seguintes informações:

    • Ambiente
    • Tipo
    • 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.

  3. 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. Isso é feito no terminal do computador. Você pode localizar seu terminal procurando o terminal no menu Iniciar ou na barra de pesquisa do computador (não na barra de pesquisa do navegador).

  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
      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 em JiraConfigurações Ícone de configurações Jira > Aplicativos> Links de aplicativos.

  3. No campo Insira a URL do aplicativo que deseja vincular, digite

    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1

  4. Clique em Criar novo link. Ignore a mensagem de erro "Nenhuma resposta foi recebida do URL inserido".

  5. Na janela Vincular aplicativos, insira valores nos campos Chave do consumidor e Segredo compartilhado.

    Você pode escolher os valores desses campos.

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

  7. Preencha os campos URL da seguinte maneira:

    CampoDescrição
    URL do token de solicitação<Jira base url>/plugins/servlet/oauth/request-token
    URL de autorização<Jira base url>/plugins/servlet/oauth/authorize
    URL do token de acesso<Jira base url>/plugins/servlet/oauth/access-token

  8. Marque a caixa de seleção Criar link de entrada.

  9. Clique em Continuar.

  10. Na janela Vincular aplicativos, preencha os seguintes campos:

    Chave do ConsumidorCole a chave do consumidor que você copiou para um local seguro.
    Nome do consumidorInsira um nome de sua escolha. Este nome é para sua própria referência.
    Chave públicaCole a chave pública do arquivo jira_publickey.pem.

  11. Clique em Continuar.

  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 Adicionar ao lado do campo conexão.

  2. No painel Criar uma conexão, preencha os seguintes campos:

    Nome da ConexãoInsira um nome para a conexão
    AmbienteSelecione se você está usando um ambiente de produção ou não produção.
    TipoSelecione se você está usando uma conta de serviço ou uma conta pessoal.
    Chave do ConsumidorCole a chave do consumidor que você copiou em um local seguro no Configure o aplicativo cliente como um consumidor no Jira
    Private KeyCole a chave privada do arquivo jira_privatekey.pcks8 criado em Gerar chaves públicas e privadas para sua conexão Jira.
    Service URLInsira a URL da instância do Jira. Exemplo: yourorganization.atlassian.net

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

Alternância de mapa

Acionadores

Observar registros

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 Adicionar

  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:

    • Comentário
    • Problema
    • Projeto
    • Sprint

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
ID SprintInsira ou mapeie a ID de velocidade da velocidade à qual você deseja adicionar um problema.
Identificação de Problema ou ChavesPara cada problema ou chave que você deseja ver a experiência, clique em Adicionar item e insira a ID ou chave do problema. Você pode inserir até 50 em um módulo.

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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.

  • Anexo
  • Comentário
  • Problema
  • Projeto
  • Sprint
  • Log de Trabalho

Chamada de API personalizada

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
URLInsira um caminho relativo a<Instance URL>/rest/api/2/
Método
Cabeçalhos

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

Cadeia de Consulta

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

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

Corpo

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

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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

  • Anexo
  • Comentário
  • Problema
  • Projeto
  • Sprint
ID ou ChaveInsira ou mapeie a ID ou a Chave do registro que deseja excluir.

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.

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

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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

  • Anexo
  • Problema
  • Projeto
  • Sprint
  • Usuário
SaídasSelecione 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 "Tipo de registro".
IDInsira ou mapeie a ID Jira Software exclusiva do registro que você deseja que o módulo leia.

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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.

  • Comentário
  • Problema
  • Projeto
  • Sprint
  • Problema de transição
ID ou ChaveInsira 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

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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.

  • Comentário
  • Problema
  • Projeto
  • Problema de Sprint
  • Log de Trabalho
Máximo de ResultadosInsira 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.

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.

ConexãoPara obter instruções sobre como conectar sua conta do Jira Software ao Workfront Fusion, consulte Conectar Jira Software ao Workfront Fusion neste artigo.
Tipo de Registro

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.

  • Problemas

  • Problemas por JQL (Jira Query Language)

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

  • Projeto

  • Projeto por problema

  • Usuário

Página anteriorMódulos CRM do Hubspot
Próxima páginaMódulos do MariaDB

Workfront