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

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

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

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

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

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

Совет

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

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

• > Доски всех инструментов
• Невыполненные> работы всех средств
• Спринты> всех инструментов
• Планы доставки
• Свертка
• Все аналитики>

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

Необходимые компоненты

Разрешения:

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

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

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

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

Каждая команда имеет доступ к различным инструментам 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 Fibre. Другие параметры формата выходных данных см. в разделе "Форматы выходных данных" для команд 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. Если необходимо переключить контекст команды, используйте селектор команды в области навигации.

   

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

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

Примечание.

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

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

Внимание

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

Браузер

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

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

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

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

   

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.

Пример

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

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.
• дочерний идентификатор: необязательно. Перемещает существующий путь к области и добавляет его в качестве дочернего узла для указанного имени или идентификатора пути.
• имя: необязательно. Задает новое имя пути области.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fiber".

Пример

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

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) для упорядочивания классификаций рабочих элементов.