Usar modelos de itens de trabalho

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Com modelos de itens de trabalho, você pode criar rapidamente itens de trabalho com valores pré-preenchidos para os campos mais usados pela sua equipe. Você pode usar modelos de item de trabalho para criar itens de trabalho ou fazer atualizações em massa para vários itens de trabalho. Você pode adicionar e gerenciar modelos de item de trabalho do portal da Web ou do Visual Studio 2015 ou versões anteriores. Para obter exemplos que mostram o uso de modelos de item de trabalho, consulte Modelos de item de trabalho de exemplo.

Os modelos de item de trabalho são distintos dos modelos de processo. Para obter mais informações, consulte Sobre processos e modelos de processo ou estes artigos específicos para modelos de processo padrão: Básico, Agile, Scrum ou CMMI.

Tarefas de modelo com suporte

A disponibilidade das opções de tarefa de modelo depende da versão do cliente e da plataforma. Você pode adicionar e gerenciar modelos de item de trabalho do portal da Web ou do Visual Studio 2015 ou versões anteriores. Para obter mais informações, consulte os pré-requisitos neste artigo.

Conforme mostrado na tabela a seguir, um ✔️ indica que a tarefa está disponível no portal da Web ou no Visual Studio 2015 ou em versões anteriores. (Selecione a versão de conteúdo com base na versão da plataforma).

---

Tarefa

Portal da Web

Visual Studio 2015

---

Capturar um item de trabalho como modelo

✔️

✔️

---

Gerencie modelos de itens de trabalho
(Definir, editar, excluir, copiar link, criar cópia e renomear)

✔️

✔️

---

Copiar link (URL) de um modelo

✔️

✔️

---

Adicionar um item de trabalho usando um modelo

✔️

✔️

---

Definir um modelo de item de trabalho

✔️

✔️

---

Aplicar um modelo a um ou mais itens de trabalho

✔️

✔️

---

Adicionar ou remover marcas de modelos

✔️

---

Definir um modelo usando um hiperlink

✔️

---

Dica

Os modelos definidos por meio do portal da Web são distintos daqueles que você define por meio do Visual Studio. Os modelos do portal da Web só podem ser gerenciados e aplicados a itens de trabalho por meio do portal da Web. Da mesma forma, os modelos do Visual Studio só podem ser gerenciados, exibidos e aplicados a itens de trabalho no Visual Studio. Porém, você pode usar as URLs de ambos os tipos de modelo para adicionar itens de trabalho por meio do portal da Web.

Pré-requisitos

• Para gerenciar modelos de item de trabalho no portal da Web, você precisa ingressar na equipe que os possui. Em seguida, você pode adicionar, editar ou excluir modelos conforme necessário.

• Você precisa ser um Colaborador do projeto e um membro da equipe para usar modelos de item de trabalho no portal da Web. Em seguida, você pode aplicar modelos a itens de trabalho existentes.

• Para adicionar, capturar ou editar modelos de item de trabalho por meio do Visual Studio Team Explorer, instale o Microsoft Visual Studio Team Foundation Server 2015 Power Tools. Esses modelos aparecem apenas na sua exibição do Team Explorer.

Capturar um item de trabalho como modelo

Dependendo da plataforma, da versão e do cliente que você usa, talvez seja necessário seguir diferentes etapas para capturar um item de trabalho.

Portal da Web

Os modelos capturados por meio do portal da Web recebem um GUID.

1. No portal da Web, abra um item de trabalho para usar como base para um modelo.

2. Escolha o ícone de ações para abrir o menu. Escolha Modelos e Capturar.

   

   Nomeie o modelo, selecione a equipe na qual você deseja salvá-lo e, opcionalmente, defina ou desmarque campos. Salve o modelo quando terminar.

   

3. Salve o modelo e selecione Copiar link para capturar a URL do modelo.

4. Você pode colar o link da URL em um navegador para criar um item de trabalho ou fornecê-lo a outras pessoas para uso para adicionar itens de trabalho. Por exemplo, você pode adicioná-lo como um hiperlink a um wiki do projeto, um dashboard por meio de um widget Markdown ou outro recurso de rede compartilhada.

   Use a URL sempre que quiser adicionar um item de trabalho do tipo definido com seus valores predefinidos.

Visual Studio 2015

Para criar itens de trabalho a partir de modelos no Visual Studio ou no Team Explorer, você pode usar arquivos de modelo de item de trabalho (extensão .wt). Esses arquivos são acessíveis na página Itens de Trabalho.

1. Se você ainda não instalou Microsoft Visual Studio Team Foundation Server 2015 Power Tools, faça isso agora. Você precisa desse software instalado para acessar a ferramenta poderosa Modelos de Item de Trabalho para o Visual Studio.

2. Abra ou execute uma consulta que lista o item de trabalho cujos campos você deseja capturar.

3. Clique com o botão direito do mouse no item de trabalho do tipo e cujos campos você deseja capturar e selecione Capturar Modelo no menu de contexto.

   

4. Na caixa de diálogo, use as caixas de seleção para selecionar todos os campos que você deseja salvar no modelo. Em seguida, adicione um nome e (opcionalmente) descrição ao modelo.

   

5. Salve o modelo e ele aparece na raiz do painel Do Team Explorer na seção Modelos.

Gerencie modelos de itens de trabalho

Para cada tipo de item de trabalho, você pode ver e gerenciar os modelos que sua equipe definiu. Você pode executar várias ações nos modelos, como adicionar, editar, copiar, excluir, renomear e obter o link.

Portal da Web

1. No portal da Web, abra as configurações do Project.

   

   Expanda Quadros e escolha Configuração da equipe. Se você precisar alternar para uma equipe diferente, use o seletor de equipe.

2. Selecione Modelos.

   Escolha qualquer tipo de item de trabalho para exibir ou adicionar modelos para esse tipo.

Gerenciar modelos para um tipo de item de trabalho

Selecione Configurações do projeto> Configuração da equipe>Modelos. um tipo de item de trabalho para exibir seus modelos definidos.

Por exemplo, escolha História de Usuário para exibir modelos definidos para capturar histórias de usuário.

Criar um modelo de item de trabalho

1. Na página de tipo de item de trabalho, selecione o Novo modelo para criar um modelo do zero.

   

2. Nomeie o modelo e, opcionalmente, adicione e remova campos. Salvat o modelo quando terminar.

3. Para obter a URL do modelo, escolha Copiar link. Você pode usar essa URL para criar itens de trabalho com base no modelo.

Editar, excluir, copiar link ou criar cópia

Na página de tipo de item de trabalho, escolha o ícone de ações de um modelo existente para acessar as opções de menu para Editar, Excluir, Copiar link ou Criar cópia.

• Editar: Selecione Editar e Salvar suas alterações.
• Excluir: selecione Excluir e, em seguida , Excluir novamente da caixa de diálogo Excluir confirmação do modelo. Depois de excluir um modelo, você não poderá recuperá-lo.
• Copiar link: selecione Copiar o link. Use a URL sempre que quiser adicionar um item de trabalho do tipo definido com seus valores predefinidos. Você pode salvar a URL como um arquivo de texto, adicioná-la a uma página da Web como um hiperlink, copiar o link para uma rede compartilhada ou enviar para sua equipe por email. Além disso, adicione um link ao dashboard de equipe.
• Criar cópia: selecione Criar cópia. Nomeie o modelo, opcionalmente, adicione e remova campos e Salve-o quando terminar.

Visual Studio 2015

Você pode usar o Visual Studio com ferramentas elétricas para gerenciar seus próprios modelos de item de trabalho. Para cada tipo de item de trabalho, você pode ver seus modelos definidos e executar várias ações neles. Você pode adicionar, editar, excluir, copiar e copiar modelos. Você pode compartilhar seus modelos com outras pessoas enviando-lhes a URL do modelo ou salvando o modelo como um arquivo .wt.

• Gerenciar modelos no painel do Team Explorer.

  

  O nó Modelos raiz representa o pai para todos os seus modelos. Você pode criar uma estrutura de diretório abaixo dela adicionando pastas. Clique com o botão direito do mouse no nó Modelos ou em uma pasta e selecione Nova Pasta no menu de contexto.

• Recortar, copiar, colar, renomear e excluir modelos e pastas usando o menu de contexto. Você também pode arrastar e soltar modelos em pastas. Para editar vários modelos, use shift-click para selecionar um intervalo ou ctrl-click para adicionar modelos individuais à sua seleção e clique com o botão direito do mouse.

Definir um modelo

1. Na seção Modelos, clique com o botão direito do mouse em Modelos e escolha para criar um modelo do zero.

   

2. Forneça um nome na caixa de diálogo e Salve seu modelo.

   

3. Selecione Copiar o link para capturar a URL do modelo que você pode usar para adicionar itens de trabalho usando o modelo.

