Usar modelos de itens de trabalho

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

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

Use modelos de itens de trabalho para criar itens de trabalho com valores predefinidos e aplicar atualizações consistentes entre itens semelhantes. Este artigo aborda os fluxos de trabalho modelo no portal web e, para ambientes legados, no Visual Studio 2015 ou anteriores. Para exemplos, veja Modelos de exemplos de itens de trabalho.

Para a maioria das equipas, usa o portal web. Use o Visual Studio 2015 com Power Tools apenas quando ainda depender da gestão de templates baseada no Team Explorer.

Os modelos de itens de trabalho são diferentes dos modelos de processo. Para contextualizar, consulte Sobre processos e modelos de processos e a orientação padrão de processos para Basic, Agile, Scrum e Integração do Modelo de Maturidade de Capacidades (CMMI).

Tip

Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Habilitar assistência de IA com Azure DevOps MCP Server para começar.

Escolha o seu fluxo de trabalho

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

Se você quiser... Utiliza... Porquê
Criar, gerir e aplicar templates no Azure DevOps atual Portal web (primário) Suporta modelos com âmbito de equipa na experiência web padrão.
Reutilize valores predefinidos partilhados por equipa e por tipo de item de trabalho Modelos guardados Ajuda as equipas a aplicar campos e valores consistentes.
Partilhe um link direto que abre um item de trabalho pré-preenchido Modelos de URL Ideal para partilha leve em dashboards, wikis e chat.
Continuar os fluxos de trabalho baseados em templates baseados no Team Explorer Visual Studio 2015 com Power Tools (legado) Usa apenas quando o teu ambiente ainda depende de ferramentas legadas.

Pré-requisitos

Workflow Requerimentos
Portal web (primário) - Acesso a uma organização e projeto Azure DevOps.
- Para gerir templates, seja membro da equipa que os detém.
- Para aplicar modelos, tenha acesso de Contribuidor no projeto.
- Utilizar um navegador suportado e abrir o Azure DevOps no portal web.
Visual Studio 2015 com Power Tools (legado) - Use este fluxo de trabalho apenas se o seu ambiente ainda depender da gestão de modelos do Team Explorer.
- Instalar Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- Os modelos criados neste fluxo de trabalho têm âmbito de utilizador e aparecem apenas no Team Explorer.

Restrições para o uso de modelos

Os templates de portais web e templates do Visual Studio são lojas separadas. Um modelo criado num cliente não aparece no outro cliente.

Tipo de modelo Scope Onde consegues gerir isso Onde podes aplicá-lo
Modelo de portal web Ao nível da equipa Portal Web Portal Web
Modelo Visual Studio Ao nível do utilizador Visual Studio Visual Studio

Ainda podes usar o URL de qualquer um dos tipos de modelo para criar itens de trabalho no portal web.

Tarefas de modelo suportadas

A disponibilidade de tarefas depende do cliente que usa. Use o portal web para fluxos de trabalho principais do Azure DevOps e use o Visual Studio 2015 com Power Tools apenas para cenários legados.

A tabela seguinte mostra o suporte por cliente.

Tarefa de modelo Portal Web Visual Studio
Capturar um item de trabalho como um modelo ✅ Suportado ✅ Suportado
Gerenciar modelos de item 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 ❌ Não suportado ✅ Suportado
Definir um modelo com um hiperlink ✅ Suportado ❌ Não suportado

Capturar um item de trabalho como um modelo

Use o procedimento que corresponde ao seu cliente: portal web (principal) ou Visual Studio 2015 e anteriores (legacy).

