Elementy szablonu procesów XML — Odwołanie

Można dostosować plik podstawowy do wzorca procesu albo dodać lub usunąć pliki wtyczkowe.Główny plik definiuje wszystkie wtyczki i wszystkie zadania, które będzie przetwarzać Kreator nowego projektu zespołowego.Dla szablonów procesów środowiska Microsoft Solutions Framework (MSF) plik główny ma nazwę ProcessTemplate i znajduje się w folderze kontenera dla plików szablonów procesów.Aby uzyskać więcej informacji, zobacz Przegląd plików szablonów procesów.

Element nadrzędny głównego pliku wtyczki jest elementem ProcessTemplate, który musi mieć zdefiniowany tylko jeden element metadata i jeden element groups.Należy przypisać unikatową nazwę do każdego szablonu procesu w kolekcji projektu zespołu, a nazwa nie może być dłuższa niż 124 znaków Unicode.

Przestroga
Jeśli załadujesz szablon o nazwie identycznej z nazwą istniejącego szablonu, istniejący szablon zostanie zastąpiony.

W tym temacie

• Struktura składni Szablon procesu

• Odniesienie do elementu metadanych

• Grupuje odwołania elementu

Struktura składni Szablon procesu

Główna wtyczka dla szablonów procesów musi być określona w jej własnym pliku w kontenerze ProcessTemplate i być zgodna ze schematem dla szablonów procesów, który jest zdefiniowany w plikach ProcessTemplate.xsd i ProcessTemplateItem.xsd.Możesz pobrać pliki schematów dla szablonów procesu z następującej strony w witrynie Microsoft: Schematy szablonów procesu i elementów roboczych dla Visual Studio Team Foundation.

Poniższy przykład pokazuje strukturę katalogu głównego elementu ProcessTemplate.Chcąc zapoznać się z bardziej szczegółowym przykładem, zobacz Definiowanie zadań głównych z wykorzystaniem pliku wtyczki szablonu procesu.

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

Odniesienie do elementu metadanych

Poniższa składnia ukazuje strukturę elementu metadata oraz jego elementy podrzędne.

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Element	Składnia	Opis
description	<description>ProcessTemplateDescription</description>	Wymagany element podrzędny metadata. Określa tekst opisu, który pojawia się w Kreatorze nowego projektu zespołowego dla szablonu procesu.
metadata	<metadata> <name> . . . </name> <description> . . . </description> <plugins> . . . </plugins> </metadata>	Wymagany element podrzędny ProcessTemplate. Element kontenera służy do określania wymaganych informacji dla dodatku typu plug-in, który ma zostać przetworzony przez Kreatora nowego projektu zespołowego.
name	<name>ProcessTemplateName</name>	Wymagany element podrzędny metadata. Definiuje nazwę szablonu procesu, która musi być unikatowa dla całej kolekcji projektu zespołowego.Maksymalna długość nazwy to 124 znaki.
plugin	<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true | false" />	Wymagany element podrzędny plugins. Określa nazwę pliku wtyczki do uwzględnienia w procesie tworzenia szablonu i określa, czy ta wtyczka powinna mieć widoczną stronę w Kreatorze nowego projektu zespołowego.
plugins	<plugins>    <plugin> . . . </plugin> </plugins>	Wymagany element podrzędny metadata. Element kontenera, który definiuje wtyczki dla szablonu procesu.
version	<version type="ID" major="Number1" minor="Number2 " />	Opcjonalny element podrzędny metadata. Określa unikatowy identyfikator oraz numery wersji głównej i pomocniczej określające wersję szablonu procesu.

Grupuje odwołania elementu

Poniższa składnia ukazuje strukturę elementu groups oraz jego elementy podrzędne.

<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 group. Określa zależności grupy od innych grup.
dependency	<dependency groupId="groupId" />	Opcjonalny element podrzędny dependencies. Określa identyfikator innej grupy zadań, od którego zależy ta grupa.Inna grupa musi wykonać swoje zadania, zanim ta grupa będzie mogła rozpocząć.
group	<group id="TaskGroupId"    description="TaskGroupDescription"    completionMessage="SuccessMessage"    failureMessage="FailureMessage">    <dependencies> . . . <dependencies>    <taskList> . . . </taskList> </group>	Wymagany element podrzędny groups. Identyfikuje zestaw zadań dla wtyczki do wykonania podczas tworzenia projektu.Dla każdego atrybutu prawidłowe są następujące wartości: id: Określa nazwę, która identyfikuje grupę zadań.Jeśli inna grupa zadań zależy od tej grupy, odwołuje się to tego identyfikatora.Należy przypisać unikatową wartość dla Identyfikatora w pliku wtyczki. opis: Określa komunikat wskazujący, podczas tworzenia projektu zespołowego, że grupa zadania jest przetwarzana. completionMessage: Określa komunikat wskazujący, podczas tworzenia projektu zespołowego, że ukończenie grupy zadań zakończyło się pomyślnie.Maksymalna długość wynosi 256 znaków. failureMessage: Określa komunikat wskazujący podczas tworzenia projektu zespołowego, że ukończenie grupy zadań nie powiodło się.
groups	<groups> <group> . . . </group> </groups>	Wymagany element podrzędny ProcessTemplate. Element kontenera, który definiuje zestaw grup zadań, które będą uruchamiane podczas tworzenia projektu.
tasklist	<taskList filename="filePath" />	Określa plik XML zawierający listę zadań do wykonania.Lista zadań dla grupy musi zawsze znajdować się w osobnym pliku XML.Aby uzyskać więcej informacji na temat 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

Dostosowywanie szablonu procesów

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