Disponible para: Jira Cloud, Jira Server (en el establecimiento) y Datacenter (protegido por LDAP también)
Configurado por: admin de equipo de Miro y admin del sistema de Jira con permisos administrativos del proyecto
⚠️ Si surge algún problema técnico, consulta nuestro artículo sobre Posibles problemas y cómo resolverlos.
💡 Obtén más información sobre las Tarjetas Jira en los artículos Preguntas frecuentes sobre las Tarjetas Jira y Cómo configurar webHook para Tarjetas Jira.
Cómo configurar Jira y Miro
✏️ Ten presente que los menús de Jira pueden diferir según la versión de Jira que estés usando. Sin embargo, el flujo general debería ser el mismo. Las siguientes instrucciones también se pueden encontrar en el Soporte de Atlassian.
Paso 1: enlace de la aplicación
Primero, crea un enlace de la aplicación y configúralo.
1. Ve a Jira Settings (Configuración de Jira) > Products (Productos) > Integrations (Integraciones) > Application links (Enlaces de aplicación).
2. Haz clic en Create new link (Crear enlace nuevo) (si estás usando las versiones más nuevas de Jira Cloud y Jira Server, elige Atlassian product/Create an incoming link [Producto Atlassian/Crear enlace entrante]). Escribe https://miro.com
Cómo agregar la dirección del sitio de Miro a la lista de enlaces de la aplicación
3. Luego, verás la siguiente ventana de diálogo. Verifica la URL o haz clic en Continue (Continuar):
Configurar la ventana de URL de la aplicación
4. En la ventana Link applications (Aplicaciones del enlace), completa el nombre de la aplicación y el tipo de aplicación, y haz clic en Continue (Continuar).
Los campos de nombre y tipo de aplicación son obligatorios
Verás el mensaje Application Link ‘APPLICATION_NAME’ created successfully (Se creó correctamente el enlace de la aplicación de APPLICATION_NAME) y aparecerá en la lista.
5. Ahora autentica la aplicación con tus datos de Miro. En la aplicación que aparece haz clic en Edit (Editar):
El enlace de la aplicación ya está creado y requiere configuración
6. Abre la pestaña Incoming Authentication OAuth (OAuth de autenticación entrante). Completa cuatro valores: URL, Consumer Key (Clave del consumidor), Consumer Name (Nombre del consumidor) y Public Key (Clave pública). Los valores son los mismos para todos los equipos de Miro.
Ventana de autenticación entrante
Para obtener los valores, inicia sesión en Miro y ve a Team settings (Configuración del equipo) > Apps & Integrations (Aplicaciones e integraciones) > Jira Cards (Tarjetas Jira).
Ten en cuenta que las Tarjetas están instaladas a nivel del equipo, así que si usas nuestro plan Enterprise, tendrás que elegir uno de los equipos de tu empresa (puedes conectar varios equipos a la misma instancia de Jira), de esta manera: Company settings (Configuración de la empresa) > Teams (Equipos). Elige un equipo de la lista y ve a Apps & Integrations (Aplicaciones e integraciones).
Si aún no tienes Tarjetas Jira en tu lista de aplicaciones, desplázate hasta la parte superior de la sección Apps & Integrations (Aplicaciones e integraciones), haz clic en Install apps (Instalar aplicaciones) y procede a instalar la aplicación desde Miro Marketplace. Después de que veas las Tarjetas Jira en la lista, haz clic en esa opción.
Se abrirá la pestaña de plugins y verás Step 1 (Paso 1) para obtener los valores necesarios para la autenticación en Jira:
Valores de Tarjetas Jira
Copia los valores de Miro y pégalos en la pestaña OAuth de Jira, y presiona Save (Guardar). Después de que Jira procese los valores, verás el mensaje de que Miro ahora está autorizado a procesar tus datos de Jira, con el estado Configured (Configurado):
El estado de configuración correcta
Paso 2: conexión
Vuelve a Miro y abre la configuración de la aplicación de las Tarjetas Jira (Team settings [Ajustes de equipo] > Apps & Integrations [Apps e integraciones] > Jira cards [Tarjetas Jira]).
Elige una de las dos opciones: crear un webhook de forma manual o automática. Dependiendo de tu elección, cancela la opción. Consulta más información en este artículo. Recomendamos encarecidamente usar el webhook automático para que no tengas que restablecerlo en caso de que apliquen grandes actualizaciones al plugin.
Por último, ingresa tu URL de Jira y haz clic en Connect (Conectar):
Conectar Tarjetas Jira
Para obtener la URL de Jira, copia el enlace base de la página de tu panel de Jira:
Panel de Jira
Aceptamos los siguientes formatos:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Si tu URL de Jira no es aceptada, consulta este artículo. Comprueba también que Miro tenga suficiente acceso a tu Jira para establecer la conexión.
Ya tienes conectada tu instancia de Jira a tu equipo de Miro. En tus webhooks de Jira se creó un webhook nuevo para el equipo de Miro en particular que conectaste. Si planeas conectar varios equipos, recomendamos que vayas a tu página de WebHooks de Jira y edites cada webhook recién creado para que tenga un nombre único. De lo contrario, podría haber confusiones.
Crear un webhook es establecer el canal para las solicitudes de actualización. Después de esto, cada uno de tus usuarios finales debe conectar su perfil de Jira personal para establecer los permisos apropiados; esto garantiza que el acceso de cada usuario desde Miro es exactamente el mismo como desde tu instancia de Jira. Cuando un usuario final intente importar o editar una tarjeta Jira por primera vez, se le pedirá que inicie sesión en Jira con sus credenciales de usuario individuales.
Después de hacer esto, los usuarios pueden agregar tareas como tarjetas en la pizarra. Todos los cambios realizados en Jira se reflejan en las Tarjetas Jira en el tablero.
✏️ Si un usuario no tiene las credenciales de Jira y tiene acceso al tablero al que se agregó la tarjeta, podrá ver el título de la tarjeta, el tipo de problema, la prioridad, la persona asignada y los atributos configurados para aparecer en la Tarjeta Jira. Sin embargo, no podrá expandir la tarjeta para ver otros atributos ni editarla, a menos que se le autorice. Si el usuario no conecta sus credenciales de Jira, no verá el avatar de la persona asignada y la apariencia general de la tarjeta será diferente.
Uso de una instancia de Jira para varios Equipos de Miro (opcional)
Si tienes varios equipos de Miro, puedes usar un enlace de aplicación existente para sincronizar Miro y Jira. Instala la aplicación de Tarjetas Jira en cualquiera de tus equipos y luego simplemente pega la URL base de Jira en la configuración de integración de tus otros equipos de Miro y haz clic en Connect (Conectar).
Cómo desinstalar el plugin
Ve a Team Settings (Ajustes de equipo) > Apps & Integrations (Aplicaciones e integraciones) > Jira Cards (Tarjetas Jira) y deshabilitar tu URL de Jira en el Paso 2. Luego, haz clic en Uninstall for team (Desinstalar para el equipo).
Cómo desinstalar Tarjetas Jira
💡 No olvides leer el artículo principal sobre cómo usar las Tarjetas Jira.