Partager via

Gestion du workflow global (witadmin)

  • Article

À l'aide d'un flux de travail global, vous pouvez réduire le travail nécessaire à la définition et à la mise à jour de champs d'élément de travail et de listes globales utilisés par plusieurs 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 dans un fichier XML ou la fenêtre d'invite de commandes.

  • importglobalworkflow :  importe le flux de travail global d'un fichier XML.

Notes

Pour qu'un flux de travail global puisse être défini, la fonctionnalité doit être activée sur le serveur de couche Application. Par conséquent, le serveur doit exécuter une version de Visual Studio Team Foundation Server, telle que Team Foundation Server 2010 avec le Service Pack 1 (SP1) qui prend en charge cette fonctionnalité. Vous pouvez télécharger le Service Pack sur la page suivante du site Web Microsoft : Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta.

L'outil en ligne de commande witadmin se trouve dans Lecteur :\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur un ordinateur qui exécute Team Explorer. Sur les ordinateurs 64 bits, l'outil se trouve dans Lecteur:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Pour plus d'informations sur le flux de travail global, consultez Personnalisation du workflow global.

Autorisations requises

Pour la collection de projets d'équipe dans laquelle le flux de travail global est défini, vous devez disposer des autorisations suivantes :

  • Pour exporter un flux de travail global, vous devez être un utilisateur valide du projet d'équipe ou de la collection.

  • Pour importer un flux de travail global, vous devez être membre des groupes de sécurité suivants : Team Foundation Administrators, Project Administrators pour importer un flux de travail dans un projet d'équipe ou Project Collection Administrators pour importer un flux de travail dans une collection.

Pour plus d'informations, consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

Notes

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur 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 sous la forme suivante : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

Si vous ne spécifiez pas de répertoire virtuel, vous devez indiquer l'URI sous la forme suivante :

http://ServerName:Port/CollectionName.

/p:ProjectName

Facultatif. Le projet d'équipe pour lequel vous souhaitez exporter ou importer le flux de travail global. Ce projet d'équipe doit être défini dans la collection 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

Le chemin d'accès et le nom du fichier de définition XML du flux de travail global à exporter ou importer.

RemarqueRemarque
Si l'ordinateur client exécute Windows Vista, vous pouvez ne pas avoir d'autorisations sur certains dossiers.Si vous tentez d'exporter la liste globale vers un emplacement pour lequel vous ne disposez d'aucune 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 sur le site Web Microsoft : Registry Virtualization 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 disposez d'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 (UTF-7) Unicode. 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 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 XML de définition du flux de travail global. Si vous ne spécifiez pas ce paramètre, les définitions des listes globales sont omises.

/? or 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 d'exister des champs à 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 du flux de travail global précédemment importées seront 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 de la collection : http://AdventureWorksServer:8080/AWTeam/Collection1

  • Projet d'équipe : Contoso

  • Numéro de port du site Web du serveur : 8080

Exportez 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/AWTeam/Collection1 /p:Contoso /f:C:myGlobalWorkflow.xml

Importez la définition d'un flux de travail global vers 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/AWTeam/Collection1 /p:Contoso /f:C:collectionGlobalWorkflow.xml

Importer la définition d'un flux de travail global dans une collection.

L'exemple suivant illustre l'importation du flux de travail global dans la collection :

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

Voir aussi

Tâches

Ajouter, utiliser et gérer des listes globales

Concepts

Définition des listes globales

Autres ressources

Personnalisation du workflow global

witAdmin : administration des objets de suivi des éléments de travail