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

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

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

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

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

Совет

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

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

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

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

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

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

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

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

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

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

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

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

Начать

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

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

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

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

Примечание.

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

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

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

Внимание

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

Открытие Параметры project, перечисление областей проекта

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

Браузер

• На веб-портале выберите (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 Fibre\Area\Service Delivery\Performance". Если это не указано, список путей к областям из корневого уровня.
• проект: необязательный. Имя или идентификатор проекта. Пример: --project "Fabrikam Fibre".

Пример

Например, следующая команда содержит пути к области глубине 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

Добавление пути к области

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

Браузер

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

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

  

CLI Azure DevOps

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

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

Параметры

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

Пример: формат 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 Fibre".

Например, следующая команда содержит пути к областям для команды доставки служб. Сведения о других параметрах формата выходных данных см. в разделе "Выходные форматы" для команд 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

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

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

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

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

   

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

   

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

   

Настройка путей к области группы

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

Примечание.

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

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

Внимание

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

Браузер

1. Открытые области для контекста команды.

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

   

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

   

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

   

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

   

   

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 Fibre".
• 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 Fibre".

Пример

Например, следующая команда переименовывает путь к области голосовой связи в 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 Fibre".

Пример

Например, следующая команда удаляет путь \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)