Поделиться через

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

  • Статья

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

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

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

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

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

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

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

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

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

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

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

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

Запросы фокусировки команды

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

Другое

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

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

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

Примечание.

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

Тип данных

Description

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

Boolean

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

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

DateTime

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

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

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

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

Двойной

Также называется Десятичным и включает в себя 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 WordsIs Empty2, Is Not Empty2

Identity

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

= , <> , > , < , >= , <= , =[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, , @RecentMentions@MyRecentActivityи @RecentProjectActivity, допустимые при использовании с полем идентификатора.

Открытый текст

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

Contains Words, , Does Not Contain WordsIs EmptyIs Not Empty

String

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

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

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

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

TreePath

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

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

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

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

Примечание.

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

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

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

Снимок экрана: параметры раскрывающегося списка Снимок экрана: параметры раскрывающегося списка

Снимок экрана: панель

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

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

а

Б

C

D-E-F

H-P

R

S

T

V-W