Elementy szablonu procesów XML — Odwołanie

Artykuł
09/13/2015

Można dostosować głównego pliku dla szablonu procesu dodać lub usunąć pliki dodatku plug-in. Plik główny definiuje dodatków plug-in i zadania służące do tworzenia projektu zespołowego w programie Visual Studio Online lub lokalnie Team Foundation Server. Głównego pliku o nazwie ProcessTemplate, znajduje się w folderze kontenera pliki szablonu procesu. Aby uzyskać więcej informacji, zobacz Przegląd plików szablonów procesów.

Element nadrzędny głównego pliku dodatku plug-in jest ProcessTemplate element, który musi mieć tylko jeden metadata i jednego groups elementu zdefiniowanego. Należy przypisać unikatową nazwę do każdego procesu szablonu w kolekcji projektów zespołowych i nazwa nie może być dłuższy niż 124 znaków Unicode.

Uwaga

Dla programu Visual Studio Online: W przypadku zaimportowania szablonu procesu z taką samą nazwę i przewodnik jako istniejącego procesu, istniejącego procesu zostanie zaktualizowana wraz ze wszystkich projektów zespołowych, które odwołują się do tego procesu.

Dla lokalnych TFS: Jeśli przekażesz szablon procesu o takiej samej nazwie, jak istniejący szablon istniejącego szablonu zostaną zastąpione.

W tym temacie:

Struktura składni ProcessTemplate
Odwołanie do elementu metadanych
Odwołanie do elementu grupy

Struktura składni ProcessTemplate

Dodatek plug-in dla szablony procesów katalogu głównego musi być określone w własny plik w ProcessTemplate element kontenera i zgodny ze schematem dla szablony procesów, który został zdefiniowany w plikach ProcessTemplate.xsd i ProcessTemplateItem.xsd. Pliki schematów dla szablony procesów można pobrać z następującej strony w witrynie sieci Web firmy Microsoft: szablon procesu i schematów elementu roboczego dla programu Visual Studio Team Foundation.

W poniższym przykładzie przedstawiono struktury katalogu głównego ProcessTemplate elementu. Na przykład szerszej zobacz Definiowanie zadań głównych z wykorzystaniem pliku wtyczki szablonu procesu.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

Odwołanie do elementu metadanych

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

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <version type="ID" major="Number1" minor="Number2" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Element	Składnia	Opis
description	`<description>ProcessTemplateDescription</description>`	Wymagany element podrzędny elementu metadata. Definiuje tekst opisu, który pojawi się w Kreatorze nowego projektu Team szablonu procesu.
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <version type="ID" major="Number1" minor="Number2/> <plugins> . . . </plugins> </metadata>`	Wymagany element podrzędny elementu ProcessTemplate. Element kontenera do określania wymaganych informacji dla dodatek, który ma zostać przetworzony przez Kreatora nowego projektu zespołowego.
name	`<name>ProcessTemplateName</name>`	Wymagany element podrzędny elementu metadata. Definiuje nazwę szablonu procesu, który musi być unikatowa w kolekcji projektów zespołowych. Maksymalna długość nazwy jest 124 znaków.
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	Wymagany element podrzędny elementu plugins. Określa nazwę dodatku plug-in pliku do uwzględnienia w proces tworzenia szablonu oraz określa, czy dodatku plug-in powinien mieć widoczne strony Kreatora nowego projektu zespołowego.
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	Wymagany element podrzędny elementu metadata. Element kontenera, który definiuje dodatków dla szablonu procesu.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Wymagany element podrzędny elementu metadata. Określa identyfikator unikatowy i numery wersji głównych i pomocniczych do identyfikowania wersji szablonu procesu.

Odwołanie do elementu grupy

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

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

Element	Składnia	Opis
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	Wymagany element podrzędny elementu group. Określa zależności, które grupy ma w innym grupom.
dependency	`<dependency groupId="groupId" />`	Element podrzędny opcjonalne dependencies. Określa identyfikator inną grupę zadanie, od którego zależy tej grupy. Grupa inne należy ukończyć jego zadań, przed rozpoczęciem tej grupy zadań.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Wymagany element podrzędny elementu groups. Identyfikuje zestaw zadań dla dodatku plug-in do wykonania podczas tworzenia projektu. Następujące wartości są prawidłowe dla każdego atrybutu: identyfikator: Określa nazwę, która identyfikuje grupy zadań. Inną grupę zadanie zależne od tej grupy, odwołuje się do tego identyfikatora. Należy przypisać unikatową wartość dla Identyfikatora w pliku dodatku plug-in. Opis: Określa komunikat do wskazania podczas tworzenia projektu zespołowego, jest przetwarzane grupy zadań. completionMessage: Określa komunikat do wskazania podczas tworzenia projektu zespołowego, że grupa zadań została ukończona pomyślnie. Maksymalna długość to 256 znaków. failureMessage: Określa wiadomości, aby wskazać, podczas tworzenia projektu zespołu, która nie została prawidłowo wykonana grupy zadań.
groups	`<groups> <group> . . . </group> </groups>`	Wymagany element podrzędny elementu ProcessTemplate. Element kontenera, który definiuje zestaw grup zadań, które będą działać podczas tworzenia projektu.
tasklist	`<taskList filename="filePath" />`	Określa plik XML, który zawiera listę zadań do wykonania. Na liście zadań grupy musi być zawsze w oddzielnym pliku XML. Aby uzyskać więcej informacji o sposobie określania tych plików, zobacz Definiowanie zadań w celu przetworzenia wtyczki.

Zobacz też

Koncepcje

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

Definiowanie zadań w celu przetworzenia wtyczki

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

Dostosowanie procesu

Definiowanie zadań głównych z wykorzystaniem pliku wtyczki szablonu procesu

Udostępnij za pośrednictwem