Freigeben über

Hinzufügen, Verwenden und Verwalten von globalen Listen

  • Artikel

Listenelemente können von mehreren Arbeitsaufgabentypen gemeinsam genutzt werden, indem Sie sie innerhalb eines oder mehrerer GLOBALLIST-Elemente einfügen.

Möglicherweise stellen Sie beim Definieren von Arbeitsaufgabentypen fest, dass einige Felder dieselbe Wertemenge verwenden. Häufig erstreckt sich dieser Satz von Werten über mehrere Arbeitsaufgabentypen und sogar über mehrere Teamprojekte. Einige dieser Listen ä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 helfen, dieses Problem zu lösen.

Tipp

Globale Listen müssen keine durch Projekte festgelegten Gruppen enthalten, da sie nicht denselben Gültigkeitsbereich wie Projekte haben. Globale Listen werden für eine Projektauflistung verwaltet.

Im Folgenden wird beschrieben, wie Sie eine globale Liste namens "Disziplinen" für den Arbeitsaufgabentyp erstellen.

Erforderliche Berechtigungen

Damit Sie eine globale Liste exportieren können, müssen Sie Mitglied der Gruppe Gültige Team Foundation-Benutzer der Projektauflistung sein. Damit Sie eine globale Liste importieren können, müssen Sie Mitglied der Gruppe Team Foundation-Administratoren oder Mitglied der Gruppe Projektadministratoren für die Projektauflistung sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So fügen Sie der Teamprojektsammlung eine globale Liste hinzu

  1. Klicken Sie in Visual Studio auf Datei, auf Neu und dann auf Datei.

  2. Klicken Sie im Bereich Kategorien auf Allgemein.

  3. Klicken Sie im Bereich Vorlagen auf XML-Datei und dann auf Öffnen.

  4. Fügen Sie dieser neuen Datei, wie im folgenden Beispiel dargestellt, den folgenden XML-Code hinzu. In diesem Beispiel wird eine globale Liste mit Disziplinen definiert, die für Ihre Organisation relevant sind.

    <?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

  5. Klicken Sie auf der Symbolleiste auf Speichern, um die Änderungen in der XML-Datei zu speichern.

    Das Dialogfeld Datei speichern unter wird angezeigt.

  6. Wechseln Sie im Dialogfeld Datei speichern unter unter Speichern in zu dem Verzeichnis, in dem Sie die Datei speichern möchten. Geben Sie der Datei einen Namen, und klicken Sie dann auf Speichern.

    Tipp

    Unter Windows Vista verfügen Sie möglicherweise nicht über die Berechtigungen für den Zugriff auf bestimmte Ordner. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Berechtigungen festgelegt haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie Berechtigungen festgelegt haben. Weitere Informationen zur Registrierungsvirtualisierung finden Sie auf der Microsoft-Website: Registry Virtualization und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.

  7. Öffnen Sie ein Visual Studio 2010-Eingabeaufforderungsfenster.

  8. Importieren Sie diese globale Liste in die Projektauflistung, indem Sie an der Eingabeaufforderung Folgendes eingeben und dann die EINGABETASTE drücken:

    witadmin importgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /f:"Dateipfad"

    Weitere Informationen finden Sie unter Verwalten von globalen Listen für Arbeitsaufgabentypen [witadmin].

  9. Zeigen Sie die globalen Listen in Team Foundation Server an, indem Sie an der Eingabeaufforderung Folgendes eingeben und dann die EINGABETASTE drücken:

    witadmin exportgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName

    Beachten Sie, dass die neu hinzugefügte Liste angezeigt wird.

