Integración de Azure DevOps

  • Artículo

Introducción a la integración de Azure DevOps

Viva Goals se integra con Microsoft Azure DevOps para actualizar automáticamente los resultados clave y los proyectos de Viva Goals. El resultado clave y el progreso del proyecto se actualizan automáticamente en función de los elementos de trabajo de Azure DevOps conectados. Puede usar la integración de Azure DevOps para

  • Seguimiento automático del progreso de un resultado clave
  • Seguimiento automático del progreso de un KPI de iniciativa
  • Realice un seguimiento automático del progreso y las tareas de una iniciativa.
    • Este enfoque actualiza el progreso de la iniciativa, sincroniza los detalles del elemento de trabajo de Azure DevOps con Viva Goals iniciativa "tareas" y, cuando se usa con la extensión de Azure DevOps Viva Goals, Viva Goals detalles de alineación de OKR se exponen directamente en los elementos de trabajo vinculados de Azure DevOps.

Consulte a continuación para obtener más información sobre cómo funciona la integración de Azure DevOps al conectarse a resultados clave, métricas de iniciativas y tareas de iniciativa.

Resultados (OKR) frente a salidas (iniciativas)

Uno de los principios fundamentales de las OKR es distinguir entre resultados frente a salidas. Los OKR y los resultados clave se centran en impulsar el impacto (es decir, los resultados), mientras que las iniciativas de Viva Goals se centran en los resultados: el trabajo que está planeado para lograr los resultados clave. Ambas son métricas importantes de las que realizar un seguimiento, pero miden cosas diferentes.

Aunque puede integrar Viva Goals resultados e iniciativas clave con los elementos de trabajo de Azure DevOps, es importante comprender la diferencia. Azure DevOps se centra principalmente en el seguimiento del trabajo, por lo que es más común integrar iniciativas de Viva Goals con Azure DevOps. Hay algunos ejemplos en los que puede tener sentido realizar un seguimiento del progreso de los resultados clave en función de los elementos de trabajo de Azure DevOps.

Cuándo usar la integración de Azure DevOps

Hay tres maneras de usar la integración de Azure DevOps con flujos de trabajo de Viva Goals. A continuación se describen los detalles de cada una de estas funcionalidades:

  1. Realice un seguimiento del progreso de una iniciativa con tareas: Además de realizar un seguimiento del progreso de la iniciativa en función de los elementos de trabajo de Azure DevOps, este enfoque permite una experiencia de usuario multiplataforma. Los detalles del elemento de trabajo de Azure DevOps se sincronizan con las vistas de iniciativa de Viva Goals y la alineación del trabajo de Azure DevOps con Viva Goals okrs se pueden ver directamente dentro de los elementos de trabajo vinculados de Azure DevOps a través de la extensión de Azure DevOps (próximamente)
  2. Realice un seguimiento del progreso de una iniciativa con KPI: Este enfoque le permite realizar un seguimiento del progreso de la iniciativa en función del estado de los elementos de trabajo de Azure DevOps. Un único valor numérico se sincroniza con Viva Goals.
  3. Realice un seguimiento del progreso de un resultado clave: Este enfoque le permite realizar un seguimiento del progreso de KR en función del estado de los elementos de trabajo de Azure DevOps. Un único valor numérico se sincroniza con Viva Goals.

Configuración de la integración de Azure DevOps

La integración de Azure DevOps debe estar habilitada por un administrador de inquilinos y organización de Viva Goals. Los administradores globales deben habilitar primero la integración de Azure DevOps para su inquilino (Habilitar integraciones en Viva Goals | Microsoft Learn). Una vez habilitado en el nivel de inquilino, un administrador de Viva Goals Organización debe habilitarlo para su organización (introducción a la administración de integraciones Viva Goals).

Nota:

Una vez habilitado, cualquier usuario de la organización que tenga permisos para crear o editar un OKR o una iniciativa puede configurar la integración entre Viva Goals y Azure DevOps.

Habilitación de la integración de Azure DevOps con iniciativas

