Saltar al contenido

Guía de conexión de Jira para Jitterbit App Builder

Esta guía de conexión te guiará a través de cómo conectar App Builder a Jira. Jira es una herramienta de seguimiento de errores utilizada en la gestión de proyectos ágiles y forma parte de la suite de productos de Atlassian.

Advertencia

Después de establecer una conexión de Jira a App Builder, necesitas restringir la lógica utilizada para mostrar los datos de Jira en la página para que no esté consultando todos los registros. No hacerlo puede resultar en que la aplicación de App Builder aparezca como no receptiva.

Requisitos previos

  • Debes tener una cuenta de Atlassian
  • Debes tener un Token de API válido para la cuenta de Atlassian

Configuración en Atlassian

Crea un token de API desde tu cuenta de Atlassian:

  1. Inicia sesión en https://id.atlassian.com/manage-profile/security/api-tokens
  2. Haz clic en Crear token de API
  3. Ingresa una Etiqueta clara y concisa para el token y haz clic en Crear
  4. Haz clic en Copiar al portapapeles y pega el token en un lugar seguro para guardarlo. Esta información será necesaria en los pasos de configuración de App Builder.

Configuración en App Builder

Crear un servidor de datos de Jira

  1. Navega a la IDE de App Builder
  2. Haz clic en Servidores de datos en el menú Conectar

  3. Haz clic en el botón + Servidor y proporciona la siguiente información:

    • Nombre del servidor: Nombre identificable para la conexión del servidor. Por ejemplo: Jira
    • Tipo: Jira
    • Url: Dominio base para la instancia de Atlassian Cloud. Por ejemplo: https://yourcompany.atlassian.net/

  4. Haz clic en Guardar

  5. Haz clic en el botón Configuración avanzada
  6. Haz clic en Editar

  7. Ingresa el Token de API en el campo Avanzado, utilizando el formato APIToken=<tuTokenDeAPI>

    Ejemplo de valor de token de API ingresado en el campo avanzado

  8. Haz clic en Guardar

Importar los datos de Jira para mostrar en App Builder

  1. Navega al IDE del App Builder
  2. Haz clic en Servidores de Datos en el menú Conectar
  3. Localiza la fuente de datos de Jira y haz clic en el botón Detalles en el panel derecho
  4. Haz clic en el botón Importar

  5. Determina qué esquema deseas importar:

    • Importar Desde Patrón: Permite importar solo las tablas especificadas en este campo. Se pueden usar prefijos para importar solo un subconjunto de tablas, por ejemplo, MyApp_* solo importará tablas que comiencen con MyApp_. Dejar el campo en blanco importará todas las tablas.
    • Haz clic en Continuar cuando se te solicite. El App Builder ejecutará la importación como una tarea en segundo plano.
    • Las pestañas Tablas, Vistas y Procedimientos enumeran todas las opciones disponibles junto con los botones correspondientes de Importar Esquema.

Después de importar los datos, puedes crear Lógica de Negocios para usar en paneles para mostrar datos de Jira en las páginas de tu aplicación de App Builder.

Solución de Problemas

Si experimentas problemas con Jira, se recomiendan los siguientes pasos de solución de problemas:

  1. Habilita el registro de datos para generar archivos de registro y datos, que puedes descargar e inspeccionar.

  2. Consulta la documentación del Proveedor ADO.NET de CData para Jira para obtener información detallada.

  3. Algunos errores específicos se enumeran a continuación con pasos de solución de problemas sugeridos:

    • Si no ves ninguna opción disponible para la fuente de datos de Jira desde el botón Importar del App Builder, verifica que hayas ingresado un Token de API válido.

    • Si el App Builder parece no responder al intentar cargar una página de la aplicación con datos de Jira, o Jira muestra un mensaje de "Algo salió mal", revisa la lógica que se está utilizando para asegurarte de que esté restringiendo los datos devueltos a criterios más razonables.