Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервисы 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)
Заметка
- Сведения об изменении значений списка выбора: для облачных служб или унаследованного процесса см. в разделе "Добавление полей" и "Управление ими"; для локального xml-процесса используйте добавление или изменение поля, настройте список выбора.
- На странице "Емкость" отображается объединение всех значений, определенных для этого поля в проектах в коллекции проектов. Чтобы ограничить значения, отображаемые на странице емкости, сделайте значения соответствующими всем командам, которым назначено
type="Activity"поле. - Сведения об изменении назначения поля ProcessConfiguration (только в локальной среде) см. в справочнике по XML-элементу конфигурации процесса.
- Каждая команда настраивает, как ошибки должны вести себя — подобно требованиям или задачам. Так как ошибки могут проявляться как на одном уровне, так и на другом, поля для оценки усилий на обоих уровнях включены в форму рабочего элемента.
Следующий шаг
Использование ИИ для запроса числовых полей
Если у вас есть 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 используют естественный язык, чтобы настроить эти запросы или задать дальнейшие вопросы, чтобы уточнить результаты.
Связанный контент
- Создание бэклога
- планировочных спринтов
- планирование емкости
- Определение запроса рабочего элемента
- поля запроса, операторы и макросы
- Поддержка свертывания работы и других полей
- Создание сводных диаграмм с Power BI
REST API
Сведения о программном взаимодействии с запросами см. в одном из следующих ресурсов REST API:
- Справочник по REST API службам Azure DevOps Services
- Запросы
- язык запросов для рабочих элементов
- Получение рабочих элементов с помощью запросов программно