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

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

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

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

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

1. Выбор типа запроса

2. Указание условия фильтрации запроса верхнего уровня

3. Добавление, удаление, группирование или разгруппирование предложений запроса

4. Выполнение или отмена запроса и проверка результатов

5. Изменение условия фильтрации запроса

   Примечание

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

Чтобы отфильтровать критерии по значению даты или по значению, принадлежащему к группе, см. следующие процедуры.

• Задание фильтра, основанного на значении даты-времени

• Задание фильтра, основанного на членстве в группе

Необходимые разрешения

Для выполнения данных процедур необходимо быть членом группы Читатели, либо разрешение Просмотр рабочих элементов на этом узле должно иметь значение Разрешить для каждого командного проекта в запросе. Чтобы сохранить запрос как командный запрос, необходимо быть членом группы администраторов проекта. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Выбор типа запроса

Выбор запроса в командном обозревателе

1. Откройте командный проект, разверните узел Рабочие элементы и выберите Командные запросы или Мои запросы.

2. В меню Группа выберите команду Добавить запрос. Щелкните правой кнопкой мыши Рабочие элементы, Мои запросы или щелкните Командные запросы и выберите пункт Добавить запрос.

   Откроется новый запрос Неструктурированный список рабочих элементов (по умолчанию).

3. На панели инструментов запроса выберите Тип запроса, в зависимости от искомого типа представления или рабочих элементов.

   • Неструктурированный список рабочих элементов (по умолчанию): возвращает один уровень ( неструктурированный список) рабочих элементов, соответствующих условию фильтрации. Этот тип запроса используется для поиска рабочих элементов, которые необходимо связать с другими рабочими элементами, экспорта рабочих элементов в Office Excel и Office Project для массового обновления полей столбцов или для создания отчета о наборе рабочих элементов. Дополнительные сведения см. в разделе Создание списка рабочих элементов (по умолчанию в виде плоского списка).

   • Рабочие элементы и прямые связи: возвращает двухуровневый набор рабочих элементов (), соответствующих условию фильтрации, и всех рабочих элементов, связанных с ними, на основании вторичного условия фильтрации. В этом представлении отображаются рабочие элементы в разворачиваемом и сворачиваемом виде. Дополнительные сведения см. в разделе Просмотр и изменение рабочих элементов в представлении прямых связей.

   • Дерево рабочих элементов: возвращает многоуровневый набор рабочих элементов (), соответствующих условию фильтрации, и содержит все рабочие элементы, связанные с рабочими элементами верхнего уровня на основании родительских и дочерних связей. В этом представлении отображаются рабочие элементы в разворачиваемом и сворачиваемом иерархическом виде. Дополнительные сведения см. в разделе Просмотр и изменение рабочих элементов в представлении в виде дерева.

К началу

Указание условия фильтрации запроса верхнего уровня

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

Примечание

Условие фильтрации, задаваемое по умолчанию для нового запроса, возвращает все рабочие элементы (Тип рабочего элемента=[Any] и Состояние=[Any]), назначенные вам (Состояние назначения=@Me) для текущего командного проекта (Командный проект=@Project).

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

Указание условия фильтрации верхнего уровня

1. Указание командных проектов, содержащих искомые рабочие элементы. Если необходимо найти рабочие элементы для:

   • текущего командного проекта, оставьте значение Командный проект=@Project;

   • другого командного проекта, введите имя проекта в столбце Значение для поля Командный проект;

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

     И/Или	Поле	Оператор	Значение
     	Командный проект	В	<имя первого командного проекта>, <имя второго командного проекта>, ...

     Разделяйте имена командных проектов с помощью запятых (,).

2. Указание типа рабочих элементов, которые нужно найти. Если необходимо найти рабочие элементы для:

   • всех типов, оставьте значение Тип рабочего элемента=[Any].

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

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

     И/Или	Поле	Оператор	Значение
     И	Тип рабочего элемента	В	<первый тип рабочего элемента>, <второй тип рабочего элемента >, ...

     Разделяйте имена каждого типа рабочих элементов запятыми (,).

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

     И/Или	Поле	Оператор	Значение
     И	Тип рабочего элемента	В группе	<Имя группы типов рабочих элементов>

     Сведения об определении групп типов рабочих элементов см. в разделе Настройка категорий для типов рабочих элементов [witadmin].

     Для получения сведений о дополнительных параметрах, которые можно использовать для фильтрации по условиям верхнего уровня, см. раздел "Операторы" в разделе Поля, операторы, значения и переменные запросов.

3. На панели инструментов запроса нажмите кнопку Выполнить и убедитесь, что результаты выполнения запроса соответствуют ожидаемым.

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

К началу

Добавление, удаление, группирование или разгруппирование предложений запроса

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

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

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

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

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

Добавление, удаление, группирование или разгруппирование предложений запроса

