Integrar Jira

La integración de Jira en Notion te permite realizar 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 y elementos de trabajo de Jira con bases de datos de Notion para gestionar 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 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 previsto configurar sincronizaciones adicionales, las vistas previas de enlaces de Jira, las menciones de enlaces y la antigua base de datos sincronizada a través de la integración de Jira deberían ser suficientes. 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.

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.

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.

También puedes configurar vistas previas de enlaces directamente desde una página de Notion. Para hacer esto:

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 tus proyectos de Jira con Notion mediante un token de API de administrador (en lugar de un token de usuario), lo que permite una experiencia de sincronización más consistente y centralizada.

Para garantizar una sincronización fiable, recomendamos crear un token sin ámbito seleccionando Crear token de API, no Crear token de API con ámbitos.

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 y elementos de trabajo de Jira como proyectos y bases de datos de elementos de trabajo en 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.

En el plan Enterprise de Notion, Jira Sync admite la sincronización bidireccional, respetando los permisos de Notion y de Jira para garantizar un acceso y una edición seguros. A través de Jira Sync, puedes aprovechar al máximo las funciones de Notion, como las relaciones y los rollups, las propiedades de bases de datos exclusivas de Notion y la IA de Notion. Usa la IA de Notion para responder rápidamente a preguntas sobre tus proyectos en Jira.

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 tus bases de datos sincronizadas de proyectos y elementos de trabajo 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).

La sincronización bidireccional respeta los permisos de Notion y de Jira para garantizar un acceso y una edición seguros.

• Solo los usuarios con acceso de edición a la base de datos de Jira sincronizada pueden activar y utilizar la sincronización bidireccional.

• Cada usuario debe autenticar su cuenta personal de Jira para poder realizar cambios desde Notion. Si anteriormente conectaste Jira solo para ver información, tendrás que volver a autenticarte para habilitar la edición.

• Los invitados o las personas que accedan a una base de datos sincronizada de Jira a través de un enlace público no pueden usar la sincronización bidireccional.

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 elementos de trabajo de Jira en una base de datos 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 elementos de trabajo de Jira (épica, error, tarea, subtarea, historia) se sincronizarán en una base de datos de elementos de trabajo de Notion, el equivalente a una base de datos de tareas de 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:

• En este momento, Jira Sync solo funciona con Jira Cloud. Jira Data Center y Jira Server no son compatibles.

• La sincronización inicial debería completarse en minutos, pero, según el tamaño de tus proyectos y elementos de trabajo de Jira, podría tardar algunas 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.

• Aunque puedes editar el estado, el responsable, la prioridad, los archivos adjuntos y los comentarios, algunos campos o propiedades de las incidencias no se pueden modificar. Incluyen la descripción, el título, la fecha, los campos personalizados y otros campos de selección o de selección múltiple (con la excepción de prioridad y estado).

• Los comentarios realizados en Notion se agregarán a Jira, pero no podrás editarlos ni eliminarlos posteriormente.

• Los archivos adjuntos deben tener un tamaño máximo de 1 MB. Cada incidencia de Jira puede tener hasta cinco archivos adjuntos. Si intentas subir un archivo adjunto que supere el límite de tamaño, la carga fallará.

  • No puedes arrastrar y soltar archivos adjuntos en una incidencia. Usa el ícono de adjuntar para agregar un archivo adjunto.

• En Notion solo aparecerán los valores de prioridad ya utilizados en los elementos de trabajo sincronizados de Jira. Las opciones que existen en Jira pero que aún no se han utilizado no se podrán seleccionar. Para que se puedan seleccionar, asigna esos valores al menos a una incidencia de Jira que ya se haya sincronizado con Notion.

• 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.

• Para saber cuándo se sincronizó Notion con Jira por última vez, pasa el cursor por encima de la insignia azul situada en la parte superior de una 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.

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

• La sincronización bidireccional no está disponible en dispositivos móviles; la unidireccional sí lo está.

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 vuelva a conectar con Notion, las bases de datos de proyectos y de elementos de trabajo no se recrearán, sino que seguirás utilizando las 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.