Conecta tu estrategia de producto en Airfocus con la ejecución de tu desarrollo en Jira usando esta poderosa integración bidireccional. Puedes importar elementos de trabajo en AirFocus y enviar elementos de AirFocus—incluidos épicos y funciones—a Jira, permitiéndote seguir su estado desde AirFocus mientras conectas tus flujos de trabajo de gestión de producto, marcos de priorización y hojas de ruta con el desarrollo diario mediante una sincronización de datos fluida. Sigue leyendo para aprender cómo configurar y configurar esta integración.
Beneficios
Conecta tus flujos de trabajo de gestión de producto, marcos de priorización y hojas de ruta con el desarrollo diario sincronizando tus datos de forma fluida entre Airfocus y Jira. La integración es compatible con Jira Cloud, Jira Server y Jira Data Center.
- Importar problemas de Jira (como elementos) en airfocus.
- Empuja los objetos de enfoque aéreo en Jira (como cualquier tipo de problema).
- Sincronización bidireccional y filtros flexibles (JQL personalizado).
- Mapeo flexible de campos.
- Muestra tus puntajes de prioridad de enfoque en AirFocus en Jira para obtener contexto sobre el valor y prioridades del negocio.
- Capacidad para ver directamente las relaciones padre-hijo en el aire.
Requisitos
- Sobre Airfocus: El usuario necesita tener licencias "Completas" para el espacio de trabajo para el que quiere configurar la integración de Jira.
- En Jira: se requieren licencias de "Administrador" para establecer el enlace de aplicación entre tu instancia de Jira y el equipo de Airfocus.
- Si el enlace de aplicación entre la instancia de Jira y el equipo de airfocus ya está establecido, cualquier usuario de Jira con al menos licencia "Create_Issue" para un proyecto puede configurar una nueva integración para esa instancia.
- Nuestra integración con Jira es compatible con Jira Cloud, Jira Server y Jira Data Center. Ofrecemos soporte a todas las versiones del servidor Jira que figuran en la Política de Final de Vida de Atlassian Suelve. Las versiones anteriores a las mencionadas allí alcanzaron el final de su vida útil (EOL) y pueden funcionar, pero no están soportadas.
Configurar la integración de Jira
- Regístrate en AirFocus o inicia sesión en tu cuenta actual.
- Crea un nuevo espacio de trabajo en AirFocus o selecciona el que quieras integrar Jira.
- Solo tienes que autorizar tu instancia de Jira una vez por equipo de enfoque aéreo.
- Puedes agregar múltiples integraciones de Jira a un espacio de trabajo dado (por ejemplo, de diferentes proyectos o instancias de Jira).
- Haz clic en Extensiones desde la esquina superior derecha de tu espacio de trabajo.
- Selecciona Gestionar integración.
- Haz clic en Conectar en la casilla "Jira".
- Selecciona Conectar una nueva instancia de Jira en el desplegable que aparece.
- Introduce la URL base de tu instancia de Jira (por ejemplo, https://airfocustest.atlassian.net/ o https://jira.mycompany.com).
- Haz clic en Continuar.
- Copia la "URL de la aplicación". Necesitarás esto para los siguientes pasos en Jira.
- Haz clic en el centro de enlaces de aplicaciones Jira para abrir el Centro de enlaces de aplicaciones Jira.
- Necesitas ser administrador en Jira para acceder a esta página.
Los siguientes pasos varían para Jira Cloud y Jira Server/Data Center. Explora la sección de abajo para que tu instancia continúe.
Crear un enlace de aplicación en Jira Cloud
- En Jira Cloud, haz clic en el icono de Configuración en la esquina superior derecha
- Selecciona las aplicaciones de Jira.
- En la sección "integración" a la izquierda, haz clic en enlaces de aplicación.
- Haz clic en el botón Crear enlace en la esquina superior derecha de la página.
- Selecciona la opción "Enlace de aplicación directa".
- Pega la URL de tu AirFocus como "application URL".
- Haz clic en Siguiente.
- Escribe un nombre para la aplicación y cerciórate de que el tipo de aplicación esté configurado como "Aplicación genérica".
- Empleando la información proporcionada en airfocus, copia y pega el nombre del proveedor de servicios, clave de consumidor, secreto compartido, URL de token de solicitud, URL de token de acceso y URL de autorización en Jira.
- Marca la casilla junto a "Crear enlace entrante".
- Haga clic en Continuar.
- Empleando la información proporcionada en airfocus, copia y pega la Clave del Consumidor, el Nombre del Consumidor y la Clave Pública en Jira.
- Haga clic en Continuar.
- Regrese a AirFocus y haga clic en Finalizar configuración.
Te redirigiremos al paso de autorización de oAuth, que permite a Airfocus usar tu Usuario de Jira para sincronizar elementos entre ambos. Haz clic en Permitir para autorizar AirFocus a sincronizar con tu cuenta.
Crear un enlace de aplicación en Jira Server o Jira Data Center
- Haga clic en Crear enlace en la parte superior derecha.
- Selecciona el producto de Atlassian.
- Pega la URL de tu AirFocus como "application URL".
- Haz clic en Continuar para confirmar.
- Rellena los valores proporcionados en la interfaz de enfoque de aire.
- Haga clic en Continuar.
- Copia los valores del Paso 3.
- Haz clic en continuar.
- Ahora deberías ver una confirmación en Jira.
- Regrese a AirFocus y haga clic en Finalizar configuración.
Te redirigiremos al paso de autorización de oAuth, que permite a Airfocus usar tu Usuario de Jira para sincronizar elementos entre ambos. Haz clic en Permitir para autorizar AirFocus a sincronizar con tu cuenta.
Configurar filtros de integración
- Selecciona el proyecto que quieres sincronizar. Puedes escribir para filtrar la lista de proyectos.
- Los proyectos que puedes ver pero para los que carecen de las licencias CREATE_ISSUES están marcados como tales (solo disponibles para Jira Cloud).
- El nombre de tu integración se crea automáticamente según el proyecto. También puedes cambiarlo más adelante.
- Selecciona el tipo de problema que quieras sincronizar.
- Dado que los campos pueden variar entre tipos de incidencia (dependiendo de tu versión de Jira y del tipo de proyecto, es decir, gestionado por equipos o gestionado por la compañía), esto filtra por los campos que puedes asignar a aquellos que realmente están disponibles en el tipo de problema seleccionado.
- Si quieres sincronizar varios tipos de incidencias, te recomendamos configurar una integración cada uno, ya sea en el mismo espacio de trabajo o en varios espacios de trabajo. Puedes conectar la integración desde otros espacios de trabajo (por ejemplo, para Epics o Sub-áreas) mediante la jerarquía de enfoque de aire.
- También puedes filtrar aún más los problemas sincronizados proporcionando una consulta JQL en los filtros de problemas (lee más sobre JQL aquí).
Mapea los campos de enfoque aéreo y Jira
Emplee la asignación para definir cómo se debe asignar la información en Jira a la información en Airfocus. Si cambia un problema o un elemento en un sistema, el otro sistema se ajustará en consecuencia.
Por ejemplo, puedes definir cómo deben asignar los estados de Jira a campos de selección única de airfocus y/o cómo deben asignar las etiquetas de Jira a campos de selección múltiple de airfocus.
También hay muchas más opciones para mapear diferentes campos personalizados y de sistema de Jira a tus campos de enfoque aéreo.
Cuando miras las opciones de mapeo de campos, verás que dos campos siempre están asignados por defecto: nombres de objetos y descripciones de objetos.
Puedes definir para cada uno de tus campos si quieres una sincronización unidireccional o bidireccional entre el campo en Jira y Airfocus.
Puedes configurar las direcciones de mapeo para todos los campos a la vez (en la medida de lo técnicamente posible) con el botón "Establecer dirección".
Por defecto, la dirección de mapeo está configurada de Jira a solo enfoque aéreo y el usuario puede cambiarla según lo que esté disponible para el mapeo.
Al configurar un nuevo mapeo para uno de tus campos, verás que solo puedes mapear campo Jira a campo de enfoque aéreo si ambos extremos tienen el mismo tipo de campo.
Al seleccionar un campo en el menú desplegable, solo los campos que coincidan con el tipo de campo se mostrarán en el menú desplegable en el otro extremo.
Luego de seleccionar dos campos que quieres mapear, puedes seleccionar las opciones de campo y cómo deben asignar.
Visión general de todos los tipos de campos mapeables
Campos del sistema Jira mapeable:
| Jira | airfocus | Jira → enfoque aéreo | airfocus → Jira |
| Nombre del número | Nombre del artículo | ✅ | ✅ |
| Descripción del número | Descripción del artículo | ✅ | ⚠️ |
| Estado | Campo de selección única de estado/personalizado | ✅ | ✅ |
| Etiquetas | Campo personalizado de selección múltiple | ✅ | ✅ |
| Fecha de creación | Campo de fecha personalizado | ✅ (solo fecha) | ❌ |
| Actualizado | Campo de fecha personalizado | ✅ (solo fecha) | ❌ |
| Criterios de aceptación | ❌ | ❌ | ❌ |
| Cesionarios | Personas/Asignados | ⚠️ | ⚠️ |
| Informante | Personas/Asignados | ⚠️ | ⚠️ |
| Adjuntos | Adjuntos | ❌ | ❌ |
| (Empezar/Due) Campo de fecha (en pareja) | Campo de rango de fechas personalizado | ✅ | ✅ |
| (Empezar/Due) Campo de fechas | Campo de fecha personalizado | ✅ | ✅ |
| Dependencias | Dependencias | ✅ | ✅ |
| Versión corrección | Campo personalizado de selección múltiple | ✅ | ❌ |
| Versión corrección | Hito (multi-select) | ✅ | ✅ |
| Versión corrección | Plazo | ✅ | ❌ |
| Versión de corrección (más reciente) | Campo personalizado de selección única | ✅ | ❌ |
| Versión de corrección (más reciente) | Campo personalizado de selección múltiple | ✅ | ❌ |
| Fecha de lanzamiento de la versión correcta | Campo de fecha personalizado | ✅ | ❌ |
| ID de emisión | ID del artículo | ❌ | ❌ |
| Tipo de incidencia | Campo personalizado de selección única | ✅ | ❌ |
| Campo multiselección | Campo personalizado de selección múltiple | ✅ | ✅ |
| Campo de prioridad | Campo personalizado de selección única | ✅ | ✅ |
| Sprints | Campo de periodo temporal | ✅ | ❌ |
| Sprint (ID) | Campo personalizado de selección múltiple | ✅ | ❌ |
| Sprint (nombre) | Campo de texto personalizado | ✅ | ❌ |
| Sprint (fechas) | Campo de rango de fechas personalizado | ✅ | ❌ |
| Sprint (más reciente) | Campo personalizado de selección única | ✅ | ❌ |
| Campo de equipos | Campo personalizado de selección única | ✅ | ✅ |
⚠️ Advertencia sobre la sincronización bidireccional en el campo de descripción: El proceso de negocio de sincronización bidireccional podría provocar pequeños cambios en el contenido y formato de las descripciones de Jira. Esto se debe a que no todos los estilos de Jira están aún soportados de forma nativa en Airfocus.
⚠️ Advertencias sobre el mapeo de campos de personas: La lógica de mapeo se basa en nombres de visualización. Por lo tanto, "Kirsten" en Jira NO se asigna a "Kirst" en Airfocus, aunque ambas cuentas usen la misma dirección de email.
En el caso de que Jira solo permita un valor en un campo de personas (por ejemplo, solo pueden tener un asignado), una sincronización con airfocus favorece el primer valor para el campo de personas de airfocus mapeado. Por ejemplo, una solicitud de soporte técnico en Jira asignada a "Julian" sobreescribir un elemento en airfocus asignado a "Julian y Nikita". Nikita será destituido y solo Julian seguirá asignado.
Campo de Jira Mapeable:
| Jira | airfocus | Jira → enfoque aéreo | airfocus → Jira | airfocus ↔ Jira |
| Campo de selección única | Campo personalizado de selección única | ✅ | ✅ | ✅ |
| Campo multiselección | Campo personalizado de selección múltiple | ✅ | ✅ | ✅ |
| Campo de fechas | Campo de fecha personalizado (rango de fechas si es múltiple) | ✅ | ✅ | ✅ |
| Campo de texto (sin incluir texto enriquecido) | Campo de texto personalizado | ✅ | ✅ | ✅ |
| Campo de texto enriquecido | Descripción del ítem/ campo de descripción del enfoque aéreo | ✅ | ⚠️ | ⚠️ |
| Campo numérico | Campo numérico personalizado | ✅ | ✅ | ✅ |
| Campo numérico | Puntaje de Prioridad | ❌ | ✅ | ❌ |
| Etiquetas | Campo personalizado de selección múltiple | ✅ | ✅ | ✅ |
Solución de problemas: Encuentra el campo de tu rango de fechas
Necesitamos al menos dos campos de fecha (aparte de las versiones fijas) para poder mapearlos a un campo de rango de fecha de enfoque en el aire.
Nuestra integración solo puede detectar campos de fecha si son visibles en el tipo de problema sincronizado (pantalla). Debes cerciorarte de que al menos dos campos de fecha estén en el tipo de problema (pantalla) de Jira y que al menos un campo de rango de fechas esté disponible para mapear en tu espacio de trabajo Airfocus.
Cómo se ve eso en Jira:
- para Jira Cloud gestionado por equipo, ve a configuración de proyectos > tipos de incidencias y arrastra el campo desde la barra lateral derecha hasta la lista de campos en el centro.
- para Jira Cloud gestionado por la compañía (y Jira Server), ve a configuración del proyecto > problemas > pantallas y edita la pantalla del tipo de problema que estás sincronizando. Puedes agregar campos de fecha adicionales al final.
Auto-mapeo de campos
Al mapear campos con muchas opciones, activa "Auto-mapear opciones de campo" para ahorrar tiempo. Esto mapea automáticamente campos con los mismos valores tanto en Airfocus como en Jira.
Generación automática de valor de campo
Activa "Auto-crear opciones de campo" para agregar automáticamente nuevos campos creados en Jira al enfoque en el aire cuando se agregan a un objeto.
Nota: El generador de auto-creación de campos no distingue mayúsculas y mayúsculas.
Cómo mapear el puntaje de enfoque con Jira
Con la integración de Jira de Airfocus, puedes usar Airfocus para la priorización y la planeación de rutas, mientras que los desarrolladores (y otros) usan Jira para la planeación diaria del desarrollo.
Por defecto, ya mostramos datos de Airfocus como puntajes de prioridad, líneas y líneas temporales en Jira. Este artículo de ayuda describe cómo puedes mapear el puntaje de enfoque en el enfoque aéreo con un campo personalizado de Jira (para el que también puedes filtrar en Jira).
Al mapear el puntaje de enfoque de airfocus con tu proyecto de Jira, podrás mostrar tu métrica de prioridad número uno justo donde trabaja la gente: en cada tarjeta de emisión sincronizada de Jira y en la portada de la carta de emisión. De este modo, conseguirás que todo tu equipo esté alineado y centrado en qué tareas importan.
Para mostrar el puntaje de enfoque en Airfocus en Jira, necesitas mapearla con un campo personalizado de Jira. El campo personalizado debe tener el tipo de campo "Campo Número". Montar esto lleva unos 3 minutos.
Aquí te mostramos cómo:
- Dentro de Jira, haz clic en el icono de engranaje en la esquina superior derecha para abrir la configuración.
- Haz clic en Issues.
- Selecciona campo personalizado en el menú de navegación a la izquierda.
- Haz clic en Crear campo personalizado desde la esquina superior derecha.
- Selecciona el campo Número como tipo de campo.
- Escribe un nombre y una descripción (opcional).
- Haz clic en Crear.
- Asocia el nuevo campo personalizado a las pantallas (de tu proyecto sincronizado)
- Vuelve a la configuración de integración de Jira en AirFocus y selecciona el campo personalizado recién creado en el desplegable
El puntaje de enfoque de Airfocus aparecerá ahora para tus problemas de Jira
Si también quieres mostrar el puntaje de enfoque en las fundas de tus cartas, sigue estos pasos:
- Haz clic en el icono de tres puntos en la esquina superior derecha de tu Tablero.
- Selecciona los ajustes de Tablero.
- Haz clic en diseño de tarjetas desde el menú de navegación a la izquierda.
- Selecciona tu puntaje de enfoque en un campo personalizado desde el desplegable.
- Hacer clic en Agregar.
- Ahora también encontrarás el puntaje de enfoque en el Tablero.
Configurar configuraciones adicionales
- Cuando "Archivos unknown issues" está activado, los elementos importados anteriormente aparecerán en Archivo en Airfocus si ya no están presentes en Jira (o simplemente ya no coinciden con los filtros JQL).
- Cuando la "Sincronización automática" está activada, tu integración se sincronizará automáticamente cada 10 minutos y cada vez que accedas al espacio de trabajo.
- Haz clic en los registros de vistas para tus registros de integración de Jira actividad y mira qué cambios se hicieron antes de la última sincronización.
Tipos de enlace de ítems del mapa
Puedes sincronizar tipos de enlace de ítems—como "Bloques", "Duplicados" y "Relacionados"—entre Jira y Airfocus usando sincronización bidireccional o unidireccional. Cuando se configura la sincronización bidireccional (bidireccional) para un tipo de enlace, cualquier actualización en una plataforma se refleja automáticamente en la otra, permitiendo visualizar dependencias en líneas de tiempo y hojas de ruta sin duplicación manual. Para flujos de trabajo más específicos, puedes configurar sincronizaciones unidireccionales o consolidar tus datos mapeando varios tipos de enlace de Jira a un solo tipo de enlace Airfocus.
Para mapear los tipos de enlace de objetos, sigue estos pasos:
- Haz clic en Extensiones desde la esquina superior derecha de cualquier página de enfoque aéreo.
- Selecciona Gestionar integración.
- En "Integración activa", selecciona Jira.
- En "Mapeado de tipo de enlace de artículo", haz clic + Agregar mapeo de tipo de enlace.
- Usando los desplegables, selecciona un tipo de enlace para Jira a la izquierda y un tipo de enlace para el enfoque aéreo a la derecha.
- Haz clic en el icono de flecha bajo "Dirección" para cambiar si la sincronización es bidireccional o unidireccional.
- Opcionalmente, haz clic + Agregar tipo de enlace para agregar un tipo adicional de enlace Jira que se asigne a un único tipo de enlace de enfoque aéreo.
- Si agregas un tipo de enlace adicional, cuando AirFocus se sincroniza con Jira, solo se sincronizará con el tipo de enlace principal.
- Haz clic en Actualizar y sincroniza desde la parte inferior de la página.
Las relaciones y dependencias de objetos ahora se sincronizarán entre Jira y Airfocus según la configuración que configuraste.
Sincronización de jerarquía
La sincronización de jerarquía para Jira te permite sincronizar automáticamente las relaciones padre-hijo desde tu proyecto Jira a airfocus. Esto te permite hacer trabajo de gestión de producto en airfocus mientras tienes la última jerarquía de Jira a la vista sin necesidad de cambiar entre airfocus y Jira.
Para configurar/habilitar la sincronización de jerarquía para Jira, necesitarás:
- Dos o más espacios de trabajo con airfocus jerarquía activada entre ellos O un espacio de trabajo que permita relaciones jerárquicas dentro del mismo espacio de trabajo.
- Dos o más tipos de problemas de Jira sincronizados con Airfocus.
- Si tienes dos integraciones en dos espacios de trabajo, sincroniza un solo tipo de elemento para cada espacio de trabajo.
- Si tienes dos integraciones en un mismo espacio de trabajo, sincronízate un tipo de elemento para cada una de las integraciones en ese espacio de trabajo.
Un usuario necesita acceso completo al espacio de trabajo para poder cambiar cualquier cosa en la integración.
Para configurar la sincronización de jerarquías, sigue estos pasos:
- En la configuración de espacio de trabajo en Airfocus, cerciórate de que la jerarquía de productos de AirFocus esté activada con otro espacio de trabajo o dentro de tu espacio de trabajo actual.
- Al final de la página de configuración de integración de Jira, activa el widget "Enlace automático de objetos".
- Puedes elegir cualquier espacio de trabajo que cumpla con lo siguiente:
- El otro espacio de trabajo tiene una relación jerárquica con el actual.
- El otro espacio de trabajo tiene integración de Jira con la misma instancia de Jira.
- El usuario tiene acceso completo al otro espacio de trabajo.
- El otro espacio de trabajo está en el mismo equipo de enfoque aéreo.
Una vez que tengas la sincronización de Jerarquía activada, puedes ver directamente las relaciones padre-hijo en Airfocus.
Observa lo siguiente al activar la sincronización de jerarquía para Jira:
- La integración solo agrega las relaciones entre los elementos sincronizados, no los elementos adicionales. Esto significa que los elementos deben estar sincronizados ya por su respectiva integración antes de que los enlaces de jerarquía se sincronicen.
- La API de Jira no revela los hijos de una epica, lo que significa que impide que Airfocus detecte si una épica de Jira tiene problemas con hijos. Para ver las relaciones infantiles en airfocus, la épica ya tiene que sincronizar con airfocus cuando sincronizas los problemas a nivel de niños para que todas las relaciones se reflejen correctamente en airfocus.
La sincronización de jerarquía para Jira también puede configurar dentro del mismo espacio de trabajo, si varios tipos de problemas de Jira están sincronizados con el mismo espacio de trabajo de Airfocus (ya sea mediante una o varias integraciones) y se activó 'Permitir relaciones jerárquicas dentro de este espacio de trabajo' en la pestaña Jerarquía de la configuración de Espacio de trabajo.
Un usuario requiere al menos acceso de lectura al proyecto Jira conectado para habilitar la sincronización de jerarquía para Jira.
Nota sobre la sincronización jerárquica para el Usuario de centros de datos Jira/local:
- La jerarquía de enfoque aéreo no coincide con las iniciativas locales de Jira. Solo épicas, historias, tareas y sub-tareas.
- La jerarquía de enfoque aéreo se sincroniza con todos los niveles de Jira Cloud, incluyendo iniciativas, épicas, historias, tareas y subáreas.
Información adicional
Conecta varios proyectos de Jira
Para conectar otro proyecto de Jira desde la misma instancia de Jira con tu espacio de trabajo, no tienes que pasar por el proceso de autenticación de nuevo en el proceso. Puedes agregar otro proyecto de integración de Jira en la página de integración a partir de ahora. La configuración solo requerirá seleccionar la instancia y empezar el mapeo de inmediato.
Direcciones IP estáticas para poner en lista blanca para tu integración con Jira Server
Si se está integrando con un sistema de implementación local como Jira Server, es posible que su equipo de TI deba permitir la lista de Airfocus en su firewall para que Airfocus pueda realizar conexiones a su servidor para crear registros. Puedes realizar la conexión a través del puerto 443.
Teams en https://app.airfocus.com o https://app.us.airfocus.com emplean estas direcciones IP:
- 46.101.71.101
- 46.101.69.142
Equipos en https://airfocus.app Emplea estas direcciones IP:
- 100.24.176.163
- 34.204.246.112
- 54.227.154.184
- 35.156.253.227
- 18.159.159.136
- 18.199.183.125
Solución de problemas
- Comprueba que las licencias del usuario que intenta conectar AirFocus a Jira cumplen con los requisitos.
- Comprueba si hay advertencias o campos que falten en la sección de mapeo de campos.
- Haz clic en el botón "depurar" en la parte inferior de la configuración de integración. Durante la sincronización, se llaman a varios extremos de la API. Si uno de ellos falla, es difícil saber cuál. El diálogo de Depurar muestra todas las llamadas y sus Resultados, para facilitar que encuentres una configuración incorrecta.
- Elimina y vuelve a instalar la integración. Pista: La configuración de enlaces de la app para conectar AirFocus a Jira sigue en pie.
- Contacta con nuestro encantador equipo de éxito del cliente para más información sobre Soporte.
Dejar comentarios sobre este artículo
¿Tienes comentarios sobre este artículo? Cuéntanos tu experiencia aquí.