Integrar airfocus con Azure DevOps

Beneficios de usar la integración con Azure DevOps

• Importa los elementos de trabajo de DevOps de Azure a Airfocus.
• Empuja los objetos de AirFocus en Azure DevOps (como cualquier tipo de trabajo de trabajo).
• Flexible filtros (via Azure DevOps Issue Search).
• Mapeado flexible para system y campo personalizado con direcciones de sincronización configurables por campo.
• Mapea directamente las descripciones de DevOps de Azure a las descripciones de Airfocus.
• Muestra tus iteraciones (sprints) en Airfocus para obtener contexto sobre el valor y las prioridades del negocio.

Configurar la integración

La integración en airfocus siempre se conecta a un airfocus específico del espacio de trabajo. Puedes agregar múltiples integraciones de Azure DevOps a un espacio de trabajo dado (por ejemplo, de diferentes proyectos Azure DevOps o para distintos tipos de elementos de trabajo).

Para configurar la integración de Azure DevOps, sigue estos pasos:

1. Regístrate en AirFocus o inicia sesión en tu cuenta actual. 
2. Crea un nuevo espacio de trabajo en AirFocus o selecciona el que quieres integrar Azure DevOps.
3. Haz clic en Extensiones desde la esquina superior derecha de la página.
4. Selecciona Gestionar integración.
   
5. Haz clic en Conectar desde la casilla "Azure DevOps".

A partir de aquí, los pasos varían según el tipo de instancia. Lea las secciones a continuación para conocer los pasos de cada uno.

Conéctate con tu cuenta de Azure DevOps Cloud

Para seguir configurando la integración de una cuenta Cloud de Azure DevOps, sigue estos pasos:

1. Selecciona Azure Cloud en el selector de tipos de instancia.
2. Haz clic en Continuar.

Serás redirigido a Azure DevOps para autenticar tus licencias de acceso y, tras iniciar sesión en tu cuenta, serás redirigido a la página de integración de Airfocus de tu espacio de trabajo.

Cerciórate de tener activada la opción "Acceso a aplicaciones de terceros vía OAuth" en la pantalla de políticas de la organización de Azure DevOps para garantizar una integración exitosa.

Conéctate a tu cuenta de Azure DevOps Server (local)

Para seguir configurando la integración de una cuenta Cloud de Azure DevOps, sigue estos pasos:

1. Seleccione Azure On-Premise en el selector de tipo de instancia.
2. Haz clic en Continuar.
3. Introduce los datos para conectarte a tu instancia de Azure DevOps Server.
   • URL base: Introduce la primera parte de tu URL de Azure DevOps Server (todo lo anterior hasta el final de tu dominio/dirección IP y antes de la primera barra diagonal). Por ejemplo: https://198.254.533.325. La URL debe ser accesible desde nuestros servidores, así que no puedes usar URLs alojadas localmente aquí.
   • Token de acceso personal: Obtén tu token de acceso personal yendo a la sección de tokens de acceso personal de la configuración de seguridad de tu Azure DevOps Usuario. Para más detalles, consulte la sección "Obtener un token de acceso personal" más abajo.
   • Nombre de la organización: Introduce el nombre exacto de la organización de Azure DevOps que quieres sincronizar con Airfocus.
4. Haz clic en Continuar para conectar a tu equipo de Airfocus con tu organización Azure DevOps.

Obtener un token de acceso personal

Para obtener tu token de acceso personal en Azure DevOps, sigue estos pasos:

1. Abre la configuración de seguridad de tu ADO.
2. Selecciona Tokens de acceso personal en el menú de navegación en el lado izquierdo de la página.
3. Haz clic + Nuevo Token desde la parte superior de la página.
4. Cree un nuevo token con al menos las siguientes licencias:
   • Elementos de trabajo (lectura y escritura)
   • Proyecto y equipo (leer)
   • Los tokens de acceso personal pueden configurar para ser válidos por un máximo de 1 año. Recuerda mantener actualizada la validez de tu token para cerciorar que la integración de Airfocus funcione sin interrupciones.
5. Haz clic en Crear.
6. Copia el token y pégalo en la configuración de integración de Airfocus.

Configura tus filtros de integración

Para configurar tus filtros de integración:

