Disponible para: Jira Cloud, Jira Server (On-Premise) y Datacenter (también con protección LDAP)
Configurado por: Miro Team Admin & Jira System Admin con permisos de administración de proyectos
⚠️ Si encuentras 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 de Jira en los artículos Preguntas frecuentes sobre las tarjetas de Jira y Cómo configurar webHook para tarjetas de Jira.
Configurar Miro en Jira
✏️ Ten presente que los menús de Jira pueden diferir dependiendo de 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.
- Ve a Configuración de Jira > Productos > Integraciones > Enlaces a aplicaciones > Crear enlace:
mceclip1.png
Ten en cuenta que la interfaz de Jira puede variar en función de tu versión de Jira
- Elige Enlace directo a la aplicación e introduce https://miro.com/ en el campo URL de la aplicación.
Importante: debes introducir la URL en este formato exacto. Haz clic en Continuar.
mceclip2.png
Crear el enlace
- En el siguiente menú, simplemente haz clic en Continuar nuevamente.
- En el menú Revisar enlace, comprueba que la URL siga siendo exactamente https://miro.com/ y escribe el Nombre de la aplicación que elijas. Desplázate hacia abajo y, en la parte inferior, marca la casilla Crear enlace entrante. Omite el resto de los campos y haz clic en Continuar. /span>
Sólo hay que rellenar el campo Nombre de la aplicación
- Aquí verás los campos de los valores de Miro. Para obtener los valores, inicia sesión en Miro.
- Para la integración a nivel de equipo, ve a Configuración del equipo > Apps e integraciones > Tarjetas de Jira.
- Para la integración a nivel de organización, ve a Configuración de la empresa > Apps > Gestionar apps > Tarjetas de Jira > Configuración.
Si no tienes tarjetas de Jira en tu lista de apps, desplázate hasta la parte superior de la sección, haz clic en Instalar apps y procede a instalar la app desde Marketplace de Miro. Cuando veas las tarjetas de Jira en la lista, haz clic para abrirlas.
Se abrirá la pestaña del plugin, y podrás ver el Paso 1 para obtener los valores necesarios:Valores de las tarjetas de Jira
Copia los valores y añádelos al menú Enlace de revisión de Atlassian.
- Verás el mensaje de procesamiento durante un momento o dos:
mceclip4.png
El último paso de la creación del enlace
Esto completa los pasos del lado de Atlassian. El enlace aparecerá en la lista de enlaces de tu aplicación.
Paso 2: conexión
Vuelve a la Configuración de tu tarjeta de Jira en Miro, y clecciona una de las dos opciones: crear un webhook manual o automáticamente. Si eliges manualmente, desmarca la opción. Consulta más información en este artículo/span>. Recomendamos 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 Conectar:
Conectar tarjetas de Jira
Para obtener la URL de Jira, copia el URL base de tu instancia 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.
⚠️ Aunque Atlassian ha dejado de dar soporte a Jira Server a partir de febrero de 2024, Miro seguirá dando soporte a la integración de Jira Cards para Jira Server en un futuro previsible.
- Visita https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si "Enlaces de aplicación" no está seleccionado, haz clic en él.
Enlaces de la aplicación Jira Server
- Haz clic en Crear enlace. Selecciona "Producto Atlassian" y proporciona la URL de la aplicación, "https://miro.com". Haz clic en Continuar.
Configurar la URL de la aplicación
- Aparecerá el cuadro de diálogo "Vincular aplicaciones". Añade un nombre de aplicación (por ejemplo, tarjeta de Jira Miro) y selecciona "Aplicación genérica" como tipo de aplicación.
Deberías ver la URL de tu aplicación Jira en "Estás creando un enlace desde:", y deberías ver https://miro.com en "A esta aplicación:". Haz clic en Continuar.jira_server_link_applicationsConfigurar los detalles de las aplicaciones de enlace
- Se procesará la configuración del enlace. Cuando termine, verás tu nuevo enlace en el área "Enlaces de aplicación" de Jira Server.
Tu aplicación configurada en Jira Server
- A continuación, tendrás que configurar los detalles de tu aplicación. Haz clic en el icono del lápiz de tu aplicación para editar los detalles de la misma.
- En el cuadro de diálogo Configurar, haz clic en la opción Autenticación entrante . Rellena la Clave del Consumidor, el Nombre del Consumidor, la Clave Pública y, opcionalmente, una descripción.
- Para la integración a nivel de equipo, esta información está disponible en Configuración del equipo > Apps e integraciones > Tarjetas de Jira.
- Para la integración a nivel de organización, esta información está disponible en Configuración de la empresa > Apps > Gestionar apps > Tarjetas de Jira > Configuración.
Configurar los detalles de autenticación entrante en Jira Server
Detalles del enlace de la aplicación Jira en Miro
- Desplázate hasta el final de las opciones de Autenticación entrante y haz clic en Guardar. Tu estado de verificación debería confirmarse ahora, y este Servidor de Jira ya puede utilizarse dentro de Miro para su uso con tarjetas de Jira. Asegúrate de elegir "Servidor Jira" y "OAuth 1.0" en el lado Miro.
jira_server_welcome_to_jira
Autorización del usuario
Después de que se conecte la integración, cada uno de tus usuarios finales debe conectar su perfil personal de Jira para establecer los permisos correspondientes; de esta manera, te aseguras de que el acceso de cada usuario del lado de Miro sea exactamente el mismo que el del lado de tu instancia de Jira. Cuando los usuarios finales intenten importar o editar una tarjeta de Jira por primera vez, se les pedirá que inicien 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 de 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 de 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.
Utilizar una instancia de Jira para varios equipos Miro
Puedes instalar tarjetas a nivel de equipo o de organización. Si tienes varios equipos, puedes aprovechar la configuración a nivel de organización para evitar repetir el procedimiento de configuración para cada equipo. El enlace de aplicación existente se utiliza para todos los equipos.
Después de conectar tu equipo u organización a una instancia de Jira, se crea un nuevo webhook en tus webhooks de Jira para ese equipo u organización de Miro. La creación de un webhook establece un canal para las solicitudes de actualización.
Si especificas ajustes a nivel de organización, los equipos que ya están conectados conservan sus ajustes actuales. Sin embargo, pueden cambiar a la configuración a nivel de organización en cualquier momento.
Además, si es necesario, los equipos pueden anular la configuración a nivel de organización para conectarse a una instancia de Jira diferente.
Si eres un cliente de empresa que desea migrar varias conexiones a nivel de equipo a la conexión predeterminada a nivel de organización, ponte en contacto con tu equipo de cuentas.
⚠️ Si quieres conectar varios equipos por separado, te recomendamos que des un nombre único al webhook de cada equipo. Ve a tu página Jira WebHooks y edita cada webhook recién creado.
No es posible conectar varias instancias de Jira a un equipo de Miro.
Cómo deshabilitar el plugin
Para la integración a nivel de equipo, ve a Configuración del equipo > Apps e integraciones > Tarjetas de Jira. A continuación, selecciona Eliminar para el equipo.
Para la integración a nivel de organización, para restringir el uso de la app de Jira, ve a Configuración de la empresa > Apps > Gestionar apps > tarjetas de Jira. A continuación, mueve la palanca a la posición de apagado.
⚠️ Si deshabilitas Jira para la organización, los usuarios de todos los equipos de Empresa no podrán utilizar las tarjetas de Jira. Para saber más sobre la gestión de apps y su restricción, consulta Gestión de apps.
Para más información: Consulta Cómo utilizar las tarjetas de Jira.