Pruebas y resolución de problemas - Jira Cloud
Probar la integración
Toma un error de baja importancia de un proyecto de pruebas y crea un ticket a partir de él. Comprueba en Jira el tipo de incidencia (debería parecerse a 'Bug', no ser un epic ni una subtarea), el contenido de la descripción y si el responsable y el estado inicial coinciden con la configuración del proyecto. Para comprobar la sincronización de vuelta, cambia ese ticket a mano en Jira a un estado de la categoría Done y espera hasta cinco minutos - el estado del error en DockRay debería pasar a resuelto sin ninguna acción por tu parte.
Problemas habituales
El ticket recibe un tipo de incidencia inesperado
DockRay tiene que reconocer el tipo 'error' con independencia del idioma de Jira - Jira Cloud traduce los nombres de los tipos al idioma de la cuenta, y la lista de tipos empieza por el epic. Por eso la integración primero descarta las subtareas y todo lo que está al nivel de epic o iniciativa, y solo entonces busca entre lo que queda un nombre parecido a 'Bug' y, en segundo lugar, a 'Task'. Si el esquema de tipos del proyecto de Jira no tiene ninguno de los dos, el ticket de todos modos no se convertirá en un epic: recibirá el primer tipo disponible a nivel de trabajo normal, a veces algo como 'Story'. Solución: añade al proyecto de Jira un tipo de incidencia equivalente a un error.
La clave del proyecto de Jira se rechaza
La clave debe empezar por una letra mayúscula y contener solo letras mayúsculas, dígitos y guion bajo. Una clave escrita en minúsculas, o con espacio, guion u otro carácter especial, se rechaza - no es una validación excesiva, sino protección frente a sacar la petición fuera del endpoint de la API previsto.
El estado del error no vuelve al panel de inmediato
Así está previsto. La sincronización de estado es periódica, no instantánea - los webhooks dinámicos de Jira Cloud requieren una aplicación OAuth/Connect registrada, que no se puede dar de alta solo con el token de API del cliente. El comando thor:sync-jira consulta los tickets vinculados cada cinco minutos, así que un retraso de hasta cinco minutos es normal, no una avería.
La conexión termina con un error de autenticación
Comprueba si el correo y el token de API pertenecen a la misma cuenta de Atlassian, si el token se ha revocado en los ajustes de Atlassian y si la dirección de la instancia realmente está en el dominio *.atlassian.net - cualquier otra dirección la rechaza la integración antes incluso de intentar conectar.
La integración deja de funcionar tras cambiar los ajustes del proyecto
Ocurre tras pasar un proyecto de sus propias credenciales a heredarlas de la cuenta, si mientras tanto también ha desaparecido la conexión a nivel de cuenta. Revisa ambos niveles por turno: la configuración del proyecto y la de la cuenta - un proyecto sin ninguna de las dos no tiene de dónde tomar credenciales.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.