Conector Jira¶
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 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 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 (consulte paleta de componentes de design).
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).
Juntas, uma conexão Jira específica e suas atividades são chamadas de endpoint 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 referenciado 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 de 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 3 pernas 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 que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política da organização Desativar atualização automática do conector).
-
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 conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:
<logger name="org.jitterbit.connector.jira" level="DEBUG"/> -
Se estiver usando agentes privados, você pode verificar os registros do agente para mais informações.