Integrar Jira

La integración de Notion con Jira permite hacer varias cosas. Puedes insertar enlaces de Jira en las páginas de Notion para acceder rápidamente a ellos o previsualizarlos, o puedes sincronizar tus proyectos e incidencias de Jira con las bases de datos de Notion para ver todo 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 de Jira: Jira y Jira Sync. Son 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 planeas configurar sincronizaciones adicionales, la integración original de Jira podría ser suficiente.

Solo ten en cuenta que utiliza tokens de usuario, que tienden a ser menos fiables que los tokens de administrador que utiliza Jira Sync.

Para una sincronización continua y flexible 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 configurarla.

Jira:

1. Haz clic en este enlace a la página de integración de Jira y luego en Añadir a Notion.

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

Jira Sync:

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

2. Haz clic en Importar y busca Jira Sync.

3. Haz clic en Conectar y completa el flujo de autenticación.

Para previsualizar enlaces desde Jira:

1. Ve a 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 de vista previa de Jira (Data Center). Es posible que tengas que desplazarte un poco hacia abajo para encontrar la sección del centro de datos. Luego, selecciona Conectar bajo ella.

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

Una vez que te hayas autenticado correctamente, verás Jira o la vista previa de Jira (centro de datos) en la parte superior de tu lista de conexiones. Cualquier enlace de Jira pegado en Notion debería mostrarse automáticamente como una vista previa de dicho enlace.

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

1. Pega una URL de Jira en una página de Notion.

2. Si aparece una ventana para ello, selecciona tu versión de Jira. Introduce 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 fácilmente un proyecto o incidencia en tus documentos.

   • Si aún no has conectado Jira con Notion, se te pedirá que lo hagas cuando pegues el enlace de Jira en Notion. Obtén más información sobre las menciones de enlaces en este artículo →

La integración de Jira Sync conecta los proyectos de Jira con Notion sirviéndose de un token de Administrador API (en lugar de un token de usuario), lo que permite disfrutar de una experiencia más unificada.

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 realizar un seguimiento de varios proyectos a la vez mediante una serie vistas, filtros y clasificaciones.

Incluso puedes utilizar el mapeo de identidades para conectar identidades de Jira con perfiles de Notion, de modo que puedas ver quién es responsable de qué en la base de datos sincronizada de Notion.

Aunque cualquier miembro puede crear sincronizaciones, para configurar Jira Sync al principio tendrás que ser propietario de un espacio de trabajo.

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

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

   • Si has creado previamente una base de datos sincronizada con Jira en Notion, ábrela y selecciona Mejorar tu sincronización con Jira en la parte superior.

2. En la ventana que aparece, selecciona Comenzar.

3. Introduce tu correo electrónico de administrador de Jira, la URL del sitio de Jira y el token de API y, a continuación, selecciona Siguiente.

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

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

2. En la ventana que aparece, selecciona Comenzar.

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

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

5. Se abrirá una base de datos en la que tienes 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 quieras sincronizar en Notion. En primer lugar, selecciona los proyectos para sincronizar y a continuación, selecciona las propiedades para sincronizar.

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

Puedes aplicar permisos a la página de la 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 usar el mapeo de identidad de usuarios para conectar identidades externas de Jira con los perfiles de tu equipo en Notion. Para ello:

1. Verifica que se ha implementado Jira Cloud.

2. Asegúrate de que tu nombre y tu dirección de correo electrónico son los mismos en Notion y en Jira.

3. Sigue estas instrucciones para establecer la visibilidad para Cualquier persona.

Para editar las propiedades de los proyectos e incidencias de Jira que están sincronizadas con tu base de datos de Notion, selecciona ••• en la parte superior de la base de datos → Fuente.

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

Después 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 los webhooks.

  • Estos cambios suelen aparecer en cuestión de minutos, pero pueden producirse retrasos ocasionales o perderse actualizaciones debido a problemas de red o con 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 sincronización (por ejemplo, no podrán añadir o eliminar proyectos o propiedades).

Tus proyectos de Jira se sincronizarán en una base de datos de proyectos de Notion. Se mapearán de forma inteligente con sus correspondientes incidencias de Jira en una base de datos de incidencias relacionada y sincronizada en Notion. Esta base de datos vendrá con las vistas de base de la datos predeterminadas ya rellenadas para que puedas empezar a trabajar rápidamente:

• Activo (tabla): Esta vista muestra los proyectos que has sincronizado y que tienen el estado «en curso». Es decir, esta vista no muestra los proyectos ya finalizados. También hay filtros predefinidos por propietario y fecha para facilitar la búsqueda.

