Usar modelos de itens de trabalho

Serviços Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Use modelos de item de trabalho para criar itens de trabalho com valores predefinidos e aplicar atualizações consistentes em itens semelhantes. Este artigo aborda fluxos de trabalho de modelos no portal web e, para ambientes herdados, no Visual Studio 2015 ou versões anteriores. Para obter exemplos, consulte exemplos de modelos de item de trabalho.

Para a maioria das equipes, use o portal da Web. Use Visual Studio 2015 com o Power Tools somente quando você ainda depender do gerenciamento de modelos baseado no Team Explorer.

Modelos de item de trabalho são diferentes dos modelos de processo. Para obter contexto, consulte Sobre processos e modelos de processos e as diretrizes do processo padrão para Basic, Agile, Scrum e Capability Maturity Model Integration (CMMI).

Tip

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

Escolha seu fluxo de trabalho

Use esta tabela para escolher o melhor fluxo de trabalho para seu cenário.

Se você quiser... Use... Por que
Criar, gerenciar e aplicar modelos no Azure DevOps atual Portal da Web (primário) Oferece suporte a modelos com escopo de equipe na experiência da Web padrão.
Reutilizar padrões compartilhados por tipo de item de trabalho e equipe Modelos salvos Ajuda as equipes a aplicar campos e valores consistentes.
Compartilhar um link direto que abre um item de trabalho pré-preenchido Modelos de URL Melhor para compartilhamento leve em dashboards, wikis e chat.
Continuar fluxos de trabalho baseados em modelos do Team Explorer Visual Studio 2015 com o Power Tools (herdado) Use somente quando seu ambiente ainda depender de ferramentas herdadas.

Pré-requisitos

Workflow Requirements
Portal da Web (primário) – Acesso a uma organização e projeto Azure DevOps.
– Para gerenciar modelos, seja um membro da equipe que possui os modelos.
– Para aplicar modelos, tenha acesso de Colaborador ao projeto.
– Use um navegador com suporte e abra Azure DevOps no portal da Web.
Visual Studio 2015 com o Power Tools (herdado) – Use esse fluxo de trabalho somente se o ambiente ainda depender do gerenciamento de modelo do Team Explorer.
- Instale Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- Os modelos criados neste fluxo de trabalho têm escopo de usuário e aparecem apenas no Team Explorer.

Restrições para usar modelos

Modelos do portal da Web e modelos de Visual Studio são repositórios separados. Um modelo criado em um cliente não aparece no outro cliente.

Tipo do modelo Scope Onde você pode gerenciá-lo Onde você pode aplicá-lo
Modelo do portal da Web No escopo da equipe Portal da Web Portal da Web
modelo de Visual Studio Escopo do usuário Visual Studio Visual Studio

Você ainda pode usar a URL de qualquer tipo de modelo para criar itens de trabalho no portal da Web.

Tarefas de modelo com suporte

A disponibilidade da tarefa depende do cliente que você usa. Use o portal da Web para fluxos de trabalho de Azure DevOps primários e use Visual Studio 2015 com o Power Tools apenas para cenários herdados.

A tabela a seguir mostra o suporte por cliente.

Tarefa de modelo Portal da Web Visual Studio
Capturar um item de trabalho como modelo ✅ Suportado ✅ Suportado
Gerencie modelos de itens de trabalho
(Definir, editar, excluir, copiar link, criar cópia e renomear)
✅ Suportado ✅ Suportado
Copiar o link (URL) de um modelo ✅ Suportado ✅ Suportado
Adicionar um item de trabalho usando um modelo ✅ Suportado ✅ Suportado
Definir um modelo de item de trabalho ✅ Suportado ✅ Suportado
Aplicar um modelo a um ou mais itens de trabalho ✅ Suportado ✅ Suportado
Adicionar ou remover tags de modelos ❌ Sem suporte ✅ Suportado
Definir um modelo com um hiperlink ✅ Suportado ❌ Sem suporte

Capturar um item de trabalho como modelo

Use o procedimento que corresponde ao seu cliente: portal da Web (primário) ou Visual Studio 2015 e anterior (herdado).

Cada modelo que você captura no portal da Web obtém um GUID exclusivo. Use as etapas a seguir para capturar um item de trabalho como modelo e copiar seu link.

  1. No portal da Web, abra o item de trabalho que você deseja usar como fonte de modelo.

  2. À direita, selecione Mais ações>Modelos>Captura:

    Captura de tela que mostra como selecionar as definições de campo de item de trabalho de captura como uma opção de modelo no menu Mais ações.

  3. No Modelo de Captura, configure campos obrigatórios e opcionais:

    • Equipe (obrigatório): selecione a equipe a ser associada ao modelo.

    • Nome (obrigatório): insira um nome de modelo.

    • Campos: use Adicionar para incluir campos, Excluir para remover campos e definir o valor do campo conforme necessário.

    • Observações: Adicionar contexto de modelo. Quando você cria um item de trabalho com base no modelo, esse texto aparece como a primeira entrada no thread Discussão .

    Captura de tela que mostra como configurar campos na caixa de diálogo Capturar modelo no portal da Web.

  4. Selecione Salvar e selecione Copiar link para copiar a URL do modelo.

    Use a URL para criar itens de trabalho do mesmo tipo com valores predefinidos. Para cenários comuns de compartilhamento, consulte Criar um item de trabalho a partir de uma URL de modelo e Adicionar um link de modelo a um painel de equipe.

  5. Verifique se o modelo aparece na lista de modelos da equipe selecionada para esse tipo de item de trabalho e se o link copiado abre um novo formulário de item de trabalho com valores predefinidos.

Gerencie modelos de itens de trabalho

Para cada tipo de item de trabalho, você pode exibir e gerenciar modelos definidos por sua equipe. Você pode adicionar, editar, copiar, excluir, renomear e copiar um link de modelo.

Use estas etapas para abrir modelos de item de trabalho no portal da Web:

  1. No portal da web, abra Configurações do projeto.

  2. Em Quadros, selecione Configuração de equipe.

  3. Se você precisar de uma equipe diferente, use o seletor Equipe na trilha de navegação.

  4. Na página Quadros , selecione Modelos:

    Captura de tela que mostra como acessar a lista de modelos salvos no Azure DevOps das Configurações de Projeto, Boards, Configuração de Equipe, Modelos.

  5. Selecione um tipo de item de trabalho, como Bug, Recurso ou Caso de Teste, para exibir ou adicionar modelos para esse tipo:

    Captura de tela dos modelos definidos para o tipo de item de trabalho bug.

Criar um modelo de item de trabalho

Use estas etapas para criar um modelo de item de trabalho no portal da Web:

  1. Na página de tipo de item de trabalho, selecione Novo modelo:

    Captura de tela mostrando como adicionar um novo modelo para o tipo de item de trabalho Bug.

    Observação

    Se você planeja usar markdown em um campo de texto grande, adicione <br> marcas para gerenciar quebras de linha e verifique se o markdown é renderizado corretamente.

  2. Na caixa de diálogo Novo Modelo , insira um Nome (obrigatório) e adicione quaisquer campos e valores opcionais.

  3. Clique em Salvar. A opção Copiar link fica disponível.

  4. Selecione Copiar link para copiar a URL do modelo.

  5. Verifique se o modelo está listado para o tipo de item de trabalho selecionado e se o link copiado abre um novo formulário de item de trabalho com valores de modelo.

Depois de salvar um modelo, você pode atualizá-lo, removê-lo, copiar seu link ou criar uma cópia.

Na página de tipo de item de trabalho, selecione Mais ações para um modelo e escolha uma destas opções:

Captura de tela das opções de menu Mais ações para um modelo selecionado.

  1. Verifique se a lista de modelos reflete sua ação (valores atualizados, item renomeado, modelo copiado ou modelo removido).

  2. Verifique se o link Copiar abre um novo formulário de item de trabalho com os valores de modelo esperados.

Adicionar um item de trabalho usando um modelo

Use o link de modelo em um navegador para criar um item de trabalho com valores predefinidos.

  1. Obtenha o link do modelo. Para obter mais informações, consulte Editar, excluir, copiar link, criar cópia.

  2. Cole o link do modelo em um navegador, conclua os campos necessários e salve suas alterações.

  3. Verifique se o novo item de trabalho é aberto com valores definidos pelo modelo preenchidos antes de salvar.

Aplicar um modelo a itens de trabalho novos ou existentes

Aplique um modelo a um item de trabalho novo ou existente ou use um modelo para atualizações em massa.

No portal da Web, você pode aplicar um modelo em um item de trabalho aberto ou em itens de trabalho selecionados.

Aplicar um modelo em um item de trabalho

Use estas etapas para aplicar um modelo a um item de trabalho novo ou existente:

  1. Abra um item de trabalho novo ou existente que você deseja atualizar com valores definidos pelo modelo.

  2. Selecione Mais ações>Modelos e selecione o nome de um modelo predefinido:

    Captura de tela que mostra como aplicar um modelo a um item de trabalho existente dentro do formulário.

    Observação

    A lista Modelos mostra modelos definidos para equipes das quais você é membro. Se a lista estiver vazia, talvez não haja modelos para o tipo de item de trabalho. Atualize seu navegador para descobrir os modelos disponíveis mais recentes.

  3. Selecione Salvar para aplicar o modelo. As alterações de campo são registradas no campo Histórico do item de trabalho.

  4. Verifique se os campos são atualizados no formulário e o histórico do item de trabalho registra as alterações salvas.

Aplicar um modelo a vários itens de trabalho

Use estas etapas para aplicar um modelo a itens de trabalho selecionados para uma atualização em massa:

  1. Selecione itens de trabalho na Lista de Pendências ou em uma lista de resultados de Consultas . Todos os itens selecionados devem ser do mesmo tipo de item de trabalho, como Bug ou Recurso.

  2. Selecione Mais ações>Modelos para um dos itens de trabalho selecionados e selecione o modelo a ser aplicado.

    Captura de tela que mostra como aplicar um modelo a vários itens de trabalho para uma atualização em massa.

    As alterações de campo são aplicadas e salvas automaticamente. As alterações de campo são registradas no campo Histórico do item de trabalho. Para mais informações sobre atualizações em massa, consulte Modificar itens de trabalho em massa.

  3. Verifique se cada item de trabalho selecionado mostra valores de campo atualizados e entradas de Histórico correspondentes.

Adicionar ou remover etiquetas de modelos de documentos

Em Visual Studio 2015 ou versões anteriores, você pode adicionar marcas a um modelo. Quando você usa o modelo, as tags são aplicadas automaticamente ao item de trabalho. Para adicionar duas ou mais marcas, separe-as com uma vírgula (,). Você não pode adicionar tags no portal da web.

Captura de tela da caixa de diálogo Editar modelo mostrando como adicionar ou remover marcas.

Se você não especificar marcas a serem removidas, todas as marcas em um item de trabalho permanecerão definidas. As tags continuam definidas mesmo quando você aplica um modelo de item de trabalho a um item de trabalho existente.

Verifique em Visual Studio se o modelo retém as marcas configuradas e os itens de trabalho aplicados incluem essas marcas depois de salvar.

Criar um item de trabalho a partir de uma URL de modelo

Crie uma URL que abra um novo item de trabalho com valores de campo predefinidos. Use essa abordagem quando quiser um atalho compartilhável para uma configuração de item de trabalho comum.

Use modelos salvos para configurações padrão reutilizáveis gerenciadas pela equipe. Use URLs de modelo quando o compartilhamento direto de links for a experiência principal.

  • Use modelos salvos quando sua equipe precisar de padrões gerenciados centralmente.
  • Use URLs de modelo quando precisar de compartilhamento leve em dashboards, wikis ou mensagens.
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}&
. . .

O exemplo a seguir cria um item de trabalho de tarefa com um título predefinido, Atribuído a, Descrição, Marcas, Atividade e Caminho de Iteração.

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

Observação

Alguns clientes do navegador impõem um limite de 2.000 caracteres para valores de campo.

Você pode salvar a URL como um arquivo de texto ou adicioná-la como um hiperlink em um painel ou página da Web.

Verifique se a abertura da URL carrega o tipo de item de trabalho correto e mostra valores de campo predefinidos no novo formulário de item de trabalho.

Adicione links para modelos a um widget do Markdown no painel da sua equipe no portal web. Cada link abre um novo item de trabalho com valores de modelo predefinidos.

O exemplo a seguir mostra um widget markdown com links para três modelos:

Captura de tela de um widget markdown com links para modelos.

Para ver as etapas de configuração, consulte Adicionar Markdown a um painel, widgets Markdown.

Solucionar problemas de modelo

  • O menu modelos não aparece: verifique se você tem acesso ao projeto e se está usando o fluxo de trabalho compatível com seu cliente.
  • A lista de modelos está vazia no portal da Web: confirme se existem modelos para o tipo de item de trabalho selecionado e se você é um membro da equipe que possui os modelos. Atualize o navegador para carregar os modelos mais recentes.
  • Não é possível gerenciar um modelo de equipe: verifique se você é um membro da equipe que possui o modelo.
  • Não é possível aplicar um modelo a vários itens de trabalho: confirme se todos os itens de trabalho selecionados são do mesmo tipo de item de trabalho.
  • As opções de modelo do Visual Studio não estão disponíveis: Confirme se você está usando o fluxo de trabalho legado do Visual Studio 2015 e se o Microsoft Visual Studio Team Foundation Server 2015 Power Tools está instalado.
  • A URL do modelo é aberta sem valores esperados: confirme se cada nome de referência de campo é válido para o tipo de item de trabalho de destino e se os valores são codificados em URL (por exemplo, espaços como + ou %20).
  • A URL do modelo falha ao carregar: confirme se a URL usa o tipo correto de organização, projeto e item de trabalho e se você está conectado a uma conta com acesso ao projeto.
  • Alguns campos de um modelo não são preenchidos: confirme se os campos ainda existem no tipo de item de trabalho e não são restritos por regras de personalização de processo.

Usar a IA para criar e aplicar modelos de item de trabalho

Se você configurar o servidor MCP Azure DevOps, poderá descrever tarefas relacionadas ao modelo em linguagem natural em vez de executar cada etapa manualmente no portal da Web ou no Team Explorer.

Trate os comandos a seguir como exemplos de situações. As operações disponíveis podem variar de acordo com a versão do SERVIDOR MCP, as ferramentas habilitadas e suas permissões.

Antes de executar um prompt, substitua os espaços reservados pelos valores do seu ambiente: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId> e <IterationPath>.

Tarefa Prompt de exemplo
Criar um modelo com base em um item Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Criar um novo modelo Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Aplicar um modelo a um item Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Aplicar um modelo em massa Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Criar itens de trabalho a partir de um modelo Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Gerar uma URL de modelo Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Atualize um modelo Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Copiar um modelo Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Encontrar equipes sem um modelo List teams in project <ProjectName> that don't have a Bug template defined
Auditar o uso do modelo Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Observação

Se você estiver usando Visual Studio Code, o modo de agente será especialmente útil para operações de modelo complexas.