Freigeben über

Verwalten von globalen Listen für Arbeitsaufgabentypen [witadmin]

  • Artikel

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.

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 globalen auf dem Server definierten 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 12.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.Weitere Informationen finden Sie unter 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 der Wert Zulassen festgelegt sein.

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

  • Um globale Listen mithilfe von witadmin destroygloballist zu vernichten, müssen Sie ein Mitglied der Gruppe Projektauflistungsadministratoren sein, oder für die Berechtigung Auflistungsebeneninformationen bearbeiten muss der Wert Zulassen festgelegt sein.

Siehe Berechtigungsreferenz für Team Foundation Server.

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 Microsoft-Website: Benutzerzugriffssteuerung.

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. Der URI hat folgendes Format: http://Servername:Port/VirtuellerVerzeichnisname/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 auf 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>

Geben Sie Sicherheitsgruppen auf Projektebene nicht in globalen Listen an, da globale Listen auf Auflistungs- und nicht auf Projektebene gelten.

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 Importieren, Exportieren 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 Arbeitsnachverfolgung