Integrar Jira

La integración de Jira en Notion te permite realizar varias cosas. Puedes insertar enlaces de Jira en páginas de Notion para tener un acceso rápido o una vista previa, o puedes sincronizar tus proyectos e incidencias en Jira con bases de datos en Notion para poder hacer un seguimiento de tu trabajo en un solo lugar. Sigue leyendo para conocer las distintas formas de integración y cómo puedes configurarlas.

Notion ofrece dos integraciones con Jira: Jira y Jira Sync. Considéralas como las opciones básica y avanzada.

Si solo necesitas sincronizar un proyecto de Jira con una base de datos de Notion una vez y no tienes pensado configurar sincronizaciones adicionales, la integración original de Jira debería ser suficiente.

Ten en cuenta que utiliza tokens de usuario, que suelen ser menos confiables que los tokens de administrador que utiliza Jira Sync.

Para sincronizaciones continuas y flexibles entre múltiples proyectos y bases de datos, Jira Sync es la opción más reciente y potente. Ten en cuenta que requiere un administrador de Jira para su configuración.

Jira:

1. Haz clic en este enlace para acceder a la página de integración con Jira y luego selecciona Agregar a Notion.

   • También puedes encontrar esta página en Configuración → Conexiones → Explorar conexiones en la Galería.

Jira Sync:

1. Ve a Configuración en la barra lateral.

2. Haz clic en Importar y busca la opción Jira Sync.

3. Haz clic en Conectar y sigue los pasos para completar la autentificación.

Para previsualizar enlaces de Jira:

1. Ve al menú Configuración → Conexiones.

2. Si usas Jira Cloud, busca la sección de Jira. Si usas Jira Data Center o Jira Server, busca la sección vista previa de Jira (Data Center). Es posible que tengas que desplazarte un poco hacia abajo para encontrarla. Luego, selecciona Conectar debajo.

3. En la ventana que aparece, selecciona tu versión de Jira. A continuación, ingresa la URL, el nombre de usuario y la contraseña de tu sitio y selecciona Autenticar.

Una vez que te hayas autenticado correctamente, verás Jira o vista previa de Jira (Data Center) en la parte superior de tu lista de conexiones. Cualquier enlace de Jira que pegues en Notion debería aparecer automáticamente como una vista previa del enlace.

Otra opción es configurar las vistas previas de enlaces directamente desde una página de Notion. Para hacerlo:

1. En una página de Notion, pega una URL de Jira.

2. En la ventana que aparece, selecciona la versión de Jira si se te solicita. Ingresa la URL de tu sitio, tu nombre de usuario y contraseña, y selecciona Autenticar.

1. Pega un enlace de Jira en Notion.

2. Selecciona Mención en el menú que aparece para referenciar con facilidad un proyecto o incidencia en tus documentos.

   • Si aún no conectaste Jira con Notion, se te pedirá que lo hagas cuando pegues tu enlace de Jira en Notion. Consulta este artículo → para saber más sobre menciones de enlace.

La integración de Jira Sync conecta proyectos de Jira con Notion mediante el uso de un token de admin de API (en lugar de un token de usuario). Esto le permite brindar una experiencia más integral.

Ahora puedes aprovechar al máximo las funciones de Notion, incluyendo las automatizaciones, los rollups y la IA de Notion. Usa la IA de Notion para responder rápidamente a preguntas sobre tus proyectos en Jira.

Jira Sync muestra tus proyectos e incidencias de Jira como bases de datos de proyectos e incidencias de Notion. Esta configuración te permite ver y dar seguimiento a múltiples proyectos mediante una vasta gama de vistas, filtros y clasificaciones.

Incluso puedes hacer un mapeo de identidades para conectar identidades de Jira con perfiles en Notion para que en las bases de datos sincronizadas en Notion puedas ver quién es responsable por qué cosa.

Si bien todos los miembros pueden crear sincronizaciones, tienes que ser propietario del espacio de trabajo para poder realizar la configuración inicial de Jira Sync.

1. Ve a Configuración en la barra lateral → Importar → Jira Sync.

   • También puedes pegar un enlace a una base de datos en Jira o utilizar el comando de barra /jira sync.

   • Si ya creaste una base de datos sincronizada de Jira con Notion, abre esa base de datos y selecciona Mejorar tu sincronización con Jira en la parte superior.

2. Selecciona Empezar en la ventana que aparece.

3. Escribo tu correo electrónico de admin de Jira, la URL del sitio de Jira y la la token de API y después selecciona Siguiente.

1. Ve a Configuración en la barra lateral → Importar → Jira Sync.

   • También puedes pegar un enlace a una base de datos en Jira o utilizar el comando de barra /jira sync.

2. Selecciona Empezar en la ventana que aparece.

3. Selecciona el sitio de Jira desde el cual quieres sincronizar.

4. Selecciona Crear una nueva sincronización o selecciona una sincronización ya existente que tengas en el menú desplegable. Si eliges una sincronización existente, tus proyectos se agregarán a las bases de datos sincronizadas de proyectos e incidencias existentes.

5. En la base de datos que se abre, tendrás que conectar tu cuenta de Jira (a menos que seas el propietario del espacio de trabajo que configuró la integración). Desde aquí, selecciona los datos que quieres sincronizar con Notion. Primero haz clic en Seleccionar proyectos para la sincronización, después, Seleccionar propiedades para la sincronización.

Repite los pasos anteriores si quieres configurar una sincronización para otro sitio, espacio de equipo o espacio de trabajo. También se sincronizarán los comentarios y archivos adjuntos (hasta cinco archivos por incidencia, de no más de 1 MB).

Puedes asignar permisos en la página de base de datos para que tus colaboradores puedan acceder a las bases de datos sincronizadas.

Las bases de datos sincronizadas incluirán propiedades de personas. Ya puedes utilizar el mapeo de identidad de usuarios para conectar identidades de terceros de GitHub y Jira con los perfiles de tu equipo en Notion. Para hacerlo:

1. Confirma haber implementado Jira Cloud.

2. Confirma que tu nombre y dirección de correo electrónico sean los mismos en Notion que en Jira.

3. Sigue estas instrucciones para configurar tu visibilidad para Todos.

Para editar las propiedades de los proyectos e incidencias de Jira que se sincronizaron con tu base de datos de Notion, selecciona ••• en la parte superior de la base de datos sincronizada → Origen.

Para eliminar una base de datos sincronizada con Jira, selecciona ••• en la parte superior de la base de datos y luego → Eliminar tabla.

Luego de la importación inicial, tus proyectos sincronizados con Jira se mantendrán al día de dos formas:

• Webhooks: las actualizaciones que se hagan en Jira se envían a Notion en tiempo real a través de webhooks.

  • Estos cambios suelen aparecer en cuestión de minutos, pero pueden producirse retrasos ocasionales o perderse actualizaciones debido a problemas de red o en el sistema.

  • Cuando se establece la sincronización con un webhook por primera vez, también se configura de forma automática.

• Resincronización: si se pierde una actualización de webhook, nuestro mecanismo de resincronización volverá a sincronizar tu colección con Jira para asegurar que esté actualizada:

  • La resincronización solo se ejecuta cuando la colección se está viendo activamente y puede llevar su tiempo, especialmente cuando se trata de colecciones grandes.

  • Se ejecutará, como máximo, una vez al día, y para indicarlo aparecerá la etiqueta "Sincronización en curso".

    • Durante este proceso, los usuarios no pueden modificar la configuración de la sincronización (por ejemplo, no podrán agregar o eliminar proyectos o propiedades).

Tus proyectos en Jira se sincronizarán en una base de datos de proyectos en Notion. Tus proyectos se asignarán de forma inteligente a sus correspondientes incidencias de Jira en una base de datos de incidencias relacionada y sincronizada en Notion. Para que puedas empezar aún más rápido, esta base de datos ya contará con vistas de base de datos predeterminadas y preconfiguradas:

• Activos (vista de tabla): muestra los proyectos que importaste cuyo estado es "En curso". En otras palabras, esta vista no muestra proyectos que ya fueron finalizados. La vista cuenta con filtros preconfigurados para propietario y fecha que facilitan las búsquedas.

• Vista de cronograma: muestra el nombre del proyecto, el estado, el propietario y el progreso. También cuenta con filtros preconfigurados para estado, propietario y fecha que facilitan las búsquedas.

• Vista de tablero: muestra tus proyectos agrupados por estado (Planificación,En curso). Puedes personalizar los estados que aparecen en la vista en el menú •••. Los proyectos están en orden de prioridad descendente.

• Todos (vista de tabla): muestra todos los proyectos importados. La vista cuenta con filtros preconfigurados para estado, propietario y fecha que facilitan las búsquedas.

