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 suporta Jira Software Cloud, Jira Server e Jira Data Center.

O conector Jira é acessado a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

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 chamados de endpoint Jira:

• Search: Recupera dados de objetos de um projeto Jira e é destinado a ser usado como fonte em uma operação.

• Issue: Cria, atualiza ou exclui um problema em um projeto Jira e é destinado a ser usado como destino em uma operação.

• Create: Cria dados de objetos em um projeto Jira e é destinado a ser usado como destino em uma operação.

• Update: Atualiza dados de objetos em um projeto Jira e é destinado a ser usado como destino em uma operação.

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

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

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

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

Os endpoints criados com este conector estão incluídos em endpoint usage reporting e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com cloud agents e private agents.

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 organization policy Disable Auto Connector Update.

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

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 versão do agente 10.83 / 11.21 ou posterior.

Solução de problemas

Se você enfrentar problemas com o conector Jira, recomenda-se seguir estas etapas de solução de problemas:

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

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

3. Ative o log de depuração de 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 log 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 log detalhado do conector, consulte Log 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.