Saltar al contenido

Conector de Jira en Jitterbit 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 se admiten.

Se accede al conector de Jira desde la pestaña Project endpoints and connectors (Puntos finales y conectores del proyecto) de la paleta de componentes de diseño (ver Design component palette).

Consejo

Las recetas de integración y las 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 configurar primero una conexión de Jira. Luego se utilizan los tipos de actividades asociados con esa conexión para crear instancias de actividades que se destinan a utilizarse como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión de Jira específica y sus actividades se conocen como punto final de Jira:

Tipos de actividades de Jira

  • Search: Recupera datos de objetos de un proyecto de Jira y está diseñado para utilizarse como origen en una operación.

  • Issue: Crea, actualiza o elimina un problema en un proyecto de Jira y está diseñado para utilizarse como destino en una operación.

  • Create: Crea datos de objetos en un proyecto de Jira y está diseñado para utilizarse como destino en una operación.

  • Update: Actualiza datos de objetos en un proyecto de Jira y está diseñado para utilizarse como destino en una operación.

  • Search Dashboard: Recupera datos de panel de Jira y está diseñado para utilizarse como origen en una operación.

  • Delete: Elimina datos de objetos de Jira y está diseñado para utilizarse como destino en una operación.

  • Transition: Recupera o actualiza problemas de Jira y está diseñado para utilizarse como destino en una operación.

  • Search Filter: Recupera datos de filtro de Jira y está diseñado para utilizarse como origen en una operación.

Los puntos finales creados con este conector se incluyen en endpoint usage reporting y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política organizativa Disable Auto Connector Update.

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 de esquema y los campos.

Información

Para instancias de Jira Cloud, Atlassian ha dejado de utilizar su punto final de API JQL (POST). A partir de la versión Harmony 11.50, la actividad Search ahora utiliza la búsqueda JQL mejorada (POST). Consulta el registro de cambios de Atlassian para conocer las diferencias entre los nuevos y antiguos puntos finales de API.

Algunos objetos están disponibles solo para el tipo de instancia Jira Cloud, o solo en agentes privados. Por ejemplo, el objeto Webhook está disponible solo para Jira Cloud, y el objeto Get_attachment_base64_content está disponible solo en agentes privados. Los objetos que no están disponibles para tu tipo de instancia o agente no aparecen en el paso Select an Object de una actividad.

El tipo de instancia Jira On-premise es compatible con estas versiones de Jira Server y 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 (no recomendado)

Este conector es compatible con la autenticación OAuth 2.0 de 3 pasos para la versión del agente 10.83 / 11.21 o posterior.

Solución de problemas

Si experimentas problemas con el conector Jira, se recomienda seguir estos pasos para la solución de problemas:

  1. Haz clic en el botón Test en la configuración de la conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que uses la política de organización Disable Auto Connector Update).

  2. Consulta los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro a tu archivo logback.xml del agente privado:

    <logger name="org.jitterbit.connector.jira" level="DEBUG"/>
    

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores con agentes privados Jitterbit.

  5. Si usas agentes privados, puedes consultar los registros del agente para obtener más información.

  6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.