Definir as tarefas raiz usando o arquivo de plug-in de modelo de processo

Artigo
06/09/2015

Personalizando o arquivo ProcessTemplate.xml, você pode adicionar, remover, ou alterar a sequência na qual os arquivos de plug-in do modelo de processo são processados. O ProcessTemplate.xml é o arquivo raiz que define todo o modelo de processo completo e todos os arquivos XML subordinados. Este arquivo contém todos os grupos de tarefas que devem ser executados para a criação bem-sucedida de um projeto de equipe. Cada grupo de tarefas faz referência a um arquivo XML subordinado (frequentemente em uma subpasta) onde as tarefas específicas são definidas. Em geral, você especifica um grupo de tarefas para cada plug-in.

Clique aqui para saber mais sobre os modelos de processo padrão do TFS. Clique aqui para aprender sobre os arquivos de plug-in de modelo de processo.

Neste tópico

Estrutura do arquivo ProcessTemplate.xml
Defina os plug-ins e os grupos de trabalho
Arquivo ProcessTemplate de exemplo

Estrutura do arquivo ProcessTemplate.xml

Em cada arquivo ProcessTemplate.xml, você define metadados e grupos de trabalho. Os metadados descrevem o modelo e especificam os plug-ins a serem processados, como mostrado no exemplo a seguir

<metadata>
    <name>MSF for Agile Software Development 2013</name>
    <description>This template is flexible and will work great for most teams using Agile planning methods, including those practicing Scrum.</description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
. . .
    </plugins>
</metadata>

Os grupos de tarefas especificam as dependências e as tarefas a serem executadas para cada plug-in, como mostra o exemplo a seguir:

<groups>
    <group id="Classification" description="Structure definition for the project." completionMessage="Project Structure uploaded.">
      <dependencies></dependencies>
      <taskList filename="Classification\Classification.xml" />
    </group>
    <group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">
      <dependencies>
        <dependency groupId="Classification" />
      </dependencies>
      <taskList filename="Groups and Permissions\GroupsandPermissions.xml" />
    </group>
. . .
</groups>

De volta ao topo

Defina os plug-ins e os grupos de trabalho

Você personaliza o arquivo ProcessTemplate.xml usando o elemento ProcessTemplate e seus elementos filho. Para obter mais informações sobre a sintaxe de cada elemento, consulte Referência a elementos XML do modelo de processo.

Você define as tarefas de plug-ins e raiz a serem processadas especificando as informações a seguir na sequência indicada:

nome. Você usa este elemento para atribuir um rótulo ao modelo de processo. No assistente de novo projeto de equipe, você especifica o modelo de processo baseado em seu nome, conforme mostra o exemplo a seguir:
```
<name>Simplified Process</name>
```
Esse elemento é necessário. O nome aparece não só na lista de modelos de processo no Novo assistente do Team Project como também na caixa de diálogo Gerenciador de Modelo de Processo. O nome de modelo de processo em uma coleção de projeto de equipe deve ser único, e o nome de cada modelo não pode ser maior de 254 caracteres Unicode. Se você carregar um modelo com o mesmo nome de um modelo existente, o modelo existente será substituído.
descrição. Você usa este elemento para definir o texto que descreve o modelo de processo no Assistente do Novo Projeto da Equipe, como mostra o exemplo a seguir:
```
<description>Choose the simple process for projects that require little or no overhead and have very low cost.</description>
```
Esse texto aparece na tela Selecionar um Modelo de Processo no novo assistente de Projeto de equipe quando um líder ou um administrador do projeto está decidindo qual modelo de processo será usado. Em geral, tente descrever quais os tipos de projetos para os quais o modelo de processo é útil em termos de tamanho de equipe, comprimento, custos, e outros fatores.

Plug-ins. Você usa os elementos plugins e plugin para definir o conjunto de plug-ins que o modelo de processo usa. Certifique-se de que se qualquer arquivo XML subordinado fizer referência a um plug-in, esse plug-in aparecerá nesta lista. Você também deve especificar o atributo wizardPage (um valor true ou false) para indicar se o plug-in requer uma página no Assistente do Novo Projeto da Equipe. Você deve especificar o conjunto de plug-ins que serão processados ao criar um projeto de equipe e se o plug-in deve ter uma página visível no Assistente do Novo Projeto da Equipe.

O XML a seguir mostra os valores corretos a serem usados para cada um dos nove plug-ins incluídos no Visual Studio Application Lifecycle Management (ALM).

