Si enfrentas un problema al instalar o usar tarjetas de Jira o el Complemento de Jira, esta guía puede ayudarte.
Sugerencias para las tarjetas de Jira
| Mensaje/problema | Causas posibles y pasos para resolver el problema |
|---|---|
|
Conexión |
|
|
Aplicable solo a OAuth 1.0. (Servidor y Centro de Datos de Jira) Jira no está conectado: Error al intentar conectarte a Miro con tus credenciales personales.
No se puede añadir tarjetas de Jira: Ventana emergente al intentar usar la aplicación de tarjetas de Jira en un tablero |
La aplicación de tarjetas de Jira está instalada, pero tu equipo de Miro no está conectado a Jira. Por favor, sigue esta guía de instalación: Cómo configurar y desinstalar las tarjetas de Jira. Si no eres admin de equipo, pídele a esa persona que lo haga. |
|
Solicitud a Jira ... falló: se produjo un tiempo de espera / Host desconocido / Conexión rechazada |
Solo es posible acceder a Jira en tu intranet (estás usando las direcciones IP incorrectas para comunicarte con el sistema de Jira). Asegúrate de incluir en la lista de permisos nuestra dirección IP, dominios y subdominios para proporcionar nuestra integración con el nivel de acceso necesario. Si estás en Jira Server y en una versión antigua, verifica que ninguna función oscura bloquee el acceso para Miro. |
| Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) solo. El enlace a la aplicación de tu Jira no está configurado correctamente |
- Has omitido algunos pasos en la configuración del webhook o el enlace - Has instalado el Addon de Jira en lugar de configurar el enlace para las tarjetas de Jira. Prueba instalar la integración de las tarjetas de Jira desde cero. Si eliges crear el webhook manualmente, prueba crearlo de forma automática. |
|
Aplicable a OAuth 1.0. (Solo Servidor y Centro de Datos de Jira). El enlace de la aplicación en tu instancia de Jira no está configurado correctamente, o el token ha vencido. Comprueba el enlace de la aplicación y vuelve a conectar la integración. |
- Se reconfiguró el enlace de la aplicación en Jira - El token ha vencido - El token ha sido revocado Asegúrate de que tu enlace de la aplicación esté configurado correctamente e intenta conectar nuevamente Miro a las tarjetas de Jira. Si estás usando un Jira altamente protegido o utilizas un proxy, asegúrate de incluir nuestras direcciones IP, dominios y subdominios en la lista de permitidos para proporcionar a nuestra integración el nivel de acceso necesario. Si estás en el servidor de Jira y en una versión anterior, verifica que ninguna función oculta bloquee el acceso para Miro. |
|
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) únicamente. Tu enlace de la aplicación pide más valores que solo URL, clave de consumidor, nombre de consumidor y clave pública |
Estás viendo la pestaña de Autenticación saliente del menú de configuración. - Cambia a la Autenticación entrante. La autenticación saliente no requiere configuración. - Si no puedes omitir el paso, agrega cualquier valor temporal. Podrás eliminarlo más adelante: cuando estés en la página con tu lista de enlaces de la aplicación, haz clic para editar el enlace de las Tarjetas de Miro y elimina los valores temporales. |
|
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) solo.
La URL de Jira no es válida /
|
Tu Jira está en una red privada/el firewall de tu empresa bloquea las conexiones de red externas.
Agrega nuestras direcciones IP del NAT Gateway (y puertos) a tu lista de admitidos. |
|
Usas un proxy / Tus URL de Jira externas e internas no coinciden. Asegúrate de completar el campo Jira URL con la dirección a la que podamos acceder, por lo que por favor configura un proxy inverso que nos permita el acceso y/o sigue los pasos de esta guía de Atlassian. Con esta solución, la integración podrá conectarse y remitir solicitudes de manera exitosa entre tu Jira y Miro si tus URL externas e internas son diferentes. | |
|
Hay una incidencia con tu certificado SSL (no se admiten certificados autofirmados).
Comprueba el certificado SSL activo en el servidor de Jira.
Esta herramienta
podría ser útil: ingresa tu URL de Jira y verás los resultados de la comprobación de conexión. | |
|
Tu Jira está bajo inicio de sesión único (también puede generar el error "La autenticación entrante no está configurada correctamente"). Asegúrate de que tu proceso de inicio de sesión único no se aplique a las solicitudes de conexión de nuestra integración. Para lograrlo, se deben excluir los siguientes puntos finales de los procesos de inicio de sesión único:
|
|
|
Comportamiento inesperado durante la instalación |
Usas las versiones de Jira 6.4 o anteriores. Nuestras tarjetas no funcionarán con estas versiones debido a este error de Jira. Actualiza tu Jira a la versión más reciente. |
| La autorización de la aplicación falló. Intenta autorizar de nuevo la aplicación. | 1. Una pérdida momentánea de la conexión. Haz clic en Conectar de nuevo. 2. Token expirado enviado durante el procedimiento de autorización. Limpia los datos en caché y empieza con un entorno limpio. En otras palabras, estimula a Jira a generar un nuevo token. |
|
Aplicable a OAuth 1.0. Solo (Jira Server y Data Center). Error de Jira: "No tienes permisos para crear Webhook 'Miro'." |
No tienes derechos de admin en Jira. Pide a tu admin de Jira que actualice tu rol a admin para que puedas configurar la integración. |
|
Solicitud a Jira fallida: la creación de la ruta PKIX falló: no se pudo encontrar una ruta de certificación válida para el objetivo solicitado |
Hay algún problema con tu certificado de servidor. |
|
Incapacidad para autorizar en Jira a través de Miro. |
Esto puede ocurrir debido a una configuración incorrecta de la infraestructura de Jira cuando esta configuración indica que es compatible con el protocolo HTTP/2, pero no se realiza ninguna transferencia de datos al intentar usarlo. Revisa tu configuración de HTTP/2 en los archivos de configuración de tu servidor web para corroborar que estén configurados correctamente. Si es necesario, deshabilita temporalmente el soporte HTTP/2 en la configuración de tu servidor para garantizar la compatibilidad con versiones anteriores y el servicio ininterrumpido hasta que se resuelva la incidencia. |
Trabajar con tarjetas |
|
|
Las tarjetas de Jira no se están actualizando
|
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) solo. Estás usando un webhook manual. Deshabilita la integración y vuelve a conectarla usando un webhook automático. Si todo funciona bien con un webhook automático, significa que se configuró uno manual de forma incorrecta. También, consulta Cómo configurar un WebHook para tarjetas de Jira. |
|
Aplicable a OAuth 1.0 y OAuth 2.0 (Jira Server & Data Center). Si estás usando un webhook automático, el primer paso de resolución de problemas es volver a conectar la integración. Si esto no ayuda, puede haber varias razones por las cuales las tarjetas de Jira ya no se estén actualizando. Por ejemplo: - un tablero de Miro fue movido o descargado a través de una copia de seguridad a un equipo diferente - las incidencias de Jira se movieron de un proyecto a otro en el lado de Jira - no tienes acceso a los proyectos en los cuales se encuentran las incidencias de Jira - (Solo Enterprise) el propietario del tablero está desactivado o tiene una licencia gratuita limitada - (Solo OAuth1.0) las tarjetas de Jira no están ubicadas en la misma instancia de Jira que estás usando actualmente en tu navegador | |
|
Aplicable solo a OAuth 1.0. (Servidor y Centro de Datos de Jira). Las tarjetas de Jira dejaron de actualizarse sin ningún cambio de tu parte y al intentar volver a conectar el enlace de la aplicación en tu Jira no está configurado correctamente. |
El mensaje de error puede aparecer cuando Miro no puede solicitar un Jira conectado debido a un error de autorización. Esto puede ocurrir si el usuario que configuró la integración revoca su token o si Jira está de alguna manera configurado con un ciclo de duración corto para el token emitido, por lo que simplemente deja de ser válido después de ese tiempo y tiene que ser reconectado para obtener un nuevo token de autorización válido que Miro use para acceder a Jira. |
|
La opción Editar tarjeta genera una ventana en blanco |
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) únicamente. Usas Jira versión 7.6 y posteriores. Por razones de seguridad, Atlassian podría no permitir que el contenido se integre en iFrames, lo que también podría afectar las ventanas emergentes para editar tus tarjetas de Jira. Puedes usar estas instrucciones como una solución alternativa. |
|
No se pudo agregar tarjetas de Jira |
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) solo. Has creado un webhook manual y no has guardado la información de la configuración. Verifica si el campo URL de Jira está completado en la Configuración de Miro. Asegúrate de hacer clic en Conectar |
|
El ícono de Editar no se muestra
|
Aplicable a OAuth 1.0. (Solo en el Servidor y Centro de Datos de Jira). Usas las versiones de servidor de Jira 7.6 o posteriores. El ícono de Editar podría no aparecer debido a una actualización de seguridad en esta versión. |
|
Tu perfil no está autorizado para editar la incidencia de Jira en cuestión. Comprueba si puedes acceder al modo de edición después de haber abierto la incidencia del lado de Jira. |
|
|
Obtienes el mensaje: No has iniciado sesión y no tienes los permisos necesarios para actuar sobre la incidencia seleccionada como invitado. Por favor inicia sesión |
Debido a la forma en que nuestra integración utiliza cookies, tu Jira podría no permitir que inicies sesión desde esta página.
Inicia sesión en Jira en otra pestaña del navegador. |
|
Tu Jira está bajo inicio de sesión único y tu IdP no permite la autenticación a través de iframes. Si estás trabajando en la aplicación de escritorio de Miro te recomendamos que cambies a la versión de navegador de Miro en miro.com. |
|
|
No hay opción de convertir/crear una tarjeta de Jira en Miro cuando eliges algunos proyectos en particular: - no hay datos en el campo tipo de incidencia
- el botón Convertir/Crear está inactivo |
No tienes acceso al Proyecto en Jira. Comprueba si pueden darte acceso. |
|
No se puede crear una incidencia de Jira al intentar convertir/crear una nueva tarjeta de Jira: |
No tienes permiso para crear incidencias de Jira.
Comunícate con tu admin de Jira y pídele que te conceda el permiso necesario por parte de Jira. Así es como debería verse: |
|
Algunos campos personalizados no se muestran en el menú Convertir a incidencia de Jira/Editar incidencia de Jira No se puede crear una incidencia de Jira. Campos requeridos (...) no son compatibles error al crear una incidencia de Jira dentro de Miro |
Los campos no están habilitados en el selector de tarjetas de Jira del tablero. Usa nuestro selector de Jira en la aplicación para configurar campos personalizados siguiendo los pasos de esta guía. |
| Si Seleccionar campos para mostrar en las tarjetas no muestra campos personalizados de tu Jira, es posible que algunas de las Pantallas configuradas para los proyectos de tu instancia de Jira protejan los campos de Miro. Ve a Configuración del proyecto > Pantallas > Esquema de pantalla predeterminado y comprueba si los campos necesarios están permitidos. | |
|
Miro no admite campos de tipo de datos complejos. Miro admite campos personalizados básicos pero no campos complejos. Configura los campos de la tarjeta de Jira y elimina aquellos campos que no sean compatibles. |
|
|
No puedes elegir al Informante cuando editas/creas una tarjeta de Jira |
No hay campo Informante en los metadatos de Crear de Jira: el campo no está disponible en la pantalla Crear de Jira para el proyecto seleccionado. Ve a Configuración del proyecto > Pantallas y comprueba si el campo Informante está presente en la pantalla Crear. |
|
No tienes el permiso necesario para configurar el informante para incidencias en el proyecto seleccionado.
Pídele al Administrador de Jira que compruebe tus niveles de acceso y que se asegure de que tengas permiso para configurar/cambiar el campo Informante en el proyecto seleccionado. Para hacerlo, necesitan iniciar sesión en Jira > ir a Configuración > Incidencias > Esquemas de permisos > y revisar el Modificar Informante (por favor, añade el Acceso a la aplicación: Cualquier usuario registrado en caso de que no lo tengas en la lista): |
|
|
El campo Informante no se puede editar para el rastro de auditoría y está configurado para quien creó la incidencia. Que el campo no esté disponible es un comportamiento previsible. |
|
|
Algunos campos se muestran en el modo de edición de una tarjeta, pero no aparecen en las tarjetas de Jira en los tableros |
Miro no recibe actualizaciones de Jira.
|
|
Aplicable a OAuth 1.0. (Solo Servidor y Centro de Datos de Jira).
Jira no está disponible error en la Configuración de la Aplicación de Tarjetas de Jira |
1. Pídele al admin de equipo que deshabilite y vuelva a conectar la integración. 2. Tu Jira está bajo protección (firewall, bloqueos de seguridad, etc.) y Miro no puede llegar a él. Si las tarjetas de Jira sincronizan al mismo tiempo entre Miro y Jira, significa que tu Jira puede enviarnos webhooks. Por eso puedes ver las actualizaciones en tus tableros.
Si estás en Jira Server y en una versión más antigua, verifica que ninguna Función Oculta bloquee el acceso a Miro. |
|
Aplicable a OAuth 1.0. (Servidor y Centro de Datos de Jira) solamente. Problemas de webhook de Jira error en la configuración de la aplicación de tarjetas de Jira |
- Cambiaste/eliminaste un webhook en el lado de Jira
Como solución, te sugerimos que deshabilites la integración y la vuelvas a conectar desde cero. |
|
Cuando usas Ctrl + V (para Windows)/Cmd + V (para Mac) para pegar un enlace de una incidencia de Jira en el tablero, no se convierte en una tarjeta de Jira, sino que se pega como una URL |
El tablero todavía se está cargando. Puede ocurrir en tableros más grandes o tableros con imágenes más grandes o documentos PDF. Espera por lo menos 10 segundos después de abrir el tablero y deja que el tablero se cargue por completo.A continuación, intenta pegar el enlace nuevamente. |
|
La descripción no está visible en las tarjetas de Jira en el tablero |
Para ver los detalles de la tarjeta, haz clic en la tarjeta y elige expandir para ver los detalles de la tarjeta en la barra lateral de tu tablero. |
|
"Mostrando 0 de 0 iteraciones de coincidencia" al tratar de buscar y encontrar iteraciones disponibles |
1. Sucede cuando no tienes iteraciones activas/futuras (todas están cerradas/completadas). 2. Tu filtro en Jira no incluye ningún proyecto. Agrega un proyecto necesario al JQL para el filtro del tablero. Así, aparecerán las iteraciones, tanto en Jira como en Miro. |
|
Aplicable a OAuth 1.0. (Solo Servidor y Centro de Datos de Jira). La conexión SSL con ... falló |
El error significa que Miro no tiene acceso a tu Jira. |
| Ningún usuario muestra el campo "Assignee" de la tarjeta de Jira en Miro |
Asegúrate de tener el permiso "Browse users" configurado a nivel global en Jira. Aprende más sobre cómo gestionar permisos globales. |
Sugerencias para el Complemento de Jira
| Mensaje / problema | Posibles causas y pasos para resolver el problema |
|---|---|
| No has iniciado sesión y no tienes los permisos necesarios para actuar sobre la incidencia seleccionada como invitado. Por favor, inicia sesión |
Desafortunadamente, debido a que nuestro complemento usa cookies, Jira no te permitirá iniciar sesión desde esta página. Inicia sesión en Jira en otra pestaña del navegador. |
|
Después de hacer clic en el botón Instalar en la página del complemento, podrías ver el siguiente error: |
Una pérdida momentánea de la conexión. En este caso, simplemente vuelve a intentar instalar un minuto más tarde. |
Durante la configuración del Complemento de Jira o después de ella, no puedes pasar a la página siguiente en un paso |
Algo en tus cookies o la caché detiene el proceso. Borra la memoria de tu navegador para el dominio atlassian.com e intenta de nuevo. |
Después de una instalación exitosa, tus usuarios de Jira que no están registrados en Miro ven el menú de inicio de sesión de Miro en lugar del tablero adjunto. |
Las políticas de Jira bloquean algunas de las funciones del plugin. Lamentablemente, este comportamiento está causado por la actualización más reciente de la API de Jira y no se puede modificar en este momento. |
|
El complemento no recuerda tu autorización y sigue pidiendo que inicies sesión cada vez. Cuando intentas agregar tableros a una incidencia de Jira, aparece un selector de tableros que muestra el error "Lo sentimos, la integración no está disponible". |
Las cookies de terceros están bloqueadas en tu navegador. Como solución, sigue la instrucción sobre cómo habilitar las cookies en tu navegador. Esto sucede principalmente con Mozilla y Safari debido a sus nuevas políticas de seguridad. |