Ir para o conteúdo

Conector Jira no Jitterbit Studio

Resumo

O conector Jira estabelece acesso ao Jira.

O conector Jira fornece uma interface para criar uma conexão Jira, a base usada para gerar instâncias de atividades Jira. Essas atividades, uma vez configuradas, interagem com o Jira através da conexão.

O conector Jira oferece suporte para Jira Software Cloud, Jira Server e Jira Data Center.

Nota

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

O conector Jira é acessado na guia Endpoints de projeto e conectores da paleta de componentes de design (consulte 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 configurar primeiro uma conexão Jira. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Tipos de atividade Jira

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

  • Issue: Cria, atualiza ou deleta um problema em um projeto Jira e destina-se a ser usado como destino em uma operação.

  • Create: Cria dados de objeto em um projeto Jira e destina-se a ser usado como destino em uma operação.

  • Update: Atualiza dados de objeto em um projeto Jira e destina-se a ser usado como destino em uma operação.

  • Search Dashboard: Recupera dados de painel do Jira e destina-se a ser usado como fonte em uma operação.

  • Delete: Deleta dados de objeto do Jira e destina-se a ser usado como destino em uma operação.

  • Transition: Recupera ou atualiza problemas do Jira e destina-se a ser usado como destino em uma operação.

  • Search Filter: Recupera dados de filtro do Jira e destina-se a ser usado como fonte em uma operação.

Endpoints criados com este conector estão incluídos em relatórios de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes em nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Desabilitar Atualização Automática de Conector.

O conector Jira usa 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 de esquema e campos.

Informação

Para instâncias do Jira Cloud, a Atlassian descontinuou seu endpoint de API JQL (POST). A partir da versão Harmony 11.50, a atividade Search agora usa a busca JQL aprimorada (POST). Consulte o changelog da Atlassian para ver as diferenças entre os novos e antigos endpoints da API.

Alguns objetos estão disponíveis apenas para o tipo de instância Jira Cloud ou apenas em agentes privados. Por exemplo, o objeto Webhook está disponível apenas para Jira Cloud, e o objeto Get_attachment_base64_content está disponível apenas em agentes privados. Objetos que não estão disponíveis para seu tipo de instância ou agente não aparecem na etapa Select an Object de uma atividade.

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

  • 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 de 3 etapas para agentes versão 10.83 / 11.21 ou posteriores.

Resolução de problemas

Se você tiver problemas com o conector Jira, recomenda-se seguir estas etapas:

  1. Clique no botão Test na configuração de conexão para garantir que a conexão foi bem-sucedida e para baixar a versão mais recente do conector no agente (a menos que use a política de organização Disable Auto Connector Update).

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

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

  4. Se usar agentes privados, ative 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 registro detalhado do conector, consulte Registro detalhado de conectores usando agentes privados Jitterbit.

  5. Se usar agentes privados, verifique os registros do agente para mais informações.

  6. Para considerações adicionais sobre resolução de problemas, consulte Resolução de problemas de operação.