Integración con Jira

Convierte una respuesta en una incidencia de Jira sin copiar y pegar: la incidencia se crea directamente desde la página de la respuesta, ya rellenada con las respuestas, la página en la que estaba el visitante y su navegador, y enlaza de vuelta a la respuesta. Disponible en los planes Business y Enterprise, para Jira Cloud (tu-empresa.atlassian.net).

Solo se admite Jira Cloud: las incidencias se crean a través de su REST API v3. Jira Server y Data Center (Jira alojado en tu propia dirección) no se pueden conectar.

Conectar Jira

Un administrador del espacio conecta Jira una sola vez desde Configuración → Integraciones, y a partir de ahí cualquiera del espacio puede crear incidencias.

La tarjeta de Jira en la página de integraciones, conectada: el sitio, la cuenta con la que se crean las incidencias y el proyecto y tipo de incidencia predeterminados — Conectado: el sitio, la cuenta con la que se crean las incidencias y los valores con los que empieza el diálogo.

Crea un token de API en la configuración de tu cuenta de Atlassian (Security → API tokens).
En la tarjeta Jira, introduce la dirección de tu Jira (https://tu-empresa.atlassian.net; también sirve un enlace copiado del navegador), el correo de la cuenta de Atlassian a la que pertenece el token y el token.
Pulsa Connect Jira. Voxtrics comprueba los datos con Jira antes de guardarlos, así que un error de escritura aparece en ese momento y no con la primera incidencia.

El token se guarda cifrado y no se vuelve a mostrar. Para cambiar más adelante el sitio, la cuenta o el token, usa Edit connection; si dejas el token vacío se conserva el guardado, siempre que el sitio y el correo no cambien.

Todas las incidencias las informa la cuenta a la que pertenece el token, con sus permisos en Jira. Una cuenta dedicada (por ejemplo [email protected]) con acceso solo a los proyectos a los que quieras enviar respuestas lo mantiene ordenado.

Valores predeterminados

Una vez conectado, elige un Default project y un Default issue type. El diálogo de creación empieza con ellos y se pueden cambiar en cada incidencia. Solo aparecen los proyectos en los que la cuenta conectada puede crear incidencias, y las subtareas quedan fuera: una respuesta no tiene incidencia padre.

Crear una incidencia desde una respuesta

Abre cualquier respuesta y busca la tarjeta Jira a la derecha. Create Jira issue abre un diálogo con:

Project e Issue type, empezando por tus valores predeterminados.
Summary: el nombre de la encuesta y las palabras del propio visitante (el texto principal), o la puntuación y la página si no hay texto.
Description: todas las respuestas, la URL de la página, la encuesta, cuándo se envió y el navegador, el SO, el dispositivo, el tamaño de la ventana y el idioma. Edítala libremente.
Attach the page snapshot: aparece cuando la respuesta tiene una captura de la página o del elemento que eligió el visitante.

El diálogo Create Jira issue con el proyecto, el tipo de incidencia, el resumen y la descripción rellenados y la casilla de la captura de la página — Todo viene rellenado a partir de la respuesta: edita lo que necesites y pulsa Create issue.

Pulsa Create issue. Voxtrics siempre añade al final de la descripción un enlace a la respuesta, para que quien recoja la incidencia en Jira pueda abrir la respuesta completa; se abre en el sitio correcto incluso en una pestaña nueva. La nueva incidencia aparece en la tarjeta Jira de la respuesta y en su registro de actividad.

Una respuesta se puede enviar hasta tres veces (por ejemplo, un error y una mejora); el diálogo indica con qué incidencias está ya vinculada. Cuando ya tiene tres, la tarjeta de Jira lo indica en lugar de ofrecer otra.

Quién puede hacer qué

Conectar, editar o desconectar Jira: los administradores del espacio.
Crear incidencias desde respuestas: administradores y managers; en encuestas restringidas por equipos, desde el rol Writer (las mismas personas que pueden cambiar el estado de una respuesta).
Ver las incidencias vinculadas a una respuesta: cualquiera que pueda abrir la respuesta.

Si algo falla

"Jira did not accept this email and API token": comprueba que el correo es el de la cuenta con la que se creó el token y que el token se copió entero.
"Jira no longer accepts the saved API token": los tokens de Atlassian caducan y se pueden revocar. La tarjeta de Jira muestra Needs attention; crea un token nuevo y guárdalo con Update token.
Jira rechazó crear la incidencia: normalmente un campo obligatorio en tu proyecto de Jira que el diálogo no rellena (por ejemplo, un componente). El mensaje cita el motivo que da Jira.

Desconectar

Disconnect borra el token guardado; nadie puede crear incidencias hasta que Jira se vuelva a conectar. Las incidencias ya creadas siguen en Jira y siguen vinculadas a sus respuestas.