Интеграция Azure DevOps

Общие сведения об интеграции Azure DevOps

Viva Goals интегрируется с Microsoft Azure DevOps для автоматического обновления ключевых результатов и проектов в Viva Goals. Ключевой результат и ход выполнения проекта автоматически обновляется на основе подключенных рабочих элементов Azure DevOps. Вы можете использовать интеграцию Azure DevOps для

• Автоматически отслеживать ход выполнения для ключевого результата
• Автоматическое отслеживание хода выполнения ключевого показателя эффективности инициативы
• Автоматически отслеживайте ход выполнения и задачи для инициативы.
  • Этот подход обновляет ход выполнения инициативы, синхронизирует сведения о рабочем элементе Azure DevOps с Viva Goals "задачами", а при использовании с расширением Azure DevOps Viva Goals Azure DevOps Viva Goals сведения о выравнивании OKR отображаются непосредственно в связанных рабочих элементах Azure DevOps.

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

Результаты (OKR) и выходные данные (инициативы)

Одним из основных принципов OKR является различие между результатами и выходными данными. OKR и ключевые результаты сосредоточены на стимулировании воздействия (т. е. на результаты), а Viva Goals инициативы ориентированы на результаты — работу, которая планируется для достижения ключевых результатов. Обе метрики являются важными для отслеживания, но они измеряют разные вещи.

Хотя вы можете интегрировать Viva Goals ключевые результаты и инициативы с рабочими элементами Azure DevOps, важно понимать разницу. Azure DevOps в основном сосредоточена на отслеживании работы, поэтому чаще всего интегрировать Viva Goals инициативы с Azure DevOps. Есть некоторые примеры, в которых может быть целесообразно отслеживать ход выполнения ключевых результатов на основе рабочих элементов Azure DevOps.

Когда следует использовать интеграцию Azure DevOps

Существует три способа использования интеграции Azure DevOps с рабочими процессами Viva Goals. Ниже описаны подробные сведения о каждой из этих возможностей.

1. Отслеживайте ход выполнения инициативы с помощью задач: Помимо отслеживания хода выполнения инициативы на основе рабочих элементов Azure DevOps, этот подход обеспечивает межплатформенный пользовательский интерфейс. Сведения о рабочем элементе Azure DevOps синхронизируются с Viva Goals представлениями инициатив, а выравнивание работы Azure DevOps для Viva Goals OKR можно просматривать непосредственно в связанных рабочих элементах Azure DevOps с помощью расширения Azure DevOps (скоро).
2. Отслеживайте ход выполнения инициативы с помощью ключевых показателей эффективности: Такой подход позволяет отслеживать ход выполнения инициативы на основе состояния рабочих элементов Azure DevOps. Одно числовое значение синхронизируется с Viva Goals.
3. Отслеживайте ход выполнения для ключевого результата. Такой подход позволяет отслеживать ход выполнения kr на основе состояния рабочих элементов Azure DevOps. Одно числовое значение синхронизируется с Viva Goals.

Настройка интеграции Azure DevOps

Интеграция Azure DevOps должна быть включена администратором клиента и организации Viva Goals. Viva Goals администраторы должны сначала включить интеграцию Azure DevOps для своего клиента (включение интеграции в Viva Goals | Microsoft Learn). После включения на уровне клиента администратор Viva Goals организации должен включить его для своей организации (Viva Goals Обзор администрирования интеграции.)

Примечание.

После включения интеграции между Viva Goals и Azure DevOps может настроить любой пользователь в организации, имеющий разрешения на создание или изменение OKR и (или) инициативы.

Включение интеграции Azure DevOps с инициативами

Этот метод является рекомендуемым подходом для согласования работы в Azure DevOps с OKRsin Viva Goals. Помимо отслеживания хода выполнения инициативы на основе рабочих элементов Azure DevOps, этот подход обеспечивает межплатформенный пользовательский интерфейс. Сведения о рабочем элементе Azure DevOps синхронизируются с представлениями инициативы Viva Goals, а при использовании с расширением Azure DevOps Viva Goals согласование работы Azure DevOps Viva Goals OKR отображается непосредственно в связанных рабочих элементах Azure DevOps.

