Определение запроса рабочего элемента в Azure Boards

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

Visual Studio 2019 | Visual Studio 2022

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

Создавайте запросы на веб-портале или из поддерживаемого клиента, например Visual Studio Team Explorer. Вы также можете определить и импортировать запрос к рабочему элементу с помощью синтаксиса WIQL и WIQ-файла. Для поддержки массовых обновлений или дополнений импортируйте или экспортируйте запросы с помощью Excel или .csv файлов.

Создавайте запросы на веб-портале или из поддерживаемого клиента, например Visual Studio Team Explorer. Вы также можете определить и импортировать запрос к рабочему элементу с помощью синтаксиса WIQL и WIQ-файла. Для поддержки массовых обновлений или дополнений импортируйте или экспортируйте запросы с помощью Excel.

Редактор запросов, веб-браузер.

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

В этой статье рассматриваются следующие темы:

  • Добавление или создание запроса
  • Как выполнять запросы между проектами
  • Как группировать и разгруппировать предложения запросов
  • Создание дерева рабочих элементов или запроса прямых ссылок

Сведения о быстром доступе ко всем задачам запроса, поддерживаемым операторам, таким как , ContainsIn, In Groupи <>(не оператору) на основе типа данных поля и примеров запросов, см. в статье Краткий справочник по запросу.

Выбор фильтра запроса

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

Примечание

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


Функции фильтрации

Макросы



Наряду с фильтрами, используемыми из Редактор запросов, вы можете интерактивно фильтровать результаты запроса с помощью функции Filter. Дополнительные сведения см. в статье Интерактивная фильтрация невыполненных работ, досок, запросов и планов.

Предварительные требования

  • По умолчанию все участники проекта и пользователи с доступом заинтересованных лиц могут просматривать и выполнять все общие запросы. Вы можете изменить набор разрешений для общей папки запроса или общего запроса. Дополнительные сведения см. в разделе Настройка разрешений запроса.
  • Чтобы добавить и сохранить запрос в разделе Общие запросы, необходимо предоставить базовый доступ или выше. Кроме того, у вас должно быть разрешение "Участие " в значение Разрешить для папки, в которую вы хотите добавить запрос. По умолчанию группа "Участники " не имеет этого разрешения.

Примечание

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

  • По умолчанию все участники проекта и пользователи с доступом заинтересованных лиц могут просматривать и выполнять все общие запросы. Вы можете изменить набор разрешений для общей папки запроса или общего запроса. Дополнительные сведения см. в разделе Настройка разрешений запроса.
  • Чтобы добавить и сохранить запрос в разделе Общие запросы, необходимо предоставить базовый доступ или выше. Кроме того, у вас должно быть разрешение "Участие " в значение Разрешить для папки, в которую вы хотите добавить запрос. По умолчанию группа "Участники " не имеет этого разрешения.

Открытие запросов

В веб-браузере (1) убедитесь, что выбран правильный проект, (2) выберите Доски>Запросы, а затем (3) выберите Все.

Запросы Open Boards>, вертикальная навигация

Если вы впервые открываете запросы, откроется страница Избранное. На этой странице перечислены запросы, которые вы указали в избранном. В противном случае можно выбрать Все , чтобы просмотреть все определенные запросы и общие запросы, определенные для проекта.

Совет

Запросы, выбранные вами или вашей командой в качестве избранного, отображаются на странице Избранное . Избранные запросы вместе с другими объектами также отображаются на странице Проекта . Дополнительные сведения см. в статье Настройка личного или командного избранного.

В веб-браузере откройте Boards>Queries.

В веб-браузере откройте Boards>Queries

Определение запроса к неструктурированному списку

Новый запрос можно запустить на вкладке Запросы на веб-портале или на вкладке Рабочие элементы в Team Explorer.

Снимок экрана: добавление нового запроса, новый интерфейс.

Отображается Редактор запросов со следующими параметрами по умолчанию: Неструктурированный список рабочих элементов, Тип рабочего элемента=[Любой] и Состояние=[Любой].

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

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

Снимок экрана: страница

Редактор запросов отображается со следующими параметрами по умолчанию: Плоский список рабочих элементов, Командный проект=@Project (текущий проект), Тип рабочего элемента=[Любой] и Состояние=[Любой].

Снимок экрана: Редактор запросов с выбранным неструктурированным списком рабочих элементов, TFS 2018 и более ранних версий.

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

Запросы между проектами или внутри нее

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

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

Снимок экрана: Редактор запросов с флажом

Установите флажок Запрос по проектам , и вы можете добавить поле "Командный проект" для фильтрации по определенному количеству проектов.

Снимок экрана: Редактор запросов с командным проектом и другими полями, добавленными для фильтрации.

Примечание

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

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

