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

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

Visual Studio 2019 | Visual Studio 2022

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Query	Сгруппированные предложения	Логическое выражение
1
2
3

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

• Запрос 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 назначения каждого сгруппированного предложения.
• Добавьте дополнительные предложения запросов, чтобы уточнить критерии фильтра запросов.
• Просмотрите параметры, доступные для указания полей, операторов и значений.
• См . рекомендации далее в этой статье.

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

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

Установка ширины столбца по умолчанию в результатах запроса

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

1. Откройте запрос, который требуется изменить.
2. Вручную настройте ширину столбца на нужный размер, перетащив края заголовков столбцов.
3. Нажмите кнопку "Сохранить" или "Сохранить как если вы хотите сохранить его в качестве нового запроса".
4. Закройте и повторно откройте запрос, чтобы обеспечить сохранение ширины столбца.

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

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

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

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

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

Определение запроса в виде гиперссылки

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

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

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'

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

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

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-минутного периода. Таким образом, система может изучить и искать план оптимизации, наиболее подходящий для вашего запроса.

Связанные статьи

• Краткий справочник по запросу.
• Часто задаваемые вопросы о запросах
• Диаграмма запроса с неструктурированным списком
• Изменение параметров столбца
• Индекс поля рабочего элемента
• сочетания клавиш;