Udostępnij za pośrednictwem

Definiowanie zadań w celu przetworzenia wtyczki

  • Artykuł

Możesz użyć tasks elementu i jego elementów podrzędnych do definiowania artefaktów do przesłania lub określonych elementów do utworzenia dla dodatku plug-in. Zadanie określa pracę, jaką musi przypadać do konfigurowania określonego procesu elementu w nowego projektu zespołowego. Liczba zadań, które można zdefiniować przekazać typów elementów roboczych, zapytania elementu pracy, dokumentów i raportów dla projektu zespołowego. 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 zadania

  • Odwołanie do elementu zadania

  • Indeks taskXML elementów za pomocą funkcji

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

Struktura składni zadania

Można określić kilku zadań w dodatku plug-in, a te zadania może być powiązany z sobą. Zadania, które definiują dla każdego dodatku plug-in musi być zgodna z definicji schematu dla tasks, zdefiniowanych w pliku Tasks.xsd i można określić w własne pliku przy użyciu tasks element 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 do elementu zadania

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

Element

Składnia

Opis

dependencies

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

Element podrzędny opcjonalne task.

Określa innym grupom, od których zależy grupy.

dependency

 
<dependency taskId="taskId" />

Element podrzędny opcjonalne dependencies.

Określa identyfikator innego zadania, od którego zależy to zadanie. Inne zadania należy ukończyć przed rozpoczęciem tego zadania.

ProcessTemplate

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

Gdzie każdy atrybut jest zdefiniowany w następujący sposób:

  • Type: Typ pliku, który można przekazać. Następujące wartości są prawidłowe: Default i Upgrade dla plików szablonów kompilacji i Custom dla laboratorium pliki szablonu.

  • Filename: Katalogu lokalnego ścieżkę i nazwę pliku do przekazania.

  • Description: Krótki ciąg tekstowy opisujący plik do przekazania.

  • ServerPath: Ścieżka serwera, na którym działa Team Foundation Server gdzie należy przekazać plik. Lokalizacja jedyne prawidłowe przekazywania jest $/$$PROJECTNAME$$/BuildProcessTemplates.

Element podrzędny opcjonalne taskXml elementu do kompilacji i laboratoryjnego dodatków plug-in.

Określa nazwę, lokalizację i miejsce docelowe plik do przekazania do obsługi procesów kompilacji dla projektów zespołowych.

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 elementu tasks.

Określa pracę, jaką musi przypadać do konfigurowania określonego procesu elementu w nowego projektu zespołowego.

  • id: Określa nazwę, która identyfikuje zadanie. To zadanie zależy od innego zadania, odwołuje się do tego identyfikatora. Należy przypisać unikatową wartość dla Identyfikatora w pliku dodatku plug-in.

  • name: Opisano funkcję zadania.

  • plugin: Umożliwia określenie, które wtyczki należy uruchomić to zadanie.

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

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

tasks

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

Wymagany element podrzędny elementu taskXml.

Zawiera zbiór task elementy czy każdy określić pracę, jaką musi przypadać do konfigurowania określonego procesu elementu w nowego projektu zespołowego.

taskXml

 
<taskXml> . . . </taskXml>

Element główny wymagane dla pliku dodatku plug-in.

Zawiera opis zadań do wykonania tego zadania jest wymagane. Kod XML w bloku ten element jest różny i właściwymi dla każdego dodatku plug-in.

UwagaUwaga
Procesor XML nie próbuje zweryfikować zawartość w elemencie.

Powrót do początku

Indeks taskXML elementów za pomocą funkcji

Aby uzyskać więcej informacji o szczegółowe informacje na temat elementów znaczników XML, które można określić dla każdego z nich dodatku plug-in, patrz część jednej z następujących tematów:

Powrót do początku

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

W poniższym przykładzie przedstawiono klasę task, która tworzy sześć typów elementów pracy przy odwołujące się do plików definicji dla każdego typu.

<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