Partager via

Importer et exporter le flux de travail global [witadmin]

  • Article

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.

Pour exécuter l'outil de ligne de commande witadmin, 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 12.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.

Consultez 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

Définir les listes globales

Autres ressources

Personnaliser le flux de travail global

witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail