Conector de Jira para Jitterbit Integration Studio
Resumen
El conector de Jira establece acceso a Jira.
El conector de Jira proporciona una interfaz para crear una conexión de Jira, la base utilizada para generar instancias de actividades de Jira. Estas actividades, una vez configuradas, interactúan con Jira a través de la conexión.
El conector de Jira es compatible con Jira Software Cloud, Jira Server y Jira Data Center.
Nota
El conector de Jira admite campos personalizados estándar. Los campos personalizados avanzados no son compatibles.
El conector de Jira se accede desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
Consejo
Recetas de integración y plantillas de procesos están disponibles para este conector a través de Jitterbit Marketplace.
Descripción general del conector
Este conector se utiliza para primero configurar una conexión de Jira. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).
Juntos, una conexión específica de Jira y sus actividades se conocen como un punto final de Jira:
-
Buscar: Recupera datos de objetos de un proyecto de Jira y está destinado a ser utilizado como una fuente en una operación.
-
Problema: Crea, actualiza o elimina un problema en un proyecto de Jira y está destinado a ser utilizado como un destino en una operación.
-
Crear: Crea datos de objetos en un proyecto de Jira y está destinado a ser utilizado como un destino en una operación.
-
Actualizar: Actualiza datos de objetos en un proyecto de Jira y está destinado a ser utilizado como un destino en una operación.
-
Buscar Dashboard: Recupera datos del dashboard de Jira y está destinado a ser utilizado como una fuente en una operación.
-
Eliminar: Elimina datos de objetos de Jira y está destinado a ser utilizado como un objetivo en una operación.
-
Transición: Recupera o actualiza problemas de Jira y está destinado a ser utilizado como un objetivo en una operación.
-
Filtro de Búsqueda: Recupera datos de filtros de Jira y está destinado a ser utilizado como una fuente en una operación.
Nota
Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.
Los endpoints creados con este conector están incluidos en reportes de uso de endpoints y cuentan para tu licencia.
Requisitos previos y versiones de API soportadas
El conector de Jira requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la última versión del conector cuando es necesario.
El conector de Jira utiliza la API REST de Jira v3 para el tipo de instancia Jira Cloud y la API REST de Jira v2 para el tipo de instancia Jira On-premise. Consulta la documentación de la API para obtener información sobre los nodos y campos del esquema.
Información
Para instancias de Jira Cloud, Atlassian ha descontinuado su endpoint de API JQL (POST). A partir de la versión Harmony 11.50, la actividad de búsqueda ahora utiliza la búsqueda mejorada de JQL (POST). Consulta el registro de cambios de Atlassian para conocer las diferencias entre los nuevos y antiguos endpoints de API.
El tipo de instancia Jira On-premise es compatible con estas versiones de Jira Server y Jira Data Center versiones:
- 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 (no recomendado)
Este conector admite autenticación OAuth 2.0 de 3 patas para la versión del agente 10.83 / 11.21 o posterior.
Solución de problemas
Si experimenta problemas con el conector de Jira, se recomiendan los siguientes pasos de solución de problemas:
-
Haga clic en el botón Probar en la configuración de conexión para asegurarse de que la conexión sea exitosa y de que la última versión del conector se descargue al agente (a menos que se esté utilizando la política de organización Deshabilitar actualización automática del conector).
-
Revise los registros de operaciones para obtener información escrita durante la ejecución de la operación.
-
Habilite el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.
-
Si utiliza agentes privados, puede habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro al archivo
logback.xml
de su agente privado:<logger name="org.jitterbit.connector.jira" level="DEBUG"/>
Para obtener más información sobre el registro detallado del conector, consulte Registro detallado para conectores que utilizan agentes privados de Jitterbit.
-
Si utiliza agentes privados, puede revisar los registros del agente para obtener más información.
-
Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operaciones.