Запрос по числовым полям

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

Узнайте, как выполнять запросы по числовым полям, таким как усилия, оценки расписания, story points или поля отслеживания времени в Azure Boards и Azure DevOps.

Подсказка

Вы можете использовать ИИ, чтобы помочь с этой задачей позже в этой статье или ознакомиться с включение помощи ИИ в Azure DevOps MCP Server, чтобы начать работу.

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

Необходимые условия

Категория Требования
Членство в проекте Вы должны быть добавлены как участник проекта.
Уровни доступа — Для просмотра и выполнения общих запросов: необходимо быть членом Project.
— Чтобы добавить и сохранить общий запрос: у вас должен быть по крайней мере базовый доступ.
Разрешения Убедитесь, что для папки, в которую вы хотите добавить запрос, разрешение Contribute установлено в значение Allow. Вашей организации может потребоваться вручную настроить группу участников , чтобы предоставить это разрешение.

Заметка

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

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

Заметка

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

Использование операторов и макросов

Операторы, поддерживаемые в предложениях, содержащих ссылки на числовые поля:

  • =, <>, >, <, >=, <=
  • =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
  • In, Not In
  • Was Ever

Разработка запросов на основе диаграмм

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

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

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

Использование фильтров

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

Фильтр для

Включить эти условия запроса

Истории пользователей или ошибки

Work Item Type In User Story,Bug

Задачи или ошибки

Work Item Type In Task,Bug

Элементы, активные или закрытые

State In Active,Closed

Элементы в категории "Требования"

Work Item Type In Group Microsoft.RequirementCategory

Неоцененные истории пользователей

Story Points <> (leave Value field blank)


Запрос количества рабочих элементов

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

Снимок экрана: запрос на ошибки в любом состоянии со сводкой по количеству рабочих элементов.

Диаграммы также включают выбор значений для отображения количества рабочих элементов.

Запрос количества ошибок по разработчикам

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

Снимок экрана, показывающий диалоговое окно

Запрос на количество ошибок по статусу и области

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

Снимок экрана: диалоговое окно

Запрос для неопределенных значений полей

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

Снимок экрана с фильтром, где значение «Точки истории» отсутствует.

Чтобы найти элементы, в которых поле не пусто, используйте оператор <> not и оставьте значение пустым.

Запрос усилий или точек истории

Назначение стори поинтов пользовательским историям или багам в рамках Agile-процесса. Используйте усилия для элементов невыполненной работы продукта и ошибок в процессе Scrum. Дополнительные сведения см. в разделе "Базовый", " Гибкий", " Scrum" или CMMI.

Запрос суммы точек истории и их состояния

Создайте запрос, который фильтрует историю пользователя и добавляет точки истории и состояние в столбцы.

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

Затем добавьте столбчатую диаграмму с накоплением, которая суммирует Story Points.

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

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

Запрос на диаграмму сгорания пользовательских историй для итерации

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

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

Затем добавьте слоистую диаграмму тренда, которая суммирует Story Points.

Снимок экрана: диалоговое окно

Запрос на незавершенные и завершенные работы

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

Процесс Доступные поля
Гибкий Исходная оценка, оставшаяся работа, завершенная работа
Скрам Оставшиеся работы
CMMI Исходная оценка, оставшаяся работа, завершенная работа

Сумма оставшихся работ на разработчика

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

Снимок экрана, показывающий запрос задач и ошибок для спринта.

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

Снимок экрана: диалоговое окно

Для спринтовых диаграмм выполнения, определяемых системой, см. Sprint burndown.

Поля, используемые для оценки и отслеживания работы

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

имя поля

Описание

Тип рабочего элемента


Действие 1, 2

Действие, необходимое для выполнения задачи. Сведения о планировании емкости см. в разделе "Планирование емкости". Допустимые значения:

  • Развёртывание
  • Дизайн
  • Развитие
  • Документация
  • Требования
  • Тестирование

Поле действия сопоставляется с Activity файлом ProcessConfiguration.3

Эталонное имя=Microsoft.VSTS.Common.Activity, тип данных=String

Задача, баг4 (Agile и Scrum)

Ценность бизнеса

Субъективная мера относительной бизнес-ценности для элемента списка задач продукта или фичи. Более высокие числа указывают на более высокое относительное значение.

Эталонное имя=Microsoft.VSTS.Common.BusinessValue, тип данных=целое число

Эпик, Функция

Выполненная работа

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

имя ссылки=Microsoft.VSTS.Scheduling.CompletedWork, тип данных: Double

Задача, ошибка4

Дисциплина 1, 2

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

  • Анализ
  • Развитие
  • Тест
  • Обучение пользователей
  • Взаимодействие с пользователем

