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.
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:
No portal da Web, abra um item de trabalho para usar como base para um modelo.
À direita, selecione
Captura de>>: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 .
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:
No portal da Web, abra as configurações do Project.
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.
Na página Quadros , selecione a seção 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 o procedimento a seguir para criar um modelo de item de trabalho por meio do portal da Web:
Na página de tipo de item de trabalho, selecione
Novo modelo para criar um modelo do zero:
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.Na caixa de diálogo Novo Modelo , insira um Nome para o modelo (obrigatório) e, opcionalmente, adicione campos com os valores necessários.
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.
Editar, excluir, copiar link ou criar cópia
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:
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.
Para obter o link do modelo, consulte a seção Editar, excluir, copiar link, criar cópia.
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:
Abra um novo item de trabalho ou um item de trabalho existente que você deseja atualizar usando os campos definidos em um modelo.
Selecione Mais
modelos deações> 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 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:
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.
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 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.
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.
Definir um modelo de item de trabalho não planejado com um hiperlink
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.
Adicionar um link de modelo a um dashboard de equipe
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:
Para obter mais informações, confira Adicionar Markdown a um painel, widgets Markdown.