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

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

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

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

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

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

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

Функцию фильтра можно использовать для интерактивного фильтрации запроса.

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

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

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

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

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

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

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

Пример пункта запроса

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Использование логических операторов «и» или «или» в выражении

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

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

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

Групповые условия

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

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

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

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

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

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

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

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

Гиперссылка запроса использует язык запросов рабочих элементов (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 ID.

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

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

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

Если настроить Azure DevOps MCP Server, можно описать запрос, необходимый для естественного языка, а не создавать предложения вручную в Query Editor.

Связанный контент

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