Определение путей к областям и назначение их команде

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

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

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

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

• Запрос и диаграмма рабочих элементов на основе пути области
• Назначение работы нескольким командам
• Работа с командами управления и функциями
• Фильтрация невыполненной работы, запроса, доски или плана с помощью путей к области

Совет

Вы можете определить структуру путей областей и назначать пути областей командам. Кроме того, вы можете добавить команду и создать путь к области с именем команды в этот момент. Если команды полностью независимы, создайте плоский набор путей области. Однако, если вы хотите создать иерархию команд, вам нужно создать иерархическое дерево путей областей. Дополнительные сведения см. в разделе "Настройка иерархии команд".

Чтобы использовать следующие средства, команды должны подписаться на пути к областям:

• Доски для всех инструментов>
• Задержки> всех инструментов
• Все инструменты спринта>
• Планы доставки
• Свертка
• Все аналитические данные>

Сведения о том, как система использует пути к областям, см. в разделе "О путях областей и итерации".

Предварительные условия

Категория

Требования

разрешения

— Чтобы задать путь к области группы или итерации: администратор команды или член группы администраторов проектов. По умолчанию пользователь, создавший проект, имеет эти разрешения. — Чтобы добавить путь к области под корневым узлом или изменить либо удалить любой дочерний узел, вы должны быть членом группы администраторов проектов . — Чтобы добавить, изменить и управлять путями к областям в узле: одно или несколько из следующих разрешений должны быть установлены на Разрешить: - Создание дочерних узлов - Удаление этого узла - Изменить этот узел - просмотр разрешений на этом узле

Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".

Ограничения наименования для путей областей см. в разделе «Сведения об областях и итерациях», «Ограничения имен».

Начало работы

Каждая команда имеет доступ к различным инструментам Agile, как описано в разделе "О командах" и средствах Agile. Эти инструменты ссылаются на пути областей команды по умолчанию. Большинство команд используют один путь к области и несколько путей итерации для отслеживания работы, но команды также могут использовать несколько путей к областям в своих невыполненных задачах и на досках для поддержки различных сценариев.

Новые проекты включают одну корневую область, соответствующую имени проекта и команде по умолчанию с тем же именем, назначенным этому корневому пути.

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

1. Определение путей областей: Определите количество и названия путей областей, необходимых для классификации вашей работы. Добавьте как минимум одну область для каждой команды. Дополнительные сведения см. в разделе "О областях и итерациях".
2. Определите команды: определите количество и имена необходимых команд. Дополнительные сведения см. в разделе "О командах и средствах Agile".
3. Настройка путей к областям: перейдите в Параметры проекта>Конфигурация проекта>Области и определите пути к областям для вашего проекта. Выполните действия, описанные в разделе «Добавление путей к области».
4. Создание команд: создание необходимых команд на основе шага 2. Дополнительные сведения см. в разделе "Добавление команды", переход из одной команды по умолчанию в несколько команд.
5. Назначьте области командам: в настройках команды назначьте пути областей по умолчанию и прочие пути для каждой команды. Выполните действия, описанные в разделе "Настройка путей по умолчанию для группы".
6. Назначьте рабочим элементам пути к областям: назначьте рабочие элементы определенным областям с помощью массового изменения для одновременного обновления нескольких элементов.

Примечание.

Назначение одного пути к области нескольким командам может привести к конфликтам при владении рабочими элементами. Дополнительные сведения см. в разделе Ограничения представлений доски для нескольких команд.

По мере необходимости можно выполнять следующие действия в любое время:

• Добавьте другие дочерние узлы
• Переименуйте область (кроме корневого пути)
• Перемещение дочернего узла под другим узлом
• Удалить дочерний узел
• Переименование команды
• Измените назначения путей области, сделанные команде

Перечисление областей проекта

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

Браузер

На веб-портале выберите (1) Настройки проекта> (2) Конфигурация проекта> (3) Области.

CLI Azure DevOps

Вывод списка путей проектных областей | Добавить путь к области проекта | Вывод списка путей областей команды | Установить пути областей команды | Переименовать или переместить путь к области проекта | Удалить путь области из команды

Вы можете перечислить пути области, определенные для проекта, с помощью az boards area project list. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

az boards area project list [--depth]
                            [--path]
                            [--project]

Параметры

• глубина: необязательно. Глубина дочерних узлов для перечисления. Пример: --depth 3. Если это не указано, возвращаются только пути к области верхнего уровня.
• путь: необязательный. Абсолютный путь области. \Area\ должен следовать после \ProjectName, который отличает этот путь от пути итерации. Например, --path \ProjectName\Area\AreaName. Если в имени узла используются пробелы, то заключите его в двойные кавычки, например, --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Если не указано, показывает пути областей, начиная с корневого уровня.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Пример

Например, следующая команда перечисляет пути областей до глубины 3 для проекта Fabrikam Fiber. Другие параметры формата выходных данных см. в разделе "Форматы выходных данных" для команд Azure CLI.

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Добавить путь области

По умолчанию определяется только одна корневая область. Добавьте новые и дочерние пути в корневой области проекта или в качестве дочернего пути к другому пути или команде. Новые пути к области добавляются в корневой узел по умолчанию.

Вы также можете добавить новые и дочерние пути областей в команду. Дополнительные сведения см. в разделе "Настройка путей к области команды".

Браузер

Чтобы добавить новую область пути, выполните следующие шаги:

1. Выделите путь к области и выберите Новый дочерний элемент. При необходимости можно выбрать путь к области и нажать Новый, или выбрать пункт меню Новый в верхней части списка областей.

2. Введите имя (255 символов или меньше) для узла. Дополнительные ограничения имен см. в разделе «Сведения об областях и итерациях», «Ограничения именования».

   

3. Выберите Сохранить и закрыть.

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

Чтобы добавить путь к дочерней области, сделайте следующее:

1. Выделите путь к области и выберите новый дочерний элемент. При необходимости можно выбрать путь к области и выбрать новый дочерний элемент или новый дочерний элемент в меню в верхней части списка областей.

2. Введите имя (255 символов или меньше) для узла. Для дополнительных ограничений имен см. раздел "Сведения о областях и итерациях", ограничения именования.

   

3. Выберите Сохранить и закрыть.

Вы также можете добавить пути областей к команде на странице Настройка команды>Области.

CLI Azure DevOps

В проект можно добавить пути области с помощью az boards area project create. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

Если указать параметр --path, новый путь к области добавляется как дочерний узел к указанному пути. Если параметр --path не указан, новый путь к области добавляется как дочерний узел корневого узла.

az boards area project create --name
                              [--path]
                              [--project]

Параметры

• name: обязательное поле. Название области пути.
• путь: необязательный. Абсолютный путь области. Пример: --path \ProjectName\Area\AreaName. Если не указано, добавляет область на корневом уровне.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Пример: формат JSON

Например, следующая команда добавляет путь к области голосовой связи в проект Fabrikam Fibre на корневом узле.

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

Пример: формат таблицы

И вот та же команда с форматом выходных данных таблицы.

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Список путей области команды

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

Браузер

1. Откройте проект, а затем выберите Настройки проекта>Конфигурация команды>Области.

   

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

   

CLI Azure DevOps

Вы можете перечислить областные пути, определенные для команды, с помощью az boards area team list. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

az boards area team list --team
                         [--project] 

Параметры

• команда: обязательно. Имя или идентификатор команды.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Например, следующая команда перечисляет областные пути для команды по предоставлению услуг. Сведения о других параметрах формата выходных данных см. в разделе "Выходные форматы" для команд Azure CLI

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Открытие параметров команды из профиля группы

Вы определяете области и итерации в Конфигурация команды в параметрах проекта. Вы можете быстро перейти к нему от журнала отслеживания командных задач, доски или панели мониторинга.

1. Откройте невыполненную работу или доску для команды и выберите Профиль команды>Параметры команды.

   Здесь мы открываем совет для команды Fabrikam Fibre и оттуда профиль команды.

   

2. Выберите итерации и области.

   

3. Если необходимо переключить контекст команды, используйте селектор команды в хлебных крошках.

   

Настройка путей к областям для команды

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

Примечание.

Команде можно назначить не более 300 путей областей. Дополнительные сведения см. в разделе Ограничения для отслеживания хода выполнения работы, процесса и проекта.

