Verwalten des globalen Workflows

Mithilfe des globalen Workflows können Sie den Arbeitsaufwand beim Definieren und Aktualisieren von Arbeitsaufgabenfeldern und globalen Listen verringern, die für viele Arten von Teamprojekten und Arbeitsaufgaben verwendet werden. Mithilfe des globalen Workflows können Sie Felder und globale Listen definieren und aktualisieren. Sie können den globalen Workflow für eine Teamprojektsammlung oder ein Teamprojekt mit den folgenden Befehlen im witadmin-Befehlszeilentool verwalten:

  • exportglobalworkflow: Exportiert den globalen Workflow in eine XML-Datei oder in das Eingabeaufforderungsfenster.

  • importglobalworkflow: Importiert den globalen Workflow aus einer XML-Datei.

Tipp

Zum Definieren eines globalen Workflows muss auf dem Anwendungsebenenserver zunächst die entsprechende Funktion aktiviert werden. Daher muss auf dem Server eine Version von Visual Studio Team Foundation Server ausgeführt werden, zum Beispiel Team Foundation Server 2010 mit Service Pack 1 (SP1), von der die Funktion unterstützt wird. Sie können das Service Pack von der folgenden Seite der Microsoft-Website herunterladen: Visual Studio Team Foundation Server 2010 SP1 Beta.

Sie finden das witadmin-Befehlszeilentool unter Laufwerk:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE auf jedem Computer, auf dem Team Explorer ausgeführt wird. Bei 64-Bit-Computern befindet sich das Tool unter Laufwerk:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Weitere Informationen zum globalen Workflow finden Sie unter Anpassen des globalen Workflows.

Erforderliche Berechtigungen

Für die Teamprojektauflistung, in der der globale Workflow definiert ist, müssen die folgenden Berechtigungen festgelegt sein:

  • Um einen globalen Workflow zu exportieren, müssen Sie ein gültiger Benutzer des Teamprojekts oder der Sammlung sein.

  • Zum Importieren eines globalen Workflows müssen Sie Mitglied der folgenden Sicherheitsgruppen sein: Team Foundation-Administratoren oder Projektadministratoren, um einen globalen Workflow in ein Teamprojekt zu importieren, oder Projektauflistungsadministratoren, um einen globalen Workflow in eine Sammlung zu importieren.

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

Tipp

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. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists] 

witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]

Parameter

Parameter

Beschreibungen

/collection:CollectionURL

Gibt die URI der Sammlung an. Die URI muss im folgenden Format angegeben werden: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname

Wenn Sie kein virtuelles Verzeichnis angeben, muss die URI im folgenden Format angegeben werden:

http://Servername:Port/Auflistungsname.

/p:ProjectName

Optional. Das Teamprojekt, für das Sie den globalen Workflow exportieren oder importieren möchten. Dieses Teamprojekt muss in der Sammlung definiert werden, die Sie mit dem /collection-Parameter angegeben haben. Wenn Sie kein Teamprojekt angeben, wird der globale Workflow für die Sammlung importiert oder exportiert.

/f:FileName

Der Pfad und der Name der XML-Definitionsdatei für den zu exportierenden oder importierenden globalen Workflow.

HinweisHinweis
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 an einen 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: Registry Virtualization und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Berechtigungen verfügen.

/e:Encoding

Optional. Der Name eines .NET Framework 2.0-Codierungsformats. Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren. Beispielsweise gibt /e utf-7 die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin die Codierung zu erkennen und verwendet bei fehlgeschlagener Erkennung UTF-8.

/v

Optional. Überprüft das XML, das den globalen Workflow definiert, importiert jedoch nicht die Definitionsdatei.

/exportgloballists

Optional. Exportiert die Definitionen von globalen Listen, auf die der globale Workflow verweist. Die Definitionen für globale Listen werden in die XML-Definition des globalen Workflows eingebettet. Wenn Sie diesen Parameter nicht angeben, werden die Definitionen für globale Listen weggelassen.

/? or help

Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Sie können Arbeitsaufgabenfelder definieren, indem Sie sie durch einen globalen Workflow importieren. Sie können jedoch die Eigenschaften vorhandener Felder nicht durch Verwendung von globalem Workflow ändern. Wenn Sie einen globalen Workflow importieren, der kein FIELDS-Element enthält, werden alle zuvor importierten Regeln für den globalen Workflow gelöscht. Felddefinitionen sind nicht betroffen.

Beispiele

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

  • URI für die Sammlung: http://AdventureWorksServer:8080/AWTeam/Collection1

  • Teamprojekt: Contoso

  • Portnummer für die Serverwebsite: 8080

Exportieren der Definition eines globalen Workflows für ein Teamprojekt

Im folgenden Beispiel wird der globale Workflow für ein Teamprojekt exportiert:

witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:myGlobalWorkflow.xml

Importieren der Definition eines globalen Workflows in ein Teamprojekt

Im folgenden Beispiel wird der globale Workflow in das Contoso-Teamprojekt importiert:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:collectionGlobalWorkflow.xml 

Importieren der Definition eines globalen Workflows in eine Sammlung

Im folgenden Beispiel wird der globale Workflow in die Sammlung importiert:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:collectionGlobalWorkflow.xml 

Siehe auch

Aufgaben

Hinzufügen, Verwenden und Verwalten von globalen Listen

Konzepte

Definieren von globalen Listen

Weitere Ressourcen

Anpassen des globalen Workflows

witAdmin: Verwalten von Objekten für das Nachverfolgen von Arbeitsaufgaben