1. Выберите Добавить инициативу в Viva Goals или измените существующую инициативу.

2. Выберите Результат.

3. Выберите Добавить задачи.

4. Выберите Автоматически из источника данных.

5. Выберите Azure DevOps в списке доступных интеграций.

6. Выберите соответствующее подключение Azure DevOps. Если вам нужно создать новое подключение Azure DevOps, необходимо войти в Azure DevOps, чтобы создать подключение к данным. Для каждого проекта Azure DevOps требуется новое подключение. После входа:

   • Укажите имя подключения. Рекомендуется включить Azure DevOps Organization и Project в имя для дальнейшего использования.
   • Выберите организацию Azure DevOps.
   • Выбор проекта Azure DevOps
   • Нажмите Далее.

7. Выберите метод подключения:

   • Общий запрос: позволяет подключиться к существующему запросу, сохраненном в Azure DevOps.
   • Рабочие элементы: позволяет подключаться к одному или нескольким рабочим элементам определенного типа. Такой подход позволяет подключаться непосредственно к "родительским" рабочим элементам, содержащим вспомогательные работы; дочерние рабочие элементы включаются автоматически.

При использовании метода connect to 'Shared Query':

1. Выберите общий метод запроса .
2. Найдите и выберите общий запрос, содержащий рабочие элементы Azure DevOps.
3. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения инициативы. Вы можете выбрать любой тип рабочего элемента в запросе или все рабочие элементы в общем запросе.
4. Выберите поле Azure DevOps, которое вы хотите использовать для отслеживания хода выполнения инициативы. Viva Goals ход выполнения инициативы вычисляется как процент завершения выбранного типа рабочего элемента.
5. Выберите Далее.
6. Нажмите Сохранить.

Теперь рядом с вашей инициативой должен появиться значок Azure DevOps. Сведения о рабочем элементе Azure DevOps также должны отображаться в представлениях инициативы Viva Goals. Viva Goals теперь автоматически синхронизирует сведения о рабочем элементе и обновляет ход выполнения инициативы один раз в час на основе поля ADO для типов рабочих элементов, выбранных в общем запросе.

При использовании метода Подключиться к рабочим элементам:

1. Выберите метод рабочих элементов .
2. Выберите тип рабочего элемента для подключения. Рекомендуется выбрать тип "родительский" рабочий элемент в иерархии Azure DevOps, содержащей выполняемую работу. Интеграция автоматически включает дочерние рабочие элементы. Например, подключитесь к компоненту, который является родительским для задач, а не к каждой отдельной задаче.
3. Найдите и выберите конкретные рабочие элементы выбранного типа.
4. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения инициативы. Вы можете измерять ход выполнения по определенному типу рабочего элемента (т. е. типу, к которому вы подключаетесь напрямую, или по любому из его дочерних типов) или по всем рабочим элементам (т. е. подключенным и дочерним).
5. Выберите поле ADO, которое вы хотите использовать для отслеживания хода выполнения инициативы.
6. Нажмите кнопку Далее.
7. Выберите Сохранить.

Теперь рядом с вашей инициативой должен появиться значок Azure DevOps. Сведения о рабочем элементе Azure DevOps также должны отображаться в представлениях инициативы Viva Goals. Viva Goals теперь автоматически синхронизирует сведения о рабочем элементе и обновляет ход выполнения этой инициативы один раз в час на основе поля Azure DevOps для выбранных типов рабочих элементов.

После выполнения описанных выше шагов не только будет регулярно обновляться ход выполнения инициативы Viva Goals, но и будут включены следующие возможности:

• Сведения о рабочем элементе Azure DevOps отображаются в представлениях инициативы Viva Goals, а также гиперссылки на сведения о рабочем элементе Azure DevOps.
• Если вы включили расширение Viva Goals Azure DevOps, полное выравнивание между OKR и рабочими элементами Azure DevOps доступно на вкладке Viva Goals в связанных рабочих элементах Azure DevOps.

