Запросы к журналам рабочих элементов и полям обсуждения в Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

Примечание

Поле рабочего элемента "Обсуждение" отсутствует. Чтобы запросить рабочие элементы с комментариями, введенными в области обсуждений, отфильтруйте поле "Журнал". Полное содержимое текста, введенного в текстовое поле "Обсуждение", добавляется в поле "Журнал".

Поддерживаемые операторы и макросы

Предложения запроса, указывающие поле журнала , могут использовать операторы Contains Words и Not Contain Words . Выполните поиск по точной фразе или используйте подстановочный знак *. Подстановочный знак можно использовать только в конце частичного слова или фразы.

Поле журнала автоматически индексируется для полнотекстового поиска, если доступен полнотекстовый поиск. См. Full-Text и частичный поиск слов

Запрос журнала рабочего элемента

Вы можете использовать веб-портал или Team Explorer для просмотра журнала рабочего элемента или поиска рабочих элементов на основе содержимого поля журнала . При выполнении поиска по содержимому поля журнала он возвращает только рабочие элементы, которые имеют изменения, записанные в этом поле. То есть он не регистрирует изменения, внесенные в текст в других полях.

Снимок экрана: Редактор запросов для поиска элементов на основе слов, содержащихся в поле

Перечисление элементов на основе содержимого поля "Журнал"

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

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

Фильтр для

Включить эти предложения запроса


Элементы, поле журнала которых содержит слово "воспроизводимый"

History Contains Words reproducible

Элементы, поле журнала которых не содержит слово "бета-версия"

History Does Not Contain Words beta

Элементы, содержащие фразу "трассировки стека" и закрытые, но повторно активированные

History Contains Words stack traces And State Was Ever Closed
And State <> Closed

Элементы, закрытые в течение указанного периода времени

State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015

Элементы, с которыми я был связан

History Contains Words MyName
Or Assigned To Was Ever _ @Me


Советы по использованию редактора запросов

  • Введите полное слово или фразу, указанную в поле "Журнал " тех рабочих элементов, которые требуется найти.
  • Введите полный текст для слова, которое требуется найти. Поле журнала индексируется для полнотекстового поиска. Если ввести только частичное слово, запрос не вернет рабочие элементы, содержащие полное слово. Например, если поле "Журнал " содержит воспроизводимое поведение фразы и выполняется поиск по запросу repro, рабочий элемент не будет найден. Однако при поиске полного слова, воспроизводимого, будет найден рабочий элемент. Вы также можете выполнить поиск строки с подстановочными знаками, например repro*.
  • Редактор запросов игнорирует распространенные слова или останавливает слова, как определено в разделе "Настройка стоп-слов и списков стоп-слов и списков стоп-слов" для поиска Full-Text.
  • На панели инструментов редактора запросов выберите или " Выполнить запрос и убедитесь, что запрос возвращает ожидаемые результаты.
  • Если вы не получите ожидаемые результаты, измените введенную фразу или слово и запустите запрос еще раз.

Просмотр журнала рабочих элементов

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

Отображаемые сведения журнала зависят от платформы, версии и клиента.

Снимок экрана: форма рабочего элемента, веб-портал, вкладка

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

Снимок экрана: форма рабочего элемента, веб-портал, схема журнала изменений состояния (только веб-портал).

Выберите запись в левой области, чтобы просмотреть сведения о внесенных изменениях.

Снимок экрана: форма рабочего элемента, вкладка

Фильтрация представления журнала

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

Примечание

Для включения функции фильтра toggle требуется включить предварительную версию функции New Boards Hub . Сведения о включении этой функции см. в статье "Управление и включение функций".

Чтобы включить функцию фильтра, выберите переключатель фильтра.

Снимок экрана: форма рабочего элемента, вкладка

Чтобы просмотреть обновления для определенных пользователей, выберите их имена в меню "Обновлено".

Снимок экрана: форма

Чтобы просмотреть обновления, внесенные в одно или несколько полей, выберите поля в меню "Поля ".

Снимок экрана: форма

Поля, поддерживающие отслеживание журнала, аудита и исправления

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

Имя поля

Описание

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


Изменил

Имя члена команды, выполнившего последнее изменение рабочего элемента.

Reference name=System.ChangedBy, Data type=String

All

Дата изменения

Дата и время изменения рабочего элемента.

Reference name=System.ChangedDate, Data type=DateTime

All

Дата закрытия 1

Дата и время закрытия рабочего элемента.
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

All

"Дата создания";

Дата и время создания рабочего элемента.

Reference name=System.CreatedDate, Data type=DateTime

All

Журнал

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

Примечание

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

Нельзя добавить форматированный текст в поле журнала. Сохранив рабочий элемент, вы не сможете изменить журнал.
Поле History вместе с TitleDescriptionSteps to Repro полями и полями автоматически индексируются для полнотекстового поиска, как описано в полях запроса, операторах и макросах.

Reference name=System.History, Data type=History

All

Дата разрешения 1

Дата и время перемещения рабочего элемента в разрешенное состояние.

Reference name=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

Ошибка (Agile, CMMI)

Редакция

Номер, присвоенный редакции рабочего элемента.

Примечание

Ограничение на редакцию рабочих элементов в 10 000 действует для обновлений, внесенных через REST API для Azure DevOps Services. Это ограничение ограничивает обновления из REST API, однако обновления с веб-портала не затрагиваются.

Reference name=System.Rev, Data type=Integer

All

Дата изменения состояния

Дата и время изменения значения в поле "Состояние".

Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

All

Аудит набора тестов

Отслеживает другие операции, выполняемые при изменении набора тестов, например добавление тестов в набор тестов или изменение конфигураций. Это поле можно просмотреть на через вкладке История или через отдельный запрос. Там будет консолидированное представление истории, в том числе изменения, проводимые с полями рабочих элементов и изменения в связанных артефактах, таких как тестовые точки и конфигурации.
Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

Набор тестов

Водяной знак

Управляемое системой поле (не редактируемое), которое увеличивается с изменениями, внесенными в рабочий элемент.
Reference name=System.Watermark, Data type=Integer

All

Примечание

  1. Чтобы эти поля были определены для WIT, они должны быть включены в WORKFLOW раздел определения WIT. Например, этот синтаксис включается в FIELDS определение при переходе в разрешенное состояние:

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">  
       <SERVERDEFAULT from="clock" />  
    </FIELD>  
    

API-интерфейсы REST

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