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 o incidencia |
Posibles causas de la incidencia y pasos para resolverla |
---|---|
Conexión | |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Jira no está conectado: se produjo un 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 de Jira. Si no eres admin de equipo, pídele a esa persona que lo haga. |
La solicitud para Jira ... falló: se ha superado el límite de tiempo, el host es desconocido, la conexión fue 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 permisos 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 otros valores además de 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 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 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 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 conectarte nuevamente. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). Error de Jira: "No tienes permisos para crear un 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. |
Falló la solicitud de Jira: la creación de la ruta PKIX falló: no pudo encontrar una ruta de certificación válida para el objetivo 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 tus ajustes de HTTP/2 en los archivos de configuración de tu servidor web para corroborar que estén establecidos 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 un webhook para tarjetas de Jira. |
Aplicable a OAuth 1.0. Solo (Servidor y Centro de Datos de Jira). 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 estén activas: - Un tablero de Miro se movió o descargó a través de una copia de seguridad a un equipo desde otro. - Las incidencias de no actualización de Jira se movieron de un proyecto a otro del lado de Jira. - No tienes acceso a los proyectos en los cuales se encuentran las incidencias de Jira. - Las tarjetas que no se actualizan no se encuentran en la misma instancia de Jira que estás usando 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, sucede que el enlace de la aplicación en tu Jira no está configurado correctamente. |
El mensaje de errorpuede 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. |
|
Obtienes el mensaje: No estás conectado 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 o 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 de Convertir o Crear está inactivo. |
No tienes acceso al Proyecto en Jira. Comprueba si pueden darte acceso. |
No se puede crear una incidencia de Jira cuando intentas convertir o 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 o Editar incidencia de Jira. No se puede crear una incidencia de Jira. Los 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 mediante 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 o crear una tarjeta de Jira. |
No hay campo Informante en el campo de metadatos Crear de Jira: el campo no está disponible en Crear pantalla de Jira para el proyecto seleccionado. 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 admin de Jira que compruebe tus niveles de acceso y que se asegure de que tengas permiso para configurar o cambiar el campo Informante en el proyecto seleccionado. Para ello, debe iniciar sesión en Jira, > ir a Configuración > Incidencias > Esquemas de permisos > comprobar el campo Modificar informantes (agregar el acceso a aplicaciones: cualquier usuario registrado en caso de que no lo tenga 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. 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 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 |
- Cambiaste o eliminaste un webhook en el lado de Jira
Como solución, te sugerimos que deshabilites la integración y la vuelvas a conectar. |
Cuando usas Ctrl + V (para Windows) o Cmd + V (para Mac) a fin de 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 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. Verás la información en la barra lateral de tu tablero. |
"Se muestran 0 de 0 iteraciones de coincidencia" al tratar de buscar y encontrar iteraciones disponibles |
1. Sucede cuando no tienes iteraciones activas o futuras (todas están cerradas o 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" (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 o incidencia | Posibles causas de la incidencia y pasos para resolverla |
---|---|
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: |
Una pérdida momentánea de la conexión. En este caso, simplemente vuelve a intentarlo 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 sucede principalmente con Mozilla y Safari debido a sus nuevas políticas de seguridad. |