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

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

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

Примечание

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

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

Предложения запросов, указывающие поле журнала , могут использовать операторы Contains Words и Not ContainS 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*.
  • Редактор запросов игнорирует распространенные слова или останавливает слова, как определено в разделе "Настройка стоп-слов и списков стоп-слов" и "Управление ими" для поиска 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 вместе с TitleDescriptionSteps to Repro полями и полями автоматически индексируются для полнотекстового поиска, как описано в полях запроса, операторах и макросах.

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=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: