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

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

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

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

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

Совет

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

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

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

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

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

• Если у вас еще нет проекта, создайте его.

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

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

  • Создание дочерних узлов
  • Удаление этого узла
  • Изменение этого узла
  • Просмотр разрешений на этом узле

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

• Убедитесь, что вы добавляете в группу администраторов проектов или являетесь членом группы "Администраторы проектов", чтобы задать пути к области группы.

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

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

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

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

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

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

Примечание.

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

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

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

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

Внимание

Выберите версию этой статьи, соответствующую вашей платформе и версии. Селектор версий находится над оглавлением. Просмотрите платформу и версию Azure DevOps.

Определите обе области и итерации для проекта из конфигурации проекта "Параметры>>проекта".

Браузер

• На веб-портале выберите (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 area (Azure DevOps CLI)
• Teams (REST API)
• Узлы классификации (REST API)