Ir para o conteúdo

Conector Jira para Jitterbit Integration Studio

Resumo

O conector Jira estabelece acesso ao Jira.

O conector Jira fornece uma interface para criar uma conexão Jira, a base utilizada para gerar instâncias de atividades Jira. Essas atividades, uma vez configuradas, interagem com o Jira por meio da conexão.

O conector Jira suporta Jira Software Cloud, Jira Server e Jira Data Center.

Nota

O conector Jira suporta campos personalizados padrão. Campos personalizados avançados não são suportados.

O conector Jira é acessado na aba Endpoints e conectores do projeto da paleta de componentes de design (veja Paleta de componentes de design).

Dica

Receitas de integração e modelos de processo estão disponíveis para este conector através do Jitterbit Marketplace.

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão Jira. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão Jira específica e suas atividades são referidos como um endpoint Jira:

Tipos de atividades Jira

  • Buscar: Recupera dados de objetos de um projeto Jira e se destina a ser usado como uma fonte em uma operação.

  • Problema: Cria, atualiza ou exclui um problema em um projeto Jira e se destina a ser usado como um alvo em uma operação.

  • Criar: Cria dados de objetos em um projeto Jira e se destina a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza dados de objetos em um projeto Jira e se destina a ser usado como um alvo em uma operação.

  • Painel de Busca: Recupera dados do painel do Jira e é destinado a ser usado como uma fonte em uma operação.

  • Excluir: Exclui dados de objetos do Jira e é destinado a ser usado como um alvo em uma operação.

  • Transição: Recupera ou atualiza problemas do Jira e é destinado a ser usado como um alvo em uma operação.

  • Filtro de Busca: Recupera dados de filtros do Jira e é destinado a ser usado como uma fonte em uma operação.

Nota

Este conector é um conector baseado no Connector SDK, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector Jira requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector Jira utiliza a Jira REST API v3 para o tipo de instância Jira Cloud e a Jira REST API v2 para o tipo de instância Jira On-premise. Consulte a documentação da API para informações sobre os nós e campos do esquema.

Informação

Para instâncias Jira Cloud, a Atlassian descontinuou seu endpoint da API JQL (POST). A partir do lançamento Harmony 11.50, a atividade de Busca agora utiliza a busca aprimorada JQL (POST). Veja o changelog da Atlassian para diferenças entre os novos e antigos endpoints da API.

O tipo de instância Jira On-premise é suportado com estas versões do Jira Server e Jira Data Center versões:

  • 9.17.2
  • 9.17.1
  • 9.17.0
  • 9.12.12
  • 9.12.9
  • 9.12.8
  • 9.12.7
  • 9.4.3
  • 8.22.3 (não recomendado)

Este conector suporta autenticação OAuth 2.0 com 3 etapas para a versão do agente 10.83 / 11.21 ou posterior.

Solução de Problemas

Se você encontrar problemas com o conector Jira, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.jira" level="DEBUG"/>

    Para mais informações sobre o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  6. Para considerações adicionais de solução de problemas, consulte Solução de Problemas de Operação.