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

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

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

  • Число вложенных файлов
  • (Обсуждение) Количество комментариев
  • Число внешних ссылок
  • Подсчет гиперссылок
  • Комментарий ссылки
  • Подсчет связанных ссылок
  • Число удаленных ссылок
  • Число вложенных файлов
  • (Обсуждение) Количество комментариев
  • Число внешних ссылок
  • Подсчет гиперссылок
  • Комментарий ссылки
  • Подсчет связанных ссылок

Описания каждого из этих полей см. в таблице, предоставленной далее в этой статье.

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

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

= , <> , > , < , >= , <= ,
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field],
In, Not In,
Was Ever

Вы можете фильтровать рабочие элементы по типу ссылки, количеству ссылок или количеству вложений.


::: moniker-end

Перечисление иерархических элементов в древовидном представлении

Добавьте запрос и выберите Дерево рабочих элементов , чтобы начать запрос. Вы увидите примерно следующее:

Примечание

Невозможно создать запрос, отображающий иерархическое представление Test Plans, наборов тестов и тестовых случаев. Эти элементы не связаны друг с другом с помощью типов ссылок "родители-потомки". Тем не менее можно создать запрос прямых ссылок, который выводит список рабочих элементов, связанных с тестом. Кроме того, вы можете просмотреть иерархию на странице Тест> Test Plans.

Оттуда можно добавить предложения запросов или изменить параметры фильтра для связанных рабочих элементов.

Фильтр для

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

Просмотр только дочерних элементов рабочего элемента 645

Добавьте в фильтр для рабочих элементов верхнего уровня:
ID = 645

Задачи или ошибки

Добавьте в раздел Фильтры для связанных рабочих элементов:
Work Item Type In Task,Bug

Элементы, назначенные моей команде (Интернет)

Добавьте к верхним и нижним фильтрам:
Assigned to In Group [Fabrikam Fiber]\Web

Родительские элементы задач, назначенных мне

Изменение параметров фильтра для сопоставления связанных рабочих элементов
Добавьте в раздел Фильтры для связанных рабочих элементов:
Assigned To = @Me

Список элементов на основе связанных зависимых элементов

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

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

Снимок экрана: Редактор запросов, рабочие элементы и прямые ссылки, веб-портал.

Как это работает:

  • Если установить флажок Запрашивать по проектам , можно перечислить все зависимые связанные рабочие элементы, соответствующие критериям фильтра, независимо от того, к какому проекту они относятся.

  • Если указать путь к области в предложении Fabrikam , можно найти только рабочие элементы, связанные с рабочими элементами, определенными в проекте Fabrikam.

  • Если указать только возвращаемые элементы, имеющие соответствующие ссылки, и Возвращать выбранные типы ссылок , запрос возвращает только рабочие элементы, связанные на основе типов ссылок "Предшественник" и "Преемник ".

Вывод списка потерянных пользовательских историй

Если вы обычно упорядочивают пользовательские истории по функциям, вы можете быстро найти пользовательские истории, которые являются потерянными, открыв невыполненную работу по продукту, включите параметр "Родители в режиме просмотра" и прокрутите вниз до раздела, в который перечислены неродовые истории (Agile) или Элементы невыполненной работы без родителей (Scrum).

Вывод списка потерянных историй или элементов невыполненной работы

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

Снимок экрана: Редактор запросов, рабочие элементы и прямые ссылки, веб-портал, истории пользователей без дедушки.

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

Число вложенных файлов

Число файлов, вложенных в рабочий элемент и хранимых в базе данных отслеживания рабочих элементов.
Reference Name=System.AttachedFileCount, Data type=Integer

Примечание

Для Azure Boards (облачная служба) можно добавить до 100 вложений в рабочий элемент. Попытки добавить дополнительные данные приводят к сообщению об ошибке при сохранении рабочего элемента.

Все

Количество комментариев

Количество примечаний, добавленных в раздел Обсуждение рабочего элемента.
Reference Name=System.CommentCount, Data type=Integer

Все

Подсчет внешних ссылок

Количество ссылок из рабочего элемента на артефакты, которые не являются рабочими элементами. такие как запросы на вытягивание, фиксации, наборы изменений или другие типы ссылок.
Reference Name=System.ExternalLinkCount, Data type=Integer

Все

Подсчет гиперссылок

Число гиперссылок, определенных для рабочего элемента.

Reference Name=System.HyperLinkCount, Data type=Integer

Все

Примечания ссылки

Содержит комментарии члена команды, создавшего ссылку. Это поле можно настроить так, чтобы оно отображалось в виде столбца в списке ссылок в форме рабочего элемента. (Не поддерживается в редакторе запросов.)

Reference Name=System.Links.Comment, Data type=PlainText

Все

Описание ссылки

Содержит тип, идентификатор и заголовок рабочего элемента, целевого для ссылки. Это поле можно настроить так, чтобы оно отображалось в виде столбца в списке ссылок в форме рабочего элемента. (Не поддерживается в редакторе запросов.)

Reference Name=System.Links.Description, Data type=PlainText

Все

Parent

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

Примечание

Вы можете добавить поле Parent в качестве столбца или указать его в предложении запроса, указав идентификатор родительского рабочего элемента.
Reference Name=System.Parent, Data type=Integer

Все

Parent

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

Примечание

Поле Родитель доступно с Azure DevOps Server 2020 и более поздних версий. Это поле нельзя указать в предложении запроса.
Reference Name=System.Parent, Data type=Integer

Все

Подсчет связанных ссылок

Количество ссылок, определенных для рабочего элемента, в которых используется тип рабочей ссылки, например "родитель-потомок", "предшественник-преемник" и "связанный". Полный список см. в справочнике по типу ссылок.
Reference Name=System.RelatedLinkCount, Data type=Integer

Все

Число удаленных ссылок

Доступно только для Azure DevOps Services. Количество ссылок из рабочего элемента на рабочие элементы, определенные в другой организации. Организации должны управляться той же службой Azure Active Directory. Поддерживаемые типы ссылок включают Использование из, Создано для и Удаленно связанные. Дополнительные сведения см. в статье Добавление ссылки на рабочие элементы, ссылка на удаленный рабочий элемент.
Reference Name=System.RemoteLinkCount, Data type=Integer

Все

Вы можете просмотреть связанные рабочие элементы и объекты в форме рабочего элемента, установив расширение визуализации рабочих элементов , доступное на вкладке Azure DevOps в Visual Studio Marketplace.

Сведения о добавлении типов ссылок см. в разделе Управление типами ссылок [witadmin].

Все вкладки, поддерживающие создание связей между рабочими элементами, реализуются с помощью элемента LinksControl в форме рабочего элемента. Этот элемент управляет фильтрацией и ограничением типов рабочих элементов, с которыми можно связаться, типами ссылок, которые можно создавать, а также возможностью связывания с рабочими элементами в другом проекте. Чтобы настроить элементы управления связью и ограничения, измените LinksControlOptions определение для типа рабочего элемента, см. статью XML-элементы LinksControlOptions.

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