Este método es el enfoque recomendado para alinear el trabajo en Azure DevOps con OKRsin Viva Goals. Además de realizar un seguimiento del progreso de la iniciativa en función de los elementos de trabajo de Azure DevOps, este enfoque permite una experiencia de usuario multiplataforma. Los detalles del elemento de trabajo de Azure DevOps se sincronizan con las vistas de iniciativa de Viva Goals y, cuando se usan con la extensión Viva Goals Azure DevOps, la alineación del trabajo de Azure DevOps con Viva Goals OKR se expone directamente dentro de los elementos de trabajo vinculados de Azure DevOps.

  1. Seleccione Agregar iniciativa en Viva Goals o edite una iniciativa existente.

  2. Seleccione Resultado.

  3. Seleccione Agregar tareas.

  4. Seleccione Automáticamente en un origen de datos.

  5. Seleccione Azure DevOps en la lista de integraciones disponibles.

  6. Seleccione la conexión de Azure DevOps adecuada. Si necesita crear una nueva conexión de Azure DevOps, deberá iniciar sesión en Azure DevOps para crear una conexión de datos. Se necesita una nueva conexión para cada proyecto de Azure DevOps. Después de iniciar sesión:

    • Proporcione un nombre de conexión: se recomienda incluir la organización y el proyecto de Azure DevOps en el nombre para futuras referencias.
    • Selección de la organización de Azure DevOps
    • Selección del proyecto de Azure DevOps
    • Seleccione Siguiente

  7. Seleccione el método de conexión:

    • Consulta compartida: permite conectarse a una consulta existente guardada en Azure DevOps.
    • Elementos de trabajo: permite conectarse a uno o varios elementos de trabajo de un tipo de elemento de trabajo específico. Este enfoque le permite conectarse directamente a los elementos de trabajo "primarios" que contienen el trabajo auxiliar; los elementos de trabajo secundarios se incluyen automáticamente.

Si usa el método de conexión a "Consulta compartida":

  1. Seleccione el método de consulta compartida .
  2. Busque y seleccione la consulta compartida que contiene los elementos de trabajo de Azure DevOps.
  3. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso de la iniciativa. Puede elegir entre cualquier tipo de elemento de trabajo de la consulta o todos los elementos de trabajo de la consulta compartida.
  4. Seleccione el campo Azure DevOps que desea usar para realizar el seguimiento del progreso de la iniciativa. Viva Goals progreso de la iniciativa se calcula como el porcentaje completado del tipo de elemento de trabajo elegido.
  5. Selecciona Siguiente.
  6. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto a la iniciativa. También debería ver los detalles del elemento de trabajo de Azure DevOps en las vistas de iniciativa de Viva Goals. Viva Goals ahora sincronizará automáticamente los detalles del elemento de trabajo y actualizará el progreso de la iniciativa una vez por hora en función del campo ADO para los tipos de elementos de trabajo seleccionados dentro de la consulta compartida.

Si usa el método Conectar a elementos de trabajo:

  1. Seleccione el método de elementos de trabajo .
  2. Seleccione el tipo de elemento de trabajo al que conectarse: se recomienda elegir el tipo de elemento de trabajo "primario" en la jerarquía de Azure DevOps que contiene el trabajo que se está realizando. La integración incluirá automáticamente los elementos de trabajo secundarios. Por ejemplo, conéctese a una característica que sea el elemento primario de las tareas en lugar de conectarse a cada tarea individual.
  3. Busque y seleccione los elementos de trabajo específicos del tipo elegido.
  4. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso de la iniciativa. Puede elegir medir el progreso por un tipo de elemento de trabajo específico (es decir, el tipo al que se conecta directamente o cualquiera de sus tipos secundarios) o todos los elementos de trabajo (es decir, los elementos conectados y los elementos secundarios).
  5. Seleccione el campo ADO que desea usar para realizar el seguimiento del progreso de la iniciativa.
  6. Seleccione Siguiente.
  7. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto a la iniciativa. También debería ver los detalles del elemento de trabajo de Azure DevOps en las vistas de iniciativa de Viva Goals. Viva Goals ahora sincronizará automáticamente los detalles del elemento de trabajo y actualizará el progreso de esta iniciativa una vez por hora en función del campo Azure DevOps para los tipos de elementos de trabajo seleccionados.

Después de completar los pasos anteriores, no solo se actualizará automáticamente el progreso de la iniciativa Viva Goals, sino que también se habilitarán las siguientes funcionalidades:

  • Los detalles del elemento de trabajo de Azure DevOps se muestran en las vistas de iniciativa de Viva Goals, junto con hipervínculos a los detalles del elemento de trabajo de Azure DevOps.
  • Si ha habilitado la extensión Viva Goals Azure DevOps, se puede acceder a la alineación completa entre los OKR y los elementos de trabajo de Azure DevOps desde una pestaña de Viva Goals dentro de los elementos de trabajo vinculados de Azure DevOps.

