Definiowanie zadań w celu przetworzenia wtyczki

  • Artykuł

Za pomocą tasks elementu i jego elementów podrzędnych, aby zdefiniować artefakty, aby przekazać lub konkretnych elementów ma być utworzony dla dodatku typu plug-in.Zadania określa pracy musi wystąpić czegoś konkretnego procesu konfigurowania w nowego zespołu projektu.Numer zadania, które można zdefiniować przekazywanie typów elementów pracy, kwerendy elementu pracy, dokumenty i raporty dla zespołu projektu.Inne zadania, które można zdefiniować skonfigurować inne obszary Visual Studio Application Lifecycle Management, takich jak Team Foundation Build, Visual Studio Lab Management, Test Manager, i Kontrola wersji programu Team Foundation.

W tym temacie

  • Struktura składni zadań

  • Odwołanie Element zadania

  • TaskXML elementów przez funkcję indeks

  • Przykład: Definiowanie typów elementów pracy

Struktura składni zadań

Można określić kilka zadań w ramach dodatku typu plug-in oraz tych zadań może być zależny od siebie.Zadania, które można zdefiniować dla każdego dodatku muszą odpowiadać definicji schematu dla tasks, zdefiniowane w pliku Tasks.xsd i określone w własny plik za pomocą tasks elementu-kontenera.

Następująca składnia pokazuje strukturę wysokiego poziomu tasks elementu i jego elementów podrzędnych.

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

Powrót do początku

Odwołanie Element zadania

W poniższej tabeli opisano każdy element, który można zdefiniować zadania dla dodatku typu plug-in.

Element

Składnia

Opis

dependencies

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

Opcjonalne podrzędnego elementu task.

Określa innych grup, od których zależy grupy.

dependency

 
<dependency taskId="taskId" />

Opcjonalne podrzędnego elementu dependencies.

Określa identyfikator innego zadania, od którego zależy to zadanie.Przed rozpoczęciem tego zadania, należy wykonać inne zadanie.

ProcessTemplate

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

Gdzie każdy atrybut jest zdefiniowany następująco:

  • Type: Typ przekazać plik.Następujące wartości są prawidłowe: Default i Upgrade dla plików szablonów kompilacji i Custom dla plików szablonów w laboratorium.

  • Filename: Katalog lokalny ścieżkę i nazwę pliku do przekazania.

  • Description: Krótki ciąg tekstowy opisujący plik do wysłania.

  • ServerPath: Ścieżka serwera z systemem Team Foundation Server gdzie przekazać plik.Lokalizacja przekazywanie tylko ważne jest $/$$PROJECTNAME$$/BuildProcessTemplates.

Opcjonalne podrzędnego elementu taskXml element dodatków kompilacji i Lab.

Określa nazwę, lokalizację i docelowy plik do wysłania do obsługi procesów budowania zespołu projektu.

task

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

Wymagany element podrzędny z tasks.

Określa pracy musi wystąpić czegoś konkretnego procesu konfigurowania w nowego zespołu projektu.

  • id: Określa nazwę, która identyfikuje zadanie.Jeśli to zadanie zależy od innego zadania, odwołuje się ten identyfikator.Należy przypisać unikatową wartość dla Identyfikatora pliku dodatku.

  • name: Opis zadania jest.

  • plugin: Określa, który dodatek należy uruchomić to zadanie.

  • completionMessage: Określa komunikat wyświetlany podczas tworzenia projektu zespołu, aby wskazać, że zadanie zostało pomyślnie ukończone.Maksymalna długość wynosi 256 znaków.

  • completionDescription: Określa komunikat wyświetlany podczas tworzenia projektu zespołu, aby wskazać, że zadanie jest przetwarzany.Minimalna długość wynosi 1 znak.

tasks

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

Wymagany element podrzędny z taskXml.

Kolekcja zawiera task elementy każdego określić pracy musi wystąpić czegoś konkretnego procesu konfigurowania w nowego zespołu projektu.

taskXml

 
<taskXml> . . . </taskXml>

Element główny wymaga pliku dodatku.

Zawiera opis pracy wymagany do wykonania tego zadania.Wewnątrz bloku tego elementu XML zmienia się i jest specyficzne dla każdego dodatku plug-in.

[!UWAGA]

Procesor XML nie próbuje sprawdzić poprawność zawartości wewnątrz elementu.

Powrót do początku

TaskXML elementów przez funkcję indeks

Aby uzyskać więcej informacji o specyfice znaczników XML, które można określić dla każdego dodatku, zobacz jeden z następujących tematów:

Powrót do początku

Przykład: Definiowanie typów elementów pracy

W poniższym przykładzie tworzy sześć typów elementów pracy, odwołując się do plików definicji dla każdego typu zadania.

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

Powrót do początku

Zobacz też

Koncepcje

Definiowanie zależności dla grup zadań i zadań w plikach wtyczek

Przegląd plików szablonów procesów