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

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

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

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

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

Примечание.

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

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

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

Примечание.

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

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

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

Совет

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

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

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

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

Примечание.

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

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

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

Примечание.

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

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

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

Совет

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

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

Совет

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

Связанные статьи

• Вывод списка запросов и управление ими с помощью редактора запросов
• Отображение тегов в карта
• Массовое изменение рабочих элементов на веб-портале
• Массовое изменение рабочих элементов из Excel

Расширение Marketplace

• Диспетчер тегов Marketplace

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

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

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

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

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

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