Определение предложения

Запрос создается путем определения одного или нескольких предложений. Каждое предложение определяет критерии фильтра для одного поля.

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

и/или Поле Оператор Значение
And Кому назначено = @Me

Список доступных операторов на основе типа данных поля см. в разделе Краткий справочник по индексу запросов.

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

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

Снимок экрана: Редактор запросов добавление предложения.

Например, выполните поиск всех назначенных вам рабочих элементов, указав поле Кому назначено , оператор равенства (=) и макрос @Me , который представляет удостоверение пользователя.

Совет

Чтобы просмотреть синтаксис WIQL для запроса и использование круглых скобок для группирования предложений, установите редактор Wiql Marketplace. Это расширение поддерживает просмотр синтаксиса WIQL и его экспорт в WIQL-файл для использования в вызовах REST API. Дополнительные сведения см. в статье Синтаксис для языка запросов рабочих элементов (WIQL).

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

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

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

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

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

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

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

  4. Чтобы добавить предложение, выберите Добавить новое предложение.

    Вы можете добавить предложение в конец запроса или выполнить следующие задачи с соответствующими значками:

    • Вставка новой строки фильтра
    • Удалить эту строку фильтра
    • Группировать выбранные предложения
    • Разгруппировать предложения

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

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

Примечание

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

Снимок экрана: список результатов запроса с запросом в виде дерева.

Снимок экрана: список результатов запроса, показывающий древовидное представление TFS 2018.

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

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

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

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

Снимок экрана: результаты запроса Direct Links.

Снимок экрана: Редактор запросов запрос прямых ссылок.

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

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

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

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

Дополнительные сведения о каждом типе ссылок см. в статье Связывание, трассировка и управление зависимостями.

И/или логическое выражение

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

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

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

Предложения группы

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

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

Совет

Чтобы просмотреть синтаксис WIQL для запроса, установите расширение редактора запросов WIQL , которое позволит просматривать версию WIQL любой записи пользовательского интерфейса запроса. Это расширение позволяет увидеть, как обрабатываются сгруппированные предложения AND/OR.

Запрос Сгруппированные предложения Логическое выражение
1 Снимок экрана: запрос предложения группы. Фильтры настраиваются для поля Тип рабочего элемента и поля Состояние или Назначено. Снимок экрана: логическое выражение. Оператор AND группит поля Тип рабочего элемента, Состояние и Назначено полям. Оператор OR группировать поля State и Assigned to.
2 Снимок экрана: запрос предложения группы с фильтрами для поля Тип рабочего элемента и одного из полей Снимок экрана: логическое выражение. Оператор AND группируют тип рабочего элемента с полями State или Assigned to , которые сгруппированы оператором OR.
3 Снимок экрана: запрос предложения группы. Фильтры настраиваются либо для поля Тип рабочего элемента, либо для полей Состояние и Назначено. Снимок экрана: логическое выражение. Оператор OR связывает тип рабочего элемента с полями State и Assigned to, которые связаны оператором AND.

Эти запросы возвращают рабочие элементы типа Bug и соответствуют следующим логическим выражениям:

  • Запрос 1. AND State=Active OR Assigned to @Me
  • Запрос 2. AND (State=Active OR Assigned to @Me)
  • Запрос 3. OR (State=Active AND Assigned to @Me)

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

Снимок экрана: веб-портал, Редактор запросов, предложения группирования выбранных запросов.

Можно также сгруппировать несколько сгруппированных предложений. Установите флажки для каждого предложения, которое уже сгруппировано. Затем щелкните значок предложения группы.

Снимок экрана: веб-портал, Редактор запросов, группирование нескольких предложений запроса.

Если результаты запроса не возвращают ожидаемые результаты, выполните следующие действия.

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

Разгруппировать предложение

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

Просмотр результатов запроса на панели мониторинга

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

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

Дополнительные сведения о добавлении мини-приложений на панель мониторинга см. в статье Добавление мини-приложений на панель мониторинга.

Мини-приложение "Просмотр результатов запроса" с заголовками "Родители"

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

  1. Создайте запрос, который фильтрует интересующие рабочие элементы. Запрос может быть неструктурированным списком, деревом или запросом с прямыми ссылками.
  2. Добавьте поле Parent в качестве столбца.
  3. Сохраните запрос как общий запрос или избранное команды.
  4. Добавьте мини-приложение "Результаты запроса " на панель мониторинга и настройте запрос. Убедитесь, что для поля Родительский задано значение для отображения.

На следующем рисунке показано мини-приложение результатов запроса, отображающее поле Родитель .

Снимок экрана: мини-приложение результатов запроса с полем родительского столбца.

Это основные сведения об определении запросов. Индекс примеров запросов см. в разделе Краткий справочник по запросу.