Использование интеграции Azure DevOps с ключевыми показателем эффективности инициативы

Используйте этот метод, если требуется обновить Viva Goals выполнения инициативы одним числовым значением. Этот подход не будет отображать рабочие элементы Azure DevOps в представлениях Viva Goals инициатив. Кроме того, этот метод не может внедрять Viva Goals в рабочие элементы Azure DevOps.

1. Выберите Добавить инициативу в Viva Goals или измените существующую инициативу.

2. Выберите Результат.

3. Выберите Добавить метрику и укажите необходимые сведения (например, имя, тип, единицы измерения, начальные значения, целевые значения).

   • Для метрик, основанных на процентах, ход выполнения инициативы вычисляется на основе процента выбранного значения поля ADO для завершенных рабочих элементов и общего числа рабочих элементов.
   • Для метрик, не основанных на процентах (числовые, денежные), ход выполнения инициативы — это количество выбранных значений поля ADO для завершенных или, при необходимости, общих рабочих элементов.

4. Выберите Ход выполнения.

5. Выберите Автоматически из источника данных.

6. Выберите Azure DevOps в списке доступных интеграций.

7. Выберите соответствующее подключение Azure DevOps. Если вам нужно создать новое подключение Azure DevOps, необходимо войти в Azure DevOps, чтобы создать подключение к данным. Для каждого проекта Azure DevOps требуется новое подключение. После входа:

   • Укажите имя подключения. Рекомендуется включить организацию Azure DevOps и инициативы в имя для удобного использования в будущем.
   • Выберите организацию Azure DevOps.
   • Выбор проекта Azure DevOps
   • Нажмите Далее.

8. Выберите метод подключения:

   • Общий запрос: позволяет подключиться к существующему запросу, хранящемуся в Azure DevOps.
   • Рабочие элементы: позволяет подключаться к одному или нескольким рабочим элементам определенного типа. Такой подход позволяет подключаться непосредственно к "родительским" рабочим элементам, содержащим вспомогательные работы; автоматически учитываются дочерние рабочие элементы.

При использовании метода connect to 'Shared Query':

1. Выберите общий метод запроса .
2. Найдите и выберите общий запрос, содержащий рабочие элементы Azure DevOps.
3. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения инициативы. Вы можете выбрать любой тип рабочего элемента в запросе или все рабочие элементы в запросе.
4. Выберите поле Azure DevOps, которое вы хотите использовать для отслеживания хода выполнения инициативы.
5. Выберите Далее.
6. Нажмите Сохранить.

Теперь рядом с вашей инициативой должен появиться значок Azure DevOps. Viva Goals теперь автоматически обновляет ход выполнения один раз в час.

При использовании метода Подключиться к рабочим элементам:

1. Выберите метод рабочих элементов .
2. Выберите тип рабочего элемента, к которому нужно подключиться. Рекомендуется выбрать тип "родительский" рабочий элемент в иерархии Azure DevOps, содержащей выполняемую работу. Интеграция автоматически включает дочерние рабочие элементы. Например, подключитесь к компоненту, который является родительским для задач, а не к каждой отдельной задаче.
3. Найдите и выберите конкретные рабочие элементы выбранного типа.
4. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения инициативы. Вы можете измерять ход выполнения по определенному типу рабочего элемента (т. е. типу, к которому вы подключаетесь напрямую, или по любому из его дочерних типов) или по всем рабочим элементам (т. е. подключенным и дочерним).
5. Выберите поле ADO, которое вы хотите использовать для отслеживания хода выполнения инициативы.
6. Нажмите кнопку Далее.
7. Выберите Сохранить.

Теперь рядом с вашей инициативой должен появиться значок Azure DevOps. Viva Goals теперь автоматически обновляет эту инициативу один раз в час.

Использование интеграции Azure DevOps с ключевым результатом

Используйте этот метод, если требуется обновить ход выполнения Viva Goals ключевого результата одним числовым значением. Этот подход не будет отображать рабочие элементы Azure DevOps в Viva Goals. Кроме того, этот метод не может внедрять Viva Goals в рабочие элементы Azure DevOps.

1. Выберите Добавить результат ключа в Viva Goals или измените существующий результат ключа.

2. Выберите Добавить метрику и укажите необходимые сведения (например, имя, тип, единицы измерения, начальные значения, целевые значения).

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

3. Выберите Ход выполнения.

4. Выберите Автоматически из источника данных.

5. Выберите Azure DevOps в списке доступных интеграций.

6. Выберите соответствующее подключение Azure DevOps. Если вам нужно создать новое подключение Azure DevOps, необходимо войти в Azure DevOps, чтобы создать подключение к данным. Для каждого проекта Azure DevOps требуется новое подключение. После входа:

   • Укажите имя подключения: рекомендуется включить организацию Azure DevOps и инициативу в имя для удобного использования в будущем.
   • Выберите Организацию Azure DevOps.
   • Выберите проект Azure DevOps.
   • Выберите Далее.

7. Выберите метод подключения:

   • Общий запрос: позволяет подключиться к существующему запросу, хранящемуся в Azure DevOps.
   • Рабочие элементы: позволяет подключаться к одному или нескольким рабочим элементам определенного типа. Такой подход позволяет подключаться непосредственно к "родительским" рабочим элементам, содержащим вспомогательные работы; автоматически учитываются дочерние рабочие элементы.

При использовании метода connect to 'Shared Query':

1. Выберите общий метод запроса .
2. Найдите и выберите общий запрос, содержащий рабочие элементы Azure DevOps.
3. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения ключевого результата. Вы можете выбрать любой тип рабочего элемента в запросе или все рабочие элементы в общем запросе.
4. Выберите поле ADO, которое нужно использовать для отслеживания хода выполнения ключевых результатов.
5. Выберите Далее.
6. Нажмите Сохранить.

Теперь вы увидите значок Azure DevOps рядом с ключевым результатом. Viva Goals теперь автоматически обновляет ход выполнения один раз в час.

При использовании метода Подключиться к рабочим элементам:

1. Выберите метод рабочих элементов .
2. Выберите тип рабочего элемента, к которому нужно подключиться. Рекомендуется выбрать тип "родительский" рабочий элемент в иерархии Azure DevOps, содержащей выполняемую работу. Интеграция автоматически включает дочерние рабочие элементы. Например, подключитесь к компоненту, который является родительским для задач, а не к каждой отдельной задаче.
3. Найдите и выберите конкретные рабочие элементы выбранного типа.
4. Выберите тип рабочего элемента, который вы хотите использовать для вычисления хода выполнения ключевого результата. Вы можете измерять ход выполнения по определенному типу рабочего элемента (т. е. типу, к которому вы подключаетесь напрямую, или по любому из его дочерних типов) или по всем рабочим элементам (т. е. подключенным и дочерним).
5. Выберите поле ADO, которое нужно использовать для отслеживания хода выполнения ключевых результатов.
6. Нажмите кнопку Далее.
7. Выберите Сохранить.

Теперь вы увидите значок Azure DevOps рядом с ключевым результатом. Viva Goals теперь автоматически обновляет эту инициативу один раз в час на основе поля ADO для выбранных типов рабочих элементов.

Вычисление хода выполнения для полей ADO в Viva Goals:

Отслеживание хода выполнения по	Процентная метрика	Числовая метрика
Количество рабочих элементов	Процент завершенных рабочих элементов от общего числа рабочих элементов для заданного запроса или типа рабочего элемента.	Количество рабочих элементов для заданного запроса или типа рабочего элемента.
Сюжетные точки	Процент точек истории для завершенных рабочих элементов из общего числа точек истории для рабочих элементов для заданного запроса или типа рабочего элемента.	Сумма точек истории для рабочих элементов для заданного запроса или типа рабочего элемента.
Усилие	Процент усилий для завершенных рабочих элементов выходит за общий объем трудозатрат для рабочих элементов для заданного запроса или типа рабочего элемента.	Сумма усилий для рабочих элементов для заданного запроса или типа рабочего элемента.
Исходная оценка	Процент от общей первоначальной оценки часов для завершенных рабочих элементов из общего исходного времени оценки для всех рабочих элементов для заданного запроса или типа рабочего элемента.	Сумма исходных оценочных часов для рабочих элементов для заданного запроса или типа рабочего элемента.
Оставшиеся трудоемкие работы	Н/Д	Общее количество оставшихся рабочих часов для рабочих элементов для заданного запроса или типа рабочего элемента.
Завершенные работы	Процент от общего количества завершенных рабочих часов для завершенных рабочих элементов из общего количества завершенных рабочих часов для всех рабочих элементов для заданного запроса или типа рабочего элемента.	Общее количество завершенных рабочих часов для рабочих элементов для заданного запроса или типа рабочего элемента.
Настраиваемые поля	Процент завершения связанного числового настраиваемого поля в ADO для заданного типа запроса или рабочего элемента.	Общая сумма связанного числового настраиваемого поля в ADO для заданного типа запроса или рабочего элемента.

Устранение неполадок с подключением

Чтобы интегрироваться с Azure DevOps, служба Viva Goals должна иметь доступ к рабочим элементам в организации Azure DevOps и инициативе, которую вы настраиваете при создании подключения в Viva Goals. В зависимости от того, как ваша организация управляет своими политиками условного доступа Microsoft Entra и разрешениями Azure DevOps, Viva Goals могут не получить доступ к информации.

Запрещенные ошибки

Если при создании подключения Azure DevOps возникают запрещенные сообщения об ошибках, скорее всего, ограничения IP-адресов или другие политики условного доступа будут blame. В этом случае необходимо проверить, включена ли политика проверки Microsoft Entra ID CAP в организации Azure DevOps. Дополнительные сведения см. в документации по Azure DevOps.

Решения

У вас есть два варианта: можно отключить политику включения проверки Microsoft Entra ID CAP в организации Azure DevOps. Для этого потребуется и администратор Azure DevOps, или необходимо добавить исходящие IP-адреса службы Viva Goals в политики условного доступа для клиентов Microsoft Entra ID.

Вопросы и ответы (часто задаваемые вопросы)

1. Почему при подключении задач инициативы Viva Goals с помощью Azure DevOps не отображаются все рабочие элементы в общем запросе и (или) все дочерние рабочие элементы при использовании метода "подключиться к рабочему элементу"?
   1. Независимо от того, подключается ли ваша инициатива Viva Goals к Azure DevOps, Viva Goals предоставляет не все рабочие элементы. Отображение Viva Goals зависит от того, как вы решите вычислить общий ход выполнения Viva Goals инициативы во время процесса установки. Если вы решили вычислять ход выполнения инициативы по любому рабочему элементу, Viva Goals действительно будет предоставлять все общие рабочие элементы запроса или все дочерние элементы, если вы подключены непосредственно к рабочим элементам.
      
      Однако мы считаем, что выбор типа "любой" рабочего элемента является исключением, так как этот подход будет предоставлять чрезмерное количество сведений о рабочем элементе, не обязательное в Viva Goals пользовательского интерфейса. Предполагается, что большинство пользователей предпочитают вычислять ход выполнения по определенному типу рабочего элемента в общем запросе или дочернем элементе подключенных рабочих элементов. Viva Goals будет использовать это решение, чтобы ограничить то, что мы предоставляем в пользовательском интерфейсе Viva Goals.
      
      Например, предположим, что вы работаете в Azure DevOps, отслеживая функции, истории пользователей и задачи. Далее предположим, что вы решили отслеживать Viva Goals ход выполнения инициативы на основе завершения пользовательской истории. Viva Goals будут отображаться только функции и пользовательские истории в представлениях инициативы Viva Goals. Пользователи могут быстро "дважды щелкнуть" Azure DevOps для получения дополнительных сведений по мере необходимости.