Si te encuentras con un problema al instalar o usar las Tarjetas Jira o el complemento de Jira, esta guía podría ayudarte.
Sugerencias para las Tarjetas Jira
Mensaje/problema |
Posibles causas y pasos para resolver el problema |
---|---|
Conexión |
|
Jira no está conectado: error al intentar conectarte a Miro con tus credenciales personales. No se pueden agregar Tarjetas Jira: mensaje emergente al tratar de usar la aplicación de Tarjetas Jira en un tablero |
La aplicación de Tarjetas 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. |
La solicitud para Jira ... falló: se ha superado el límite de tiempo/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 permisos para posibilitar nuestra integración con el nivel de acceso necesario. |
El enlace a tu aplicación de Jira no está configurado correctamente |
- Omitiste algunos pasos en la configuración del webhook o el enlace - Instalaste el complemento de Jira en lugar de configurar el enlace para las Tarjetas Jira. Prueba desinstalar la integración de las Tarjetas Jira desde cero. Si eliges crear el webhook manualmente, prueba crearlo de forma automática. |
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. |
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 Outgoing Authentication (autenticación saliente) del menú de configuración. - Cambia a Incoming Authentication (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. |
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 permisos. |
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 un problema 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 conectar nuevamente. |
Error de Jira: "No tienes permisos para crear Webhook 'Miro'". |
No tienes derechos de administrador en Jira. Pídele a tu administrador de Jira que actualice tu función 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 algún problema con tu certificado de servidor. |
Trabajar con tarjetas |
|
Las Tarjetas Jira no se están actualizando
|
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 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 Jira ya no estén activas: - Un tablero de Miro se movió/descargó a través de una copia de seguridad a un equipo desde otro. - Los problemas 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 los problemas 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. |
|
Las Tarjetas 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 Edit card (editar tarjeta) genera una ventana en blanco |
Usas una versión de Jira 7.6 y posterior. 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 Jira. Puedes usar estas instrucciones como una solución práctica. |
No puedes agregar Tarjetas 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 los ajustes de Miro. Asegúrate de hacer clic en Connect (conectar) |
El icono Edit (editar) no aparece
|
Usas las versiones de servidor de Jira 7.6 o posteriores. El icono Edit (editar) podría no aparecer debido a una actualización de seguridad en esta versión. |
Tu perfil no está autorizado para editar el problema de Jira en cuestión. Comprueba si puedes acceder al modo de edición después de haber abierto el problema del lado de Jira. |
|
Obtienes el mensaje: No estás conectado y no tienes los permisos necesarios para actuar sobre el problema seleccionado 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 Issue type (tipo de problema) - El botón Convert/Create (convertir/crear) está inactivo |
No tienes acceso al proyecto en Jira. Comprueba si pueden darte acceso. |
No se puede crear un problema de Jira al intentar convertir/crear una nueva Tarjeta Jira: |
No tienes permiso para crear problemas 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 problema de Jira/Editar problema de Jira. No se puede crear un problema de Jira. Los campos requeridos (...) no son compatibles, error al crear una problema de Jira dentro de Miro |
Los campos no están habilitados en el selector de Tarjetas Jira del tablero. Usa nuestro selector de Jira en la aplicación para configurar campos personalizados siguiendo los pasos de esta guía. |
Si la opción Select fileds to display on cards (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 Project settings (ajustes del proyecto) > Default Screen Scheme (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 jira y elimina los campos que no sean compatibles. |
|
No puedes elegir el Reporter (informante) al editar/crear una Tarjeta Jira. |
No hay campo Reporter (informante) en Create metadata (crear metadatos): el campo no está disponible en Jira, crea la pantalla para el proyecto seleccionado de Jira. Ve a Project settings (configuración del proyecto) > Screens (pantallas) y comprueba si el campo Reporter (informante) está presente en Create screen (crear pantalla). |
No tienes el permiso necesario para configurar el informante para problemas 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/cambiar el campo Reporter (informante) en el proyecto seleccionado. Para ello, debe iniciar sesión en Jira, ir a Settings (configuración) > Issues (problemas) > Permission schemes (esquemas de permisos) y comprobar el campo Modify Reporter (modificar informante) (agregar Application access: Any logged in user (acceso a aplicaciones: cualquier usuario registrado) en caso de que no lo tengas en la lista): |
|
El campo Reporter (informante) no se puede editar para el rastro de auditoría y está configurado para quien creó el problema. 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 Jira en los tableros |
Miro no recibe actualizaciones de Jira.
|
Error: Jira no está disponible en la configuración de aplicación de Tarjetas de Jira |
1. Pídele al admin del equipo que desactive 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 Jira se sincronizan al mismo tiempo entre Miro y Jira, significa que tu Jira puede enviarnos webhooks. Por eso puedes ver las actualizaciones en tus tableros.
|
Error de problemas webhook de Jira en los ajustes de la aplicación de Tarjetas Jira |
- Cambiaste/eliminaste 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 (en Windows)/Cmd + V (en Mac) para pegar un enlace de un problema de Jira en el tablero, no se convierte en una Tarjeta 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 Jira en el tablero |
La descripción de una tarjeta puede estar oculta si te alejas. Para ver la descripción, es posible que debas ampliar la tarjeta o acercarte (la descripción se vuelve parcialmente visible acercando al triple) |
"Mostrando 0 de 0 iteraciones de coproblema" 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. |
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 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/problema | Posibles causas y pasos para resolver el problema |
---|---|
No has iniciado sesión y no tienes los permisos necesarios para actuar sobre el problema seleccionado como invitado. Inicia sesión |
Lamentablemente, debido a la forma en que el plugin utiliza las 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 Install (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 un problema 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. |