Использование шаблонов рабочих элементов

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 г.

Используйте шаблоны рабочих элементов для создания рабочих элементов с предопределенными значениями и применения согласованных обновлений между аналогичными элементами. В этой статье рассматриваются рабочие процессы шаблонов на веб-портале и для устаревших сред в Visual Studio 2015 или более ранних версий. Примеры см. в разделе "Примеры шаблонов рабочих элементов".

Для большинства команд используйте веб-портал. Используйте Visual Studio 2015 с Power Tools только если вы по-прежнему используете управление шаблонами на основе Team Explorer.

Шаблоны рабочих элементов отличаются от шаблонов процессов. Дополнительные сведения см. в разделе О процессах и шаблонах процессов и в руководстве по процессам по умолчанию для Basic, Agile, Scrum и Capability Maturity Model Integration (CMMI).

Tip

Вы можете использовать ИИ, чтобы помочь с этой задачей далее в этой статье или см. включение ИИ-помощи с помощью Azure DevOps MCP Server, чтобы приступить к работе.

Выбор рабочего процесса

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

Если вы хотите... Используйте... Почему
Создание, управление и применение шаблонов в текущих Azure DevOps Веб-портал (основной) Поддерживает шаблоны на уровне команды в стандартной веб-версии.
Повторно использовать общие значения по умолчанию для команды и типа рабочего элемента Сохраненные шаблоны Помогает командам применять согласованные поля и значения.
Поделитесь прямой ссылкой, которая открывает предварительно заполненный рабочий элемент URL-адреса шаблона Лучше всего использовать упрощенный общий доступ на панелях мониторинга, вики-сайтах и чатах.
Продолжить рабочие процессы на основе шаблонов в Team Explorer Visual Studio 2015 с Power Tools (устаревшая версия) Используйте только в том случае, если среда по-прежнему зависит от устаревших инструментов.

Предварительные условия

Workflow Requirements
Веб-портал (основной) — Доступ к Azure DevOps организации и проекту.
— Чтобы управлять шаблонами, будьте членом команды, которая владеет шаблонами.
— Чтобы применить шаблоны, у участника есть доступ к проекту.
— Используйте поддерживаемый браузер и откройте Azure DevOps на веб-портале.
Visual Studio 2015 с Power Tools (устаревшая версия) — Используйте этот рабочий процесс, только если среда по-прежнему зависит от управления шаблонами Team Explorer.
— Установите Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
— Шаблоны, созданные в этом рабочем процессе, являются областью действия пользователя и отображаются только в Team Explorer.

Ограничения для использования шаблонов

Шаблоны веб-портала и шаблоны Visual Studio являются отдельными хранилищами. Шаблон, созданный в одном клиенте, не отображается в другом клиенте.

Тип шаблона Scope Где вы можете управлять им Где его можно применить
Шаблон веб-портала В рамках команды Веб-портал Веб-портал
шаблон Visual Studio Область действия пользователя Visual Studio Visual Studio

URL-адрес любого типа шаблона можно использовать для создания рабочих элементов на веб-портале.

Поддерживаемые задачи шаблона

Доступность задач зависит от используемого клиента. Используйте веб-портал для основных рабочих процессов Azure DevOps и используйте Visual Studio 2015 с Power Tools только для устаревших сценариев.

В следующей таблице показана поддержка клиента.

Задача шаблона Веб-портал Visual Studio
Сохранение рабочего элемента в качестве шаблона ✅ Поддерживается ✅ Поддерживается
Управление шаблонами рабочих элементов
(Определение, изменение, удаление, копирование ссылки, создание копии и переименование)		 ✅ Поддерживается ✅ Поддерживается
Копирование ссылки (URL-адрес) шаблона ✅ Поддерживается ✅ Поддерживается
Добавление рабочего элемента с помощью шаблона ✅ Поддерживается ✅ Поддерживается
Определение шаблона рабочего элемента ✅ Поддерживается ✅ Поддерживается
Применение шаблона к одному или нескольким рабочим элементам ✅ Поддерживается ✅ Поддерживается
Добавление или удаление тегов из шаблонов ❌ Не поддерживается ✅ Поддерживается
Определение шаблона с гиперссылкой ✅ Поддерживается ❌ Не поддерживается

Сохранить рабочий элемент в качестве шаблона

Используйте процедуру, соответствующую клиенту: веб-портал (основной) или Visual Studio 2015 и более ранних версий (устаревшая версия).

Каждый шаблон, который вы записываете на веб-портале, получает уникальный GUID. Выполните следующие действия, чтобы записать рабочий элемент в качестве шаблона и скопировать ее ссылку.

  1. На веб-портале откройте рабочий элемент, который вы хотите использовать в качестве источника шаблона.

  2. Справа выберите "Другие действия>Шаблоны>Копирование:"

    Снимок экрана, показывающий, как выбрать определения полей рабочего элемента для захвата в качестве параметра шаблона из меню «Дополнительные действия».

  3. В шаблоне записи настройте обязательные и необязательные поля:

    • Команда (обязательно): выберите команду, чтобы связать ее с шаблоном.

    • Имя (обязательно): введите имя шаблона.

    • Поля. Используйте команду "Добавить " для включения полей, удаления полей и задания значения поля по мере необходимости.

    • Примечания. Добавление контекста шаблона. При создании рабочего элемента из шаблона этот текст отображается как первая запись в потоке обсуждения .

    Снимок экрана: настройка полей в диалоговом окне

  4. Нажмите кнопку "Сохранить", а затем нажмите кнопку "Копировать" , чтобы скопировать URL-адрес шаблона.

    Используйте URL-адрес для создания рабочих элементов одного типа с предопределенными значениями. Распространенные сценарии совместного использования см. в статье "Создание рабочего элемента из URL-адреса шаблона " и добавление ссылки шаблона на панель мониторинга группы.

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

Управление шаблонами рабочих элементов

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

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

  1. На веб-портале откройте параметры Project.

  2. В разделе Доски выберите Настройка команды.

  3. Если вам нужна другая команда, воспользуйтесь селектором Team в цепочке навигации.

  4. На странице "Доски" выберите "Шаблоны":

    Снимок экрана, который показывает, как получить доступ к списку сохраненных шаблонов в Azure DevOps в настройках проекта: Доски, Конфигурация команды, Шаблоны.

  5. Выберите тип рабочего элемента, например "Ошибка", " Компонент" или " Тестовый случай", чтобы просмотреть или добавить шаблоны для этого типа:

    Скриншот шаблонов, определённых для типа рабочего элемента 'Ошибка'.

Создание шаблона рабочего элемента

Чтобы создать шаблон рабочего элемента на веб-портале, выполните следующие действия.

  1. На странице типа рабочего элемента выберите новый шаблон:

    Снимок экрана, показывающий, как добавить новый шаблон для типа рабочего элемента

    Замечание

    Если вы планируете использовать markdown в большом текстовом поле, добавьте <br> теги для управления разрывами строк и убедитесь, что markdown отображается правильно.

  2. В диалоговом окне "Новый шаблон " введите имя (обязательно), а затем добавьте любые необязательные поля и значения.

  3. Нажмите кнопку "Сохранить". Опция Копировать ссылку становится доступной.

  4. Выберите ссылку "Копировать", чтобы скопировать URL-адрес шаблона.

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

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

На странице типа рабочего элемента выберите "Дополнительные действия для шаблона" и выберите один из следующих вариантов:

Снимок экрана: параметры меню

  • Изменить: выберите "Изменить", обновите шаблон и нажмите кнопку "Сохранить".

  • Удаление: нажмите кнопку "Удалить", а затем подтвердите. Удаленные шаблоны не могут быть восстановлены.

  • Ссылка на копирование: выберите ссылку "Копировать" , чтобы скопировать URL-адрес шаблона. Дополнительные сведения о параметрах общего доступа см. в разделе "Создание рабочего элемента из URL-адреса шаблона " и "Добавление ссылки шаблона" на панель мониторинга группы.

  • Создать копию: выберите "Создать копию", введите имя, при необходимости измените поля и нажмите кнопку "Сохранить".

  1. Убедитесь, что список шаблонов отражает ваше действие (обновленные значения, переименованный элемент, скопированный шаблон или удаленный шаблон).

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

Добавление рабочего элемента с помощью шаблона

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

  1. Получите ссылку шаблона. Дополнительные сведения см. в разделе "Изменить", "Удалить", "Копировать ссылку", "Создать копию".

  2. Вставьте ссылку шаблона в браузер, заполните обязательные поля и сохраните изменения.

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

Применение шаблона к новым или существующим рабочим элементам

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

На веб-портале можно применить шаблон в открытом рабочем элементе или между выбранными рабочими элементами.

Применение шаблона в рабочем элементе

Выполните следующие действия, чтобы применить шаблон к новому или существующему рабочему элементу:

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

  2. Выберите Дополнительные действия>, затем выберите имя предопределенного шаблона:

    Снимок экрана: применение шаблона к существующему рабочему элементу в форме.

    Замечание

    В списке шаблонов показаны шаблоны , определенные для команд, в которых вы являетесь членом. Если список пуст, может не быть шаблонов для типа рабочего элемента. Обновите браузер, чтобы обнаружить последние доступные шаблоны.

  3. Нажмите кнопку "Сохранить", чтобы применить шаблон. Изменения полей записываются в поле Журнал рабочего элемента.

  4. Проверьте, что поля обновились в форме и что в элементе работы History отображаются сохранённые изменения.

