Отслеживание работы с помощью управляемых запросов в Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Вывод списка ошибок, историй пользователей или других рабочих элементов на основе условий поля, заданных с помощью запросов. Затем эти списки можно просмотреть вместе с командой, работой по сортировке или массовым обновлением рабочих элементов. Наряду с управляемыми запросами средство семантического поиска предоставляет некоторые перекрывающиеся и различные функциональные возможности, которые стоит изучить.
Используйте управляемые запросы для поддержки этих операций:
- Массовое обновление рабочих элементов с помощью веб-портала
- Триаж и обновление рабочих элементов
- Просмотр иерархии рабочих элементов
- Предоставление общего доступа к списку рабочих элементов с участником команды
Вы можете создавать запросы и папки запросов на веб-портале или из Visual Studio Team Explorer. Изменения, внесенные в одном клиенте, отражаются в других клиентах, так как все изменения хранятся в хранилище данных отслеживания работы.
Начало работы с запросами
Если вы только начинаете работу, просматриваете , запускаете или отправляете запрос рабочего элемента по электронной почте. Краткий справочник по задачам редактора запросов и примерам запросов см . в кратком справочнике по запросу.
- Чтобы найти рабочие элементы, назначенные вам, добавьте макросы @Me в качестве значения поля "Назначенный кому " в одном из предложений запроса.
- Все допустимые пользователи со стандартным доступом могут создавать запросы и папки в области "Мои запросы ". Чтобы создать запросы и папки запросов в разделе "Общие запросы", необходимо иметь набор разрешений "Участие". Дополнительные сведения см. в разделе "Настройка разрешений для запросов".
- Вы можете изменить любой запрос, добавив критерии, чтобы сосредоточиться на области продукта, итерации или другом поле. Чтобы изменить запрос, откройте редактор запросов.
- Вы можете открыть любой запрос в Excel. Вы также можете обновить поля одного или нескольких рабочих элементов и опубликовать изменения в базе данных для отслеживания рабочих элементов.
- Вы можете визуализировать состояние или ход выполнения , создав круговую диаграмму, гистограмму или диаграмму тренда для запросов с неструктурированным списком.
Обработка запросов
В следующих разделах представлен обзор функций, поддерживаемых для определения запросов рабочих элементов и управления ими.
- Фильтры запросов определяются с помощью Редактор запросов.
- Макросы запросов можно выбрать для определенных полей, чтобы создать предложение запроса.
- Функции управления результатами запросов и запросами доступны на странице результатов запроса.
Фильтры запросов
В следующей таблице перечислены функции фильтрации запросов, поддерживаемые каждой версией Azure DevOps.
Примечание.
Управляемые запросы не поддерживают поиск близкого взаимодействия, однако семантические поиски выполняются. Кроме того, семантические поиски поддерживают как подстановочные знаки, так * и ? в качестве подстановочных знаков, и можно использовать несколько подстановочных знаков для сопоставления нескольких символов. Дополнительные сведения см. в разделе "Поиск функциональных рабочих элементов".
Функция фильтра
Поддержка запросов
Поддерживаемые версии
Поиск по строке текста (одинарный текст, многострочный текст, форматированный текст)
Поиски не учитывает регистр.
Все версии
Подстановочная карточка = *
Все версии
Поиск рабочих элементов на основе прямых ссылок или топологических или иерархических ссылок.
Фильтрация связанных рабочих элементов на MODE основе синтаксиса WIQL
Все версии
Предложения групп и вложений с помощью операторов AND и OR Boolean.
Все версии
Найдите рабочие элементы на основе поля, соответствующего предыдущему значению.
Поддерживаемый оператор: Was Ever поиск рабочих элементов на основе значения, определенного по определенной дате.
Поддерживаемый оператор: ASOF (синтаксис WIQL)
Все версии
Используйте макросы для создания запросов относительно даты, других инструментов, таких как путь к области команды, итерация команды и многое другое.
Все версии
Найдите рабочие элементы в одном или нескольких проектах в организации или коллекции. По умолчанию используется текущий проект. Используйте поле "Командный проект" для запроса к двум или нескольким проектам.
Все версии
Найдите рабочие элементы на основе того, как два поля сравниваются друг с другом.
Поддерживаемые операторы: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Все версии
Найдите рабочие элементы на основе того, содержат ли они или не содержат тег.
Поддерживаемые операторы: Contains, Does Not Contain
Все версии
Поиск рабочих элементов на основе пустых или не пустых полей HTML/форматированного текста.
Поддерживаемые операторы: Is Empty, Is Not Empty
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Найдите работу, значение поля которой соответствует любому значению в разделенном наборе, например набор типов рабочих элементов, состояний рабочего процесса или значений списка выбора. Разделите значения с разделителем списка, соответствующим региональным параметрам, определенным для клиентского компьютера. Например, можно использовать запятую(,).
Все версии
Поиск рабочих элементов на основе логического значения поля.
Все версии
Поиск рабочих элементов на основе ключевых слов или фраз, добавленных с помощью обсуждения.
Все версии
Поиск рабочих элементов на основе их столбца, пловки или состояния "Выполнение/готово".
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Фильтрация результатов запроса на основе ключевого слова или выбора полей.
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Для массового перемещения, копирования или вставки предложений запросов установите и используйте редактор WIQL.
Поддерживаемые макросы
В следующей таблице перечислены макросы запросов или переменные, поддерживаемые версиями Azure DevOps. Для фильтрации уведомлений можно использовать некоторые из этих макросов.
Примечание.
Некоторые макросы можно использовать только на веб-портале. К ним относятся @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity и макросы @TeamAreas. Эти макросы не поддерживаются при экспорте запроса в Excel, фильтрах уведомлений или выполнении из Team Explorer или REST API.
Более подробные описания и ссылки на примеры см. в полях запросов, операторах и макросах.
Макрос
Поддержка запросов
Поддерживаемые версии
Найдите любой тип рабочего элемента, Work Item Type=[Any]или любое состояние. State=[Any]
Все версии
Найдите работу, где Identity field=logged in user.
Все версии
Найдите работу, где Date-Time field=today.
Все версии
Найдите работу, определенную в одном или нескольких проектах.
Все версии
Найдите работу, определенную в текущей итерации для команды.
Все версии
Найдите работу, определенную в +/- n текущей итерации для команды.
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Поиск текущей работы, вошедшего в систему, выполняется следующим ID In @Followsобразом.
Все версии
Поиск недавно измененных рабочих элементов см. в разделе "Просмотр и добавление рабочих элементов", ID In @MyRecentActivity страница "Рабочие элементы".
Все версии
Найдите работу, в которой выбранное поле даты и времени находится в течение текущего дня, месяца, недели или года с смещением плюс/минус, например: Closed Date>=@StartOfDay-7
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Найдите работу, назначенную пути области или пути итерации указанной команды, например запрос по области или пути итерации.
Azure DevOps 2019 с Azure DevOps Server 2022, Azure DevOps Services
Функции управления результатами запросов и запросами
Следующие функции обеспечивают поддержку работы с результатами запроса, сохранением и предоставлением общего доступа к запросам и многое другое.
- Добавление диаграммы запросов на панель мониторинга
- Применение интерактивных фильтров
- Выбор сортировки столбцов
- Выбор параметров столбца запроса
- Копирование URL-адреса запроса копирования результатов
- запроса
- Создание диаграмм запросов
- Создание папок запросов
Неподдерживаемые функции
Запросы рабочих элементов поддерживают только запросы рабочих элементов и рабочих элементов, связанных с другими рабочими элементами. Ниже приведены некоторые задачи, которые не поддерживают управляемые запросы:
- Иерархические представления планов тестирования, наборов тестов и тестовых вариантов. Эти элементы не связаны друг с другом с помощью типов ссылок родительского дочернего элемента. Вместо этого иерархию можно просмотреть на странице "Тестовые>планы тестирования".
- Представления, показывающие связанные объекты, такие как сборки, выпуски, код или другие объекты, не являющиеся рабочими элементами.
- Вывод списка рабочих элементов, связанных из одного проекта в другой.
- Экспорт запроса между проектами в Excel. Прямые ссылки экспортируются в Excel в виде плоского списка.
Типы запросов (неструктурированные, прямые ссылки, дерево)
Azure Boards поддерживает три типа запросов. Значок рядом с каждым запросом указывает тип запроса. Используйте следующее руководство, чтобы выбрать тип запроса в зависимости от того, что вы хотите выполнить с помощью запроса.
Тип запроса
Руководство по использованию
Неструктурированный список рабочих элементов
- Вывод списка элементов для выполнения массовых обновлений в полях
- Сортировка списка рабочих элементов
- Создание диаграммы запросов и добавление ее на панель мониторинга
- Создание диаграммы для получения количества элементов или суммы поля
- Экспорт списка элементов в Excel для обновления полей
Рабочие элементы и прямые ссылки
- Список элементов, зависящих от других рабочих элементов
- Поиск связанных или зависимых от других рабочих элементов
- Вывод списка связанных рабочих элементов для выполнения массовых обновлений полей
- Создание списка связанных рабочих элементов
- Вывод списка связанных рабочих элементов, связанных с тестом
- Поиск потерянных элементов невыполненной работы, рабочих элементов, у которых нет родительских элементов
Примечание.
Рабочие элементы и прямые ссылки экспортируются в Excel в виде неструктурированного списка. Запросы прямых ссылок импортируются как неструктурированный список, так как изменение нескольких типов ссылок не поддерживается в Excel.
Дерево рабочих элементов
- Перечисление дерева рабочих элементов, связанных с родительским дочерним элементом, или другого типа ссылки на дерево-топологию
- Сортировка иерархического списка рабочих элементов
- Экспорт иерархического списка элементов в Excel для обновления полей или изменения иерархии
Дополнительные сведения о типах ссылок см. в справочнике по типу ссылок.
Мои запросы, общие запросы и избранное
Только вы можете просматривать и запускать запросы, сохраненные в разделе "Мои запросы " с каталогом запросов. Кроме того, вы можете выбрать один из этих запросов, чтобы он отображалась в селекторе запросов.
Запросы, сохраненные в разделе "Общие запросы" , могут просматриваться всеми пользователями с доступом к проекту. Общие запросы могут быть организованы в папках и избранном вами или командой. Кроме того, вы можете задать разрешения для папок и запросов, чтобы запретить другим пользователям перемещать или изменять их.
Дополнительные сведения см. в разделе:
- Управление запросами и папками запросов
- Настройка разрешений запроса
- Избранное запроса и настройка личного или командного избранного
Каталог запросов, папки запросов и элементы навигации
Страница "Запросы " содержит представление, ориентированное на каталог, которое можно фильтровать, чтобы найти конкретные запросы, интересующие вас. При работе на страницах запросов можно перейти к подпапке, папке или странице.
Кроме того, вы можете выбрать запрос, который вы выбрали из меню селектора. Вы также можете просмотреть все запросы, возвращающие вас на страницу "Все запросы ".
Дополнительные сведения см. в разделе "Часто задаваемые вопросы о запросах", "Навигация" и "Папки".
Диаграммы запросов и мини-приложения
Вы можете быстро создавать круговые, линейчатые, сводные и трендовые диаграммы из запроса с неструктурированным списком. Запросы должны быть неструктурированными и возвращать 1000 или меньше рабочих элементов. Вы можете добавить диаграммы запросов на панель мониторинга, повторить попытку и перенастроить их.
Мини-приложения на основе запросов обеспечивают поддержку представления сведений о запросах на панели мониторинга. Например, количество активных ошибок или список рабочих элементов, с которыми можно взаимодействовать. Дополнительные сведения о диаграммах запросов и мини-приложениях см. в следующих статьях:
- Диаграмма запроса с неструктурированным списком
- Диаграмма для мини-приложения рабочих элементов
- Мини-приложение результатов запроса
- Мини-приложение плитки запроса
Добавление настраиваемого поля для поддержки запросов
Сведения о добавлении настраиваемого поля для поддержки потребностей запроса см. в статье "Настройка процесса отслеживания работы".
Панель задач и элементы списка запросов
Вы можете заметить и задаться вопросом, почему содержимое области задач отличается от содержимого, указанного с созданным запросом? Дополнительные сведения см. в разделе "Элементы панели задач" и "Элементы списка запросов".
Запросы полнотекстового поиска и параметры сортировки
Чтобы поддерживать запросы полнотекстового поиска, параметры сортировки базы данных SQL Server должны соответствовать языку, который имеет средство разбиения слов, зарегистрированное в SQL Server. Если вы используете неподдерживаемый язык, при выполнении запроса рабочего элемента можно получить непредвиденные результаты, указывающие операторы "Содержит " или "Содержит слова " с текстовыми строками.
Дополнительные сведения см. в следующих статьях:
REST API
Сведения о программном взаимодействии с запросами см. в одном из следующих ресурсов REST API:
- Справочник по REST API Azure DevOps Services
- Запросы
- Язык запросов рабочих элементов
- Извлечение рабочих элементов с помощью запросов программным способом