Запрос по области или пути итерации
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: