Si te encuentras con una incidencia al instalar o usar las tarjetas de Jira o el Complemento de Jira, esta guía puede ayudarte.
Sugerencias para las tarjetas de Jira
Mensaje/incidencia | Posibles causas y pasos para resolver la incidencia |
---|---|
Conexión |
|
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Jira no está conectado: Error al intentar conectarte a Miro con tus credenciales personales. No se pueden agregar tarjetas de Jira: Mensaje emergente al tratar de 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. Sigue esta guía de instalación: Cómo configurar y desinstalar Tarjetas Jira Si no eres admin de equipo, pídele a esa persona que lo haga. |
Solicitud a Jira ... fallida: Se ha agotado el tiempo de espera / Host desconocido / Conexión denegada |
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 agregar nuestra dirección IP, nuestros dominios y subdominios a tu lista de admitidos para posibilitar nuestra integración con el nivel de acceso necesario. Si estás en el Servidor de Jira y en una versión anterior, comprueba dos veces que ninguna función oculta bloquee el acceso a Miro. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). 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 Complemento de Jira en lugar de configurar el enlace para las tarjetas de Jira. Prueba desinstalar 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 las tarjetas de Jira con Miro. Si estás usando un Jira altamente protegido o un proxy, asegúrate de incluir nuestra dirección IP, nuestros dominios y subdominios en la lista de admitidos para posibilitar nuestra integración con el nivel de acceso necesario. Si estás en el Servidor de Jira y en una versión anterior, comprueba dos veces que ninguna función oculta bloquee el acceso a Miro. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Tu enlace de la aplicación pide más valores que solo la URL, la clave del consumidor y la 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. Solo (Servidor y Centro de Datos de Jira). 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 de NAT Gateway (y puertos) a tu lista de admitidos. |
Usas un proxy/Tus URL de Jira internas no coinciden Asegúrate de rellenar el campo URL de Jira con la dirección a la que podemos acceder. Configura un proxy inverso que nos permita acceder y/o seguir 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 externa e interna 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 puede serte útil: introduce tu URL de Jira y verás los resultados de la comprobación de la conexión. |
|
Tu Jira está bajo SSO (también puede generar el error La autenticación entrante no está configurada correctamente). Asegúrate de que tu proceso de SSO 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 SSO: POST {JIRA_URL}/plugins/servlet/oauth/request-token
POST {JIRA_URL}/plugins/servlet/oauth/access-token
GET {JIRA_URL}/rest/api/2/serverInfo
|
|
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 la aplicación nuevamente. |
Una pérdida momentánea de la conexión. Haz clic para conectar nuevamente. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Error de Jira: "No tienes permisos para crear el webhook 'Miro'". |
No tienes derechos de administrador en Jira. Pide a tu administrador de Jira que actualice tu rol a admin para que puedas configurar la integración. |
Solicitud a Jira fallida: Error en la creación de la ruta PKIX: no se ha podido encontrar una ruta de certificación válida para el destino solicitado. |
Hay alguna incidencia 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. Solo (Servidor y Centro de Datos de Jira). 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. Además, consulta Cómo configurar WebHook para tarjetas de Jira. |
Aplicable a OAuth 1.0 y OAuth 2.0 (Servidor y Centro de Datos de Jira). Si utilizas un webhook automático, el primer paso para solucionar el problema es volver a conectar la integración. Si esto no ayuda, puede haber varias razones por las que las tarjetas de Jira ya no se actualizan. Por ejemplo: - un tablero de Miro fue movido o descargado mediante 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 donde se encuentran las incidencias de Jira - (Sólo empresas)el propietario del tablero está desactivado o tiene una licencia gratuita limitada - (sólo OAuth1.0) las tarjetas de Jira no se encuentran en la misma instancia de Jira que estás utilizando actualmente en tu navegador |
|
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Las tarjetas de Jira dejaron de actualizarse sin ningún cambio de tu lado 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á configurado de alguna manera 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 con el cual Miro pueda acceder a Jira. |
La opción Editar tarjeta genera una ventana en blanco |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). 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 práctica. |
No puedes agregar tarjetas de Jira |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Has creado un webhook manual y no has guardado la información de la configuración. Comprueba si el campo de la URL de Jira está completo en la configuración de Miro. Asegúrate de hacer clic en Conectar |
El ícono de Editar no aparece
|
Aplicable a OAuth 1.0. Solo (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. |
|
Entiende el mensaje: No has iniciado sesión y no tienes los permisos necesarios para actuar sobre la incidencia seleccionada como invitado. 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 SSO 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 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 Jira: |
No tienes permiso para crear incidencias de Jira. Comunícate con tu administrador 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. Los campos requeridos (...) no son compatibles/span>, 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 > 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 los campos que no sean compatibles. |
|
No puedes elegir el Informante al editar/crear una tarjeta de Jira. |
No hay campo Informante en Crear metadatos: el campo no está disponible en Jira, crea la pantalla para el proyecto seleccionado de Jira. Ve a Configuración del proyecto > Pantallas y comprueba si el campo Informante está presente en Crear pantalla. |
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 ello, tienen que iniciar sesión en Jira > ir a Configuración > Incidencias > Esquemas de permisos > y marcar el campo Modificar reportero (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). Error: Jira no está disponible en la configuración de aplicación de tarjetas de Jira |
1. 1. Pídele al Administrador del equipo que desactive y vuelva a conectar la integración. 2. 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 el Servidor de Jira y en una versión anterior, comprueba dos veces que ninguna función oculta bloquee el acceso a Miro. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Error de incidencias webhook de Jira en la configuración de la aplicación de tarjetas de Jira |
- Has cambiado/borrado un webhook en el lado de Jira
Como solución, te sugerimos que desactives la integración y la vuelvas a conectar. |
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./span> |
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. 1. Sucede cuando no tienes iteraciones activas/futuras (todas están cerradas/completadas). 2. 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" (asignado) de la tarjeta de Jira en Miro |
Asegúrate de tener el permiso "Browse users" (navegar por usuarios) configurado a nivel global en Jira. Más información sobre cómo administrar los permisos globales. |
Sugerencias para el Complemento de Jira
Mensaje/incidencia | Posibles causas y pasos para resolver la incidencia |
---|---|
No has iniciado sesión y no tienes los permisos necesarios para actuar sobre la incidencia seleccionada como invitado. 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: hiccup.png |
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 las instrucciones para habilitar las cookies en tu navegador. Esto ocurre sobre todo con Mozilla y Safari debido a sus nuevas políticas de seguridad. |