Compartir a través de

Integración de GitLab

  • Artículo

Viva Goals integración de GitLab le permite actualizar el progreso objetivo y clave del resultado (OKR) automáticamente en función del progreso de los problemas en los proyectos de GitLab.

Supongamos que usa GitLab para realizar un seguimiento de los proyectos y que tiene un objetivo en Viva Goals resolver 30 problemas cada trimestre. Al vincular este objetivo al proyecto correspondiente en GitLab, el estado del OKR se actualizará a medida que se resuelvan los problemas del proyecto asociado. También puede realizar un seguimiento del progreso de los problemas que controla un usuario específico en busca de objetivos centrados en el usuario. Viva Goals sincronizará automáticamente los valores y hará un gráfico de su progreso hacia el objetivo, lo que ahorrará tiempo mientras mantiene sus OKR actualizados.

Todos los usuarios y administradores pueden usar esta característica. Los administradores pueden administrar la integración desde el panel de administración.

Habilitación de la integración de GitLab

Los administradores pueden seguir estos pasos para habilitar esta integración:

  1. En la barra lateral, vaya a Administración y seleccione la pestaña Integraciones.

  2. Busque GitLab o búsdela en la sección Integraciones de datos .

  3. Seleccione Habilitar junto a GitLab. Si ya ha creado una conexión, tendrá una opción para administrar la integración en su lugar.

    Para deshabilitar la integración, seleccione Administrar> laintegración de deshabilitación decambios>.

Conexión de GitLab a la cuenta de Viva Goals como administrador

  1. Después de habilitar la integración como administrador, debe configurar una conexión de GitLab desde la página Configuración de GitLab . Para acceder a esta página, vaya a Administración>Integraciones y seleccione Administrar junto a GitLab.

  2. Seleccione Nueva conexión e inicie sesión en su cuenta de GitLab.

  3. Escriba un nombre para la conexión.

  4. Es opcional compartir esta conexión con otros usuarios de la organización. Seleccione Siguiente para empezar a trabajar con esta integración. Puede editar la conexión guardada en cualquier momento.

  5. Viva Goals permite conectarse con varios proyectos. Seleccione Nueva conexión para capturar datos de otro proyecto. Estas conexiones se diferencian por nombre. Los nombres se mostrarán a otros usuarios cuando vinculen sus OKR con datos de GitLab.

Conexión de proyectos de GitLab a un OKR

Después de configurar la conexión, el siguiente paso es vincular OKR a los proyectos de GitLab.

  1. Al crear o editar un OKR, abra la lista desplegable Progreso y estado . En la sección con el texto "Conectarse a un origen de datos para actualizaciones de progreso automáticas", busque y seleccione el icono de GitLab.

  2. Si ya ha creado una conexión o si el administrador ha compartido una conexión con usted, esa conexión se seleccionará automáticamente. Viva Goals le pedirá que cree una nueva conexión solo si no hay conexiones ya creadas o compartidas.

  3. Seleccione el método que desea usar para usar el progreso de la medida: porcentaje completado o KPI (métrica de éxito). Si elige KPI, proporcione una métrica, un valor inicial y un valor de destino.

  4. Si hay varias conexiones, seleccione una. Todos los proyectos asociados estarán disponibles en la lista desplegable. Elija un proyecto y seleccione un hito.

  5. Elija una entrada en el campo Asignado a para realizar un seguimiento de los problemas que controla un usuario específico. Seleccione Etiquetas según corresponda.

  6. Seleccione un estado adecuado para realizar un seguimiento del estado de los problemas que están cerrados o abiertos. Esta opción solo se aplica a los OKR de tipo KPI.

  7. Puede buscar problemas directamente escribiendo el identificador de problema o el título del problema; como alternativa, puede seleccionarlos en la lista desplegable del campo Problemas . También puede seleccionar varios problemas y conectarlos al OKR.

Cálculo del progreso realizado en un OKR

Si usa una métrica de KPI para realizar un seguimiento del progreso, el progreso del OKR se calculará en función del recuento de problemas. Si usa el porcentaje completado para realizar un seguimiento del progreso, el porcentaje se calculará en función del número de problemas cerrados.

Si tiene subtareas agregadas en cada problema, el progreso se calculará también en función del estado de las subtareas. Por ejemplo, si ha conectado dos problemas que tienen dos subtareas cada una a su OKR, cuando cierre la subtarea 1 en el problema 1, el progreso se actualizará al 25 por ciento. Cuando cierre más adelante la subtarea 2 en el problema 1, el progreso de OKR será del 50 %.

Nota:

Si selecciona porcentaje completado para realizar el seguimiento del progreso, el progreso se calculará solo en función del porcentaje de problemas cerrados. Si también desea realizar un seguimiento de los problemas que están abiertos, debe seleccionar una métrica de KPI para realizar un seguimiento del progreso.

Los siguientes colores de la barra de progreso indican el estado del objetivo:

  • Si el progreso es entre un 0 y un 25 % menor que el progreso esperado en cualquier momento, el estado okr está detrás y la barra de progreso será naranja.

  • Si el progreso es más del 25 por ciento menor de lo esperado en cualquier momento, el estado okr está en riesgo y la barra de progreso será roja.

Deshabilitación de la integración de GitLab

Los administradores pueden deshabilitar la integración de GitLab en cualquier momento: vaya a GitLab en la sección Integraciones y seleccione Administrar. En la página Configuración de GitLab , seleccione Cambiar>Deshabilitar integración.

Nota:

Si un proyecto de Gitlab se cierra sin todas las subta tareas marcadas como completadas, Viva Goals tendrá en cuenta que el proyecto se ha completado porque se ha cerrado.