Запрос по области или пути итерации
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Путь области и путь итерации — это два поля, которые отображаются в форме управления работой для всех типов элементов работы. Вы определяете их для проекта — пути области и пути итерации — а затем выбираете те, которые вы хотите связать с командой.
Чтобы лучше понять, как работать с областями и путями итерации, см. статью О командах и средствах Agile.
Необходимые условия
Заметка
Пользователи с доступом уровня Участника к общедоступному проекту имеют полный доступ к функциям запросов, так же, как и пользователи с доступом уровня Базовый. Для получения дополнительной информации см. краткий справочник по доступу для заинтересованных сторон.
| Категория | Требования |
|---|---|
| Уровни доступа | — Для просмотра и выполнения общих запросов: члену проекта . — Чтобы добавить и сохранить общий запрос: по крайней мере базовый доступ. |
| Разрешения | разрешение участие в разрешить папке, в которую требуется добавить запрос. По умолчанию у группы нет этого разрешения. |
Заметка
Следующие макросы поддерживаются только на веб-портале: @CurrentIteration, @CurrentIteration +/-n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityи @TeamAreas. Запросы, содержащие эти макросы, не будут работать при открытии в Visual Studio или Team Explorer, Microsoft Excel или Microsoft Project.
Поддерживаемые операторы и макросы
При создании запросов и указании полей пути области и пути итерации можно использовать следующие операторы:
| Оператор | Используйте, когда вы хотите... |
|---|---|
= |
Укажите одну область или путь итерации |
<> |
Отфильтруйте одну область, определенный путь или путь итерации. |
In |
Фильтрация по набору путей области или итерации. |
Not In |
Исключите элементы, назначенные набору путей области или итерации. |
Under |
Укажите все пути, находящиеся под областью выбора или под путем итерации. |
Not Under |
Исключите элементы, назначенные в определенной области или итерационном пути. |
Вместе с этими операторами можно использовать следующие макросы при выборе пути итерации. Например, см. примеры в запросе по дате или текущей итерации.
| Макрос | Используйте, когда вы хотите... |
|---|---|
@CurrentIteration |
Укажите текущую итерацию, связанную с выбранным контекстом команды. |
@CurrentIteration +/- n |
Фильтруйте элементы на основе назначения скользящему окну спринтов, связанных с выбранным контекстом команды. |
@TeamAreas |
Фильтрация элементов на основе путей области, назначенных определенной команде. |
Заметка
Макросы @CurrentIteration +/- n и @TeamAreas поддерживаются для Azure DevOps Server 2019 и более поздних версий. Эти макросы поддерживаются только на веб-портале. Запросы, содержащие эти макросы, не будут работать при открытии в Visual Studio или Team Explorer, Microsoft Excel или Microsoft Project.
Запросы путей области
Чтобы отфильтровать рабочие элементы, назначенные нескольким областям, можно использовать оператор In, как показано в следующем примере.
Запросы на основе имен узлов и ключевых слов
Используйте поле имя узла для фильтрации рабочих элементов, назначенных для путей областей, основываясь на ключевом слове с помощью оператора Contains. Имя узла указывает последний узел пути области , который соответствует последнему узлу в иерархии дерева.
Следующий запрос дает тот же результат, что и предыдущий пример.
запрос имени узла для нескольких областей 
В этом примере фильтр возвращает любые рабочие элементы, назначенные области пути, последний узел которого содержит слово "Azure".
запрос 
Вот еще один пример, использующий Node Name и оператор In.
запрос имени узла для нескольких областей
Запросы пути к области группы
Используйте макрос @TeamAreas, чтобы быстро найти элементы, назначенные на пути области, закрепленные за определенной командой. Укажите оператор =. Редактор запросов автоматически запрашивает указать имя команды. Его можно добавить, введя имя команды и выбрав значение команды, которое отображается в критерии фильтра поиска.
Справочник по полю классификации
| имя поля | описание | Имя ссылки |
|---|---|---|
| Путь к области | Группирует рабочие элементы в области функций продукта или области команды. Область должна быть допустимым узлом в иерархии проекта. | System.AreaPath |
| Итерационный путь | Группирует рабочие элементы по именованным спринтам или периодам времени. Итерация должна быть допустимым узлом в иерархии проекта. | Система.ИтерационныйПуть |
Для каждого поля путь к данным=TreePath, отчетируемый тип=Dimension, атрибут индекса=True.
Если вы определяете имя пути, которое больше 256 символов, его нельзя указать в Microsoft Project. Чтобы избежать этой проблемы, задавайте имена путей длиной не более 10 символов и не углубляйте узлы более чем на 14 уровней.
Не удается применить большинство правил полей к системным полям, таким как System.AreaPath и System.IterationPath. Дополнительные сведения см. в разделе Правила и оценка правил.
Следующие поля не отображаются в формах рабочих элементов, но отслеживаются для каждого типа рабочего элемента. Эти поля предоставляют числовое значение для каждого значения классификации, определенного для проекта. Эти поля можно использовать для фильтрации запросов и создания отчетов.
| имя поля | описание | Имя ссылки | типа данных |
|---|---|---|---|
| Идентификатор области | Уникальный идентификатор области, которой назначается этот рабочий элемент. | System.AreaId | Целое число |
| Идентификатор итерации | Уникальный идентификатор итерации, к которой назначается этот рабочий элемент. | System.IterationId | Целое число |
| Имя узла | Имя последнего узла маршрута к области. Например, если путь к области — Project\A1\B2\C3, имя узла — C3. | System.NodeName | Струна |
Тип отчета, доступный по умолчанию, отсутствует. Идентификатор области и идентификатор итерации индексируются, а имя узла не индексируется. Дополнительные сведения об атрибутах полей см. в разделе Поля и атрибуты рабочих элементов.
Связанные статьи
- краткий справочник по запросу
- Определите пути областей и назначьте команде
- Определение путей этапов (спринта) и настройка итераций команды
- Задать разрешения и доступ для отслеживания работы
REST API
Сведения о программном взаимодействии с запросами см. в одном из следующих ресурсов REST API: