Definieren von globalen Listen

Durch Verwendung globaler Listen in Team Foundation Server (TFS) können Sie den erforderlichen Arbeitsaufwand für das Aktualisieren von Listen minimieren, die in den Definitionen von mehreren Arbeitsaufgabentypen verwendet werden. Globale Listen sind Auswahllisten, die Sie in ein oder mehrere Felder und Definitionen von Arbeitsaufgabentypen einschließen können. Eine globale Liste kann innerhalb eines Arbeitsaufgabentyps (WIT) definiert werden, den Sie einem Teamprojekt hinzufügen, als globale Liste für eine Teamprojektauflistung oder innerhalb eines globalen Workflows. Sie können Listenelemente für mehrere WITs in einer Auflistung freigeben, indem Sie die Listenelemente in ein oder mehrere GLOBALLIST-Elemente einschließen.

Beim Definieren von Arbeitsaufgabentypen stellen Sie möglicherweise fest, dass einige Felder die gleichen Werte verwenden. Häufig ist die gemeinsame Verwendung durch mehrere WITs und sogar mehrere Teamprojekte möglich. Einige dieser Werte, wie z. B. die Buildnummer nächtlicher Builds, ändern sich häufig, sodass Administratoren diese Listen ständig an zahlreichen Speicherorten aktualisieren müssen. Globale Listen können insbesondere dann nützlich sein, wenn eine Liste aus einem externen System abgeleitet werden muss. Angenommen beispielsweise, ein Unternehmen pflegt eine separate Kundendatenbank. Wenn Sie einen Fehler melden, den ein Kunde entdeckt hat, wird der Name des Kunden in ein benutzerdefiniertes Found By Customer-Feld eingegeben.

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

Anforderungen

• Um globale Listen zu exportieren oder aufzurufen, müssen Sie ein Mitglied der Gruppe "Gültige Benutzer für Projektauflistung" sein, oder für die Berechtigung "Informationen auf Auflistungsebene anzeigen" muss "Zulassen" festgelegt sein.

• Um globale Listen zu definieren oder zu bearbeiten, müssen Sie ein Mitglied der Gruppe "Projektadministratoren" sein, oder für die Berechtigung "Projektebeneninformationen bearbeiten" muss "Zulassen" festgelegt sein.

• Wenn Sie eine globale Liste hinzufügen oder ändern möchten, verwenden Sie das Befehlszeilentool witadmin, um die Definition für globale Listen zu importieren und zu exportieren. Siehe Verwalten von globalen Listen für Arbeitsaufgabentypen [witadmin]. Um eine globale Liste zu verwenden, fügen Sie sie der FIELD-Definition innerhalb eines Arbeitsaufgabentyps hinzu. Siehe Verweis für alle FIELD-XML-Elemente.

Hinzufügen und Verwalten globaler Listen

Eine globale Liste ist ein Satz von LISTITEM-Elementen, die gespeichert und global von allen Teamprojekten in einer Auflistung verwendet werden. Globale Listen sind für Felder nützlich, die in mehreren Arbeitsaufgabentypen definiert sind, wie "Betriebssystem", "In Build gefunden" und "In Build korrigiert".

Sie können globale Listen und ihre Elemente mit einer der folgenden Methoden definieren:

• Teamprojektauflistung: Sie können die für eine Teamprojektauflistung definierten globalen Listen exportieren, ändern, löschen und importieren. Diese globalen Listen stehen allen Teamprojekten in der Auflistung zur Verfügung.

• Definition eines Arbeitsaufgabentyps: Nachdem ein Teamprojekt erstellt wurde, können Sie die globalen Listen, die für einen Arbeitsaufgabentyp verfügbar sein sollen, der Definition des Typs hinzufügen.

• Definition des globalen Workflows: Nachdem ein Teamprojekt erstellt wurde, können Sie die globalen Listen, die für alle Arbeitsaufgabentypen verfügbar sein sollen, der Definition des globalen Workflows für ein Teamprojekt oder eine Auflistung hinzufügen. Weitere Informationen finden Sie unter Anpassen des globalen Workflows.

Syntaxstruktur

In der folgenden Tabelle werden die GLOBALLIST- und LISTITEM-Elemente beschrieben. Sie können diese Elemente verwenden, um eine Auflistung von Werten zu erstellen, die dem Benutzer als Auswahlliste oder Dropdownmenü mit Elementen angezeigt wird.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>
 

<LISTITEM value="Name" />

Beispiel einer globalen Liste

Durch Hinzufügen der folgenden Syntax können Sie eine globale Liste innerhalb einer XML-Definitionsdatei für einen Arbeitsaufgabentyp oder einen globalen Workflow definieren:

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

Mit der folgenden Syntax können Sie innerhalb einer XML-Definitionsdatei für einen Arbeitsaufgabentyp auf eine globale Liste verweisen:

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

Informationen zur Struktur und zum Speicherort von Definitionsdateien für Arbeitsaufgabentypen oder globale Workflows finden Sie unter Verweis für alle WIDT-XML-Elemente oder Globale XML-Elementreferenz für Workflows.

Beispiel einer globalen Liste für eine Projektauflistung

Um eine globale Liste einer Projektauflistung hinzuzufügen, können Sie unter Verwendung 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 darf nicht leer sein. Jedes GLOBALLIST-Element muss über mindestens ein definiertes LISTITEM-Element verfügen.

Fragen und Antworten

F: Gibt es globale Listen, die automatisch mit Daten gefüllt werden?

A: Ja. Die globale Liste namens Builds – Teamprojektname wird bei jeder Ausführung eines Builds ergänzt. Im Laufe der Zeit kann diese Liste sehr lang werden. Eine bewährte Methode ist es, nicht benutzte Einträge regelmäßig aus der Liste zu entfernen.

Weitere Informationen zur Verwendung dieser Liste finden Sie unter Felder, die die Integration in die Test-, Build- und Versionskontrolle unterstützen.

Siehe auch

Referenz

Verwalten von globalen Listen für Arbeitsaufgabentypen [witadmin]

Konzepte

Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams