Sdílet prostřednictvím

Define the tasks to process a plug-in

  • Článek

Můžete použít tasks element a jeho podřízených elementů definovat artefakty být odeslán nebo konkrétní elementy, které má být vytvořen pro modul plug-in. Úloha určuje práci, kterou musí být stejné konfigurace něco specifické pro proces v nové týmového projektu. Počet úloh, které definujete nahrát typy pracovních položek, pracovní položky dotazy, dokumenty a sestavy pro týmový projekt. Další úlohy, které můžete definovat konfigurovat ostatní oblasti Visual Studio – správa životního cyklu aplikací, jako je například Team Foundation Build, Visual Studio Lab Management, Test Manager, a Team Foundation – správa verzí.

V tomto tématu

  • Struktura Syntaxe úlohy

  • Odkaz na Element úlohy

  • Index taskXML prvků pomocí funkce

  • Příklad: Definování typů pracovních položek

Struktura Syntaxe úlohy

Můžete zadat několik úkolů v rámci moduly plug-in a mohou tyto úlohy jsou závislé na sebe navzájem. Úlohy, které definují pro každý modul plug-in musí odpovídat definici schématu pro tasks, definované v souboru Tasks.xsd a své vlastní souboru pomocí je možné zadat tasks elementu kontejneru.

Následující syntaxe ukazuje vysoké úrovně strukturu tasks elementu a jeho podřízených elementů.

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

Zpět na začátek

Odkaz na Element úlohy

Následující tabulka popisuje každý element, který můžete definovat úkoly pro modul plug-in.

Element

Syntaxe

Popis

dependencies

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

Volitelný podřízený prvek task.

Určuje další skupiny, na kterých závisí skupině.

dependency

 
<dependency taskId="taskId" />

Volitelný podřízený prvek dependencies.

Určuje ID jiného úkolu, na kterých závisí tohoto úkolu. Druhý úkol, musíte dokončit před zahájením tohoto úkolu.

ProcessTemplate

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

Kde jednotlivé atributy je definován následujícím způsobem:

  • Type: Typ souboru, který je právě odeslat. Jsou platné tyto hodnoty: Default a Upgrade pro soubory šablon sestavení a Custom pro soubory šablon testovacího prostředí.

  • Filename: Místního adresáře cesta a název souboru, který chcete uložit.

  • Description: Krátký textový řetězec, který popisuje soubor, který chcete uložit.

  • ServerPath: Cesta k serveru, na kterém je spuštěn Team Foundation Server kde musí být nahrán souboru. Je platný pouze nahrávání umístění $/$$PROJECTNAME$$/BuildProcessTemplates.

Volitelný podřízený prvek taskXml element pro sestavování a testovacích prostředí moduly plug-in.

Určuje název, umístění a cílový soubor, který chcete uložit pro podporu procesů sestavení pro týmový projekt.

task

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

Požadovaný podřízený element tasks.

Určuje práci, kterou musí být stejné konfigurace něco specifické pro proces v nové týmového projektu.

  • id: Určuje název, který identifikuje úlohu. Pokud jiný úkol závisí na tuto úlohu, kterou odkazuje tomuto ID. Je nutné přiřadit jedinečnou hodnotu pro ID v rámci soubor modulu plug-in.

  • name: Popisuje, co úloha umožňuje.

  • plugin: Určuje, které modul plug-in úloha spuštěna.

  • completionMessage: Určuje zprávu, chcete-li zobrazit během vytváření projektu týmu, která označuje, že úloha byla úspěšně dokončena. Maximální délka je 256 znaků.

  • completionDescription: Určuje zprávu, chcete-li zobrazit během vytváření projektu týmu označuje, že úloha je zpracováván. Minimální délka je 1 znak.

tasks

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

Požadovaný podřízený element taskXml.

Obsahuje kolekci task elementy, aby každá zadat práci, kterou musí být stejné konfigurace něco specifické pro proces v nové týmového projektu.

taskXml

 
<taskXml> . . . </taskXml>

Požadovaný kořenový element pro modul plug-in soubor.

Popisuje práci, kterou je nutné k provedení této úlohy. XML uvnitř tohoto elementu bloku se mění a je specifické pro každý modul plug-in.

PoznámkaPoznámka
Procesor XML není pokusí se ověřit obsah v rámci elementu.

Zpět na začátek

Index taskXML prvků pomocí funkce

Další informace o specifické prvky značek XML, které můžete určit pro každý modul plug-in, naleznete v následujících tématech:

Zpět na začátek

Příklad: Definování typů pracovních položek

Následující příklad ukazuje úlohu, která vytvoří odkazující na definici soubory pro každý typ šest typů pracovních položek.

<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>

Zpět na začátek

Viz také

Koncepty

Define dependencies for task groups and tasks in plug-in files

Overview of process template files