Partager via

Importer et exporter la configuration de processus [witadmin]

  • Article

Vous pouvez personnaliser la configuration de processus pour modifier l'affichage des pages de l'outil de planification Agile accessibles via Team Web Access (TWA). Quelques outils supplémentaires vous obligent à mapper les états de flux de travail aux mappages de méta-états.

Pour obtenir une vue d'ensemble de la façon de personnaliser les pages de l'outil de planification Agile, voir Configurer et personnaliser les outils de planification Agile pour un projet d'équipe.

Notes

Si vous recevez le message d'erreur TF400917, une configuration non valide a été détectée dans TWA.Réimportez le fichier de configuration de processus dans votre projet d'équipe en utilisant witadmin importcommonprocessconfig.Vous obtiendrez les messages dont vous avez besoin pour résoudre l'erreur.

Pour gérer la configuration de processus pour un projet d'équipe, utilisez l'outil en ligne de commande witadmin pour exporter et importer le fichier de définition XML de configuration de processus. Pour en savoir plus sur la configuration de processus, voir Informations de référence sur les éléments XML de configuration de processus.

Traiter un objet WIT à des fins de personnalisation

  • exportprocessconfig :  exporte la définition de configuration de processus vers un fichier XML ou la fenêtre d'invite de commandes.

  • importprocessconfig :  importe le fichier XML de définition de configuration de processus.

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%.

Spécifications

  • Pour exporter des définitions de configuration de processus, vous devez être un utilisateur valide du projet d'équipe ou de la collection.

  • Pour importer des définitions de configuration de processus, vous devez être membre des groupes de sécurité suivants : Team Foundation Administrators ou Project Administrators.

Pour plus d'informations, consultez Référence des autorisations pour Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Paramètres

Paramètre

Description

/collection:CollectionURLx

Requis. Spécifie l'URL 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

Requis. Spécifie le projet d'équipe pour lequel vous souhaitez exporter ou importer la configuration de processus. Ce projet d'équipe doit être défini dans la collection que vous avez spécifiée à l'aide du paramètre /collection. Vous n'avez pas besoin de spécifier de projet d'équipe quand vous spécifiez le commutateur /v.

/f:FileName

Chemin d'accès et nom du fichier de définition XML pour la configuration de processus à 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, voir 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 la configuration de processus mais n'importe pas le fichier de définition.

/? ou help

Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

Notes

L'installation de VS TFS 2013 met à niveau les projets d'équipe existants.Ils utiliseront le fichier de configuration de processus, qui associe les fichiers de configuration Agile et les fichiers de configuration communs pris en charge dans TFS 2012.Les commandes witadmin suivantes sont maintenant déconseillées, de même que leurs fichiers de configuration correspondants :

  • exportagileprocessconfig

  • exportcommonprocessconfig

  • importagileprocessconfig

  • importcommonprocessconfig

Si vous mettez à jour un projet d'équipe mis à niveau, voir Mettre à jour un projet d'équipe mis à niveau pour accéder à de nouvelles fonctionnalités.

Si vous rencontrez des problèmes lors de l'accès à des plans de test ou à des suites de tests existants après une mise à niveau vers TFS 2013.3, voir Mettre à jour manuellement un projet d'équipe pour prendre en charge la gestion du test.

Exemples

Les valeurs suivantes s'appliquent dans chaque exemple :

  • URL pour la collection : http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Projet d'équipe : Contoso

  • Numéro de port pour le site web du serveur : 8080

Pour ajouter un champ dans le volet d'ajout rapide

Vous pouvez ajouter des champs pour n'importe quel volet d'ajout rapide. Par exemple, l'exemple suivant ajoute Valeur commerciale au volet du Backlog de produit.

Volet Backlog avec le champ Valeur commerciale ajouté

Le volet affiche uniquement les champs inclus dans la section FIELDS de la définition WIT du WIT sélectionné. Par exemple, si vous sélectionnez le WIT de bogue, seul Titre s'affiche, étant donné que le paramètre Valeur commerciale n'est pas défini pour les bogues. Pour ajouter un autre WIT au volet, vous l'ajoutez à la catégorie des spécifications comme décrit ici.

  1. Si vous ne disposez pas des autorisations d'administration pour votre projet d'équipe, obtenez-les.

  2. Ouvrez une fenêtre d'invite de commandes à l'emplacement où Visual Studio ou Team Explorer est installé, puis entrez :

    cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

    Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%. Le téléchargement de Team Explorer est gratuit.

  3. Exportez le fichier de configuration du processus.

    witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

    Un exemple de CollectionURL est http://MonServeur:8080/tfs/NomCollectionProjetÉquipe.

  4. Ajoutez le nom de référence de champ dans la section AddPanel.

    Par exemple, la syntaxe suivante ajoute l'élément Priorité dans le volet.

    <AddPanel>
   <Fields>
      <Field refname="System.Title" />
      <Field refname="Microsoft.VSTS.Common.BusinessValue" />
   </Fields>
