Usar modelos de item 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 item de trabalho, você pode criar rapidamente itens de trabalho com valores pré-preenchidos para os campos comumente usados da 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 mostrando 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: Basic, Agile, Scrum ou CMMI.

Tarefas de modelo suportadas

A disponibilidade das opções de tarefa de modelo depende do seu cliente e da versão 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, a ✔️ indica que a tarefa está disponível no portal da Web ou no Visual Studio 2015 ou em versões anteriores. (Certifique-se de selecionar a versão do conteúdo com base na versão da sua plataforma).

---

Tarefa

Portal Web

2015 Visual Studio

---

Capturar um item de trabalho como um modelo

✔️

✔️

---

Gerenciar modelos de item 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 tags de modelos

✔️

---

Definir um modelo usando um hiperlink

✔️

---

Gorjeta

Os modelos que você define por meio do portal da Web são distintos daqueles que você define por meio do Visual Studio. Os modelos de 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. Mas, você pode usar as URLs de ambos os tipos de modelo para adicionar itens de trabalho através do portal da Web.

Pré-requisitos

• Permissões:
  • Para gerenciar modelos de item de trabalho no portal da Web, seja um membro da equipe que os possui. Em seguida, você pode adicionar, editar ou excluir modelos conforme necessário.
  • Para usar modelos de item de trabalho no portal da Web, seja um Colaborador do projeto. Em seguida, você pode aplicar modelos a itens de trabalho existentes.
• Ferramentas: 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 só aparecem em sua exibição do Team Explorer.

Capturar um item de trabalho como um modelo

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

Portal Web

Os modelos capturados através 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. Selecione o ícone de ações e, em seguida, escolha Captura de modelos>.

   

   Nomeie o modelo, selecione a equipe na qual deseja salvá-lo e, opcionalmente, defina ou limpe 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 de 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 para um wiki de projeto, um painel por meio de um widget Markdown ou outro recurso de rede compartilhado.

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

Visual Studio 2015

Para criar itens de trabalho a partir de modelos no Visual Studio ou Team Explorer, você pode usar arquivos de modelo de item de trabalho, por exemplo, extensão .wt. Esses arquivos podem ser acessados na página Itens de Trabalho.

1. Iniciar sessão no Visual Studio.

2. Abra ou execute uma consulta que liste 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 deseja salvar no modelo. Em seguida, adicione um nome e (opcionalmente) uma descrição ao modelo.

   

5. Salve o modelo, que aparece na raiz do painel Team Explorer na seção Modelos.

Gerenciar modelos de item 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 Web

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

   

   Expanda Quadros e escolha Configuração de equipe. Se precisar de mudar para uma equipa diferente, utilize o seletor de equipas.

2. Selecione Modelos.

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

Gerenciar modelos para um tipo de item de trabalho

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

Por exemplo, selecione User Story para exibir modelos definidos para capturar histórias de usuários.

Criar um modelo de item de trabalho

1. Na página 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. Salve 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 as alterações.
• Excluir: Selecione Excluir e, em seguida , Excluir novamente na caixa de diálogo de confirmação do modelo. Depois de excluir um modelo, você não pode recuperá-lo.
• Copiar link: Selecione Copiar link. Use a URL sempre que quiser adicionar um item de trabalho do mesmo tipo com valores predefinidos. Você pode salvar o URL como um arquivo de texto, adicioná-lo a uma página da Web como um hiperlink, copiar o link para uma rede compartilhada ou enviar para sua equipe por e-mail. Além disso, considere adicionar um link ao painel da equipe.
• Criar cópia: Selecione Criar cópia. Nomeie o modelo, opcionalmente adicione e remova campos e, em seguida , salve-o quando terminar.

Visual Studio 2015

Você pode usar o Visual Studio com ferramentas avançadas 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 o URL do modelo ou salvando o modelo como um .wt arquivo.

• Gerencie modelos a partir do painel Team Explorer.

  

  O nó raiz Modelos representa o pai para todos os seus modelos. Você pode criar uma estrutura de diretórios 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.

• Recorte, copie, cole, renomeie e exclua modelos e pastas usando o menu de contexto. Você também pode arrastar e soltar modelos em pastas. Para editar vários modelos, use a tecla Shift pressionada para selecionar um intervalo ou clique com a tecla Ctrl pressionada 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 criar um modelo do zero.

   

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

   

3. Selecione Copiar 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 o menu de contexto (clique com o botão direito do mouse) e escolha a opção desejada.

  

• Para tornar os modelos usados com freqüê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 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 de modelos

• Para alterar o diretório onde os modelos são armazenados, selecione o link Configurar ou vá até ele por meio de Opções>de Ferramentas>Modelos de Item de Trabalho do Microsoft Team Foundation Server.> Use esta 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 principal método usado para adicionar um item de trabalho usando um modelo é abrir o link do modelo dentro de 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 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.

   

   Apenas aparecem os modelos definidos para as equipas a que pertence.

   Gorjeta

   Atualize seu 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 anotados 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, em seguida, 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ários 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 obter mais informações sobre atualizações em massa, consulte Modificar itens de trabalho em massa.

Visual Studio 2015

1. Abra ou execute uma consulta que liste um ou mais 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 tags de modelos

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

Se você não especificar tags para remover, todas as tags presentes em um item de trabalho permanecerão definidas. Eles permanecem definidos 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 mesmo tipo com 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, Tags, 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

Gorjeta

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

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

Adicionar um link de modelo a um painel de equipe

Você pode adicionar links para um widget Markdown que aparecem no painel da sua 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 obter mais informações, consulte Adicionar Markdown a um painel, Markdown widgets.

Artigos relacionados

• FAQs sobre os Painéis do Azure
• Modelos de item de trabalho de exemplo