Tus incidencias en Jira (épica, error, tarea, subtarea, historia) se sincronizarán en una base de datos de incidencias en Notion, que equivale a una base de datos de tareas en Notion. Para que puedas empezar aún más rápido, contará con vistas de bases de datos predeterminadas, igual que con las bases de datos de proyectos sincronizadas:

• Por proyecto (vista de tabla): muestra todas las tareas, agrupadas por proyecto. La vista cuenta con filtros preconfigurados para estado, persona asignada, fecha y proyecto que facilitan las búsquedas.

• Por Épica (vista de tabla): muestra tus historias de Jira, tareas y errores agrupados por Épica.

• Vista de tablero: se agrupa por estado y en orden de prioridad descendente. Muestra las siguientes propiedades preconfiguradas: persona asignada, proyecto, prioridad y subtareas.

• Todas las tareas (vista de tabla): muestra todas las tareas sincronizadas. Muestra lassiguientes propiedades preconfiguradas: nombre de tarea, estado, persona asignada, fecha, prioridad, etiquetas y proyecto.

• Mías (vista de tabla): esta vista filtrada muestra las tareas que te hayan asignado. Existen filtros predeterminados para estado, fecha y proyecto.

Jira Sync es compatible con la mayoría de las propiedades de Jira, pero no con todas. Aquí te dejamos la lista de propiedades de Jira no admitidas:

• La sincronización inicial completa solo debería tomar unos minutos, pero dependiendo del tamaño de los proyectos y las incidencias de Jira, puede llegar a tardar varias horas.

• Es posible que algunos campos de incidencias o propiedades no se sincronicen, como el texto enriquecido en una propiedad y selecciones múltiples alojadas una dentro de otra.

• Para garantizar un rendimiento óptimo, no se importarán propiedades de Jira con más de 1000 valores.

• Una vez que se haya configurado la sincronización inicial, las actualizaciones de las propiedades deberían reflejarse en tiempo real en Notion. Si creas nuevas propiedades, estos cambios pueden tardar hasta 12 horas en sincronizarse.

• No es posible sincronizar Jira con Notion de manera manual; las sincronizaciones suceden como respuestas a las actualizaciones realizadas en Jira.

• En este momento, las actualizaciones de Jira se sincronizarán con tus bases de datos de Notion en tiempo real, pero no al revés. Los cambios que realices en tu base de datos de Notion no se sincronizarán con Jira.

• En la parte superior de la base de datos podrás ver cuándo fue la última vez que Notion se sincronizó con Jira en una insignia azul en la parte superior de la base de datos. En cambio, si ves una insignia amarillaFallo de sincronización o Se interrumpió la sincronización, es posible que tengas que seguir los pasos descritos a continuación para volver a conectar Jira.

  

• Comprueba si tienes acceso de edición o acceso completo a una base de datos sincronizada si quieres agregar o borrar proyectos o propiedades.

• Si no ves actualizaciones del lado de Notion, prueba con actualizar la página.

• La propiedad Watcher puede llegar a tardar 12 horas en sincronizarse correctamente.

Si el registro de webhook o la sincronización de tu proyecto fallaron, aparecerá Se produjo un error durante la sincronización en la parte superior de la base de datos. Para resolver este problema, prueba volver a sincronizar con un conjunto distinto de proyectos. También puedes comprobar si tus proyectos tienen algún problema en Jira.

Si tu token de Jira no es válido o alguien desconectó Jira de Notion, verás Se interrumpió la sincronización en la parte superior de la base de datos. Para resolver este problema, selecciona Volver a autenticar junto a Se interrumpió la sincronización. Para poder completar este proceso, debes ser propietario del espacio de trabajo.

Una vez que tu instancia de Jira se haya vuelto a conectar con Notion, tus proyectos y bases de datos de incidencias no se volverán a crear; en cambio, seguirás usando los proyectos y bases de datos de incidencias que ya tenías.

Si quieres desconectar Jira completamente de Notion:

1. Ve a Configuración en la barra lateral → Importar.

2. Selecciona ••• junto a Jira → Borrar.

Las bases de datos sincronizadas antiguas tienen más o menos este aspecto. Si tienes una base de datos sincronizada antigua, puedes seguir los pasos descritos arriba para recrear tus proyectos y bases de datos de incidencias en Notion mediante la nueva y mejorada Jira Sync.