Uso de la integración de Azure DevOps con KPI de iniciativa

Use este método cuando desee actualizar el progreso de la iniciativa de Viva Goals con un único valor numérico. Este enfoque no mostrará los elementos de trabajo de Azure DevOps dentro de Viva Goals vistas de iniciativa, ni este método tiene la capacidad de insertar Viva Goals dentro de los elementos de trabajo de Azure DevOps.

  1. Seleccione Agregar iniciativa en Viva Goals o edite una iniciativa existente.

  2. Seleccione Resultado.

  3. Seleccione Agregar métrica y rellene los detalles necesarios (es decir, nombre, tipo, unidades, inicio, valores de destino)

    • En el caso de las métricas basadas en porcentajes, el progreso de la iniciativa se calcula en función del porcentaje del valor de campo de ADO seleccionado para los elementos de trabajo completados frente a los elementos de trabajo totales.
    • En el caso de las métricas no basadas en porcentajes (numérico, moneda), el progreso de la iniciativa es un recuento del valor del campo ADO seleccionado para los elementos de trabajo completados o, opcionalmente, totales.

  4. Seleccione Progreso.

  5. Seleccione Automáticamente en un origen de datos.

  6. Seleccione Azure DevOps en la lista de integraciones disponibles.

  7. Seleccione la conexión de Azure DevOps adecuada. Si necesita crear una nueva conexión de Azure DevOps, debe iniciar sesión en Azure DevOps para crear una conexión de datos. Se necesita una nueva conexión para cada proyecto de Azure DevOps. Después de iniciar sesión:

    • Proporcione un nombre de conexión: se recomienda incluir la organización de Azure DevOps y las iniciativas en el nombre para facilitar la referencia futura.
    • Selección de la organización de Azure DevOps
    • Selección del proyecto de Azure DevOps
    • Seleccione Siguiente

  8. Seleccione el método de conexión:

    • Consulta compartida: permite conectarse a una consulta existente almacenada en Azure DevOps
    • Elementos de trabajo: permite conectarse a uno o varios elementos de trabajo de un tipo de elemento de trabajo específico. Este enfoque le permite conectarse directamente a los elementos de trabajo "primarios" que contienen el trabajo auxiliar; los elementos de trabajo secundarios se consideran automáticamente.

Si usa el método de conexión a "Consulta compartida":

  1. Seleccione el método de consulta compartida .
  2. Busque y seleccione la consulta compartida que contiene los elementos de trabajo de Azure DevOps.
  3. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso de la iniciativa. Puede elegir entre cualquier tipo de elemento de trabajo de la consulta o todos los elementos de trabajo de la consulta.
  4. Seleccione el campo Azure DevOps que desea usar para realizar el seguimiento del progreso de la iniciativa.
  5. Selecciona Siguiente.
  6. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto a la iniciativa. Viva Goals ahora actualizará automáticamente el progreso una vez por hora.

Si usa el método Conectar a elementos de trabajo:

  1. Seleccione el método de elementos de trabajo .
  2. Seleccione el "tipo de elemento de trabajo" al que conectarse: se recomienda elegir el tipo de elemento de trabajo "primario" en la jerarquía de Azure DevOps que contiene el trabajo que se está realizando. La integración incluirá automáticamente los elementos de trabajo secundarios. Por ejemplo, conéctese a una característica que sea el elemento primario de las tareas en lugar de conectarse a cada tarea individual.
  3. Busque y seleccione los elementos de trabajo específicos del tipo elegido.
  4. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso de la iniciativa. Puede elegir medir el progreso por un tipo de elemento de trabajo específico (es decir, el tipo al que se conecta directamente o cualquiera de sus tipos secundarios) o todos los elementos de trabajo (es decir, los elementos conectados y los elementos secundarios).
  5. Seleccione el campo ADO que desea usar para realizar el seguimiento del progreso de la iniciativa.
  6. Seleccione Siguiente.
  7. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto a la iniciativa. Viva Goals ahora actualizará automáticamente esta iniciativa una vez por hora.

Uso de la integración de Azure DevOps con un resultado clave