Применение шаблона к нескольким рабочим элементам

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

  1. Выберите рабочие элементы из списка результатов невыполненной работы или списка результатов запросов . Все выбранные элементы должны иметь один и тот же тип рабочего элемента, например Bug или Feature.

  2. Выберите несколько шаблонов действий> для одного из выбранных рабочих элементов и выберите шаблон для применения.

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

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

  3. Убедитесь, что каждый выбранный рабочий элемент содержит обновлённые значения полей и соответствующие записи в History.

Добавление или удаление тегов из шаблонов

В Visual Studio 2015 или более ранних версиях можно добавить теги в шаблон. При использовании шаблона теги автоматически применяются к рабочему элементу. Чтобы добавить два или более тегов, разделите их запятыми (,). Невозможно добавить теги на веб-портале.

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

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

Убедитесь, что в Visual Studio шаблон сохраняет настроенные теги и примененные рабочие элементы включают эти теги после сохранения.

Создание рабочего элемента из URL-адреса шаблона

Создайте URL-адрес, который открывает новый рабочий элемент с предопределенными значениями полей. Используйте этот подход, если требуется общий ярлык для общей конфигурации рабочего элемента.

Используйте сохранённые шаблоны для повторно используемых настроек по умолчанию, управляемых командой. Используйте URL-адреса шаблонов, если основной сценарий — прямой обмен ссылками.

  • Используйте сохраненные шаблоны, если команда нуждается в централизованно управляемых значениях по умолчанию.
  • Используйте URL-адреса шаблона, если требуется упрощенный общий доступ на панелях мониторинга, вики-сайтах или сообщениях.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

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

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Замечание

Некоторые клиенты браузера накладывают ограничение на 2000 символов для значений полей.

Вы можете сохранить URL-адрес в виде текстового файла или добавить его в виде гиперссылки на панели мониторинга или веб-страницу.

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

Добавьте ссылки на шаблон в мини-приложение Markdown на панели мониторинга группы на веб-портале. Каждая ссылка открывает новый рабочий элемент с предопределенными значениями шаблона.

В следующем примере показан мини-приложение Markdown со ссылками на три шаблона:

Снимок экрана: мини-приложение Markdown со ссылками на шаблоны.

Инструкции по настройке см. в разделе Добавление Markdown на панель мониторинга, мини-приложения Markdown.

Устранение неполадок с шаблоном

  • Меню шаблонов не отображается: убедитесь, что у вас есть доступ к проекту и что вы используете рабочий процесс, поддерживаемый клиентом.
  • Список шаблонов пуст на веб-портале: убедитесь, что шаблоны существуют для выбранного типа рабочего элемента и что вы являетесь членом команды, которая владеет шаблонами. Обновите браузер, чтобы загрузить последние шаблоны.
  • Не удается управлять шаблоном команды: убедитесь, что вы являетесь членом команды, которая владеет шаблоном.
  • Не удается применить шаблон к нескольким рабочим элементам: убедитесь, что все выбранные рабочие элементы имеют одинаковый тип рабочего элемента.
  • Параметры шаблона в Visual Studio недоступны: убедитесь, что вы используете устаревший сценарий Visual Studio 2015 и что установлены Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
  • URL-адрес шаблона открывается без ожидаемых значений: убедитесь, что каждое ссылочное имя поля допустимо для целевого типа рабочего элемента и что значения закодированы для URL-адреса (например, пробелы как + или %20).
  • Не удается загрузить URL-адрес шаблона: убедитесь, что URL-адрес использует правильный тип организации, проекта и рабочего элемента, и что вы вошли в учетную запись с доступом к проекту.
  • Некоторые поля из шаблона не заполняют: убедитесь, что поля по-прежнему существуют в типе рабочего элемента и не ограничены правилами настройки процесса.

Создание и применение шаблонов рабочих элементов с помощью ИИ

Если настроить Azure DevOps MCP Server, можно описать задачи, связанные с шаблонами, на естественном языке, а не выполнять каждый шаг вручную на веб-портале или Team Explorer.

В качестве примеров сценариев следует рассматривать следующие запросы. Доступные операции могут отличаться по версии MCP Server, включенным средствам и вашим разрешениям.

Перед запуском запроса замените заполнители значениями из вашего окружения: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId> и <IterationPath>.

задачи Пример запроса
Создание шаблона из элемента Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Создать новый шаблон Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Применение шаблона к одному элементу Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Массовое применение шаблона Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Создание рабочих элементов из шаблона Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Создание URL-адреса шаблона Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Обновление шаблона Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Копирование шаблона Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Поиск команд, отсутствующих в шаблоне List teams in project <ProjectName> that don't have a Bug template defined
Аудит использования шаблона Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Замечание

Если вы используете Visual Studio Code, режим агента особенно полезен для сложных операций шаблонов.

Связанный контент

  • Last updated on