Использование индекса для запроса быстрых эталонных данных в Azure Boards и Azure DevOps

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

Примеры запросов

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

Ключевые слова, запросы с подстановочными знаками

Запросы на основе тегов

Запросы на изменение состояния, причины или рабочего процесса

Запросы на основе даты и итерации

Запросы ссылок и количества вложений

Запросы на основе удостоверений

Число рабочих элементов и запросы числовых полей

Журнал, обсуждение и запросы на изменение изменений

Запросы, ориентированные на группу

Создание и тестирование запросов полей

Другое

Задачи запроса

Операторы и макросы, поддерживаемые для каждого типа данных

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

Примечание

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

Data type

Описание

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

Boolean

Поддерживает значение True или False. Примеры запросов: запрос по назначению или изменениям рабочего процесса.

= , <> , =[Field] , <>[Field]

DateTime

Поле даты, в котором можно указать переменную, например @Today или @Today-1, или значение, например 01.01.2012. Введите даты в шаблон даты, заданный для личного профиля. Дополнительные сведения см. в разделе Настройка личных настроек .

Примеры запросов см. в разделе Запрос по дате or@CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Макросы: @Today, допустимые с любым полем DateTime

Дополнительные макросы, поддерживаемые в Azure DevOps 2019 с обновлением 1 и более поздних версий:
@StartOfDay, @StartOfWeek, @StartOfMonthи @StartOfYearдопустимы для любого поля DateTime

Double

Также называется Decimal и включает в себя picklistDouble1. Действительное число, например 0,2 или 3,5.

Примеры запросов: запрос по числовым полям.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

Строка знаков, представляющая уникальное значение ИД.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Журнал

Настраиваемое отформатированное поле, используемое для отслеживания исторических сведений и назначенное только полю Журнала .

Примеры запросов: журнал и аудит.

Содержит слова, не содержит слов

HTML

Текстовые строки, поддерживающие форматированные описания, такие как поля Описание или Шаги воспроизведения . Эти поля автоматически индексируются для полнотекстового поиска, если полнотекстовый поиск доступен. Примеры запросов: запрос по заголовкам, идентификаторам и полям форматированного текста.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Удостоверение

Строковое поле, используемое для хранения удостоверения пользователя. Примеры запросов: запрос по назначению или изменениям рабочего процесса.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverМакросы: @me допустимы для всех полей удостоверений.

Целое число

Также включает picklistInteger1. 32-битовое знаковое целое число, например 0, 1, 2, 34.

Примеры запросов: запрос по числовым полям

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Макросы: @Follows, @MyRecentActivity, @RecentMentionsи @RecentProjectActivityдопустимы при использовании с полем идентификатора .

Plaintext

Многострочный текстовые строки, которые поддерживают длинные описания и автоматически индексируются для полнотекстового поиска при наличии полнотекстового поиска.
Примеры запросов: запрос по заголовкам, идентификаторам и полям форматированного текста.

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

String

Также включает picklistString1. Короткий однострочный текст, который может содержать до 255 символов Юникода. Строковые поля поддерживают поле Title , списки выбора (раскрывающееся меню), учетные записи пользователей, теги и другие поля.

Примеры запросов: запрос по заголовкам, идентификаторам и полям форматированного текста и запрос по значению списка выбора.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Макросы: [Any], допустимые с полем @ProjectТип рабочего элемента , допустимые с полем "Командный проект".

Путь к дереву

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

Примеры запросов: Запрос по области или пути итерации и Запрос по дате или текущей итерации.

Under, Not Under, =, <>, In, Not In

Макросы: @TeamAreas3, допустимые с полем "Путь к области"
@CurrentIterationи @CurrentIteration+/- n4 допустимых с полем "Путь итерации"

Примечание

  1. Типы данных picklist... назначаются только настраиваемым полям, определенным для наследуемого процесса. Наследуемая модель процесса поддерживается только для Azure DevOps Server 2019 и более поздних версий.
  2. Операторы Is Empty и Is Not Empty поддерживаются для Azure DevOps Server версии-кандидата 2019 и более поздних версий.
  3. Макрос @TeamAreas поддерживается для Azure Boards и Azure DevOps Server 2019 и более поздних версий.
  4. Макрос @CurrentIteration +/- n поддерживается для Azure DevOps Server 2019 и более поздних версий и только при запуске с веб-портала.

Шаблон даты и времени

Шаблон даты и времени, который вы вводите для полей DateTime , должен соответствовать шаблону, выбранному в профиле. Сведения о том, как просмотреть или изменить выбранные параметры, см. в разделе Настройка параметров пользователя, время и языковой стандарт.

Страница

Страница

Примеры запросов для выбранных полей

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

A

B

C

D-E-F

H-P

R

S

T

V–W