Путь к области по умолчанию определяет путь области по умолчанию, назначенный рабочим элементам, созданным из контекста команды.

Внимание

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

Браузер

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

1. Выберите параметры проекта>конфигурация команды>области.

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

   Здесь мы показываем зоны для команды Fabrikam Fiber.

   

3. Выберите один или несколько путей к области, которые будут активными для команды.

   

   В этом случае мы активируем пути подобластей для проекта. Теперь руководство может отслеживать прогресс всех команд.

   

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

   

   

CLI Azure DevOps

Вы можете задать путь области по умолчанию для команды или добавить путь области, используя az boards area team add. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

Параметры

• путь: обязательный. Абсолютный путь области. Пример: --path \ProjectName\AreaName.
• команда: обязательный параметр. Имя или идентификатор команды.
• include-sub-areas: Необязательный. Включите дочерние узлы пути области. Принятые значения: false, true.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".
• set-as-default: необязательный. Укажите как путь области по умолчанию для команды. Значение по умолчанию: False.

Пример

Например, следующая команда добавляет путь к области "Voice" в команду "Voice" для проекта Fabrikam Fiber, делает его значением по умолчанию и включает подобласти.

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

Переименование или перемещение пути области

Система автоматически обновляет рабочие элементы и запросы, которые ссылаются на обновлённый участок области. Каждый путь к области связан с уникальным ИДЕНТИФИКАТОРом GUID.

Браузер

1. Чтобы переименовать Путь области, откройте страницу настройки проектаконфигурация проектаОбласти в веб-портале.

2. Выберите контекстное меню узла и нажмите кнопку "Изменить".

   

3. В открывшемся диалоговом окне введите новое имя.

   

4. Чтобы переместить узел в иерархии, измените поле "Расположение ".

   Примечание.

   При переименовании или изменении поля "Расположение " для узла система автоматически обновляет существующие рабочие элементы, ссылающиеся на путь к области.

CLI Azure DevOps

Переименовать или переместить область пути в проекте

Можно с помощью команды az boards area project update переименовать или переместить путь области проекта. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

• путь: обязательный. Абсолютный путь области. Пример: --path \ProjectName\AreaName.
• child-id: необязательно. Перемещает существующий путь области и добавляет его в качестве дочернего узла для указанного имени пути или идентификатора.
• имя: необязательно. Задает новое имя пути области.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Пример

Например, следующая команда переименовывает путь к области Voice в Voice и Web для проекта Fabrikam Fiber.

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

Удалить путь области из команды

Чтобы удалить путь к области из команды, используйте az boards area team remove.

az boards area team remove --path
                           --team
                           [--project]

Параметры

• путь: обязательный. Абсолютный путь области. Пример: --path \ProjectName\AreaName.
• команда: обязательная. Имя или идентификатор команды.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Пример

Например, следующая команда удаляет путь \Service Delivery\Voice из группы голосовой связи проекта Fabrikam Fibre.

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Удаление пути к области

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

Внимание

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

1. Чтобы удалить Область, откройте веб-портал, страницу Настройки проекта>Конфигурация проекта>Области.

2. Выберите контекстное меню узла и нажмите кнопку "Удалить " или "Удалить".

3. В открывшемся диалоговом окне выберите Путь к области, чтобы переназначить рабочие элементы, а затем выберите Удалить путь.

   

Отслеживание прогресса по областям

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

Следующие шаги

Установка путей итерации или спринтов

Связанные статьи

Как видно, пути к областям играют важную роль в поддержке инструментов Agile, команд и управления рабочими элементами. Дополнительные сведения о работе с этими полями см. в следующих статьях:

• Сведения о областях и итерациях
• Добавление другой команды
• Настройка параметров команды и добавление администраторов команды
• Использование гибких средств, использующих области или итерации
• Запрос по области или пути итерации
• Настройка разрешений и доступа для отслеживания работы

Программные ресурсы

Пути к областям и пути итерации также называются узлами классификации.

• Используйте область az boards (Azure DevOps CLI).
• Используйте Teams (REST API) для управления конфигурациями команд.
• Используйте узлы классификации (REST API) для упорядочивания классификаций рабочих элементов.