1. Selecciona el proyecto Azure DevOps con el que quieres integrar. Agrega la siguiente información para que Airfocus sepa a dónde enviar los datos:
   • Organización
   • Proyecto
   • Área
2. Opcionalmente, incluye elementos de trabajo de todas las subáreas del área seleccionada marcando la casilla junto a "Incluir elementos de trabajo de todas las subáreas del área seleccionada".

Puedes especificar además qué elementos de trabajo quieres sincronizar usando el campo de Búsqueda de Incidencias de Azure DevOps en la configuración de integración. Proporciona una búsqueda rápida y flexible en todos tus trabajos y en todos tus proyectos (por ejemplo, t:epic AND s:new).

Filtros comunes

• Para filtros por el tipo de elemento de trabajo Azure DevOps:
  • T:Épico
  • T:Característica
  • t:story
  • t:tareas

Para extraer elementos con una etiqueta específica de Azure DevOps

• etiquetas:etiqueta abc

Para incorporar elementos con una iteración específica de Azure DevOps.

• iteración:iteración abc

Lee más sobre la búsqueda avanzada aquí.

Configura tu mapeo de campos

Emplea el mapeo para definir cómo debe mapearse la información en Azure DevOps a Airfocus (y viceversa). Los nombres de los elementos (obligatorios) y las descripciones de los elementos (opcionales) siempre se asignan por defecto al configurar una nueva integración.

Cómo establecer direcciones de mapeo

Define para cada uno de tus campos si quieres tener una sincronización unidireccional o una sincronización bidireccional entre el campo en Azure DevOps y Airfocus.

Establece las direcciones de mapeo para todos los campos a la vez con el desplegable "Establecer dirección".

Por defecto, la dirección de mapeo está configurada de Azure DevOps a solo enfoque en aire y el usuario puede cambiar según lo que esté disponible para mapear.

Cómo agregar un nuevo mapeo de campos

Cuando seleccionas un campo en el desplegable, solo los campos que coinciden con ese tipo de campo se muestran en el desplegable del otro extremo.

Luego de seleccionar dos campos que quieres mapear, puedes seleccionar las opciones de campo y cómo deben asignar:

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 Azure DevOps.

Generación automática de valor de campo

Activa "Auto-crear opciones de campo" para agregar automáticamente nuevos campos creados en Azure DevOps a Airfocus cuando se agregan a un elemento. 

Nota: El generador de auto-creación de campos no es sensible a mayúsculas minúsculas.

Visión general de todas las opciones de mapeo de campo actualmente disponibles

Notas

1. ⚠️ Si la descripción está sincronizada en ambas direcciones, esto puede provocar que AirFocus realice pequeños cambios en el contenido y el formato de las descripciones de Azure DevOps. Esto se debe a que todavía no todos los estilos de Azure DevOps son compatibles de forma nativa con Airfocus.
2. El mapeo en esta dirección no puede soportar si el campo objetivo en ADO está configurado como solo lectura.
3. Esto incluye solo campos numéricos personalizados de ADO. Mientras que cualquier sistema de campos numéricos debe implementar por separado (como por ejemplo Prioridad o Esfuerzo). Por lo tanto, si un campo numérico del sistema no se menciona explícitamente en esta tablas, significa que aún no está soportado.
4. Las listas de selección con valores personalizados permitidos no son adecuadas para mapear a campos de selección de enfoque en el aire, porque la cantidad de opciones de selección en este caso es dinámica y puede cambiar frecuentemente con el tiempo, lo que requeriría reconfigurar el mapeo de integración cada vez que aparece un nuevo valor en la lista de selecciones. Por eso asignamos estas listas de selección a campos de texto o números normales en el enfoque aéreo, así cualquier valor nuevo en el lado ADO siempre se sincroniza automáticamente con el lado del enfoque en aire.
5. Esto incluye campos personalizados de fecha-hora, así como los campos del sistema Fecha Empezar, Fecha Objetivo, Fecha de Entrega, Fecha de Resuelto y Fecha de Cambio de Estado.
6. ⚠️ Actualmente, Airfocus no soporta campos de fecha-hora (con la parte de la hora), sino solo campos de fecha. Por lo tanto, mapear campos de fecha y hora ADO en campos de fecha de enfoque en ambas direcciones. Resultados en la pérdida de la parte de tiempo en el lado ADO - la hora se resetear con el foco en aire a 00:00:00.
7. Actualmente, ADO no tiene campos de rango de fechas incorporados. Sin embargo, es posible mapear un par de campos de fecha-hora ADO soportados en un campo de enfoque de distancia de fechas.
8. Mapear el campo Stack Rank de airfocus a Microsoft Azure DevOps puede provocar comportamientos inesperados. La documentación de Microsoft recomienda no actualizar manualmente este campo, ya que Microsoft Azure DevOps calcula dinámicamente la clasificación de la pila tras bambalinas para mantener backlog prioridades. Se emplea mejor como una sincronización unidireccional de ADO a airfocus.

