Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015
Os 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 Capability Maturity Model Integration (CMMI).
Pré-requisitos
| Pré-requisito | Description |
|---|---|
| Permissões | - Para gerenciar modelos de item de trabalho no portal da web, seja um membro da equipe proprietária dos modelos. Em seguida, você pode adicionar, editar ou excluir modelos conforme necessário. - Para usar modelos de item de trabalho no portal 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 só aparecem em sua exibição do Team Explorer. |
Tarefas de modelo suportadas
A disponibilidade das opções de tarefas 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 Descrição da tarefa para ir para as seções correspondentes, certifique-se de selecionar a versão do conteúdo (guia) na seção para a configuração da plataforma, conforme apropriado.
| Tarefa de modelo | Portal Web | 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 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 tags de modelos | ✔️ | |
| Definir um modelo com um hiperlink | ✔️ |
Restrições para o uso de modelos
Os modelos definidos no portal da Web são distintos dos modelos definidos 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.
- 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 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. As seções a seguir fornecem procedimentos para o portal da Web e Visual Studio 2015 e versões anteriores.
O Azure DevOps atribui um identificador GUID exclusivo a cada modelo capturado através do portal Web. Use o procedimento a seguir para capturar um item de trabalho como um modelo através 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
Mais ações>Captura de modelos>:Na caixa de diálogo Modelo de captura , configure os campos obrigató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 ajuste qualquer valor de campo específico conforme necessário.Notas: 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 a partir do modelo capturado, suas informações são adicionadas como a primeira entrada no thread de discussão .
Selecione Salvar e, em seguida, selecione Copiar link para capturar a URL do modelo.
Use a URL sempre que quiser adicionar um item de trabalho do mesmo tipo com valores predefinidos. Eis alguns exemplos:
- Crie um item de trabalho com base no modelo capturado colando o link URL em uma janela do navegador.
- Compartilhe o URL com outras pessoas para uso próprio ao adicionar itens de trabalho.
- Adicione o URL como um hiperlink para um wiki do projeto.
- Adicione o URL a um widget Markdown em um painel de equipe.
Gerenciar modelos de item de trabalho
Para cada tipo de item de trabalho, você pode exibir e gerenciar os modelos definidos pela sua equipe. Execute várias ações nos modelos, como adicionar, editar, copiar, excluir ou renomear e obtenha 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 Configurações do projeto.
Na seção Painéis , selecione Configuração da equipe. Se você precisar mudar para uma equipe diferente, use o seletor de equipe na trilha de trilha da página.
Na página Painéis , 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 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, você pode adicionar
<br>tags para gerenciar quebras de linha e garantir que a marcação seja renderizada corretamente.Na caixa de diálogo Novo modelo , insira um Nome para o modelo (obrigatório) e, opcionalmente, adicione campos com quaisquer valores necessários.
Selecione Guardar. 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 ter um modelo salvo, você pode editar ou excluir o modelo, criar um link compartilhável para o modelo ou criar uma cópia do modelo.
Na página 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 as 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, não é possível recuperá-lo.
Copiar link: para obter uma cópia do URL do modelo, 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 enviá-lo para sua equipe por e-mail. Além disso, considere adicionar um link ao painel da 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 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 obrigató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 dentro de 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 ações>Modelos e, em seguida, 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, pode não haver modelos para o tipo de item de trabalho. Atualize seu navegador para descobrir os modelos mais recentes disponíveis.
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 Listas de pendências 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 são 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 tags 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 tags, separe-as com uma vírgula (,). Esta tarefa não está disponível no portal Web.
Se você não especificar tags para remover, todas as tags presentes em um item de trabalho permanecerão definidas. As tags 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. Esta tarefa não está disponível no portal 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 TitleTaskTitle. A sintaxe especifica valores para os campos Atribuído a, Descrição, Tags, 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 de 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 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 no painel da sua 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, consulte Adicionar Markdown a um painel, Markdown widgets.