Conector Jira para Jitterbit Integration Studio
Resumo
O conector Jira estabelece acesso a Jira.
O conector Jira fornece uma interface para criar uma conexão Jira, a base usada para gerar instâncias de atividades do Jira. Essas atividades, uma vez configuradas, interagem com o Jira por meio da conexão.
O conector Jira é compatível com 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 aba endpoints e conectores do projeto 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 que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).
Juntos, uma conexão específica do Jira e suas atividades são chamadas de endpoint do Jira:
-
Pesquisar: Recupera dados de objeto de um projeto Jira e deve ser usado como fonte em uma operação.
-
Emitir: Cria, atualiza ou exclui um problema em um projeto do Jira e deve ser usado como um alvo em uma operação.
-
Criar: Cria dados de objeto em um projeto Jira e deve ser usado como um alvo em uma operação.
-
Atualizar: Atualiza dados de objeto em um projeto Jira e deve ser usado como um alvo em uma operação.
-
Painel de Pesquisa: Recupera dados do painel do Jira e deve ser usado como fonte em uma operação.
-
Excluir: Exclui dados de objeto do Jira e deve ser usado como alvo em uma operação.
-
Transição: Recupera ou atualiza problemas do Jira e deve ser usado como um alvo em uma operação.
-
Filtro de Pesquisa: Recupera dados de filtro do Jira e deve ser usado como fonte em uma operação.
Nota
Este conector é um Connector SDK, que pode ser consultado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.
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 do agente baixam automaticamente a versão mais recente do conector quando necessário.
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 e campos do esquema.
O tipo de instância Jira On-premise é compatível com estas versões do Jira Server e do Jira Data Center:
- 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 três etapas para a versão do agente 10.83 / 11.21 ou posterior.
Solução de problemas
Se você tiver problemas com o conector Jira, estas etapas de solução de problemas são recomendadas:
-
Clique no botão Testar 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 para o agente (a menos que esteja usando a Desativar atualização automática do conector política da organização).
-
Verifique os registros de operação para qualquer informação escrita durante a execução da operação.
-
Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
-
Se estiver usando agentes privados, você pode habilitar registro detalhado do conector para este conector adicionando esta entrada de configuração do registrador ao do seu agente privado
logback.xml
arquivo:<logger name="org.jitterbit.connector.jira" level="DEBUG"/>
Para obter mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores que usam agentes privados Jitterbit.
-
Se estiver usando agentes privados, você pode verificar os registros do agente para obter mais informações.
-
Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.