Importer et exporter le flux de travail global [witadmin]
Vous pouvez utiliser un flux de travail global pour réduire au maximum le travail nécessaire pour définir et mettre à jour les listes globales et les champs d'élément de travail que partagent différents projets d'équipe et types d'éléments de travail. Avec le flux de travail global, vous pouvez définir et mettre à jour les champs et les listes globales. Vous pouvez gérer le flux de travail global d'une collection de projets d'équipe ou d'un projet d'équipe à l'aide des commandes suivantes de l'outil en ligne de commande witadmin :
exportglobalworkflow : exporte le flux de travail global vers un fichier XML ou la fenêtre d'invite de commandes.
importglobalworkflow : importe le flux de travail global à partir d'un fichier XML.
L'outil en ligne de commande witadmin ne fonctionne que quand vous l'exécutez sur un serveur TFS local. Pour exécuter l'outil, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%.
Pour plus d'informations sur le flux de travail global, consultez Personnaliser le flux de travail global.
Spécifications
Pour exporter un flux de travail global, vous devez être un utilisateur valide du projet d'équipe ou de la collection de projets d'équipe.
Pour importer un flux de travail global dans un projet d'équipe, vous devez être membre des groupes de sécurité suivants : Team Foundation Administrators, Administrateurs de la collection de projets ou Project Administrators.
Pour importer un flux de travail global dans une collection de projets d'équipe, vous devez être membre du groupe Team Foundation Administrators ou Administrateurs de la collection de projets.
Voir Référence des autorisations pour Team Foundation Server.
Notes
Même si vous vous connectez avec des autorisations d'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur exécutant Windows Server 2008.Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, sélectionnez Démarrer, ouvrez le menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, consultez la page suivante sur le site web Microsoft : Contrôle de compte d'utilisateur.
witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists]
witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]
Paramètres
Paramètre |
Description |
|---|---|
/collection:CollectionURL |
Spécifie l'URI de la collection. Vous devez spécifier l'URI dans le format suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection Si vous ne spécifiez pas de répertoire virtuel, vous devez spécifier l'URI dans le format suivant : http://NomServeur:Port/NomCollection. |
/p:ProjectName |
Facultatif. Projet d'équipe pour lequel vous voulez exporter ou importer le flux de travail global. Ce projet d'équipe doit être défini dans la collection que vous avez spécifiée à l'aide du paramètre /collection. Si vous ne spécifiez pas de projet d'équipe, le flux de travail global est importé ou exporté pour la collection. |
/f:FileName |
Chemin d'accès et nom du fichier de définition XML pour le flux de travail global à exporter ou importer. Notes Si l'ordinateur client exécute Windows Vista, vous pouvez ne pas disposer d'autorisations d'accès à certains dossiers.Si vous essayez d'exporter la liste globale vers un emplacement où vous ne possédez pas d'autorisation, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel.Pour plus d'informations, consultez les pages suivantes du site web Microsoft : Virtualisation du Registre et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous possédez des autorisations. |
/e:Encoding |
Facultatif. Nom d'un .NET Framework 2.0 qui encode le format. L'encodage spécifié sera utilisé pour exporter ou importer les données XML. Par exemple, /e utf-7 spécifie l'encodage Unicode (UTF-7). Si vous omettez ce paramètre, witadmin essaie de détecter l'encodage et utilise UTF-8 si la détection échoue. |
/v |
Facultatif. Valide le fichier XML qui définit le flux de travail global mais n'importe pas le fichier de définition. |
/exportgloballists |
Facultatif. Exporte les définitions des listes globales référencées par le flux de travail global. Les définitions pour les listes globales seront incorporées dans le fichier de définition XML du flux de travail global. Si vous ne spécifiez pas ce paramètre, les définitions des listes globales sont omises. |
/? ou help |
Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes. |
Notes
Vous pouvez définir des champs d'éléments de travail en les important via un flux de travail global. Toutefois, vous ne pouvez pas modifier les propriétés de champs existants à l'aide du flux de travail global. Si vous importez un flux de travail global qui ne contient pas d'élément FIELDS, toutes les règles déjà importées pour ce flux de travail global sont supprimées. Les définitions de champ ne seront pas affectées.
Exemples
Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :
URI pour la collection : http://AdventureWorksServer:8080/tfs/DefaultCollection
Projet d'équipe : Contoso
Numéro de port pour le site web du serveur : 8080
Exporter la définition d'un flux de travail global pour un projet d'équipe
L'exemple suivant exporte le flux de travail global pour un projet d'équipe :
witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:myGlobalWorkflow.xml
Importer la définition d'un flux de travail global dans un projet d'équipe
L'exemple suivant importe le flux de travail global dans le projet d'équipe Contoso :
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:collectionGlobalWorkflow.xml
Importer la définition d'un flux de travail global dans une collection
L'exemple suivant importe le flux de travail global dans la collection :
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:collectionGlobalWorkflow.xml
Voir aussi
Concepts
Autres ressources
Personnaliser le flux de travail global
witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail