Поля, операторы, значения и переменные запросов
При создании в Visual Studio Team Foundation Server 2010 запроса для поиска рабочих элементов можно задать одно или несколько предложений для идентификации рабочих элементов, которые требуется найти. Для каждого предложения запроса можно указать поле, оператор и значение или переменную. Например, можно выполнить поиск рабочих элементов в определенном командном проекте, указав поле "Командный проект", оператор равенства (=) и имя командного проекта, в качестве значения. Вместо значения, можно указать переменную, например "@Project", которая представляет текущий командный проект.
Пример предложения запроса
И/или |
Поле |
Оператор |
Значение |
And |
Командный проект |
= |
@Project |
Дополнительные общие сведения о запросах см. в разделе Поиск ошибок, задач и прочих рабочих элементов. Сведения о переходах в редакторе запросов и представлении запросов при помощи сочетаний клавиш см. в разделе Сочетания клавиш для редактора запросов и представления результатов запроса.
Содержание раздела
И/Или
Поля запроса и значения
Операторы запроса
Переменные запроса
Контрольный список для определения предложения запроса:
В первой пустой строке, щелкните ячейку под заголовком в столбце "Поле", нажмите стрелку вниз, чтобы отобразить список доступных полей, затем выберите элемент из списка.
Дополнительную информацию см. в разделе Поля запроса и значения.
В той же пустой строке, щелкните ячейку под заголовком в столбце "Оператор", нажмите стрелку вниз, чтобы отобразить список доступных операторов, затем выберите элемент из списка.
Дополнительные сведения см. Операторы.
В той же строке, щелкните ячейку под заголовком в столбце "Значение".
Введите значение или нажмите стрелку вниз, затем выберите элемент из списка.
Дополнительные сведения об использовании переменных для указания текущего командного проекта, пользователя или даты см. в разделе Переменные.
Чтобы добавить предложение, выберите Щелкните здесь, чтобы добавить предложение.
Предложение можно добавить в конце запроса, вставить после существующего предложения (
.gif "Предложение запроса вставки")
), а также, при необходимости, удалить (.gif "Удаление предложения запроса")
), сгруппировать (.gif "Группировка предложения запроса")
) и разгруппировать (.gif "Отмена группировки предложение запроса")
) предложения. Также содержимое предложения можно скопировать и вставить в новое место. Дополнительные сведения см. в разделе Задание условия фильтрации запроса.
И/или
Этот столбец можно использовать, чтобы указать способ тестирования предложений. Чтобы найти рабочие элементы, удовлетворяющие критериям текущего и предыдущего предложений, укажите И. Чтобы найти рабочие элементы, удовлетворяющие критериям текущего или предыдущего предложений, укажите Или.
Поля запроса и значения
При указании значения для каждого поля, оно должно соответствовать типу данных этого поля. Все поля в Team Foundation имеют один из типов данных, перечисленных в следующей таблице:
Тип данных |
Сохраненные данные |
|---|---|
DateTime |
Конкретный момент всеобщего скоординированного времени (UTC). Можно указать переменную, например @Today или @Today-1, либо значение, например 1/1/2009. |
Double |
Действительное число, например 0,2 или 3,5. |
GUID |
Строка знаков, представляющая уникальное значение ИД. |
HTML |
Текстовые строки, поддерживающие форматированные описания. |
Integer |
32-битовое знаковое целое число, например 0, 1, 2, 34. |
PlainText |
Текстовые строки, поддерживающие длинные описания, например поля "Описание" или "История", определенные для рабочего элемента. Рабочие элементы можно найти по фразе или ключевому слову в поле "PlainText". |
String |
Текстовая строка, содержащая до 255 знаков Юникода. |
TreePath |
Древовидная структура, например, "Путь области" или "Путь итерации". Необходимо выбрать элемент из списка допустимых значений. Можно найти рабочие элементы, которые равны или находятся ниже по структуре дерева. |
К началу
Операторы запроса
Операторы запроса, приведенные в таблице, служат для определения зависимости между значением предложения и значением рабочего элемента. Сведения о типе данных, назначенном полям рабочих элементов, см. в разделе Использование системных полей и полей, определенных шаблонами процессов MSF.
Оператор запроса |
Возвращает рабочие элементы, если значение рабочего элемента совпадает с указанным критерием. |
Применимые типы данных |
|---|---|---|
= |
Совпадает со значением предложения. |
"Число", "Текст", "Дата", "Дерево" |
<> |
Не совпадает со значением предложения. |
"Число", "Текст", "Дата", "Дерево" |
> |
Больше значения предложения. |
"Число", "Текст", "Дата" |
< |
Меньше значения предложения. |
"Число", "Текст", "Дата" |
>= |
Больше или равно значению предложения. |
"Число", "Текст", "Дата" |
<= |
Меньше или равно значению предложения. |
"Число", "Текст", "Дата" |
=[Поле] |
Совпадает со значением, содержащимся в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
<>[Поле] |
Не совпадает со значением, содержащимся в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
>[Поле] |
Больше значения, содержащегося в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
<[Поле] |
Меньше значения, содержащегося в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
>=[Поле] |
Больше или равно значению, содержащемуся в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
<=[Поле] |
Меньше или равно значению, содержащемуся в указанном поле |
Имя поля, принадлежащего к тому же типу данных, что и указанное поле |
Содержит |
Содержит в предложении текстовое значение. |
Text |
Не содержит |
Не содержит в предложении текстовое значение. |
Текст |
В |
Совпадает с любым значением в наборе с разделителями. Например, можно найти рабочие элементы, с ИД 100, 101 и 102, если эти значения определены для поля ИД. .gif "Важное примечание") Важно
Разделяйте значения разделителем элементов списка, соответствующим региональным параметрам на клиентском компьютере.Например, можно использовать запятую (,).
|
"Число", "Текст", "Дата", "Дерево" |
В группе |
Совпадает со значением, являющимся членом группы в предложении. Можно указать группу по умолчанию, настраиваемую группу или группу категорий в Team Foundation Server. Например, можно создать запрос для поиска всех рабочих элементов, назначенных членам группы "Участники". .gif "Примечание") Примечание
Указать в качестве значения группу безопасности или группу рассылки электронной почты нельзя.
|
Строка, соответствующая имени группы пользователей или группы категорий в Team Foundation Server. Примечание
Оператор В группе применяется только для полей, использующих строковый тип данных, или поля "Тип рабочего элемента".
Дополнительные сведения о группах категорий см. в разделе Группирование типов рабочих элементов по категориям. |
Не в группе |
Не совпадает со значением, являющимся членом группы в предложении. |
Строка, соответствующая имени группы пользователей или группы категорий в Team Foundation Server. Примечание
Оператор Не в группе применяется только для полей, использующих строковый тип данных, или поля "Тип рабочего элемента".
Дополнительные сведения о группах категорий см. в разделе Группирование типов рабочих элементов по категориям. |
Всегда |
Совпадает со значением в предложении по любому из перечисленных выше пунктов. |
"Текст", "Дата" |
В группе |
Совпадает со значением в предложении или содержится в предложении под узлом. |
Дерево |
Не в группе |
Не совпадает со значением в предложении и не содержится в предложении под узлом. |
Дерево |
К началу
Переменные запроса
Переменные, приведенные в таблице, можно использовать для поиска рабочих элементов, относящихся к текущему пользователю, проекту или дате.
Переменная запроса |
Использование |
|---|---|
@Me |
Эти переменные используются для автоматического поиска текущего псевдонима пользователя в поле, содержащем псевдонимы пользователя. Например, чтобы найти все открытые рабочие элементы, необходимо в столбце Поле установить значение Активировал, в столбце Оператор — значение =, а в столбце Значение — значение @Me. |
@Project |
Эта переменная используется для поиска рабочих элементов в текущем командном проекте. Например, чтобы найти все рабочие элементы текущего проекта, необходимо в столбце Поле установить значение Командный проект, в столбце Оператор — значение =, а в столбце Значение — значение @Project. |
@Today |
Эта переменная используется для поиска рабочих элементов, относящихся к текущей или более ранней дате. Можно также изменить переменную @Today, вычитая из нее дни. Например, чтобы найти все элементы, активированные на прошлой неделе, в столбце Поле необходимо установить значение Дата активации, в столбце Оператор — значение >=, а в столбце Значение — значение @Today - 7. |
[Any] |
Эта переменная используется для поиска рабочих элементов, относящихся к любому значению, указанному для определенного поля. |
К началу
См. также
Задачи
Задание условия фильтрации запроса
Добавление, удаление, изменение порядка и сортировка столбцов
Сохранение, копирование, переименование и удаление запросов рабочих элементов
Создание списка рабочих элементов (по умолчанию в виде плоского списка)
Просмотр и изменение рабочих элементов в представлении прямых связей
Просмотр и изменение рабочих элементов в представлении в виде дерева
Основные понятия
Поиск ошибок, задач и прочих рабочих элементов
Другие ресурсы
Совместное использование рабочих элементов и запросов с участниками команды
Журнал изменений
Дата |
Журнал |
Причина |
|---|---|---|
|
Июль 2010 |
Исправлены сведения о разделителе, используемом при указании нескольких значений. |
Обратная связь от клиента. |
|
Сентябрь 2010 |
Исправлены сведения о значениях, указываемых для операторов В группе и Не в группе. |
Обратная связь от клиента. |