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

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

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

Ознакомьтесь с нашими рекомендуемыми рекомендациями далее в этой статье.

Необходимые компоненты

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

Примечание.

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

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

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

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

Примечание.

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

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

Макросы

Вы также можете интерактивно отфильтровать запрос с помощью функции фильтра .

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

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

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

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

Совет

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

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

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

Выберите Создать запрос.

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

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

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

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

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

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

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

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

С помощью запроса между проектами проверка можно добавить поле "Командный проект", чтобы отфильтровать количество проектов.

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

Примечание.

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

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

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

Чтобы создать запрос, определите одно или несколько предложений. Каждое предложение определяет критерии фильтра для одного поля.

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

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

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

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

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

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

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

Совет

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

Использование и (или) логического выражения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Гиперссылка запроса использует язык запросов рабочих элементов (WIQL), который напоминает Transact-SQL. Дополнительные сведения см. в разделе Синтаксис языка запросов рабочих элементов (WIQL).

Примечание.

Большинство браузеров применяют ограничение в диапазоне от 2000 до 2083 символов для строки URL-адреса.

Кодирование части WIQL синтаксиса URL-адреса. Для кодирования URL-адреса можно использовать любой инструмент кодировщика URL-адресов.

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

Например, следующая гиперссылка содержит идентификатор и заголовок всех активных ошибок, определенных в пути к области FabrikamFiber/Web для организации Fabrikam.

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

Декодированные WIQL соответствуют следующим требованиям:

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

Примечание.

Длина WIQL не должна превышать 32K символов для запросов Azure Boards.

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

Например, следующая гиперссылка содержит идентификатор, заголовок и состояние всех ошибок в пути к области FabrikamFiber/Web.

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

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

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'

Рекомендации

Следующие рекомендации применяются к следующим запросам, которые можно создать:

Создание ориентированных, выборочных запросов

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

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

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

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

Использование Contains words для строковых совпадений

Чтобы отфильтровать совпадение строк, используйте Contains Words вместо Contains оператора. Оператор Contains Words выполняет полнотекстовый поиск по указанному полю, что, как правило, выполняется быстрее.

Оператор Contains выполняет проверку таблицы, которая является более медленной операцией, чем Contains Words оператор. Он также потребляет больше циклов ЦП. Эти циклы ЦП могут привести к возникновению ограничений скорости. Дополнительные сведения см. в разделе "Ограничения скорости и использования".

Указание небольших групп с In Group помощью оператора

Оператор In Group фильтрует рабочие элементы на основе совпадений в группе значений. Группа значений соответствует значениям, содержащимся в группе, группе безопасности или категории отслеживания работы. Например, можно создать запрос, чтобы найти все рабочие элементы, назначенные любому участнику команды. Или найдите все рабочие элементы, принадлежащие категории требований (Microsoft.RequirementCategory).

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

Избегайте использования негритированных операторов

Неисправные операторы, такие как <>, Not In, Not Under, Not In Group, как правило, создают неизбирательные запросы и большие результирующие наборы.

При необходимости используйте только отрицание операторов. Всегда старайтесь сначала найти альтернативные варианты. Например, если Field1 имеет значения A, B, C, D; укажите Field1 In A, B, C предложение, а не предложение с отрицаниемField1 <> D.

Избегайте сравнения строк

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

Ограничения Or операторов

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

Сохранение запроса

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

Выполнение запроса

Иногда необходимо выполнить запрос несколько раз, чтобы достичь правильного плана оптимизации. Не забудьте сохранить запрос и запустить его до 10 раз в течение 30-минутного периода. Таким образом, система может изучить и искать план оптимизации, наиболее подходящий для вашего запроса.