Saltar al contenido

Guía de Conexión de Jira

Esta guía de conexión le explicará cómo conectar Vinyl a Jira. Jira es una herramienta de seguimiento de errores utilizada en la gestión ágil de proyectos y forma parte del conjunto de productos Atlassian.

Advertencia

Después de establecer una conexión de Jira con Vinyl, debe restringir la lógica utilizada para mostrar los datos de Jira en la página para que no consulte todos los registros. De lo contrario, es posible que la aplicación Vinyl parezca no responder.

Requisitos Previos

  • Debes tener instalado Vinyl 3.3+
  • Debes tener una cuenta Atlassian
  • Debes tener un token API válido para la cuenta Atlassian

Configuración en Atlassian

Crea un token API desde tu cuenta de Atlassian:

  1. Inicie sesión en https://id.atlassian.com/manage-profile/security/api-tokens
  2. Haga clic en Crear token de API
  3. Ingrese una Etiqueta clara y concisa para el token y haga clic en Crear.
  4. Haga clic en Copiar al portapapeles y pegue el token en una ubicación segura para guardarlo. Esta información será necesaria en los pasos de configuración de Vinyl.

Configuración en Vinyl

Crear un Servidor de Datos Jira

  1. Navegue hasta el Vinyl IDE
  2. Haga clic en Servidores de datos en el menú Conectar.

  3. Haga clic en el botón + Servidor y proporcione 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. Haga clic en Guardar

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

  7. Ingrese el token API en el campo Avanzado, usando el formato APIToken=<yourAPIToken>

    Ejemplo de valor del token API ingresado en el campo Avanzado

  8. Haga clic en Guardar

Importe los Datos de Jira para Mostrarlos en Vinyl

  1. Navegue hasta el Vinyl IDE
  2. Haga clic en Servidores de datos en el menú Conectar.
  3. Localice la fuente de datos de Jira y haga clic en el botón Detalles en el panel derecho.
  4. Haga clic en el botón Importar

  5. Determine qué esquema desea importar:

    • Importar desde patrón: le permite importar solo las tablas especificadas en este campo. Los prefijos se pueden usar para importar solo un subconjunto de tablas, por ejemplo MyApp_* sólo importará tablas que comiencen con MyApp_. Si deja el campo en blanco, se importarán todas las tablas.
    • Haga clic en Continuar cuando se le solicite. Vinyl 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 Importar esquema correspondientes.

Después de importar los datos, puede crear Business Logic para usar en paneles y mostrar datos de Jira en páginas de su aplicación Vinyl.

Solución de Problemas

  • Si no ve ninguna opción disponible para la fuente de datos de Jira desde el botón Importar de Vinyl, verifique que haya ingresado un token API válido.
  • Si Vinyl parece no responder al intentar cargar una página de aplicación con datos de Jira, o si Jira muestra el mensaje "Algo salió mal", revise la lógica que se utiliza para asegurarse de que está restringiendo los datos que se devuelven a criterios más razonables.