Запрос по области или пути итерации

  • Статья

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

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

Чтобы лучше понять, как работать с областями и путями итерации, см. сведения о командах и инструментах Agile.

Примечание.

Следующие макросы поддерживаются только на веб-портале: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity и @TeamAreas. Запросы, содержащие эти макросы, не будут работать при открытии в Visual Studio/Team Обозреватель, Microsoft Excel или Microsoft Project.

Поддерживаемые операторы и макросы

При создании запросов и указании полей пути области и пути итерации можно использовать следующие операторы:

Оператор Используйте, когда вы хотите...
= Укажите одну область или путь итерации
<> Отфильтруйте одну область, определенный путь или путь итерации.
In Фильтрация по набору путей области или итерации.
Not In Исключите элементы, назначенные набору путей области или итерации.
Under Укажите все пути в области выбора или пути итерации.
Not Under Исключите элементы, назначенные в определенной области или пути итерации.

Вместе с этими операторами можно использовать следующие макросы при выборе пути итерации. Примеры см. в разделе "Запрос по дате" или текущей итерации.

Макрос Используйте, когда вы хотите...
@CurrentIteration Укажите текущую итерацию, связанную с выбранным контекстом команды.
@CurrentIteration +/- n Фильтруйте элементы на основе назначения скользящему окну спринтов, связанных с выбранным контекстом команды.
@TeamAreas Фильтрация элементов на основе путей области, назначенных определенной команде.

Примечание.

@TeamAreas Макросы @CurrentIteration +/- n поддерживаются для Azure DevOps Server 2019 и более поздних версий. Эти макросы поддерживаются только на веб-портале. Запросы, содержащие эти макросы, не будут работать при открытии в Visual Studio/Team Обозреватель, Microsoft Excel или Microsoft Project.

Запросы пути к области

Можно указать фильтрацию рабочих элементов, назначенных нескольким путям области, с помощью оператора In , как показано в следующем примере.

Запрос по пути к области для нескольких областей

Имя узла и запросы на основе ключевое слово

Используйте поле "Имя узла" для фильтрации рабочих элементов, назначенных путям области на основе ключевое слово с помощью оператора Contains. Имя узла указывает последний узел пути области, соответствующий последнему узлу в иерархии дерева.

Следующий запрос дает тот же результат, что и предыдущий пример.

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

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

Запрос для нескольких спринтов

Ниже приведен еще один пример использования имени узла и оператора In.

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

Запросы пути к области группы

Используйте макрос @TeamAreas для быстрого поиска элементов, назначенных определенным командам. = Укажите оператор. Редактор запросов автоматически запрашивает указать имя команды. Его можно добавить, введя имя команды и выбрав значение команды, которое отображается в критерии фильтра поиска.

Запрос по путям области, назначенным команде

Справочник по полю классификации

Имя поля Description Имя ссылки
Путь к области Группы рабочих элементов в области продуктов или групп. Область должна быть допустимым узлом в иерархии проекта. System.AreaPath
Путь итерации Группирует рабочие элементы по именованным спринтам или периодам времени. Итерация должна быть допустимым узлом в иерархии проекта. System.IterationPath

Для каждого поля, путь к данным=TreePath, отчетируемый тип=Dimension, атрибут индекса=True.

Если вы определяете имя пути, которое больше 256 символов, его нельзя указать в Microsoft Project. Чтобы избежать этой проблемы, определите имена путей не более 10 символов и не вложены узлы более 14 уровней глубоко.

Не удается применить большинство правил полей к системным полям, таким как System.AreaPath и System.IterationPath. Дополнительные сведения см. в разделе "Правила" и "Оценка правил".

Следующие поля не отображаются в формах рабочих элементов, но отслеживаются для каждого типа рабочего элемента. Эти поля предоставляют числовое значение для каждого значения классификации, определенного для проекта. Эти поля можно использовать для фильтрации запросов и создания отчетов.

Имя поля Description Имя ссылки Тип данных
Идентификатор области Уникальный идентификатор области, которой назначается этот рабочий элемент. System.AreaId Целое
Идентификатор итерации Уникальный идентификатор итерации, к которой назначается этот рабочий элемент. System.IterationId Целое
Имя узла Имя последнего узла пути к области. Например, если путь к области — Project\A1\B2\C3, имя узла — C3. System.NodeName Строка

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

REST API

Сведения о программном взаимодействии с запросами см. в одном из следующих ресурсов REST API: