Добавление тегов рабочих элементов для классификации и фильтрации списков и информационных панелей

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

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

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

Вы можете добавлять и изменять теги на веб-портале из подключаемого модуля Team Обозреватель для Visual Studio. Кроме того, вы можете открыть запрос в Excel для массового изменения тегов.

Примечание.

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

Необходимые компоненты

  • Необходимо добавить в проект.
  • Чтобы просмотреть или изменить рабочие элементы, необходимо иметь рабочие элементы Представления в этом узле и изменить рабочие элементы в разрешениях этого узла, для которых задано значение Allow. По умолчанию группа участников имеет этот набор разрешений. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
  • Чтобы добавить новые теги для добавления в рабочие элементы, необходимо иметь базовый доступ или более высокий уровень и иметь разрешения на создание нового определения тегов проекта, заданных в значение Allow. По умолчанию группа участников имеет этот набор разрешений. Даже если разрешение явно задано для заинтересованных лиц, у них нет разрешения на добавление новых тегов, так как они запрещены на уровне доступа. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
  • Все члены проекта, даже члены группы читателей , могут отправлять сообщения электронной почты, содержащие рабочие элементы.
  • Необходимо добавить в проект.
  • Чтобы просмотреть или изменить рабочие элементы, необходимо иметь рабочие элементы Представления в этом узле и изменить рабочие элементы в разрешениях этого узла, для которых задано значение Allow. По умолчанию группа участников имеет этот набор разрешений. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
  • Чтобы добавить новые теги для добавления в рабочие элементы, необходимо иметь базовый доступ или более высокий уровень и иметь разрешения на создание нового определения тегов проекта, заданных в значение Allow. По умолчанию группа участников имеет этот набор разрешений. Даже если разрешение явно задано для заинтересованных лиц, у них нет разрешения на добавление новых тегов, так как они запрещены на уровне доступа. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
  • Все члены проекта, даже члены группы читателей , могут отправлять сообщения электронной почты, содержащие рабочие элементы.
  • Пользователи с доступом заинтересованных лиц для общедоступных проектов могут добавлять новые теги.
  • По умолчанию всем участникам и заинтересованным лицам общедоступных проектов предоставляются разрешения на добавление новых и существующих тегов. Заинтересованные лица в частных проектах могут добавлять теги, которые уже определены, но не новые теги. Чтобы предоставить или ограничить разрешения на создание новых тегов, необходимо задать определение тега create на уровне проекта. Дополнительные сведения см. в разделе "Изменение разрешений на уровне проекта".

Добавление тегов в рабочий элемент

Теги должны иметь 400 символов или меньше, а не содержать разделителей, таких как , (запятая), ; (точка с запятой) или другой символ форматирования.

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

На веб-портале откройте рабочий элемент и добавьте тег. Выберите "Добавить тег" и введите ключевое слово. Или выберите из списка ранее назначенных тегов.

Снимок экрана: добавление одного или нескольких тегов в рабочий элемент.

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

Теги, которые отображаются в строке тегов, уже назначены рабочему элементу. Чтобы отменить назначение тега, выберите x в тегеСнимок экрана: удаление тега, назначенного рабочему элементу..

Массовое добавление или удаление тегов

Рабочие элементы массового обновления можно добавлять или удалять на веб-портале. Массовые изменения тегов аналогично массовому изменению других полей с помощью веб-портала. Кроме того, вы можете использовать Excel для массового добавления или удаления тегов.

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

Примечание.

Массовое изменение тегов из Visual Studio или других поддерживаемых клиентов не поддерживается.

Запрос рабочих элементов на основе тегов

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

Совет

Чтобы понять, как AND/OR группируются предложения, см. статью "Создание и сохранение управляемых запросов", предложений групп. Чтобы просмотреть синтаксис WIQL для запроса, установите расширение редактора запросов WIQL, которое позволяет просмотреть версию WIQL любой записи редактора запросов.

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

Например, здесь мы запрашиваем все рабочие элементы, помеченные WebServiceлибо.

Снимок экрана: Редактор запросов для запроса к тегам.

Примечание.

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

Отображение тегов в результатах невыполненной работы или запроса

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

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

Отображаются все теги, добавленные в перечисленные рабочие элементы.

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

Списки фильтров с помощью тегов

На веб-портале можно фильтровать невыполненные работы, доски и результаты запроса с помощью тегов.

Начните с выбора фильтра .

Установите флажки этих тегов, которые необходимо отфильтровать. Сохраните выбор OR , чтобы запустить логический ИЛИ для всех выбранных тегов. Или выберите параметр AND , чтобы запустить логический и на всех выбранных тегах.

Снимок экрана: просмотр с добавленным столбцом тегов.

Удаление, удаление и управление тегами

Теги нельзя удалить с помощью веб-интерфейса Azure DevOps.

Если необходимо удалить тег, можно создать скрипт или приложение, которое может удалить с помощью REST API Azure DevOps или клиентских библиотек .NET. Дополнительные примеры см. в статье Azure-DevOps-Администратор-CLI.

Другой вариант — установить диспетчер тегов Marketplace, который добавляет страницу тегов в boards или Work для управления тегами, включая удаление.

Теги цветового кода на досках

Выделите теги на доске Kanban карта, закодив их цветом. Эти цвета отображаются только на настраиваемой доске Kanban. Они не отображаются в невыполненных журналах или досках задач. Дополнительные сведения см. в разделе "Настройка карта", тегов цветового кода.

Снимок экрана: последовательность, доски, Параметры, диалоговое окно

Диаграмма рабочих элементов и группирование по тегам

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

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

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

Ограничения на количество тегов

Хотя не существует жесткого ограничения, создание более 100 000 тегов для коллекции проектов может отрицательно повлиять на производительность. Кроме того, раскрывающееся меню автозаполнения для элемента управления тегами отображает не более 200 тегов. Если определены более 200 тегов, начните вводить, чтобы элемент управления тегами отображал соответствующие теги.

Не удается назначить более 100 тегов рабочему элементу или вы получите следующее сообщение:

TF401243: Failed to save work item because too many new tags were added to the work item.

Сохраните рабочий элемент с тегами (100 или меньше), которые вы добавили, а затем можно добавить дополнительные теги.

Ограничить запросы менее чем 25 тегами. Больше, чем эта сумма, и запрос, скорее всего, истекает.

Добавление тегов в представление столбцов по умолчанию в невыполненной работы продукта

Чтобы добавить поле "Теги" в качестве поля столбца для невыполненной работы продукта, измените файл ProcessConfiguration, чтобы включить System.Tags. Дополнительные сведения см. в справочнике по XML-элементу конфигурации процесса.

Расширение Marketplace