Verwalten von globalen Listen für Arbeitsaufgabentypen

Artikel
02/27/2013

Globale Listen sind Auswahllisten, die Sie in mehrere Felder und Arbeitsaufgabentypen aufnehmen können.Verwenden Sie sie, um den Aufwand zu verringern, der mit der Aktualisierung einer Liste, die von mehreren Arbeitsaufgabentypen genutzt wird, verbunden ist.Da globale Listen für eine Teamprojektauflistung definiert werden, können sie in den Arbeitsaufgabentypen für alle Teamprojekte in der Auflistung enthalten sein.

Hinweis
Globale Listen müssen keine durch Projekte festgelegten Sicherheitsgruppen enthalten, da sie nicht denselben Gültigkeitsbereich wie Teamprojekte haben.

Sie können eine globale Liste in Ihrer eigenen Definitionsdatei, in einer Definitionsdatei für einen Arbeitsaufgabentyp oder im globalen Workflow definieren.Die Definition der globalen Liste verwaltet die für eine Auflistung definierten globalen Listen.Für die Definition der globalen Listen werden die folgenden Befehle im witadmin-Befehlszeilentool verwendet:

destroygloballist: Zerstört eine globale Liste.
exportgloballist: Exportiert die globalen Listen in eine XML-Datei oder in das Eingabeaufforderungsfenster.Sie exportiert eine einzelne Datei mit allen globalen Listen, die für die Teamprojektauflistung definiert wurden.
importgloballist: Importiert globale Listen von einer XML-Datei.Wenn Sie versuchen, eine bereits auf dem Server vorhandene globale Liste, zu importieren, werden Sie in einer Warnung gefragt, ob Sie die auf dem Server vorhandene globale Liste überschreiben möchten.Wenn Sie versuchen, eine globale Liste zu importieren, die noch nicht vorhanden ist, erstellt der Befehl eine neue globale Liste.
listgloballist: Zeigt den Namen jeder auf dem Server definierten globalen Liste an.

Weitere Informationen finden Sie unter Definieren von globalen Listen und Anpassen des globalen Workflows.

Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.

Hinweis
Mit dem Prozess-Editor, einem Powertool für Visual Studio, können Sie globale Listen erstellen und bearbeiten.Dieses Tool wird nicht unterstützt.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools.

Anforderungen

Für die Teamprojektauflistung, in der die globalen Listen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

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.
Zum Zerstören oder Importieren von globalen Listen müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder der Sicherheitsgruppe Projektadministratoren sein.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

Hinweis
Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie Als Administrator ausführen aus.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie Als Administrator ausführen aus.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Parameter

Parameter	Beschreibung
/collection:CollectionURL	Gibt den URI der Teamprojektauflistung an.Das Format für den URI sieht folgendermaßen aus: http://Servername:Port/NameDesVirtuellenVerzeichnisses/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname.
/n:GlobalListName	Der Name der globalen Liste, die zerstört werden soll.
/f:FileName	Der Pfad und der Name der zu exportierenden oder importierenden XML-Definitionsdatei der globalen Listen. Hinweis Wenn auf dem Clientcomputer Windows Vista ausgeführt wird, haben Sie möglicherweise keine Berechtigungen für bestimmte Ordner.Wenn Sie versuchen, die globale Liste nach einem Speicherort zu exportieren, für den Sie keine Berechtigungen haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Weitere Informationen finden Sie auf den folgenden Seiten der Microsoft-Website: Registrierungsvirtualisierung und Häufig auftretende Datei- und Registrierungsvirtualisierungsprobleme in Windows Vista.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, an dem Sie über ausreichende Berechtigungen verfügen.
/e:Encoding	Der Name eines .NET Framework 2.0-Codierungsformats.Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren./e utf-7 gibt beispielsweise die Unicode (UTF-7)-Codierung an.Wenn Sie diesen Parameter weglassen, versucht witadmin die Codierung zu erkennen, und bei fehlgeschlagener Erkennung verwendet witadmin UTF-8.
/noprompt	Deaktiviert die Eingabeaufforderung zur Bestätigung.
/? oder help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Durch Importieren einer globalen Liste wird eine Liste erstellt, sofern noch keine vorhanden ist.Wenn die Liste bereits vorhanden ist, gibt der witadmin importgloballist-Befehl eine Warnung aus, die darauf hinweist, dass die aktuelle Liste überschrieben wird.Sie können ein eigenes Programm zur Aktualisierung einer vorhandenen globalen Liste schreiben oder die globale Liste selbst mit den neuen Daten aktualisieren.

Zum Erstellen einer neuen globalen Liste, beginnen Sie mit dem folgenden Code und ändern ihn nach Bedarf.In diesem Beispiel wird eine globale Liste mit Disziplinen definiert, die Sie Aufgaben zuweisen können.

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

Um einem Feld eine globale Liste hinzuzufügen, exportieren Sie die Definition für den Arbeitsaufgabentyp der das Feld, enthält und fügen Sie es der Felddefinition, wie im folgenden Beispiel gezeigt, hinzu:

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

Zum Anzeigen der Änderungen, importieren Sie die Typdefinition und aktualisieren Sie den Browser oder Clientcache.Sie müssen möglicherweise alle auf das Feld verweisenden Arbeitsaufgaben schließen und erneut öffnen.

Informationen zum Exportieren und Importieren von Typdefinitionen finden Sie unter Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin].

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

URI für die Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection
Anschlussnummer Serverwebsite: 8080

Anzeigen der Namen globaler Listen

Im folgenden Beispiel werden die auf dem Server definierten globalen Listen gezeigt.In diesem Beispiel werden die globalen Listen mit der Standard-UTF-8-Codierung exportiert:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Exportieren der Definition globaler Listen

Im folgenden Beispiel werden die globalen Listen exportiert:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

Im folgenden Beispiel werden dieselben globalen Listen auf denselben Server exportiert, allerdings mit Unicode-Codierung UTF-7.

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importieren der Definition globaler Listen

Im folgenden Beispiel werden globale Listen importiert:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

Im folgenden Beispiel werden dieselben globalen Listen in denselben Server importiert, allerdings mit Unicode-Codierung UTF-7.

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Siehe auch

Konzepte

Definieren von globalen Listen

Weitere Ressourcen

Anpassen des globalen Workflows

witAdmin: Anpassen und Verwalten von Objekten für die Nachverfolgung von Arbeitsaufgaben

Freigeben über