Partilhar via

Definir as tarefas para processar um plug-in

  • Artigo

Você usa o tasks elemento e seus elementos filho para definir os artefatos para ser carregado ou elementos específicos 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ê definir carregar os tipos de item de trabalho, consultas de itens de trabalho, documentos e relatórios para um projeto de equipe. Outras tarefas que você pode definir configurar outras áreas do 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 de elemento de tarefas

  • Índice para elementos pela função taskXML

  • Exemplo: Definindo tipos de itens de trabalho

Estrutura de sintaxe de tarefas

Você pode especificar várias tarefas dentro de um plug-in, e essas tarefas podem ter dependências entre si. As tarefas que você definir para cada plug-in deve estar de acordo com a definição de esquema para tasks, definido no arquivo Tasks.xsd e ser especificado em seu próprio arquivo usando o tasks elemento contêiner.

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

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

Voltar ao início

Referência de elemento de tarefas

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

Elemento

Sintaxe

Descrição

dependencies

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

Elemento filho opcional de task.

Especifica a outros grupos dos quais depende de um grupo.

dependency

 
<dependency taskId="taskId" />

Elemento filho opcional de dependencies.

Especifica a ID de outra tarefa da qual essa tarefa depende. A outra tarefa deve concluir antes de começar a essa tarefa.

ProcessTemplate

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

Onde cada atributo é definido da seguinte maneira:

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

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

  • Description: Uma cadeia de caracteres de texto curta que descreve o arquivo a ser carregado.

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

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

Especifica o nome, o local e o destino de um arquivo para carregar para dar suporte a 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 tasks obrigató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 depender essa tarefa, ele faz referência a essa ID. Você deve atribuir um valor exclusivo para a ID do arquivo de plug-in.

  • name: Descreve o que faz a tarefa.

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

  • completionMessage: Especifica a mensagem a ser exibida durante a criação do projeto de equipe para indicar que a tarefa foi concluída com êxito. Comprimento máximo é de 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 caractere.

tasks

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

Elemento filho de taskXml obrigatório.

Contém uma coleção de task elementos que especificam 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 de plug-in.

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

Dica

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

Voltar ao início

Índice para elementos pela função taskXML

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

Voltar ao início

Exemplo: Definindo tipos de itens de trabalho

O exemplo a seguir mostra uma tarefa que cria seis tipos de itens de trabalho referenciando 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>

Voltar ao início

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