<plugins>   <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true"/>   <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true"/>   <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />   <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />   <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" /></plugins>

Grupos de Tarefas. Você usa os elementos groups e group para definir grupos de tarefas. Cada grupo de trabalho define as informações que são necessárias para processar cada plug-in. Cada grupo de trabalho especifica o arquivo que contém o conjunto de tarefas a ser processado e as dependências opcionais que o grupo tem em outros grupos de trabalho. A estratégia mais comum e mais fácil é criar um elemento taskList por grupo por plug-in.

O exemplo a seguir mostra como um grupo de tarefas cria os grupos e as permissões padrão. As tarefas específicas são definidas no arquivo referenciado (GroupsandPermissions.xml). Este grupo de tarefas tem uma dependência que as tarefas no grupo de classificação concluem com êxito.
```
<group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">   <dependencies>      <dependency groupId="Classification" />   </dependencies>   <taskList filename="Groups and Permissions\GroupsandPermissions.xml" /></group>
```
Para cada grupo de trabalho, você define as seguintes informações:
1. ID. Uma identificação única atribuída ao plug-in.
2. Descrição. O texto que descreve as tarefas de plug-in no Novo assistente de projeto de equipe.
3. Mensagem de conclusão. A mensagem que aparecerá no Novo assistente do Team Project quando todas as tarefas do plug-in forem concluídas com êxito.
4. (Opcional) Mensagem de falha. A mensagem que aparecerá no Novo assistente do Team Project quando a conclusão de uma ou mais tarefas do plug-in falhar.
5. (Opcional) Dependências do plug-in. Você usa os elementos dependencies e dependency para definir o conjunto de dependências para um plug-in ser processado. Uma dependência corresponde a um plug-in que deve terminar com êxito antes que as tarefas de plug-in atual possam ser processadas.
6. Arquivo de tarefa. Você usa o elemento tasklist para especificar o arquivo que contém o conjunto de tarefas para processar o plug-in.

De volta ao topo

Arquivo ProcessTemplate de exemplo

A sintaxe a seguir lista os conteúdo do arquivo ProcessTemplate.xml para o Microsoft Visual Studio Scrum.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
  <metadata>
    <name>Microsoft Visual Studio Scrum 2013</name>
    <description>This template is for teams who follow the Scrum methodology and use Scrum terminology.</description>
<version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="6" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
    </plugins>
  </metadata>
  <groups>
    <group id="Classification" description="Structure definition for the project." completionMessage="Project structure uploaded.">
      <dependencies>
</dependencies>
      <taskList filename="Classification\Classification.xml" />
    </group>
    <group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">
      <dependencies>
        <dependency groupId="Classification" />
      </dependencies>
      <taskList filename="Groups and Permissions\GroupsAndPermissions.xml" />
    </group>
    <group id="WorkItemTracking" description="Work item definitions uploading." completionMessage="Work item tracking tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="WorkItem Tracking\WorkItems.xml" />
    </group>
    <group id="VersionControl" description="Creating version control." completionMessage="Version control task completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
      </dependencies>
      <taskList filename="Version Control\VersionControl.xml" />
    </group>
    <group id="Build" description="Build default processes uploading." completionMessage="Build default processes uploaded.">
      <dependencies>
        <dependency groupId="VersionControl" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="Build\Build.xml" />
    </group>
    <group id="Lab" description="Creating Lab." completionMessage="Lab task completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
        <dependency groupId="Build" />
      </dependencies>
      <taskList filename="Lab\Lab.xml" />
    </group>
    <group id="TestManagement" description="Test Management default configurations uploading." completionMessage="Test Management default configurations uploaded.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
      </dependencies>
      <taskList filename="Test Management\TestManagement.xml" />
    </group>
    <group id="Reporting" description="Project reports uploading." completionMessage="Project reporting tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="WorkItemTracking" />
        <dependency groupId="VersionControl" />
      </dependencies>
      <taskList filename="Reports\ReportsTasks.xml" />
    </group>
    <group id="Portal" description="Creating project portal site" completionMessage="Project portal tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Reporting" />
      </dependencies>
      <taskList filename="Windows SharePoint Services\WssTasks.xml" />
    </group>
  </groups>
</ProcessTemplate>

Consulte também

Conceitos

Visão geral de arquivos de modelo de processo

Personalizar um modelo de processo

Outros recursos

Referência a elementos XML do modelo de processo

Compartilhar via