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

  • Статья

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

Фильтр для

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

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

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 и управление ими.
  • На панели инструментов редактора запросов выберите Выполнить запрос или Выполнить запрос, значок более ранней версии и убедитесь, что запрос возвращает ожидаемые результаты.
  • Если вы не получите ожидаемые результаты, измените введенную фразу или слово и выполните запрос еще раз.

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

Имя поля

Описание

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

Изменил

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

Reference name=System.ChangedBy, Data type=String

Все

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

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

Reference name=System.ChangedDate, Data type=DateTime

Все

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

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

Все

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

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

Reference name=System.CreatedDate, Data type=DateTime

Все

Журнал

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

Примечание

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

Вы не можете добавить форматированный текст в поле журнала. После сохранения рабочего элемента вы не сможете изменить журнал.
Поле History вместе с полями Descriptionи Steps to ReproTitle автоматически индексируется для полнотекстового поиска, как описано в разделе Поля запроса, операторы и макросы.

Reference name=System.History, Data type=History

Все

Дата разрешения 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

Все

Дата последнего изменения

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

Reference name=System.RevisedDate, Data type=DateTime

Общий параметр, общий шаг, тестовый случай

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

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

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

Все

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

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

Набор тестов

Водяной знак

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

Все

Примечание

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

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

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

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