Definieren von globalen Listen

Mit globalen Listen können Sie den Aufwand verringern, der mit der Aktualisierung einer Liste verbunden ist, die von mehreren Arbeitsaufgabentypen genutzt wird. Globale Listen sind Auswahllisten, die Sie in mehrere Felder und Arbeitsaufgabentypen aufnehmen können. Eine globale Liste kann innerhalb eines Arbeitsaufgabentyps, den Sie einem Teamprojekt oder einer Prozessvorlage hinzufügen, als globale Liste für eine Teamprojektsammlung oder innerhalb eines globalen Workflows definiert werden. Listenelemente können von mehreren Arbeitsaufgabentypen einer Auflistung verwendet werden. Schließen Sie die Listenelemente hierzu in mindestens ein GLOBALLIST-Element ein.

Möglicherweise stellen Sie beim Definieren von Arbeitsaufgabentypen fest, dass einige Felder dieselben Werte verwenden. Häufig kann sich diese gemeinsame Nutzung über mehrere Arbeitsaufgabentypen und sogar über mehrere Teamprojekte erstrecken. Einige dieser Werte ändern sich möglicherweise häufig, z. B. die Buildnummer von nächtlichen Builds, bei denen ein Administrator die Listen häufig an vielen Speicherorten aktualisieren muss. Globale Listen sind besonders nützlich, wenn eine Liste von einem externen System abgeleitet werden muss. Angenommen, ein Unternehmen führt eine separate Kundendatenbank. Wenn ein von einem Kunden festgestellter Fehler protokolliert wird, wird der Kundenname in ein benutzerdefiniertes Feld Found By Customer eingetragen.

Globale Listen können für eine Auflistung als XML-Datei verwaltet werden, die Sie auflisten, importieren, exportieren und löschen können. Der Name jeder globalen Liste kann bis zu 254 Unicode-Zeichen enthalten, und er muss innerhalb einer Auflistung eindeutig sein.

In diesem Thema

• Hinzufügen und Verwalten globaler Listen

• Syntaxstruktur zum Definieren globaler Listen

• Syntaxstruktur globaler Listen, die einer Arbeitsaufgaben-Typdefinition oder einem globalen Workflow hinzugefügt werden

• Syntaxstruktur globaler Listen, die für eine Auflistung verwaltet werden

Hinzufügen und Verwalten globaler Listen

Eine globale Liste ist ein Satz von LISTITEM-Elementen, der gespeichert und global von allen in einer Auflistung enthaltenen Teamprojekten verwendet wird. Globale Listen sind hilfreich für Arbeitsaufgabenfelder, die innerhalb mehrerer Arbeitsaufgabentypen definiert werden, z. B. "Betriebssystem", "In Build gefunden" und "In Build korrigiert".

Globale Listen und deren Elemente können mit einer der folgenden Methoden definiert werden:

• Prozessvorlage: Definieren Sie globale Listen für eine Prozessvorlage. Jedes Teamprojekt, das mithilfe dieser Vorlage erstellt wird, hat Zugriff auf die globalen Listen.

• Teamprojektsammlung: Für eine Teamprojektsammlung definierte globale Listen können exportiert, geändert, gelöscht und importiert werden. Diese globalen Listen stehen für alle Teamprojekte in der Auflistung zur Verfügung.

• Arbeitsaufgaben-Typdefinition: Globale Listen, die für einen Arbeitsaufgabentyp verfügbar sein sollen, können der entsprechenden Typdefinition hinzugefügt werden.

• Definition des globalen Workflows: Globale Listen, die global für alle Arbeitsaufgabentypen verfügbar sein sollen, können der Definition des globalen Workflows für ein Teamprojekt oder eine Auflistung hinzugefügt werden. Weitere Informationen finden Sie unter Anpassen des globalen Workflows.

Zurück nach oben

Syntaxstruktur zum Definieren globaler Listen

In der folgenden Tabelle werden die Elemente GLOBALLIST und LISTITEM beschrieben. Mithilfe dieser Elemente können Sie mehrere Werte aufführen, die dem Benutzer in Form einer Auswahlliste oder eines Dropdownmenüs angezeigt werden.

Element	Syntax	Beschreibung
GLOBALIST	<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>	Dient zum Definieren eines Satzes von LISTITEM-Elementen, der für eine Auflistung gespeichert wird und von allen in der Auflistung enthaltenen Teamprojekten verwendet werden kann. globalListName: Eine Textzeichenfolge mit bis zu 255 Zeichen. GLOBALLIST ist ein erforderliches untergeordnetes Element des GLOBALLISTS-Elements sowie ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES. Weitere Informationen finden Sie unter Definieren von Auswahllisten.
LISTITEM	<LISTITEM value="Name" />	Definiert einen gültigen Listenwert. Hinweis Globale Listen müssen keine durch Projekte festgelegten Gruppen enthalten, da sie nicht für ein Projekt festgelegt werden. LISTITEM ist ein erforderliches untergeordnetes Element des GLOBALLIST-Elements sowie ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.

Zurück nach oben

Syntaxstruktur globaler Listen, die einer Arbeitsaufgaben-Typdefinition oder einem globalen Workflow hinzugefügt werden

Eine globale Liste kann in einer XML-Definitionsdatei für einen Arbeitsaufgabentyp oder globalen Workflow definiert werden. Fügen Sie hierzu die folgende Syntax hinzu:

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

Mithilfe der folgenden Syntax kann auf eine globale Liste in einer XML-Definitionsdatei für einen Arbeitsaufgabentyp verwiesen werden:

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

Informationen zu Struktur und Speicherort von Definitionsdateien für Arbeitsaufgabentypen oder zum globalen Workflow finden Sie unter XML-Elementreferenz für WITD bzw. unter Globale XML-Elementreferenz für Workflows.

Zurück nach oben

Syntaxstruktur globaler Listen, die für eine Projektauflistung verwaltet werden

Wenn Sie einer Projektauflistung eine globale Liste hinzufügen möchten, können Sie mithilfe des witadmin importgloballist-Befehls die folgende Syntax importieren:

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Eine globale Liste kann nicht leer sein. Jedes GLOBALLIST-Element muss über mindestens ein definiertes LISTITEM-Element verfügen.

Zurück nach oben

Siehe auch

Aufgaben

Hinzufügen, Verwenden und Verwalten von globalen Listen

Referenz

Verwalten von globalen Listen für Arbeitsaufgabentypen [witadmin]

Konzepte

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten

Definieren und Verwenden von Listen, Auswahllisten und globalen Listen

Weitere Ressourcen

Anpassen des globalen Workflows

Änderungsprotokoll