1. Добавление предложений выполняется одним из следующих способов.

   1. Чтобы добавить предложение в конец условия фильтрации, щелкните Щелкнуть здесь, чтобы добавить новое предложение.

   2. Иначе, чтобы вставить предложение, щелкните правой кнопкой мыши место, куда хотите вставить новое предложение, и щелкните Вставить предложение.

      Новая строка предложения запроса добавляется над положением указателя мыши.

   3. Если необходимо, чтобы предложение обрабатывалось как предложение Или, щелкните И, а затем щелкните Или.

      Выберите значение И, если для получения необходимого результата данное и предыдущее предложения должны быть true. Выберите значение Или, если для получения необходимого результата либо данное предложение, либо предшествующее ему предложение должно быть true.

   4. Укажите значения для Поле, Оператор и Значение.

      Столбец запроса	Использование
      Поле	Укажите поле для типа рабочих элементов, которые нужно найти. Набор рабочих элементов фильтруется на основании значений Оператор и Значения, определенных для поля. Нажмите ALT + СТРЕЛКА ВНИЗ или введите имя поля, которое нужно выбрать.
      Оператор	Укажите способ сравнения запросом значения, найденного в заданном поле записи. Примеры выбора оператора: = (равно), <> (не равно), > (больше чем), < (меньше чем), >= (больше чем или равно), <= (меньше чем или равно), Содержит, Не содержит, Увеличение и Всегда.
      Значение	Укажите значение, которое следует найти в выбранном поле. Если доступно несколько значений, щелкните стрелку раскрывающегося списка и выберите нужное значение. Можно указать переменную запроса для динамического добавления значений в запрос. Если доступно несколько значений, щелкните стрелку раскрывающегося списка и выберите нужное значение. Если имеется несколько значений, которые следует отфильтровать, используйте оператор In для указания разделенного запятыми списка значений. Чтобы указать динамическое значение, укажите допустимую переменную запроса.

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

2. Чтобы удалить предложение запроса, щелкните правой кнопкой мыши слева от строки удаляемого предложения и выберите пункт Удалить предложения.

3. Сгруппируйте предложения запроса рабочего элемента, выполнив следующие действия.

   1. В этом запросе выберите предложения запроса, которые необходимо объединить в группу, щелкая самую левую ячейку в строке. Для выбора нескольких строк нажмите клавишу CTRL и щелкайте необходимые ячейки.

   2. Щелкните правой кнопкой мыши выбранные предложения, а затем выберите команду Группировать предложения.

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

4. Разгруппируйте предложения запроса рабочего элемента, выполнив следующие действия.

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

   2. Щелкните группу правой кнопкой мыши, а затем выберите команду Разгруппировать предложения.

      Скобка в левом поле запроса исчезает, и предложения разгруппируются.

      Примечание

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

К началу

Выполнение или отмена запроса и просмотр результатов

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

Выполнение или отмена запроса на основании условия фильтрации запроса

1. На панели инструментов запроса нажмите кнопку Выполнить.

   Примечание

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

2. Для отмены поиска по запросу щелкните Остановить запрос либо в меню Команда выберите пункт Остановить обновление.

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

К началу

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

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

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

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

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

  3. Проверьте группировку предложений запроса и назначение операторов И/или для каждого сгруппированного предложения.

  4. Добавьте другие предложения запроса для уточнения условия фильтрации запроса.

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

К началу

Задание фильтра, основанного на значении даты-времени

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

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

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

   1. Выберите Поле, принадлежащее к типу данных "Дата", чтобы добавить или изменить предложение запроса.

      Примечание

      В именах полей даты содержится слово "date".

   2. В столбце Оператор выберите = (равно).

   3. В столбце Значение щелкните стрелку и выберите пункт @Today, соответствующий сегодняшней дате.

      Примечание

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

   4. Нажмите кнопку Выполнить и проверьте результаты выполнения запроса.

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

   1. Выберите Поле, принадлежащее к типу данных "Дата", чтобы добавить или изменить предложение запроса.

   2. В столбце Оператор выберите = (равно).

   3. В столбце Значение введите дату с соблюдением формата, принятого в используемой операционной системе.

   4. Нажмите кнопку Выполнить и проверьте результаты выполнения запроса.

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

   1. Выберите Поле, принадлежащее к типу данных "Дата", чтобы добавить или изменить предложение запроса.

   2. В столбце Операторвыберите значение > (больше чем) для поиска элементов после указанной даты или значение >= (больше чем или равно) для поиска элементов, включающих выбранную дату.

   3. В столбце Значение введите первую дату диапазона дат, следуя принятому в используемой операционной системе формату.

   4. Вставьте еще одно предложение запроса непосредственно под предыдущим предложением.

   5. В столбце присвоений И/или выберите значение И.

   6. В столбце Операторвыберите значение < (меньше) для поиска элементов перед датой или значение <= (меньше чем или равно) для поиска элементов, для поиска элементов, включающих выбранную дату.

   7. В столбце Значение введите последнюю дату диапазона дат, следуя принятому в используемой операционной системе формату.

   8. В столбце Оператор выберите = (равно).

   9. В столбце Значение введите дату с соблюдением формата, принятого в используемой операционной системе.

   10. Выберите два предложения запроса, относящихся к определенной дате, и сгруппируйте их.

   11. Нажмите кнопку Выполнить и проверьте результаты выполнения запроса.

К началу

Задание фильтра, основанного на членстве в группе

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

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

1. Задайте следующие типы предложений:

   • Добавьте следующее предложение, чтобы найти рабочие элементы, назначенные любому пользователю, принадлежащему к группе "Администраторы проекта":

     И/Или	Поле	Оператор	Значение
     И	Кому назначено	В группе	Администраторы проектов

   • Добавьте следующее предложение, чтобы найти активные рабочие элементы любого типа в группе категорий "Тест":

     И/Или	Поле	Оператор	Значение
     И	Состояние	=	Активно
     И	Тип рабочего элемента	В группе	Тест

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

2. Щелкните Выполнить запрос и просмотрите результаты выполнения запроса.

К началу

См. также

Задачи

Добавление, удаление, изменение порядка и сортировка столбцов

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

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

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

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

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

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

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

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

Дата	Журнал	Причина
Август 2010	Добавлен пример логического вычисления сгруппированного предложения.	Обратная связь от клиента.
Сентябрь 2010	Исправлен пример использования оператора В группе.	Обратная связь от клиента.