So verwenden Sie globale Listen in einem Arbeitsaufgabentyp

  1. Führen Sie witadmin exportwitd aus, um "Task.xml" zu exportieren. Weitere Informationen finden Sie unter Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin].

  2. Klicken Sie in Visual Studio auf Datei, auf Öffnen und dann auf Datei.

    Dadurch wird das Dialogfeld Datei öffnen angezeigt.

  3. Wechseln Sie unter Suchen in zu dem Verzeichnis, in das Sie die Datei exportiert haben.

    Wenn Sie einen Arbeitsaufgabentyp ändern, um eine Prozessvorlage anzupassen, navigieren Sie zu dem Speicherort, an den Sie die Vorlage heruntergeladen haben.

    Tipp

    Wenn Sie Windows Vista ausführen, verfügen Sie möglicherweise nicht über die Berechtigungen für den Zugriff auf bestimmte Ordner. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Berechtigungen festgelegt haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie Berechtigungen festgelegt haben. Weitere Informationen zur Registrierungsvirtualisierung finden Sie auf der Microsoft-Website: Registry Virtualization und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.

  4. Markieren Sie Task.xml, und klicken Sie dann auf Öffnen. Klicken Sie in der Eingabeaufforderung für Zeilenenden auf Nein.

  5. Suchen Sie den folgenden Abschnitt der XML-Datei, in dem das Feld Disziplin definiert wird:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  6. Löschen Sie die Liste zugelassener Werte, indem Sie den folgenden XML-Code entfernen (im Beispiel hervorgehoben):

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  7. Legen Sie die zulässigen Werte für das Feld Disziplin auf die zuvor definierte globale Liste fest, indem Sie der Datei den folgenden XML-Code hinzufügen:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

  8. Klicken Sie auf der Symbolleiste auf Speichern, um die Änderungen in der XML-Datei zu speichern.

  9. Importieren Sie die geänderte Aufgabe in Team Foundation Server. Weitere Informationen finden Sie unter Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin].

  10. Klicken Sie in Visual Studio im Fenster Team Explorer auf Aktualisieren, um die neuesten Updates vom Server herunterzuladen.

    Diese Updates enthalten die soeben importierten Änderungen. Warten Sie einige Sekunden, bis alle Knoten geladen werden. Knoten, die noch geladen werden, sind mit in Arbeit bezeichnet.

  11. Erstellen Sie eine Aufgabe. Klicken Sie dazu mit der rechten Maustaste auf den Knoten Arbeitsaufgabe, zeigen Sie auf Arbeitsaufgabe hinzufügen, und klicken Sie dann auf Aufgabe.

    Diese Arbeitsaufgabe wird aus dem von Ihnen geänderten und importierten Arbeitsaufgabentyp erstellt.

  12. Wählen Sie das Feld Disziplin im neuen Arbeitsaufgabenformular aus.

    Beachten Sie, dass die zulässigen Werte jetzt aus der globalen Disziplinen-Liste abgerufen werden.

  13. Klicken Sie auf Schließen, um die neue Aufgabe zu schließen. Klicken Sie auf Nein, wenn Sie zum Speichern der Aufgabe aufgefordert werden.

So fügen Sie Werte einem Feld hinzu, ohne eine XML-Datei für den Arbeitsaufgabentyp zu importieren

  1. Um dem Feld Disziplin Werte hinzuzufügen, ohne die Definitionsdatei für den Arbeitsaufgabentyp zu bearbeiten oder neu zu importieren, öffnen Sie über Visual Studio die Datei "disciplines.xml", und fügen Sie die folgenden neuen Werte hinzu. Im Beispiel werden diese hervorgehoben dargestellt.

    <GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>

  2. Klicken Sie auf der Symbolleiste auf Speichern, um die Änderungen in der XML-Datei zu speichern.

  3. Öffnen Sie ein Visual Studio-Eingabeaufforderungsfenster.

  4. Importieren Sie diese globale Liste in die Projektauflistung, indem Sie an der Eingabeaufforderung Folgendes eingeben und dann die EINGABETASTE drücken:

    witadmin importgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /f:"Dateipfad"

  5. Klicken Sie in Team Explorer auf Aktualisieren, um die neuesten Updates vom Server herunterzuladen.

    Diese Updates enthalten die soeben importierten Änderungen. Warten Sie einige Sekunden, bis alle Knoten geladen werden. Knoten, die noch geladen werden, sind mit in Arbeit bezeichnet.

  6. Erstellen Sie eine Aufgabe. Klicken Sie dazu mit der rechten Maustaste auf den Knoten Arbeitsaufgabe, zeigen Sie auf Arbeitsaufgabe hinzufügen, und klicken Sie dann auf Aufgabe.

  7. Wählen Sie das Feld Disziplin aus.

    Beachten Sie, dass die neuen Werte in der globalen Liste jetzt zur Auswahl im Feld angezeigt werden.

    Tipp

    Sie können auf globale Listen für zulässige Werte verweisen, die von verschiedenen Arbeitsaufgabentypen oder Teamprojekten gemeinsam genutzt werden. Somit wird ermöglicht, dass durch eine einzelne Aktualisierung der globalen Liste automatisch die zulässigen Werte aller Arbeitsaufgabentypen aktualisiert werden, die auf die Liste verweisen.

  8. Klicken Sie auf Schließen, um die neue Aufgabe zu schließen. Klicken Sie auf Nein, wenn Sie zum Speichern der Aufgabe aufgefordert werden.

Siehe auch

Referenz

GLOBALLISTS-Element (globales Listenschema)

GLOBALLISTS Element (Work Item Type Definition Schema)

Konzepte

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten

Definieren von globalen Listen

Definieren und Verwenden von Listen, Auswahllisten und globalen Listen

Weitere Ressourcen

Index für XML-Elementdefinitionen für Arbeitsaufgabentypen