Sincronización de jerarquía

La sincronización de jerarquía para Azure DevOps te permite sincronizar automáticamente las relaciones padre-hijo desde tu proyecto Azure DevOps con Airfocus (por ahora es unidireccional). Esto te permite hacer trabajo de gestión de producto en Airfocus mientras tienes la última jerarquía de Azure DevOps a la vista sin necesidad de cambiar entre Airfocus y Azure DevOps.

Para configurar/habilitar la sincronización de jerarquía para Azure DevOps, necesitarás:

• Dos o más espacios de trabajo con la jerarquía Airfocus 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 elementos de trabajo de Azure DevOps 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 configuración de integración.

Para configurar la sincronización de jerarquías, sigue estos pasos:

1. 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.
   
2. En la parte inferior de la página de configuración de integración de Azure DevOps, activa el widget "Enlace automático de objetos".
   
3. Para cerciorar que la jerarquía se mantiene, cerciórate de que los espacios de trabajo cumplan lo siguiente:
   • El otro espacio de trabajo tiene integración con la misma organización de Azure DevOps.
   • 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.

Ten en cuenta lo siguiente al activar la sincronización de jerarquía para Azure DevOps:

• La integración solo agrega las relaciones entre los elementos sincronizados, no los elementos adicionales. Esto significa que los elementos deben sincronizar ya con su integración respectiva antes de que los enlaces jerárquicos se sincronicen.
• La sincronización de jerarquía para Azure DevOps también puede configurar dentro del mismo espacio de trabajo, si varios tipos de elementos de trabajo de Azure DevOps 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 requeriría al menos acceso de lectura al proyecto Azure DevOps conectado para habilitar la sincronización de jerarquía para Azure DevOps.

Configuración adicional

• Cuando "Archivos unknown issues" está activado, los elementos importados anteriormente están en Archivo en Airfocus si ya no están presentes en Azure DevOps o ya no entran en el conjunto de filtros para la integración.
• Cuando la "Sincronización automática" está activada, tu integración se sincroniza automáticamente cada 10 minutos y cada vez que accedes al espacio de trabajo.
• Haz clic en registros de vistas para tus registros de integración de Azure DevOps actividad y mira qué cambios se hicieron antes de la última sincronización.
  

Para almacenar tus ajustes e importar tus objetos a Airfocus, haz clic en Actualizar y sincroniza.

Direcciones IP estáticas para poner en lista blanca para tu integración con Azure DevOps

Equipos en https://app.airfocus.com o https://app.us.airfocus.com  Emplea 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

Información importante

• Para crear/autenticar una nueva integración con Azure DevOps, la cuenta de Azure DevOps empleada debe tener acceso a nivel Administrador.
• Modificar una integración existente en airfocus solo requiere que el usuario tenga licencias completas para el espacio de trabajo.
• Incluso si el usuario de AirFocus no tiene acceso a la cuenta de Azure DevOps empleada en la configuración inicial, la cuenta de Azure DevOps debe conservar las mismas licencias para cerciorar que la integración funcione en todo momento.
• Si antes se activó una sincronización bidireccional, se aplicará a todos los mapeos cuando sea posible. Si no, se configurará como una sola vía de Azure DevOps a Airfocus.
• Si "Mostrar descripción de Azure DevOps" estaba activada, la integración solo sincronizará la descripción con el campo especial de solo lectura hasta el 31 de marzo de 2023. El usuario debe migrar manualmente al nuevo mapeo de campos de descripción en la sección de mapeo de campos de su integración. Desde el 1 de abril de 2023, el campo especial de descripción (y su interruptor) dejará de estar disponible.

Dejar comentarios sobre este artículo