Partilhar via

Definir as tarefas para processar um plug-in

  • Artigo

Você usa o elemento de tasks e seus elementos filho para definir os artefatos sejam carregados ou determinados elementos a serem criados para um plug-in. Uma tarefa especifica o trabalho que deve ocorrer para configurar algo específico para o processo em um novo projeto de equipe. Um número de tarefas que você define o carregamento os tipos de itens de trabalho, item de trabalho, consulte documentam, e relatórios para um projeto de equipe. Outras tarefas que você pode definir configurar outras áreas de Visual Studio Application Lifecycle Management, como Team Foundation Build, Visual Studio Lab Management, Test Manager, e Controle de versão do Team Foundation.

Neste tópico

  • Estrutura de sintaxe de tarefas

  • Referência do elemento de tarefas

  • Índice elementos de taskXML pela função

  • Exemplo: Definindo tipos de itens de trabalho

Estrutura de sintaxe de tarefas

Você pode especificar várias tarefas em um plug-in, e essas tarefas podem ter dependências em uma outras. As tarefas que você define para cada plug-in devem estar de acordo com a definição de esquema para tasks, definida no arquivo de Tasks.xsd, e são especificadas em seu próprio arquivo usando o elemento contêiner de tasks .

A sintaxe a seguir mostra a estrutura de alto nível do elemento de tasks e seus elementos filhos.

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

De volta ao topo

Referência do elemento de tarefas

A tabela a seguir descreve cada elemento que pode definir as tarefas para um plug-in.

Elemento

Sintaxe

Descrição

dependencies

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

Elemento filho opcional de task.

Especifica que outros grupos de um grupo depende.

dependency

 
<dependency taskId="taskId" />

Elemento filho opcional de dependencies.

Especifica a identificação de outra tarefa que depende de essa tarefa. Outra tarefa deve terminar antes que possa iniciar esta tarefa.

ProcessTemplate

 
<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

Onde cada atributo é definido como segue:

  • Type: o tipo de arquivo que está sendo carregado. Os seguintes valores são válidas: Default e Upgrade para arquivos de modelo de compilação e Custom para arquivos de modelo de laboratório.

  • Filename: O caminho local e o nome do arquivo para carregar.

  • Description: Uma cadeia de caracteres de texto curto que descreve o arquivo para carregar.

  • ServerPath: O caminho de servidor que está executando Team Foundation Server onde o arquivo deve ser carregado. O único local válido de carregamento é $/$$PROJECTNAME$$/BuildProcessTemplates.

Elemento filho opcional de elemento de taskXml para os plug-ins de compilação e de laboratório.

Especifica o nome, o local, e o destino de um arquivo para carregar para suportar processos de compilação para um projeto de equipe.

task

 
<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

Elemento filho de tasksnecessário.

Especifica o trabalho que deve ocorrer para configurar algo específico para o processo em um novo projeto de equipe.

  • id: Especifica um nome que identifica a tarefa. Se outra tarefa depende de esta tarefa, faz referência a essa identificação Você deve atribuir um valor exclusivo para a identificação no arquivo da plataforma.

  • name: Descreve o que faz a tarefa.

  • plugin: Identifica o plug-in deve executar esta tarefa.

  • completionMessage: Especifica a mensagem a ser exibida durante a criação do projeto de equipe para indicar que a tarefa for concluída com êxito. o comprimento máximo é 256 caracteres.

  • completionDescription: Especifica a mensagem a ser exibida durante a criação do projeto de equipe para indicar que a tarefa está sendo processada. O comprimento mínimo é 1 caracteres.

tasks

 
<tasks>
    <task>. . . </task>
</tasks>

Elemento filho de taskXmlnecessário.

Contém uma coleção de elementos de task que cada um especifica o trabalho que deve ocorrer para configurar algo específico para o processo em um novo projeto de equipe.

taskXml

 
<taskXml> . . . </taskXml>

Elemento raiz necessário para um arquivo da plataforma.

Descreve o trabalho que é necessário para concluir esta tarefa. XML dentro de este bloco de elemento e varia é específico para cada plug-in.

Dica

O processador XML não tenta validar o conteúdo dentro do elemento.

De volta ao topo

Índice elementos de taskXML pela função

Para obter mais informações sobre específicos de elementos de marcação XML que você pode especificar para cada plug-in, consulte um dos seguintes tópicos:

De volta ao topo

Exemplo: Definindo tipos de itens de trabalho

O exemplo a seguir mostra uma tarefa que cria seis tipos de itens de trabalho referenciar os arquivos de definição para cada tipo.

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

De volta ao topo

Consulte também

Conceitos

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

Visão geral de arquivos de modelo de processo