Поля, операторы, значения и переменные запросов

Можно искать и создавать списки рабочих элементов с помощью создания запросов к рабочим элементам.Определив одно или несколько предложений, можно отфильтровать весь список рабочих элементов внутри командного проекта или коллекции командных проектов, чтобы получить набор интересующих рабочих элементов.Для каждого предложения запроса можно указать поле, оператор и значение или переменную.Например, можно выполнить поиск рабочих элементов в определенном командном проекте, задав поле Командный проект, оператор равенства (=) и имя командного проекта в качестве значения.Вместо задания значения можно указать переменную, например @Project, которая представляет текущий командный проект.

Пример предложения запроса

И/Или	Поле	Оператор	Значение
И	Командный проект	=	@Project

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

Содержание раздела

• И/Или

• Поля запроса и значения

• Операторы запроса

• Переменные запроса

• Частично полнотекстового поиска и ключевые слова

• Запрос индексированных полей

Контрольный список для определения предложения запроса:

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

   Дополнительную информацию см. в разделе Поля запроса и значения.

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

   Дополнительные сведения см. Операторы.

3. В той же строке, под заголовком столбца значение, либо введите значение, либо нажмите стрелку вниз и выберите элемент из списка.

4. Дополнительные сведения об использовании переменных для указания текущего командного проекта, пользователя или даты см. в разделе Переменные.

5. Чтобы добавить предложение, выберите Нажмите, чтобы добавить новое предложение или Добавить новое предложение.

   Предложение можно добавить в конце запроса, вставить после существующего предложения (), а также, при необходимости, удалить (), сгруппировать () и разгруппировать () предложения.

И/Или

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

В каждое поле рабочего элемента можно добавить одно новое предложение для того, чтобы уточнить условие поиска и отобразить только необходимые рабочие элементы.Если запрос не отображает ожидаемых результатов, можно добавить, удалить, сгруппировать или разгруппировать предложения запроса для уточнения отображаемых результатов запроса.

Предложения запросов можно группировать и использовать в качестве единого блока отдельно от остального запроса, что похоже на заключение в скобки выражения в математическом уравнении или логическом утверждении.При группировании предложений оператор И или ИЛИ, указанный для первого предложения в группе, применяется ко всей группе.

Как показано в следующем примере, сгруппированные предложения преобразуются в соответствующее логическое выражение.Первое выражение возвращает рабочие элементы с приоритетом 1 и все активные ошибки с любым приоритетом.Второе выражение возвращает все активные рабочие элементы с приоритетом 1, а также все ошибки с приоритетом 1, вне зависимости от того, активны они или нет.

Сгруппированные предложения	Логическое выражение
	Приоритет=1 ИЛИ (Тип рабочего элемента=Ошибка И Состояние=Активно)
	Приоритет=1 И (Тип рабочего элемента=Ошибка ИЛИ Состояние=Активно)

Дополнительные сведения см. в разделе Задание условия фильтрации запроса.

Поля запроса и значения

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

Тип данных	Сохраненные данные
DateTime	Конкретный момент всеобщего скоординированного времени (UTC).Можно указать переменную, например @Today или @Today-1, либо значение, например 1/1/2012.
Double	Действительное число, например 0,2 или 3,5.
GUID	Строка знаков, представляющая уникальное значение ИД.
History	Форматированное настраиваемые поля, используемый для отслеживания получения информации.Этот тип данных используется только для поддержки поле Журнал.Это поле является индексированным автоматически для полнотекстового поиска, если полнотекстовый поиск доступен.Как описано в разделе Частично полнотекстового поиска и ключевые слова далее в этом разделе.
HTML	Текстовые строки, поддерживающие форматированные описания, например поля Описание или Шаги для воспроизведения.Эти поля автоматически индексируются для полнотекстового поиска, если полнотекстовый поиск доступен.Как описано в разделе Частично полнотекстового поиска и ключевые слова далее в этом разделе. Примечание При обновлении Team Foundation Server, поле Описание изменяется от типа поля PlainText в HTML.С помощью команды witadmin changefield можно отменить тип данных этого поля по мере необходимости.Дополнительные сведения см. в разделе Управление полями рабочих элементов [witadmin].
Integer	32-битовое знаковое целое число, например 0, 1, 2, 34.
PlainText	Текстовые строки, поддерживающих длинные описания, например поле Сведения о запуске приложения.Эти поля автоматически индексируются для полнотекстового поиска, если полнотекстовый поиск доступен.Как описано в разделе Частично полнотекстового поиска и ключевые слова далее в этом разделе.
String	Текстовая строка, которая может содержать до 255 символов юникода.
TreePath	Древовидная структура, например, "Путь области" или "Путь итерации".Необходимо выбрать элемент из списка допустимых значений.Можно найти рабочие элементы, которые равны или находятся ниже по структуре дерева.Дополнительные сведения см. в разделе Создание и изменение областей и итераций.

К началу

Операторы запроса

Операторы запроса, приведенные в таблице, служат для определения зависимости между значением предложения и значением рабочего элемента.Сведения о типе данных, назначенном полям рабочих элементов, см. в разделе Справочник по полям рабочих элементов для Visual Studio ALM.

Оператор запроса	Возвращает рабочие элементы, если значение рабочего элемента совпадает с указанным критерием.	Применимые типы данных
=	Совпадает со значением предложения.	Номер, включая Double, GUID, Integer, String, DateTime и TreePath
<>	Не совпадает со значением предложения.	Номер, String, DateTime и TreePath
>	Больше значения предложения.	Номер, String и DateTime
<	Меньше значения предложения.	Номер, String и DateTime
>=	Больше или равно значению предложения.	Номер, String и DateTime
<=	Меньше или равно значению предложения.	Номер, String и DateTime
=[Поле]	Совпадает со значением, содержащимся в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
<>[Поле]	Не совпадает со значением, содержащимся в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
>[Поле]	Больше значения, содержащегося в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
<[Поле]	Меньше значения, содержащегося в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
>=[Поле]	Больше или равно значению, содержащемуся в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
<=[Поле]	Меньше или равно значению, содержащемуся в указанном поле.	Имя поля, принадлежащего к тому же типу данных, что и указанное поле
Содержит	Содержит точные или частичные совпадения строки текста в поле, выбранном для фильтрации.	String
Не содержит	Не содержит точных или частичных совпадений строки текста в поле, выбранном для фильтрации.	String
Содержит слова	Содержит точное совпадение текстовой строки или слов в поле, выбранном для фильтрации.Можно также ввести частично ключевые слова или фразы, содержащие подстановочный знак - *.Для ограничений см. в разделе Полнотекстовый поиск для требований к сервера и сортировки.	Поля используются текста, которые индексируются для полнотекстового поиска, которые соответствуют всем полям PlainText и HTML, и Название.
Не содержит слов	Не содержит точное совпадение текстовой строки или слов в поле, выбранном для фильтрации.	Текстовые поля, проиндексированные для полнотекстового поиска.
В	Совпадает с любым значением в наборе с разделителями.Например, можно найти рабочие элементы, с ИД 100, 101 и 102, если эти значения определены для поля ИД. Важно Разделяйте значения разделителем элементов списка, соответствующим региональным параметрам на клиентском компьютере.Например, можно использовать запятую (,).	Номер, String, DateTime, TreePath
В группе	Совпадает со значением, являющимся членом группы в предложении.Можно указать группу по умолчанию, настраиваемую группу или группу категорий в Team Foundation Server.Например, можно создать запрос для поиска всех рабочих элементов, назначенных членам группы "Участники". Примечание Указать в качестве значения группу безопасности или группу рассылки электронной почты нельзя.	объект String, соответствующий имени группы пользователей или группы категорий в Team Foundation Server. Примечание Можно использовать оператор В группе только с полями, используется тип данных String, а в поле Тип рабочего элемента. Дополнительные сведения о группах категорий см. в разделе Определение категорий для группирования типов рабочих элементов.
Не в группе	Не совпадает со значением, являющимся членом группы в предложении.	объект String, соответствующий имени группы пользователей в Team Foundation Server или группы категорий, определенных для командного проекта. Примечание Оператор В группе применяется только для полей, использующих тип данных String или поле Тип рабочего элемента. Дополнительные сведения о группах категорий см. в разделе Определение категорий для группирования типов рабочих элементов.
Всегда	Совпадает со значением в предложении по любому из перечисленных выше пунктов.	String, DateTime
В группе	Совпадает со значением в предложении или содержится в предложении под узлом.	TreePath
Не в группе	Не совпадает со значением в предложении и не содержится в предложении под узлом.	TreePath