</AddPanel>

    Conseils :

    • Vous pouvez rechercher le nom de référence d'un champ à l'aide de cet index.

    • Ajoutez tous les champs requis pour les types d'éléments de travail définis pour la catégorie des spécifications. De cette manière, vous évitez d'avoir à ouvrir le formulaire d'élément de travail pour les remplir lorsque vous ajoutez des éléments de Backlog via ce volet.

  5. Importez le fichier de configuration du processus.

    witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

  6. Actualisez la page de Backlog pour afficher le volet mis à jour.

Mettre à jour les mappages de méta-états pour prendre en charge Test Manager

Si vous personnalisez la section WORKFLOW du plan de test ou de la suite de tests, vous devez mapper les états aux méta-états. Ceci permet de prendre en charge les clients Test Manager qui utilisent Visual Studio 2013.2 ou versions antérieures.

Dans l'exemple suivant, le flux de travail du plan de test a été mis à jour pour utiliser les états Design, Testing et Signed Off. Pour assurer la compatibilité descendante, TestPlanWorkItems est ajouté à la section ProjectProcessConfiguration de la définition de la configuration de processus.

WORKFLOW

Mappages de méta-états

 
<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>
 
<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

Si vous modifiez le flux de travail de la suite de tests, vous devez apporter une mise à jour similaire pour mapper de nouveaux états. Dans ce cas, ajoutez-la dans une section TestSuiteWorkItems. Consultez Informations de référence sur les éléments XML de configuration de processus.

Q et R

Q : Quelles personnalisations puis-je effectuer tout en continuant à utiliser l'Assistant Configurer les fonctionnalités pour mettre à jour mon projet d'équipe après une mise à niveau TFS ?

R : Vous pouvez personnaliser le volet d'ajout rapide. L'Assistant Configurer les fonctionnalités mettra à jour vos projets d'équipe et vous aurez accès aux fonctionnalités les plus récentes.

D'autres modifications peuvent vous amener à effectuer certaines opérations manuelles lors de la mise à jour de votre projet d'équipe. Pour en savoir plus sur les personnalisations que vous pouvez effectuer et celles à éviter, voir Personnaliser l'expérience de suivi du travail : avant d'effectuer la personnalisation, comprendre les implications en matière de maintenance et de mise à jour.

Q : Quand dois-je mapper des états de flux de travail à des méta-états ?

R : Quand vous ajoutez des états de flux de travail aux types d'éléments de travail suivants ou les supprimez, vous devez penser à mettre à jour la configuration de processus pour ajouter ou supprimer les mappages de méta-états correspondants.

  • Types d'éléments de travail appartenant à la catégorie des spécifications ou des tâches : les mappages de méta-états prennent en charge l'affichage des outils de planification Agile.

  • Types d'éléments de travail appartenant à la catégorie des bogues : les mappages de méta-états prennent en charge l'outil Mon travail (projets d'équipe Agile et CMMI).

  • Plan de test et suite de tests : les mises à jour apportées au flux de travail de ces types d'éléments de travail doivent être mappées uniquement lorsque vous prenez en charge des membres d'équipe se connectant à TFS à partir d'une version de Test Manager basée sur Visual Studio 2013.2 ou version antérieure.

    Les types d'éléments de travail du plan de test et de la suite de tests sont uniquement disponibles avec la mise à niveau vers TFS 2013.3, laquelle est proposée sous forme de téléchargement ici.

    Mettez à jour les mappages de méta-états si vous recevez une erreur de type L'application a rencontré une erreur inattendue lorsque vous vous connectez à votre projet d'équipe.

    Message d'erreur par défaut de l'application après la mise à niveau de TFS

Comment corriger les erreurs de configuration de processus ?

R : Lorsque vous apportez l'une des modifications suivantes à un projet d'équipe, vous devez mettre à jour les définitions du type d'élément de travail, les catégories ou la configuration de processus. Pour éviter les erreurs, apportez toujours vos modifications dans l'ordre suivant : (1) types d'éléments de travail, (2) catégories et (3) configuration de processus.

Personnalisation

Mettre à jour ou vérifier la définition d'un type d'élément de travail

Mettre à jour ou vérifier la définition de la configuration de processus

Ajouter un type d'élément de travail à la catégorie des spécifications

(Un type d'élément de travail peut appartenir à la catégorie des spécifications ou à la catégorie des tâches, mais pas les deux.)

Pour inclure les champs suivants :

  • Priorité du Backlog (Scrum) ou Rang dans la pile (Agile ou CMMI)

    (doivent correspondre à la valeur du champ assignée à type=Order dans le fichier de configuration de processus)

  • Effort (Scrum), Points de récit (Agile) ou Taille (CMMI)

    (doivent correspondre à la valeur du champ assignée à type=Effort dans le fichier de configuration de processus)

  • Chemin d'accès à la zone ou valeur du champ assignée à type=Team dans le fichier de configuration de processus

  • Tous les champs inclus dans la section AddPanel du fichier de configuration de processus (les champs doivent être définis dans la section FIELDS, mais ils ne doivent pas forcément être inclus dans la section FORM).

Pour contenir les mappages de méta-états nécessaires :

  • Mapper le début de chaque état de flux de travail à type="Proposed"

  • Mapper chaque état de flux de travail intermédiaire à faire apparaître dans le tableau Kanban à type="InProgress"

  • Mapper la fin de chaque état de flux de travail à type="Complete"

    Vous ne pouvez avoir qu'un seul état mappé à type="Complete"

Pour contenir une entrée pour définir les codes de couleur associés au type d'élément de travail. Par exemple :

<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

Modifier le flux de travail d'un type d'élément de travail dans la catégorie des spécifications

N/A

Pour contenir les mappages de méta-états nécessaires (comme décrits ci-dessus) pour ajouter un type d'élément de travail à la catégorie des spécifications.

Ajouter un type d'élément de travail à la catégorie des tâches

Pour inclure les champs suivants :

  • Priorité du Backlog (Scrum) ou Rang dans la pile (Agile ou CMMI)

  • Activité (Scrum ou Agile) ou Discipline (CMMI)

    (doivent correspondre à la valeur du champ assignée à type=Activity dans le fichier de configuration de processus)

  • Travail restant

    (doivent correspondre à la valeur du champ assignée à type=RemainingWork dans le fichier de configuration de processus)

  • Chemin d'accès à la zone ou valeur du champ assignée à type=Team dans le fichier de configuration de processus

  • (Facultatif) Travail d'origine et Travail effectué (Agile et CMMI uniquement)

Pour contenir les mappages de méta-états nécessaires :

  • Mapper le début de chaque état de flux de travail à type="Proposed"

  • Mapper chaque état de flux de travail intermédiaire à faire apparaître dans le tableau des tâches à type="InProgress"

  • Mapper la fin de chaque état de flux de travail à type="Complete"

    Vous ne pouvez avoir qu'un seul état mappé à type="Complete"

Pour contenir une entrée pour définir les codes de couleur associés au type d'élément de travail. Par exemple :

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

Modifier le flux de travail d'un type d'élément de travail dans la catégorie des tâches

N/A

Pour contenir les mappages de méta-états nécessaires (comme décrits ci-dessus) pour ajouter un type d'élément de travail à la catégorie des tâches.

Ajouter un type d'élément de travail à la catégorie des bogues (Agile et CMMI uniquement)

Modifier le flux de travail d'un type d'élément de travail dans la catégorie des bogues (Agile et CMMI uniquement)

N/A

Pour contenir les mappages de méta-états nécessaires :

  • Mapper le début de chaque état de flux de travail à type="Proposed"

  • Mapper chaque état de flux de travail intermédiaire à faire apparaître dans Mon travail à type="InProgress"

  • Mapper la fin de chaque état de flux de travail à type="Complete"

    Vous ne pouvez avoir qu'un seul état mappé à type="Complete"

Pour en savoir plus, consultez Prendre en charge l'état de mise à jour d'un bogue à l'aide de Mon travail.

Supprimer un type d'élément de travail de la catégorie des spécifications ou de la catégorie des tâches

N/A

Pour supprimer tous les mappages de méta-états qui sont uniquement associés à ce type d'élément de travail

Supprimer un type d'élément de travail d'un projet d'équipe

Pour supprimer le type d'élément de travail du fichier de catégories.

Pour supprimer tous les mappages de méta-états qui sont uniquement associés au type d'élément de travail que vous avez supprimé et l'élément WorkItemColor qui définit les codes de couleur pour le type d'élément de travail que vous avez supprimé.

Q : Comment personnaliser d'autres fonctions qui apparaissent dans les outils de planification Agile de TWA ?

R : Certaines personnalisations peuvent être effectuées dans l'interface utilisateur. D'autres nécessitent de modifier la configuration du processus ou d'autres objets du projet d'équipe. Pour une vue d'ensemble, consultez Configurer et personnaliser les outils de planification Agile pour un projet d'équipe.

Q : Voulez-vous utiliser plusieurs Backlogs de portefeuille ?

R : L'expérience par défaut prend en charge un niveau de Backlog de portefeuille. Vous pouvez ajouter jusqu'à cinq niveaux, comme décrit dans Ajouter un journal des travaux en souffrance (backlog) à la gestion de portefeuille Agile.

Q : Souhaitez-vous ajouter ou modifier les WIT qui apparaissent sur votre tableau de tâches ou votre Backlog de produit ?

R : Si vous avez ajouté un WIT personnalisé, vous pouvez l'ajouter au Backlog ou au tableau de tâches. Cependant, vous ne pouvez pas les faire apparaître aux deux emplacements. Découvrez comment en lisant Ajouter des bogues au backlog ou au tableau de tâches.