Cada modelo que capturas no portal web recebe um GUID único. Use os passos seguintes para capturar um item de trabalho como modelo e copiar o seu link.

  1. No portal web, abre o item de trabalho que queres usar como fonte do modelo.

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

    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:

    • Equipa (obrigatório): Selecione a equipa a associar ao modelo.

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

    • Campos: Use Adicionar para incluir campos, Eliminar para remover campos e definir o Valor do campo conforme necessário.

    • Notas: Adicionar contexto do modelo. Quando crias um item de trabalho a partir do modelo, este texto aparece como a primeira entrada no tópico de Discussão .

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

  4. Selecione Guardar e depois selecione Copiar o link para copiar o URL do modelo.

    Use a URL para criar itens de trabalho do mesmo tipo com valores pré-definidos. Para cenários comuns de partilha, veja Criar um item de trabalho a partir de um URL modelo e Adicionar um link de modelo a um painel de equipa.

  5. Verifique se o modelo aparece na lista de modelos da equipa selecionada para esse tipo de item de trabalho, e o link copiado abre um novo formulário de item de trabalho com valores pré-definidos.

Gerenciar modelos de item de trabalho

Para cada tipo de item de trabalho, pode visualizar e gerir modelos definidos pela sua equipa. Pode adicionar, editar, copiar, eliminar, renomear e copiar um link de modelo.

Use estes passos para abrir modelos de itens de trabalho no portal web:

  1. No portal web, abre as definições do Project.

  2. Em Tabuleiros, selecione configuração de equipa.

  3. Se precisar de uma equipa diferente, use o seletor Equipa no trilho de navegação.

  4. Na página de Fóruns , selecione Templates:

    Captura de ecrã que mostra como aceder à lista de modelos guardados no Azure DevOps a partir das definições do projeto, quadros, configuração da equipa, modelos

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

    Captura de ecrã dos modelos definidos para o tipo de item de trabalho Bug.

Criar um modelo de item de trabalho

Use estes passos para criar um modelo de trabalho no portal web:

  1. Na página do 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 planeia usar markdown num campo de texto grande, adicione <br> etiquetas para gerir quebras de linha e garantir que o markdown é renderizado corretamente.

  2. No diálogo Novo Modelo , introduza um Nome (obrigatório) e depois adicione quaisquer campos e valores opcionais.

  3. Selecione Guardar. A opção Copiar link fica disponível.

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

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

Depois de guardares um modelo, podes atualizá-lo, removê-lo, copiar o link ou criar uma cópia.

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

Captura de ecrã das opções do menu Mais ações para um modelo selecionado.

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

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

Adicionar um item de trabalho usando um modelo

Use o link do modelo num navegador para criar um item de trabalho com valores pré-definidos.

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

  2. Cola o link do modelo num navegador, completa os campos obrigatórios e guarda as tuas alterações.

  3. Verifique se o novo item de trabalho é aberto com os valores definidos pelo modelo já preenchidos antes de o guardar.

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 web, pode aplicar um modelo num item de trabalho aberto ou entre itens selecionados.

Aplicar um modelo em um item de trabalho

Use estes passos para aplicar um modelo a um item de trabalho novo ou existente:

  1. Abra um novo ou existente item de trabalho que queira atualizar com valores definidos por template.

  2. Selecione Mais ações>Modelos e, em seguida, 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, pode não haver modelos para o tipo de item de trabalho. Atualize seu navegador para descobrir os modelos mais recentes disponíveis.

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

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

Aplicar um modelo a vários itens de trabalho

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

  1. Selecione itens de trabalho do Backlog ou de uma lista de resultados de Consultas. Todos os itens selecionados devem ser do mesmo tipo de item de trabalho, como Bug ou Característica.

  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 no campo são aplicadas e guardadas automaticamente. As alterações de campo são registadas no campo Histórico do item de trabalho. Para obter mais informações sobre atualizações em massa, consulte Modificar itens de trabalho em massa.

  3. Verifique se cada item de trabalho selecionado apresenta valores atualizados dos campos e entradas de Histórico correspondentes.

Adicionar ou remover tags de modelos

No Visual Studio 2015 ou versões anteriores, pode adicionar etiquetas a um modelo. Quando usas o modelo, as etiquetas aplicam-se automaticamente ao item de trabalho. Para adicionar duas ou mais tags, separe-as com uma vírgula (,). Não podes adicionar etiquetas no portal web.

Captura de ecrã da caixa de diálogo Editar modelo que mostra como adicionar ou remover etiquetas.

