Compartilhar via


Referência a elementos XML do modelo de processo

Você pode personalizar o arquivo raiz para um modelo de processo adicionar ou remover arquivos de plug-in. O arquivo raiz define todos os plug-ins e as tarefas usadas para criar um projeto de equipe no Visual Studio Online ou um local no Team Foundation Server. O arquivo raiz, chamado ProcessTemplate, está localizado na pasta de contêiner para os arquivos de modelo de processo. Para obter mais informações, consulte Visão geral de arquivos de modelo de processo.

O elemento pai do arquivo de plug-in da raiz é o ProcessTemplate elemento, que deve ter apenas um metadata e um groups elemento definido. Você deve atribuir um nome exclusivo para cada modelo de processo em uma coleção de projetos de equipe e o nome não pode ter mais de 124 caracteres Unicode.

Dica

Online do Visual Studio: Se você importar um modelo de processo com o mesmo nome e guia como um processo existente, o processo existente é atualizado com todos os projetos de equipe que fazem referência a esse processo.

Para o TFS local: se você carregar um modelo de processo com o mesmo nome de um modelo existente, o modelo existente será substituído.

Neste tópico

  • Estrutura de sintaxe ProcessTemplate

  • Referência de elemento de metadados

  • Referência de elemento de grupos

Estrutura de sintaxe ProcessTemplate

A plug-in de modelos de processo de raiz deve ser especificada em seu próprio arquivo no ProcessTemplate elemento contêiner e estar de acordo com o esquema para modelos de processo, que é definido nos arquivos ProcessTemplate.xsd e ProcessTemplateItem.xsd. Você pode baixar os arquivos de esquema para modelos de processos nesta página do site da Microsoft: Modelo de processos e esquemas de itens de trabalho para Visual Studio Team Foundation.

O exemplo a seguir mostra a estrutura da raiz ProcessTemplate elemento. Para obter um exemplo mais abrangente, consulte Definir as tarefas raiz usando o arquivo de plug-in de modelo de processo.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

Referência de elemento de metadados

A sintaxe a seguir mostra a estrutura do elemento metadata e seus elementos filho.

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <version type="ID" major="Number1" minor="Number2" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Elemento

Sintaxe

Descrição

description

<description>ProcessTemplateDescription</description>

Elemento filho de metadata obrigatório.

Define o texto da descrição que aparece no novo Assistente de projeto de equipe para o modelo de processo.

metadata

<metadata>
    <name> . . . </name>
    <description> . . . </description>
    <version type="ID" major="Number1" minor="Number2/>
    <plugins> . . . </plugins>
</metadata>

Elemento filho de ProcessTemplate obrigatório.

Elemento de contêiner para especificar as informações para o plug-in ser processado pelo Assistente para novo projeto de equipe necessárias.

name

<name>ProcessTemplateName</name>

Elemento filho de metadata obrigatório.

Define o nome do modelo de processo, que deve ser exclusivo na coleção de projetos de equipe. O comprimento máximo do nome é 124 caracteres.

plugin

<plugin name="Microsoft.ProjectCreationWizard.PluginName 
wizardPage="true | false" />

Elemento filho de plugins obrigatório.

Especifica o nome de um arquivo de plug-in para incluir na criação do modelo de processo e especifica se o plug-in deve ter uma página visível no Assistente para novo projeto de equipe.

plugins

<plugins>
   <plugin> . . . </plugin>
</plugins>

Elemento filho de metadata obrigatório.

Elemento de contêiner que define os plug-ins para o modelo de processo.

version

<version type="ID" major="Number1" minor="Number2 " />

Elemento filho de metadata obrigatório.

Especifica uma ID exclusiva e os números de revisão principal e secundário para identificar a versão do modelo de processo.

Referência de elemento de grupos

A sintaxe a seguir mostra a estrutura do elemento groups e seus elementos filho.

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

Elemento

Sintaxe

Descrição

dependencies

<dependencies>
<dependency>. . . </dependency>
</dependencies>

Elemento filho de group obrigatório.

Especifica as dependências que tem o grupo em outros grupos.

dependency

<dependency groupId="groupId" />

Elemento filho opcional de dependencies.

Especifica a ID de outro grupo de tarefas depende desse grupo. O outro grupo deve concluir suas tarefas antes de começar a esse grupo de tarefas.

group

<group id="TaskGroupId" 
   description="TaskGroupDescription" 
   completionMessage="SuccessMessage" 
   failureMessage="FailureMessage">
   <dependencies> . . . <dependencies>
   <taskList> . . . </taskList>
</group>

Elemento filho de groups obrigatório.

Identifica um conjunto de tarefas para um plug-in para serem executadas durante a criação do projeto. Os seguintes valores são válidos para cada atributo:

  • id: especifica um nome que identifica o grupo de tarefas. Se outro grupo de tarefas depende desse grupo, ele faz referência a essa ID. Você deve atribuir um valor exclusivo para a ID do arquivo de plug-in.

  • Descrição: Especifica a mensagem para indicar durante a criação do projeto de equipe, que o grupo de tarefas está sendo processado.

  • completionMessage: Especifica a mensagem para indicar durante a criação do projeto de equipe, o grupo de tarefas foi concluída com êxito. Comprimento máximo é de 256 caracteres.

  • failureMessage: Especifica a mensagem a indicar, durante a criação de projeto de equipe, que o grupo de tarefas não foi concluída com êxito.

groups

<groups>
    <group> . . . </group>
</groups>

Elemento filho de ProcessTemplate obrigatório.

Elemento de contêiner que define o conjunto de grupos de tarefas que serão executados durante a criação do projeto.

tasklist

<taskList filename="filePath" />

Especifica um arquivo XML que contém a lista de tarefas para serem executadas. A lista de tarefas para um grupo deve estar sempre em um arquivo XML separado. Para obter mais informações sobre como especificar esses arquivos, consulte Definir as tarefas para processar um plug-in.

Consulte também

Conceitos

Visão geral de arquivos de modelo de processo

Definir as tarefas para processar um plug-in

Definir dependências para grupos de tarefas e tarefas em arquivos de plug-in

Personalizar um processo

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