Поле "Дисциплина" соответствует Activity в файле ProcessConfiguration.3

Эталонное имя=Microsoft.VSTS.Common.Discipline, тип данных=String

Задача, ошибка 4 (CMMI)

Усилие

Субъективная мера размера ошибки или элемента невыполненной работы продукта. Используйте трудозатраты для вычисления командной скорости и составления прогнозов; это сопоставляется с Effort в файле ProcessConfiguration.

Эталонное имя=Microsoft.VSTS.Scheduling.Effort, тип данных=Double

Элемент бэклога продукта, баг 4 (Scrum)

Фича, Эпик

Точки истории

Субъективная мера размера истории пользователя. Story Points влияют на скорость работы команды и прогнозирование, сопоставляются с Effort в файле ProcessConfiguration.

Эталонное имя=Microsoft.VSTS.Scheduling.StoryPoints, тип данных=Double

История пользователя, ошибка 4 (Agile)

Размер

Субъективная мера размера требования. Размер способствует скорости и сопоставляется с Effort в файле ProcessConfiguration.

Эталонное имя=Microsoft.VSTS.Scheduling.Size, тип данных=Double

Требование, ошибка 4 (CMMI)

Исходная оценка

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

Эталонное имя=Microsoft.VSTS.Scheduling.OriginalEstimate, тип данных=Double

Задача, ошибка 4 (agile и CMMI)

оставшиеся работы

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

Заметка

Для Azure Boards на доске задач отображается "h" (часы) для оставшейся работы. Для настройки локального XML-процесса можно изменить файл ProcessConfiguration, чтобы изменить обозначение (например, "d" для дней).

Эталонное имя=Microsoft.VSTS.Scheduling.RemainingWork, тип данных=Double

Задача, ошибка4

Требуется проверка

Указывает, что задача требует проверки. Допустимые значения: да или нет (по умолчанию).

Эталонное имя=Microsoft.VSTS.CMMI.ТребуетОбзора, тип данных=строка

Задача (CMMI)

Требуется тест

Указывает, что для задачи требуется тест. Допустимые значения: да или нет (по умолчанию).

Эталонное имя=Microsoft.VSTS.CMMI.RequiresTest, тип данных=String

Задача (CMMI)

Тип задачи1

Указывает тип задачи. Допустимые значения:

  • Корректирующее действие
  • Действие по устранению рисков
  • Запланированный

Эталонное имя=Microsoft.VSTS.CMMI.TaskType, тип данных=String

Задача, ошибка4 (процесс CMMI)

Заметка

  1. Сведения об изменении значений списка выбора: для облачных служб или унаследованного процесса см. в разделе "Добавление полей" и "Управление ими"; для локального xml-процесса используйте добавление или изменение поля, настройте список выбора.
  2. На странице "Емкость" отображается объединение всех значений, определенных для этого поля в проектах в коллекции проектов. Чтобы ограничить значения, отображаемые на странице емкости, сделайте значения соответствующими всем командам, которым назначено type="Activity"поле.
  3. Сведения об изменении назначения поля ProcessConfiguration (только в локальной среде) см. в справочнике по XML-элементу конфигурации процесса.
  4. Каждая команда настраивает, как ошибки должны вести себя — подобно требованиям или задачам. Так как ошибки могут проявляться как на одном уровне, так и на другом, поля для оценки усилий на обоих уровнях включены в форму рабочего элемента.

Следующий шаг

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

Если у вас есть Azure Boards MCP Server, подключённый к агенту ИИ в агентном режиме, вы можете использовать запросы на естественном языке для поиска рабочих элементов на основе усилий, story points и полей отслеживания времени.

Задача Пример запроса
Элементы, требующие больших усилий Find all user stories with story points greater than 8 that are still active
Проверка точности оценки List tasks where completed work exceeds the original estimate
Отслеживание оставшейся работы Show active sprint tasks with remaining work greater than zero
Поиск неоцененных элементов Find user stories where the effort field is empty or not set
Вычисление емкости спринта Show total story points committed vs completed for the current sprint in <Contoso>
Узнайте оценки выбросов List tasks in <Contoso> where remaining work is greater than 16 hours
Сумма усилий по назначению Show total story points assigned to each team member in the current sprint for <Contoso>
Идентифицировать неотслеженное время List active tasks in the current sprint for <Contoso> that have original estimate set but completed work is still zero
Сравнение усилий между спринтами Show total story points completed per sprint for the last 4 sprints in <Contoso>
Поиск несоответствий размеров List user stories in <Contoso> with story points of 1 that have more than 3 child tasks

Заметка

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

REST API

Сведения о программном взаимодействии с запросами см. в одном из следующих ресурсов REST API: