Compartilhar via


Usar modelos de itens de trabalho

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

Modelos de item de trabalho ajudam você a criar rapidamente itens de trabalho com valores pré-preenchidos para seus campos comumente usados. 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. Este artigo descreve como 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 demonstram como usar os 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 (Capability Maturity Model Integration).

Pré-requisitos

Pré-requisito Description
Permissões – Para gerenciar modelos de item de trabalho no portal da Web, seja um membro da equipe que possui os modelos. 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 usando o 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.

Tarefas de modelo com suporte

A disponibilidade das opções de tarefa de modelo depende da configuraçã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.

A tabela a seguir mostra o suporte para tarefas no portal da Web e no Visual Studio 2015 ou versões anteriores. Se você usar os links de descrição da tarefa para ir para as seções correspondentes, selecione a versão do conteúdo (guia) na seção para a configuração da plataforma, conforme apropriado.

Tarefa de modelo Portal da Web Visual Studio
Capturar um item de trabalho como modelo ✔️ ✔️
Gerencie modelos de itens de trabalho
(Definir, editar, excluir, copiar link, criar cópia e renomear)
✔️ ✔️
Copiar o 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 com um hiperlink ✔️

Restrições para usar modelos

Os modelos definidos no portal da Web são distintos dos modelos definidos 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.
  • Os modelos do Visual Studio só podem ser gerenciados, exibidos e aplicados a itens de trabalho no Visual Studio.

No entanto, você pode usar as URLs de ambos os tipos de modelo para adicionar itens de trabalho por meio do portal da Web.

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. As seções a seguir fornecem procedimentos para o portal da Web e o Visual Studio 2015 e versões anteriores.

O Azure DevOps atribui um identificador GUID exclusivo a cada modelo capturado por meio do portal da Web. Use o procedimento a seguir para capturar um item de trabalho como um modelo por meio do portal da Web e acessar um link para o modelo salvo:

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

  2. À direita, selecione Captura de>>:

    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. Na caixa de diálogo Capturar Modelo , configure os campos necessários e quaisquer campos opcionais:

    • Equipe: (Obrigatório) Use a lista suspensa para selecionar uma equipe existente para associar ao modelo capturado.

    • Nome: (Obrigatório) Insira um nome para o modelo.

    • Campos: use a ação Adicionar para adicionar campos, a ação Excluir para remover campos e ajustar qualquer valor de campo específico, conforme necessário.

    • Observações: selecione dentro da caixa para adicionar mais informações sobre o modelo. Quando você seleciona dentro da caixa, as ferramentas de edição são exibidas. Quando você cria um novo item de trabalho com base no modelo capturado, suas informações são adicionadas 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 capturar a URL do modelo.

    Use a URL sempre que quiser adicionar um item de trabalho do mesmo tipo com seus valores predefinidos. Aqui estão alguns exemplos:

    • Crie um item de trabalho com base no modelo capturado colando o link da URL em uma janela do navegador.
    • Compartilhe a URL com outras pessoas para seu próprio uso ao adicionar itens de trabalho.
    • Adicione a URL como um hiperlink a um wiki do projeto.
    • Adicione a URL a um widget markdown em um painel de equipe.

Gerencie modelos de itens de trabalho

Para cada tipo de item de trabalho, você pode exibir e gerenciar os modelos definidos por sua equipe. Execute várias ações nos modelos como adicionar, editar, copiar, excluir ou renomear e obter um link para o modelo.

Use o procedimento a seguir para acessar modelos de item de trabalho por meio do portal da Web:

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

  2. Na seção Quadros , selecione a configuração da equipe. Se você precisar mudar para uma equipe diferente, use o seletor de equipe na trilha de trilha de trilha para a página.

  3. Na página Quadros , selecione a seção Modelos :

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

  4. 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 o procedimento a seguir para criar um modelo de item de trabalho por meio do portal da Web:

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

    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, pode adicionar <br> marcas para gerenciar quebras de linha e garantir que o markdown seja renderizado corretamente.

  2. Na caixa de diálogo Novo Modelo , insira um Nome para o modelo (obrigatório) e, opcionalmente, adicione campos com os valores necessários.

  3. Clique em Salvar. A opção Copiar link fica disponível. Você pode usar essa URL para criar itens de trabalho com base no modelo.

Depois de salvar um modelo, você pode editar ou excluir o modelo, criar um link fragmentável para o modelo ou criar uma cópia do modelo.

Na página de tipo de item de trabalho, selecione Mais ações para um modelo existente e, em seguida, selecione uma opção de menu:

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

  • Editar: Para atualizar o modelo, selecione Editar, faça suas alterações e selecione Salvar.

  • Excluir: para remover o modelo, selecione Excluir. Na caixa de diálogo de confirmação, selecione Excluir. Depois de excluir um modelo, você não poderá recuperá-lo.

  • Copiar link: para obter uma cópia da URL do modelo, selecione Copiar link. Use a URL sempre que quiser adicionar um item de trabalho do mesmo tipo 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 enviá-lo para sua equipe por email. Além disso, adicione um link ao dashboard de equipe.

  • Criar cópia: para fazer uma cópia do modelo, selecione Criar cópia. Insira um nome para a cópia do modelo e, opcionalmente, adicione, remova e atualize os campos. Selecione Salvar quando terminar.

Adicionar um item de trabalho usando um modelo

A abordagem mais comum para adicionar um item de trabalho usando um modelo é abrir o link do modelo em uma janela do navegador.

  1. Para obter o link do modelo, consulte a seção Editar, excluir, copiar link, criar cópia.

  2. Para criar o novo item de trabalho, cole o link do modelo em uma janela do navegador, configure os campos necessários e salve as alterações.

Aplicar um modelo a itens de trabalho novos ou existentes

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

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

Aplicar um modelo em um item de trabalho

Use o procedimento a seguir para aplicar um modelo a um item de trabalho novo ou existente:

  1. Abra um novo item de trabalho ou um item de trabalho existente que você deseja atualizar usando os campos definidos em um modelo.

  2. Selecione Maismodelos deações> 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 selecionado. Todas as alterações de campo são anotadas no campo Histórico do item de trabalho.

Aplicar um modelo a vários itens de trabalho

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

  1. Selecione os itens de trabalho na lista de resultados backlog ou consultas . Todos os itens de trabalho 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 automaticamente e os itens de trabalho salvos. Todas as alterações de campo são anotadas 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.

Adicionar ou remover marcas de modelos

No Visual Studio 2015 ou anterior, 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, separe-as com uma vírgula (,). Essa tarefa não está disponível 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 presentes em um item de trabalho permanecerão definidas. As marcas permanecem definidas mesmo quando você aplica um modelo de item de trabalho a um item de trabalho existente.

No Visual Studio 2015 ou anterior, você pode especificar um modelo de item de trabalho que define vários valores de campo usando a sintaxe a seguir. Você pode usar a URL sempre que quiser adicionar um item de trabalho do mesmo tipo com valores predefinidos. Essa tarefa não está disponível no portal da Web.

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}&
. . .

Por exemplo, o código a seguir especifica uma tarefa de item de trabalho com o TítuloTaskTitle. A sintaxe especifica valores para os campos Caminho atribuído a, descrição, marcas, atividade e 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 adicionar a URL a um dashboard ou página da Web como um hiperlink.

Você pode adicionar links a um widget markdown no painel da equipe no portal da Web. Esses links abrem um item de trabalho com os campos definidos pelo modelo predefinidos.

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

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

Para obter mais informações, confira Adicionar Markdown a um painel, widgets Markdown.