Freigeben über

Gewusst wie: Verwenden einer globalen Liste

  • Artikel

Aktualisiert: November 2007

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 nächtlicher Buildvorgänge. Es stellt keine zufriedenstellende Lösung dar, diese auf mehrere Speicherorte verteilten Listen von einem Administrator in kurzen Abständen aktualisieren zu lassen. Globale Listen helfen, dieses Problem zu lösen. Globale Listen müssen keine durch Projekte festgelegten Gruppen enthalten, da sie nicht denselben Gültigkeitsbereich wie Projekte haben.

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 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 das Projekt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So verwenden Sie Team Foundation-Befehle an einer Eingabeaufforderung

  • Klicken Sie auf Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2008 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2008-Eingabeaufforderung.

    Stattdessen können Sie auch vsvars32 im Visual Studio-Installationspfad ausführen. Dieser lautet in der Regel DriveLetter:\Programme\Microsoft Visual Studio 9.0\Common7\Tools.

    Hinweis:

    Visual Studio 2008 muss installiert sein, damit die Eingabeaufforderung von Visual Studio 2008 verwendet werden kann.

So fügen Sie dem Team Foundation-Server 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 Speichern, um die Änderungen in der XML-Datei zu speichern.

    Das Dialogfeld Datei speichern unter wird angezeigt.

    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.

    Hinweis:

    Unter Windows Vista haben Sie möglicherweise keine Zugriffsrechte für bestimmte Ordner. Wenn Sie versuchen, die globale Liste an einem Speicherort zu speichern, für den Sie keine Zugriffsrechte besitzen, wird die Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=92325 und unter https://go.microsoft.com/fwlink/?LinkId=92323. Um diese Umleitung zu vermeiden, können Sie die Datei an einem Speicherort speichern, für den Sie über Zugriffsrechte verfügen.

  6. Öffnen Sie ein Visual Studio 2008-Eingabeaufforderungsfenster.

  7. Importieren Sie diese globale Liste in Team Foundation Server, indem Sie den folgenden Befehl eingeben und dann die EINGABETASTE drücken:

    glimport /f "Dateipfad" /t " Team Foundation Server-Name**"**

    Hinweis:

    Da sich eine globale Liste in Team Foundation Server global auswirkt, geben Sie beim Ausführen des glimport-Befehls kein Teamprojekt an. Weitere Informationen finden Sie unter glimport.

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

    glexport /t "<Team Foundation Server-Name>"

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

So verwenden Sie globale Listen in einem Arbeitsaufgabentyp

  1. Führen Sie witexport aus, um Task.xml zu exportieren. Weitere Informationen finden Sie unter Gewusst wie: Exportieren eines Arbeitsaufgabentyps aus einem vorhandenen Projekt.

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

    Dadurch wird das Dialogfeld Datei öffnen angezeigt.

  3. Navigieren 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 Prozessvorlage heruntergeladen haben.

    Hinweis:

    Unter Windows Vista haben Sie möglicherweise keine Zugriffsrechte für bestimmte Ordner. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Zugriffsrechte besitzen, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=92325 und unter https://go.microsoft.com/fwlink/?LinkId=92323. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Zugriffsrechte verfügen.

  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, durch den 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 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 Gewusst wie: Importieren eines Arbeitsaufgabentyps in ein vorhandenes Projekt.

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

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

  11. Erstellen Sie eine neue 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 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 Speichern, um die Änderungen in der XML-Datei zu speichern.

  3. Öffnen Sie ein Visual Studio-Eingabeaufforderungsfenster.

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

    glimport /f "Dateipfad" /t " Team Foundation Server-Name**"**

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

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

  6. Erstellen Sie eine neue 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.

    Hinweis:

    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

Konzepte

Globale Listen

Referenz

GLOBALLISTS-Element (globales Listenschema)

GLOBALLISTS-Element (Definitionsschema Arbeitsaufgabentyp)

Weitere Ressourcen

Definitionsschema "Arbeitsaufgabentyp"