• Vista cronológica: Esta vista muestra el nombre del proyecto, el estado, el propietario y el grado de progreso. También hay filtros predefinidos por estado, propietario y fecha para facilitar la búsqueda.

• Tablero: Esta vista muestra sus proyectos agrupados por estado(Planificación, En curso). Puedes personalizar los estados que se muestran en la vista en el menú ••• . Los proyectos están ordenados por prioridad descendente.

• Todos (tabla): esta vista muestra todos tus proyectos importados. También hay filtros predefinidos por estado, propietario y fecha para facilitar la búsqueda.

Tus incidencias de Jira (épica, error, tarea, subtarea, historia) se sincronizarán en una base de datos de incidencias de Notion, similares a una base de datos de tareas de Notion. Al igual que con la base de datos de proyectos sincronizados, habrá vistas de la base de datos predeterminadas ya creadas para que puedas empezar a trabajar rápidamente:

• Por Proyecto (tabla): Esta vista muestra todas las tareas agrupadas por proyecto. Hay filtros preestablecidos por estado, usuario asignado, fecha y proyecto para facilitar las búsquedas.

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

• Tablero: Esta vista está agrupada por estado y está ordenada por prioridad descendente. Las propiedades preestablecidas que se mostrarán son usuario asignado, proyecto, prioridad y subtareas.

• Todas las tareas (tabla): esta vista muestra todas tus tareas sincronizadas. Las propiedades preestablecidas que se mostrarán son nombre de la tarea, estado, usuario asignado, fecha, prioridad, etiqueta y proyecto.

• Mías (vista de tabla): En esta vista solo se muestran las tareas que tienes asignadas. Hay filtros preestablecidos para estado, fecha y proyecto.

La mayoría de las propiedades de Jira son compatibles con Jira Sync, aunque no todas. Aquí tienes la lista de propiedades de Jira no compatibles:

• La sincronización inicial solo debería tardar unos minutos en completarse, pero en función del tamaño de los proyectos y las incidencias de Jira, podría tardar hasta unas horas.

• Es posible que algunos campos de incidencia o de propiedad no se sincronicen, como el texto enriquecido en los campos de selección múltiple anidados y de propriedad.

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

• Una vez completada la sincronización inicial, las actualizaciones de las propiedades deberían reflejarse en Notion en tiempo real. Si creas propiedades nuevas, los cambios podrían tardar hasta 12 horas en sincronizarse.

• No puedes sincronizar Jira manualmente con Notion. Las sincronizaciones se hacen en respuesta a las actualizaciones realizadas en Jira.

• Por ahora, solo se sincronizan las actualizaciones de Jira con tu base de datos de Notion, pero no al revés. Los cambios que realices en tu base de datos de Notion no se sincronizarán con Jira.

• Podrás ver cuándo fue la última vez que Notion se sincronizó con Jira, en un distintivo azul en la parte superior de las bases de datos. Si en su lugar aparece un mensaje amarillo de Sincronización fallida o Sincronización detenida, es posible que tengas que seguir los pasos que se indican a continuación para volver a conectar con Jira.

  

• Asegúrate de tener acceso completo a una base de datos sincronizada si quieres añadir o eliminar proyectos o propiedades.

• Si no ves actualizaciones en la parte de Notion, prueba a actualizar la página.

• La propiedad Observador puede tardar hasta 12 horas en sincronizarse correctamente.

Si se ha producido un fallo en el registro del webhook o la sincronización de tu proyecto, verás Sincronización fallida en la parte superior de la base de datos. Para resolver el problema, vuelve a intentar la sincronización con un conjunto diferente de proyectos. También puedes comprobar que tus proyectos no tengan ninguna incidencia en Jira.

Si tu token de Jira ya no es válido o alguien ha desconectado Jira de Notion, verás Sincronización detenida en la parte superior de la base de datos. Para solucionar este problema, selecciona Volver a autenticar junto a Sincronización detenida. Debe ser propietario de un espacio de trabajo para completar este proceso.

Una vez que tu instancia de Jira se haya reconectado con Notion, no se recrearán tus bases de datos de proyectos y de incidencias; seguirás utilizando las que tenías antes.

Si quieres desconectar Jira de Notion por completo:

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

2. Selecciona ••• al lado de Jira → Eliminar.

Las base de datos sincronizadas heredadas funcionan de la siguiente manera: si tienes una base de datos sincronizada heredada, puedes seguir los pasos anteriores para volver a crear tus bases de datos de proyectos e incidencias en Notion utilizando la función mejorada Jira Sync.