Интеграция с GitLab

Сведения об интеграции с GitLab

Viva Goals интеграция с GitLab позволяет автоматически обновлять ход выполнения задач и ключевых результатов (OKR) в зависимости от хода возникновения проблем в проектах GitLab.

Рассмотрим следующий пример: вы используете GitLab для отслеживания проектов. У вас есть цель в Viva Goals решать 30 вопросов каждый квартал. При связывании этой цели с соответствующим проектом в GitLab состояние OKR будет обновлено по мере устранения проблем в связанном проекте. Вы также можете отслеживать ход выполнения проблем, которые обрабатываются конкретным пользователем для целей, ориентированных на пользователя. Viva Goals автоматически синхронизирует значения и начертает ход достижения цели, экономя время и сохраняя okr в актуальном состоянии.

Эту функцию могут использовать все пользователи и администраторы. Администраторы могут управлять интеграцией с панели мониторинга администратора.

Включение интеграции с GitLab

Администраторы могут выполнить следующие действия, чтобы включить эту интеграцию:

  1. На боковой панели перейдите в раздел Администратор и выберите вкладку Интеграции.

    Снимок экрана: страница интеграции в Viva Goals.

  2. Для GitLab у вас будет возможность включить интеграцию. Если вы уже создали подключение, у вас будет возможность управлять интеграцией.

    Снимок экрана: параметр включения для GitLab в Viva Goals.

    Вы также можете отключить интеграцию в том же разделе: Перейдите к разделу Изменить и выберите Отключить интеграцию в раскрывающемся списке.

    Снимок экрана: выбор параметра Отключить интеграцию для GitLab в Viva Goals.

Для администраторов: подключение GitLab к учетной записи Viva Goals

  1. После включения интеграции в качестве администратора необходимо настроить подключение GitLab на странице конфигурации GitLab .

  2. Выберите Создать подключение и войдите в учетную запись GitLab.

    Снимок экрана: добавление нового подключения GitLab в Viva Goals.

  3. Введите имя подключения.

    Снимок экрана: имя нового подключения GitLab в разделе Viva цели.

  4. Предоставлять другим пользователям в организации общий доступ к этому подключению необязательно. Нажмите Далее, чтобы приступить к работе с этой интеграцией. Сохраненное подключение можно изменить в любое время.

  5. Viva Goals позволяет подключаться к нескольким проектам. Выберите Создать подключение , чтобы получить данные из другого проекта. Эти подключения различаются по имени. Имена будут отображаться другим пользователям при связывании okr с данными GitLab.

Использование интеграции GitLab и подключение проектов GitLab к OKR

После настройки подключения следующий шаг — связывание OKR с проектами GitLab.

  1. При создании или изменении OKR выберите Автоматически из источника данных. В раскрывающемся меню выберите GitLab.

    Снимок экрана: выбор GitLab в качестве источника данных.

  2. Если вы уже создали подключение или администратор предоставил вам общий доступ к подключению, оно будет выбрано автоматически. Viva Goals предложит создать новое подключение, только если нет уже созданных или общих подключений.

  3. Выберите метод, который вы хотите использовать для измерения хода выполнения, процента завершения или ключевого показателя эффективности (метрики успеха). При выборе ключевого показателя эффективности укажите метрику, начальное и целевое значение.

  4. Выберите подключение, если имеется несколько подключений. Все связанные проекты будут доступны в раскрывающемся списке. Выберите проект и выберите веху.

    Снимок экрана: добавление сведений о подключении GitLab.

  5. Выберите назначенного , чтобы отслеживать проблемы, которые обрабатываются определенным пользователем. Выберите настраиваемые метки .

  6. Выберите соответствующее состояние, чтобы отслеживать состояние закрытых или открытых проблем. Этот параметр применим только к okr типа ключевого показателя эффективности.

  7. Вы также можете напрямую искать проблемы, введя идентификатор или название проблемы или выбрав их в раскрывающемся списке в поле Проблемы . Вы также можете выбрать несколько проблем и подключить их к OKR.

Как вычислить ход выполнения интеграции с GitLab

Ход выполнения OKR будет вычисляться на основе количества проблем, если вы выбрали метрику ключевого показателя эффективности для отслеживания хода выполнения. Если вы выбрали процент завершения для отслеживания хода выполнения, процент будет вычисляться на основе количества закрытых проблем.

Если для каждой проблемы добавлены подзадачи, ход выполнения также будет вычисляться на основе состояния подзадач. Например, если вы подключили к OKR две проблемы, каждая из которых имеет по две подзадачи, при закрытии подзадачи 1 в выпуске 1 ход выполнения будет обновлен до 25 процентов. При закрытии подзадачей 2 в выпуске 1 ход выполнения OKR составит 50 %.

Примечание.

Если выбрать процент завершения для отслеживания хода выполнения, ход выполнения будет вычисляться только на основе процента закрытых проблем. Если вы также хотите отслеживать открытые проблемы, необходимо выбрать метрику ключевого показателя эффективности для отслеживания хода выполнения.

Определенные цвета индикатора выполнения обозначают степень достижения цели.

  • Если ход выполнения на 0–25 процентов меньше ожидаемого прогресса в любой момент времени, состояние OKR отстает, а индикатор выполнения будет оранжевым.

  • Если в любой момент ход выполнения более чем на 25 процентов меньше, чем ожидалось, состояние OKR находится под угрозой, а индикатор выполнения будет красным.

Отключение интеграции с GitLab

Администраторы могут отключить интеграцию GitLab в любое время. Перейдите к GitLab в разделе Интеграции и выберите Управление. На странице Конфигурации GitLab перейдите в раскрывающийся список Изменение , выберите Отключить и подтвердите.

Примечание.

Если проект в Gitlab закрыт без пометки всех вложенных задач, помеченных как завершенные, Viva Goals будет считать проект завершенным после закрытия.