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

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

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

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

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

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

  • =, , <> < > >= ,<=
  • =[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 , =а затем оставить значение для поля пустым. Например, в следующих фильтрах перечислены все рабочие элементы типа User Stories, поле "Точки истории", поле "Точки истории" является пустым.

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

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

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

При работе с гибким процессом можно назначить точки истории или ошибки пользователей. Кроме того, при работе с процессом Scrum вы можете использовать элементы невыполненной работы и ошибки. Дополнительные сведения см. в статьях "Базовый", "Гибкий", "Scrum" или "CMMI" и "Рабочие процессы".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Снимок экрана: запрос задач и ошибок для спринта.

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

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

Сведения о системных диаграммах спринта сгоревшего спринта см. в статье Sprint burndown.

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

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

Имя поля

Description

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


Действие 1, 2

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

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

Поле действия назначается Activity в файле ProcessConfiguration.3

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

Задача, ошибка4 (гибкая и scrum)

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

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

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

Epic, Feature

Завершенная работа

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

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

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

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

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

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

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

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

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

Трудозатраты

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

Это поле 3 также используется для вычисления скорости команды и прогнозирования. Он назначается Effort в файле ProcessConfiguration.

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

Элемент невыполненной работы продукта, ошибка 4 (scrum)

Функция, Эпическая

Баллы истории

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

Это поле 3 также используется для вычисления скорости команды и прогнозирования. Он назначается Effort в файле ProcessConfiguration.

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

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

Размер

Субъективная единица измерения, которая фиксирует размер требования. Чем больше размер, тем больше работы требуется для реализации.

Это поле3 также используется для вычисления скорости команды и прогнозирования. Он назначается Effort в файле ProcessConfiguration.

Имя ссылки=Microsoft.VSTS. Планирование. Размер, тип данных=Double

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

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

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

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

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

Оставшиеся трудоемкие

Объем работы, остающейся для завершения задачи. Вы можете указать работу в часах или в днях. Не существует встроенных единиц времени, связанных с этим полем. Это поле 3 также используется для вычисления сожжения. Он назначается type="RemainingWork" в файле ProcessConfiguration.

Примечание.

Для Досок Azure в области задач всегда отображается "h" в течение нескольких часов в связи с оставшейся работой. Для TFS можно изменить файл ProcessConfiguration для поля "Оставшийся рабочий тип", чтобы указать "d" в течение нескольких дней или другую предпочтительную метку.

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

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

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

Указывает, что задача требует проверки. Можно указать да или нет (по умолчанию).

Эталонное имя=Microsoft.VSTS.CMMI.ТребуетСяReview, тип данных=String

Задача (CMMI)

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

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

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

Задача (CMMI)

Типзадачи 1

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

  • Действие по исправлению
  • Действие по устранению рисков
  • Плановое

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

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

Примечание.

  1. Чтобы изменить выбор меню: для облачных служб или унаследованного процесса см. статью "Добавление полей и управление ими", а также для локального XML-процесса, см . статью "Добавление или изменение поля", настройка списка выбора.
  2. Значения, отображаемые на странице емкости для действия (Agile или Scrum) или Дисциплины (CMMI), отражают объединение всех значений, определенных для поля во всех проектах в экземпляре коллекции проектов. Таким образом, чтобы ограничить значения, отображаемые для емкости на страницах невыполненной работы с спринтом, необходимо сопоставить значения во всех проектах, назначенных полю type="Activity".
  3. Чтобы изменить назначение поля ProcessConfiguration (только в локальной среде), ознакомьтесь со ссылкой на XML-элемент конфигурации процесса.
  4. Каждая команда может настроить свои средства Гибкой разработки, чтобы определить, обрабатываются ли ошибки, аналогичные требованиям или задачам. Так как ошибки могут отображаться как с требованиями, так и с задачами, поля, используемые для оценки усилий на уровне требований и уровне задач, включаются в форму рабочего элемента.

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

REST API

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