Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
No portal da Web, abra o item de trabalho que você deseja usar como fonte de modelo.
À direita, selecione
Mais ações>Modelos>Captura: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 .
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.
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:
No portal da web, abra Configurações do projeto.
Em Quadros, selecione Configuração de equipe.
Se você precisar de uma equipe diferente, use o seletor Equipe na trilha de navegação.
Na página Quadros , selecione Modelos:
Selecione um tipo de item de trabalho, como Bug, Recurso ou Caso de Teste, para exibir ou adicionar modelos para esse tipo:
Criar um modelo de item de trabalho
Use estas etapas para criar um modelo de item de trabalho no portal da Web:
Na página de tipo de item de trabalho, selecione
Novo modelo:
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.Na caixa de diálogo Novo Modelo , insira um Nome (obrigatório) e adicione quaisquer campos e valores opcionais.
Clique em Salvar. A opção Copiar link fica disponível.
Selecione Copiar link para copiar a URL do modelo.
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.
Editar, excluir, copiar link ou criar cópia
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:
Editar: Selecione Editar, atualize o modelo e selecione Salvar.
Excluir: selecione Excluir e confirme. Modelos excluídos não podem ser recuperados.
Copiar link: selecione Copiar link para copiar a URL do modelo. Para opções 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.
Criar cópia: selecione Criar cópia, insira um nome, ajuste opcionalmente os campos e, em seguida, selecione Salvar.
Verifique se a lista de modelos reflete sua ação (valores atualizados, item renomeado, modelo copiado ou modelo removido).
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.
Obtenha o link do modelo. Para obter mais informações, consulte Editar, excluir, copiar link, criar cópia.
Cole o link do modelo em um navegador, conclua os campos necessários e salve suas alterações.
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:
Abra um item de trabalho novo ou existente que você deseja atualizar com valores definidos pelo modelo.
Selecione
Mais ações>Modelos e selecione o nome de um modelo predefinido:
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.
Selecione Salvar para aplicar o modelo. As alterações de campo são registradas no campo Histórico do item de trabalho.
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:
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.
Selecione
Mais ações>Modelos para um dos itens de trabalho selecionados e selecione o modelo a ser aplicado.
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.
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.
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.
Adicionar um link de modelo a um dashboard de equipe
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:
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.
Conteúdo relacionado
- Perguntas frequentes Azure Boards
- Modelos de itens de trabalho de exemplo
- Modificar itens de trabalho em massa