Se não especificares etiquetas para remover, todas as etiquetas de um item de trabalho mantêm-se definidas. As etiquetas mantêm-se definidas mesmo quando aplicas um modelo de item de trabalho a um item de trabalho já existente.

Verifique no Visual Studio se o modelo mantém as etiquetas configuradas e se os itens de trabalho aos quais foram aplicadas essas etiquetas as incluem depois de guardar.

Criar um item de trabalho a partir de um URL modelo

Crie uma URL que abra um novo item de trabalho com valores de campo pré-definidos. Use esta abordagem quando quiser um atalho partilhável para uma configuração comum de item de trabalho.

Utilize modelos guardados para predefinições reutilizáveis geridas pela equipa. Utilize URLs de modelo quando a partilha direta de ligações constituir a experiência principal.

  • Utilize modelos guardados quando a sua equipa precisar de predefinições geridas centralmente.
  • Use URLs de modelo quando precisar de partilha simples em painéis, 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 seguinte cria um item de trabalho de Tarefa com um Título, Atribuído a, Descrição, Etiquetas, Atividade e Caminho de Iteração pré-definidos.

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 de navegador impõem um limite de 2.000 caracteres para valores de campo.

Pode guardar a URL como ficheiro de texto, ou adicioná-la como um hiperlink num painel ou página web.

Verificar se, ao abrir o URL, é carregado o tipo correto de item de trabalho e são mostrados os valores predefinidos dos campos no formulário do novo item de trabalho.

Adicione ligações para modelos a um widget de Markdown no painel da sua equipa no portal da Web. Cada link abre um novo item de trabalho com valores de modelo pré-definidos.

O exemplo seguinte mostra um widget Markdown com ligações para três templates:

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

Para passos de configuração, veja Adicionar Markdown a um painel, Widgets de Markdown.

Resolva problemas do modelo

  • O menu de modelos não aparece: Verifique se tem acesso ao projeto e que está a usar o fluxo de trabalho suportado pelo seu cliente.
  • A lista de modelos está vazia no portal web: Confirme que existem modelos para o tipo de item de trabalho selecionado e que é membro da equipa que detém os modelos. Atualize o navegador para carregar os modelos mais recentes.
  • Não consegue gerir um modelo de equipa: Verifique se é membro da equipa que detém o modelo.
  • Não é possível aplicar um modelo a vários itens de trabalho: Confirme que todos os itens selecionados são do mesmo tipo.
  • As opções de modelo do Visual Studio não estão disponíveis: Confirme que está a usar o fluxo de trabalho legado do Visual Studio 2015 e que o Microsoft Visual Studio Team Foundation Server 2015 Power Tools está instalado.
  • URL do modelo abre sem valores esperados: Confirme que cada nome de referência de campo é válido para o tipo de item de trabalho alvo e que os valores estão codificados por URL (por exemplo, espaços como + ou %20).
  • O URL do modelo não é carregado: Confirme que o URL utiliza a organização, o projeto e o tipo de item de trabalho corretos e que tem sessão iniciada numa conta com acesso ao projeto.
  • Alguns campos de um template não aparecem: Confirme que os campos ainda existem no tipo de item de trabalho e que não estão restritos por regras de personalização de processos.

Use IA para criar e aplicar modelos de itens de trabalho

Se configurar o Azure DevOps MCP Server, pode descrever tarefas relacionadas com modelos em linguagem natural em vez de fazer cada passo manualmente no portal web ou no Team Explorer.

Trate os seguintes prompts como exemplos de cenários. As operações disponíveis podem variar consoante a versão do MCP Server, as ferramentas ativadas e as suas permissões.

Antes de executar um prompt, substitua os marcadores de posição por valores do seu ambiente: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId>, e <IterationPath>.

Tarefa Exemplo de prompt
Crie um modelo a partir de 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 em massa um modelo 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 um URL de modelo Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Atualizar 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 equipas sem modelo List teams in project <ProjectName> that don't have a Bug template defined
Utilização de modelos de auditoria Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Observação

Se estiveres a usar Visual Studio Code, o modo agente é especialmente útil para operações complexas de templates.