К началу

Переменные запроса

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

Переменная запроса	Использование
@Me	Эти переменные используются для автоматического поиска текущего псевдонима пользователя в поле, содержащем псевдонимы пользователя.Например, чтобы найти все открытые рабочие элементы, необходимо в столбце Поле установить значение Активировал, в столбце Оператор — значение =, а в столбце Значение — значение @Me.
@Project	Эта переменная используется для поиска рабочих элементов в текущем командном проекте.Например, чтобы найти все рабочие элементы текущего проекта, необходимо в столбце Поле установить значение Командный проект, в столбце Оператор — значение =, а в столбце Значение — значение @Project.
@Today	Эта переменная используется для поиска рабочих элементов, относящихся к текущей или более ранней дате.Можно также изменить переменную @Today, вычитая из нее дни.Например, чтобы найти все элементы, активированные на прошлой неделе, в столбце Поле необходимо установить значение Дата активации, в столбце Оператор — значение >=, а в столбце Значение — значение @Today - 7.
[Any]	Эта переменная используется для поиска рабочих элементов, относящихся к любому значению, указанному для определенного поля.

К началу

Частично полнотекстового поиска и ключевые слова

Укажите Содержит или не содержит для поиска для конкретных совпадений или частично ключевые слова или фразы.Укажите Содержит слова или Не содержит слов для поиска для точной фразы или использовать подстановочный знак - *.Эти операторы используются полнотекстовый индекс.Можно использовать подстановочный знак в конце частично ключевые слова или фразы.

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

Примечание
Не все развертывания поддерживают полнотекстовый поиск.Например, в SQL Express и SQL Azure, которые поддерживают службы Team Foundation, не поддерживают полнотекстовый поиск.В этих экземплярах, только те операторов Содержит и Не содержит.

Содержит слова и Не содержит слов фильтрующие элементы на основе полнотекстовом индексе, созданном для полей используются текста.Team Foundation автоматически индексы все поля используются текста с типом данных PlainText и HTML и полем Название для полнотекстового поиска.Индекс и операторы доступны только при SQL Server, поддерживает Team Foundation Server поддерживает полнотекстовый поиск.

Полнотекстовый поиск требует параметров сортировки SQL, которые соответствуют языку, содержащему средства разбиения текста на слова, зарегистрированные с SQL Server.Если параметры сортировки для базы данных коллекции группового проекта, используемой для вашей Team Foundation Server, не соответствуют поддерживаемому языку, то результаты поиска могут не соответствовать ожиданиям.В таких случаях можно попробовать использовать операторы Содержит или Не содержит.

Для получения дополнительных сведений см. Запросы полнотекстового поиска и параметры сортировки.

Запрос индексированных полей

Кроме того, в полнотекстовый индекс создан индекс запроса.Он основан на тех полей, имеющих активное индексирование.Индекс повышает время отклика запроса при выполнении запросов, содержащих индексированные поля.

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

Используется команда witadmin indexfield включить или отключить индексирование для поля.Дополнительные сведения см. в разделе Управление полями рабочих элементов [witadmin].

См. также

Задачи

Задание условия фильтрации запроса

Работа с запросом неструктурированного списка (по умолчанию)

Работа со связанными иерархиями (дерево рабочих элементов)

Основные понятия

Поиск ошибок, задач и прочих рабочих элементов

Другие ресурсы

Работа со связанными зависимостями (прямые ссылки)

Журнал изменений

Дата	Журнал	Причина
Август 2012 г.	Исправлена таблица, типы данных полей и удаленное Description из набора полей, которые индексируются для полнотекстового поиска.Добавлен раздел 2 на andn полнотекстовых запросов поиска индекса.	Улучшение информации.