Editar, usar, copiar ou excluir um modelo

• Para editar, excluir ou concluir outra ação em um modelo, abra seu menu de contexto (clique com o botão direito do mouse) e escolha a opção desejada.

  

• Para tornar os modelos usados com mais frequência mais acessíveis, você pode definir um modelo padrão para cada tipo de item de trabalho. Para fazer isso, clique com o botão direito do mouse em um modelo no Team Explorer e selecione Definir como Padrão. Uma marca de seleção aparece no ícone para indicar que agora é o padrão.

Definir o diretório do modelo

• Para alterar o diretório em que os modelos são armazenados, selecione o link Configurar ou acesse-o por meio de Ferramentas>Opções>Microsoft Team Foundation Server>Modelos de Item de Trabalho. Use essa caixa de diálogo para definir o caminho do repositório de modelos. Coloque seus modelos em um local de rede para compartilhá-los com sua equipe.

Adicionar um item de trabalho usando um modelo

O método principal usado para adicionar um item de trabalho usando um modelo é abrir o link do modelo em uma janela do navegador. Para obter o link do modelo, consulte a seção Editar, excluir, copiar link, criar cópia.

Aplicar um modelo a itens de trabalho novos ou existentes

Você pode aplicar um modelo a um único item de trabalho ou fazer uma atualização em massa de vários itens de trabalho.

Portal da Web

Aplicar um modelo em um item de trabalho

1. Abra um novo item de trabalho ou um item de trabalho existente que você deseja atualizar usando os campos definidos em um modelo, escolha o ícone de ações para abrir o menu, selecione Modelos e selecione o nome de um modelo predefinido.

   

   Somente os modelos definidos para equipes às quais você pertence aparecem.

   Dica

   Atualize o navegador para descobrir os modelos mais recentes adicionados. Se você não vir nenhum modelo, talvez não haja nenhum para esse tipo de item de trabalho.

2. Salve o item de trabalho para que as alterações sejam aplicadas. Os campos alterados são observados no campo Histórico.

Aplicar um modelo a vários itens de trabalho

1. Para atualizar em massa vários itens de trabalho, primeiro selecione-os na lista de pendências ou em uma lista de resultados de consulta e abra o menu de ações de um deles. Todos os itens de trabalho selecionados devem ser do mesmo tipo de item de trabalho. Por exemplo, todas as histórias de usuário ou todos os bugs.

2. Escolha o modelo a ser aplicado.

   

3. As alterações de campo são aplicadas automaticamente e os itens de trabalho são salvos. Para saber mais sobre atualizações em massa, confira Modificar itens de trabalho em massa.

Visual Studio 2015

1. Abra ou execute uma consulta que lista os itens de trabalho cujos campos você deseja capturar.

2. Clique com o botão direito do mouse nos itens de trabalho, que devem ser do mesmo tipo, e escolha Aplicar Modelo no menu de contexto.

   

3. Selecione o modelo a ser usado e selecione OK.

   

4. Salve o item de trabalho.

Adicionar ou remover marcas de modelos

Você pode adicionar marcas a um modelo e elas são aplicadas ao item de trabalho quando você usa o modelo. Para adicionar duas ou mais marcas, delimite-as com uma vírgula (,).

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

Definir um modelo de item de trabalho não planejado usando um hiperlink

Você pode especificar um modelo de item de trabalho que especifica vários valores de campo usando a sintaxe a seguir. Use a URL sempre que quiser adicionar um item de trabalho do tipo definido com seus valores predefinidos.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Por exemplo, a sintaxe a seguir especifica uma tarefa de item de trabalho com o título TaskTitle. Ele especifica valores para os campos Atribuído a, Descrição, Marcas, Atividade e Caminho de Iteração.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_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

Dica

Há um limite de caracteres de 2000 imposto por alguns clientes do navegador.

Você pode salvar a URL como um arquivo de texto ou adicionar a URL a um dashboard ou página da Web como um hiperlink.

Adicionar um link de modelo a um dashboard de equipe

Você pode adicionar links a um widget Markdown que aparece em seu dashboard de equipe no portal da Web. Esses links abrem um item de trabalho com os campos definidos pelo modelo predefinidos.

Por exemplo, o widget a seguir contém links para três modelos.

Para saber mais sobre o widget Markdown, confira Adicionar Markdown a um dashboard, widgets Markdown.

Artigos relacionados

• Perguntas frequentes sobre o Azure Boards
• Usar como modelos itens de trabalho