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:

-
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:
-
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).
-
Verifique os registros de operação para qualquer informação registrada durante a execução da operação.
-
Ative o registro de debug de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos e dados de log adicionais.
-
Se usar agentes privados, ative o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo
logback.xmldo 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.
-
Se usar agentes privados, verifique os registros do agente para mais informações.
-
Para considerações adicionais sobre resolução de problemas, consulte Resolução de problemas de operação.