Use este método cuando desee actualizar el progreso del resultado de clave de Viva Goals con un único valor numérico. Este enfoque no mostrará los elementos de trabajo de Azure DevOps dentro de Viva Goals, ni este método tiene la capacidad de insertar Viva Goals dentro de los elementos de trabajo de Azure DevOps.

  1. Seleccione Agregar resultado de clave en Viva Goals o edite un resultado de clave existente.

  2. Seleccione Agregar métrica y rellene los detalles necesarios (es decir, nombre, tipo, unidades, inicio, valores de destino)

    • En el caso de las métricas basadas en porcentajes, el progreso del resultado clave se calcula en función del porcentaje del valor de campo de ADO seleccionado para los elementos de trabajo completados frente al total de elementos de trabajo.
    • En el caso de las métricas no basadas en porcentajes (numérico, moneda), el progreso del resultado clave es un recuento del valor del campo ADO seleccionado para los elementos de trabajo completados o, opcionalmente, totales.

  3. Seleccione Progreso.

  4. Seleccione Automáticamente en un origen de datos.

  5. Seleccione Azure DevOps en la lista de integraciones disponibles.

  6. Seleccione la conexión de Azure DevOps adecuada. Si necesita crear una nueva conexión de Azure DevOps, debe iniciar sesión en Azure DevOps para crear una conexión de datos. Se necesita una nueva conexión para cada proyecto de Azure DevOps. Después de iniciar sesión:

    • Proporcione un nombre de conexión: se recomienda incluir la organización y la iniciativa de Azure DevOps en el nombre para facilitar la referencia futura.
    • Seleccione la organización de Azure DevOps.
    • Seleccione el proyecto de Azure DevOps.
    • Selecciona Siguiente.

  7. Seleccione el método de conexión:

    • Consulta compartida: permite conectarse a una consulta existente almacenada en Azure DevOps
    • Elementos de trabajo: permite conectarse a uno o varios elementos de trabajo de un tipo de elemento de trabajo específico. Este enfoque le permite conectarse directamente a los elementos de trabajo "primarios" que contienen el trabajo auxiliar; los elementos de trabajo secundarios se consideran automáticamente.

Si usa el método de conexión a "Consulta compartida":

  1. Seleccione el método de consulta compartida .
  2. Busque y seleccione la consulta compartida que contiene los elementos de trabajo de Azure DevOps.
  3. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso del resultado de la clave. Puede elegir entre cualquier tipo de elemento de trabajo de la consulta o todos los elementos de trabajo de la consulta compartida.
  4. Seleccione el campo ADO que desea usar para realizar el seguimiento del progreso del resultado de la clave.
  5. Selecciona Siguiente.
  6. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto al resultado de la clave. Viva Goals ahora actualizará automáticamente el progreso una vez por hora.

Si usa el método Conectar a elementos de trabajo:

  1. Seleccione el método de elementos de trabajo .
  2. Seleccione el "tipo de elemento de trabajo" al que conectarse: se recomienda elegir el tipo de elemento de trabajo "primario" en la jerarquía de Azure DevOps que contiene el trabajo que se está realizando. La integración incluirá automáticamente los elementos de trabajo secundarios. Por ejemplo, conéctese a una característica que sea el elemento primario de las tareas en lugar de conectarse a cada tarea individual.
  3. Busque y seleccione los elementos de trabajo específicos del tipo elegido.
  4. Seleccione el tipo de elemento de trabajo que desea usar para calcular el progreso del resultado de la clave. Puede elegir medir el progreso por un tipo de elemento de trabajo específico (es decir, el tipo al que se conecta directamente o cualquiera de sus tipos secundarios) o todos los elementos de trabajo (es decir, los elementos conectados y los elementos secundarios).
  5. Seleccione el campo ADO que desea usar para realizar el seguimiento del progreso del resultado de la clave.
  6. Seleccione Siguiente.
  7. Seleccione Guardar.

Ahora debería ver el icono de Azure DevOps junto al resultado de la clave. Viva Goals ahora actualizará automáticamente esta iniciativa una vez por hora en función del campo ADO para los tipos de elementos de trabajo seleccionados.

Cálculo del progreso de los campos de ADO en Viva Goals:

Seguimiento del progreso por Métrica de porcentaje Métrica de número
Recuento de elementos de trabajo Porcentaje de elementos de trabajo completados del total de elementos de trabajo para el tipo de elemento de trabajo o consulta especificado. Número de elementos de trabajo para el tipo de consulta o elemento de trabajo especificado.
Puntos de la historia Porcentaje de puntos de historia de los elementos de trabajo completados de los puntos de historia totales de los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado. Suma de puntos de historia para los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado.
Esfuerzo Porcentaje de esfuerzo de los elementos de trabajo completados del esfuerzo total de los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado. Suma de esfuerzo para los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado.
Estimación original Porcentaje del total de horas estimadas originales para los elementos de trabajo completados de las horas estimadas originales totales de todos los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado. Suma de horas de estimación originales de los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado.
Trabajo restante N/D Total de horas de trabajo restantes para los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado.
Trabajo completado Porcentaje del total de horas de trabajo completadas para los elementos de trabajo completados del total de horas de trabajo completadas para todos los elementos de trabajo para el tipo de elemento de trabajo o consulta especificado. Total de horas de trabajo completadas para los elementos de trabajo para un tipo de consulta o elemento de trabajo determinado.
Campos personalizados Porcentaje completado del campo personalizado numérico asociado en ADO para el tipo de consulta o elemento de trabajo especificado. Suma total del campo personalizado numérico asociado en ADO para el tipo de consulta o elemento de trabajo especificado.

Solución de problemas de conexión

Para integrarse con Azure DevOps, el servicio Viva Goals debe poder acceder a los elementos de trabajo de la organización de Azure DevOps y a la iniciativa que configure al crear la conexión en Viva Goals. En función de cómo administre su organización sus directivas de acceso condicional de Microsoft Entra y los permisos de Azure DevOps, Viva Goals podría no poder acceder a la información.

Errores prohibidos

Si encuentra mensajes de error prohibidos al crear una conexión de Azure DevOps, es probable que se culpen a las restricciones de direcciones IP u otras directivas de acceso condicional. En este caso, debe comprobar si la directiva habilitar Microsoft Entra validación de CAP de identificador está habilitada en la organización de Azure DevOps. Para obtener más información, consulte la documentación de Azure DevOps.

Soluciones

Tiene dos opciones: puede desactivar la directiva habilitar Microsoft Entra validación de CAP de identificador en la organización de Azure DevOps. Lo que requeriría y administrador de Azure DevOps, o bien debe agregar las direcciones IP salientes del servicio Viva Goals a las directivas de acceso condicional para los inquilinos Microsoft Entra id.

Preguntas más frecuentes (preguntas más frecuentes)

  1. Al conectar mis tareas de iniciativa de Viva Goals con Azure DevOps, ¿por qué no veo todos los elementos de trabajo en mi consulta compartida o todos los elementos de trabajo secundarios cuando se usa el método "Conectar al elemento de trabajo"?
    1. Si conecta la iniciativa de Viva Goals a Azure DevOps, Viva Goals no expone todos los elementos de trabajo. Lo que Viva Goals muestra depende de cómo decida calcular el progreso general de la iniciativa Viva Goals durante el proceso de configuración. Si decide calcular el progreso de la iniciativa por cualquier elemento de trabajo, Viva Goals de hecho expondrá todos los elementos de trabajo de consulta compartida o todos los elementos secundarios, si se conectó directamente a los elementos de trabajo.

      Sin embargo, creemos que elegir "cualquier" tipo de elemento de trabajo es la excepción, ya que este enfoque expondría una cantidad excesiva de detalles de elementos de trabajo no necesarios dentro de Viva Goals experiencia de usuario. Se supone que la mayoría de los usuarios deciden calcular el progreso por un tipo de elemento de trabajo específico dentro de la consulta compartida o un elemento secundario de los elementos de trabajo conectados. Viva Goals usará esa decisión para limitar lo que exponemos en la experiencia de usuario de Viva Goals.

      Por ejemplo, suponga que el trabajo de Azure DevOps es el seguimiento de características, historias de usuario y tareas. Además, supongamos que decide realizar un seguimiento del progreso de Viva Goals iniciativa en función de la finalización del artículo de usuario. Viva Goals solo mostrará las características y las historias de usuario dentro de las vistas de iniciativa de Viva Goals. Los usuarios pueden "hacer doble clic" rápidamente en Azure DevOps para obtener más detalles según sea necesario.