Importer et exporter la configuration de processus

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Vous personnalisez la configuration du processus pour modifier l’affichage des outils Agile du portail web. Quelques outils supplémentaires nécessitent que vous mappiez les états de flux de travail aux mappages de métastate.

Pour gérer la configuration du processus pour un projet, utilisez l’outil witadmin en ligne de commande pour exporter et importer le fichier de définition XML de configuration du processus. Pour en savoir plus sur la configuration du processus, consultez ProcessConfiguration.

• exportprocessconfig: exporte la définition de configuration du processus vers un fichier XML ou la fenêtre d’invite de commandes.
• importprocessconfig: importe le fichier XML de définition de configuration du processus.

Exécuter l’outil witadmin en ligne de commande

Pour exécuter l’outil witadmin en ligne de commande, ouvrez une fenêtre d’invite de commandes où Visual Studio est installé. L’outil witadmin en ligne de commande s’installe avec n’importe quelle version de Visual Studio. Vous pouvez accéder à cet outil en installant la version gratuite de Visual Studio Community ou de Visual Studio Team Explorer.

Pour Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Enterprise ou Professional à la place de , en fonction de Communityla version que vous avez installée.

Pour Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Enterprise ou Professional à la place de , en fonction de Communityla version que vous avez installée.

Pour Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Professional ou TeamExplorer à la place de , en fonction de Enterprisela version que vous avez installée.

Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%. Vous pouvez installer Visual Studio Community (qui fournit gratuitement l’accès à Team Explorer) ou Visual Studio Team Explorer 2017 .

Prérequis

• Pour exporter des définitions de configuration de processus, vous devez être un utilisateur valide du projet ou de la collection.
• Pour importer des définitions de configuration de processus, vous devez être membre des groupes de sécurité suivants : Administrateurs Team Foundation ou Administrateurs de projet.

Pour plus d’informations, consultez Modifier les autorisations au niveau de la collection de projets.

Syntaxe

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

Paramètres

Notes

L’installation de la dernière version d’Azure DevOps met à niveau des projets existants. Si vous mettez à jour un projet mis à niveau, consultez Configurer les fonctionnalités après une mise à niveau.

Si vous rencontrez des problèmes d’accès aux plans de test existants ou aux suites de tests après une mise à niveau, consultez Mises à jour manuelles pour prendre en charge la gestion des tests.

Exemples

Les valeurs suivantes s’appliquent dans chaque exemple :

• URL de la collection : http://AdventureWorksServer:8080/tfs/DefaultCollection
• Projet: Contoso
• Numéro de port du site web du serveur : 8080

Pour ajouter un champ au panneau d’ajout rapide

Vous pouvez ajouter des champs pour n’importe quel panneau d’ajout rapide. Par exemple, l’exemple suivant ajoute la valeur métier au panneau du backlog de produits.

Le panneau affiche uniquement les champs inclus dans la FIELDS section de la définition WIT pour l’option WIT sélectionnée. Par exemple, si vous sélectionnez le bogue WIT, seul le titre s’affiche, car la valeur métier n’est pas définie pour les bogues. Pour ajouter un autre WIT au panneau, vous l’ajoutez à la catégorie de configuration requise. Voir Ajouter un type d’élément de travail à un backlog et une carte.

1. Si vous n’avez pas d’autorisations d’administration pour votre projet, obtenez-les.

2. Ouvrez une fenêtre d’invite de commandes en fonction des instructions fournies dans Comment exécuter l’outil en ligne de commande witadmin. Par exemple :

   cd %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
   

3. Exportez le fichier de configuration du processus.

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

   Un exemple de CollectionURL est http://MyServer:8080/tfs/TeamProjectCollectionName.

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

   Par exemple, la syntaxe suivante ajoute l’élément Priority au panneau.

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

   Conseil

   • 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 de configuration requise. De cette façon, vous évitez d’avoir à ouvrir le formulaire d’élément de travail pour les remplir lorsque vous ajoutez des éléments de backlog via le panneau.

5. Importez le fichier de configuration du processus.

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

6. Actualisez la page de votre backlog pour afficher le panneau mis à jour.

Mettre à jour les mappages de métastate pour prendre en charge le Gestionnaire de tests

Si vous personnalisez la WORKFLOW section du plan de test ou de la suite de tests, vous devez mapper les états aux métastates.

Dans l’exemple suivant, le flux de travail du plan de test a été mis à jour pour utiliser les états Conception, Test et Connexion. Pour prendre en charge la compatibilité descendante, il TestPlanWorkItems est ajouté à la ProjectProcessConfiguration section de la définition de configuration du processus.

Workflow

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

Mappages de métastates

<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 effectuer une mise à jour similaire si vous souhaitez mapper de nouveaux états. Vous l’ajouteriez dans une TestSuiteWorkItems section. Consultez ProcessConfiguration.

Questions & réponses

Q : Quand dois-je mapper les états de flux de travail aux métastates ?

R : Lorsque vous ajoutez ou supprimez des états de flux de travail aux types d’éléments de travail suivants, vous devez envisager de mettre à jour la configuration du processus pour ajouter ou supprimer des mappages de métastate correspondants.

• Les types d’éléments de travail appartenant à la catégorie d’exigence ou à la catégorie de tâche : les mappages de métastate prennent en charge l’affichage des outils de planification Agile.

• Types d’éléments de travail qui appartiennent à la catégorie de bogues : mappages metastate pour prendre en charge l’outil My Work (projets agiles 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 les membres de l’équipe qui se connectent à Azure DevOps à partir d’une version de Test Manager basée sur Visual Studio 2013.2 ou une version antérieure.

  Mettez à jour les mappages de métastate si vous recevez une application a détecté une erreur d’erreur inattendue lorsque vous vous connectez à votre projet.

  

Comment faire résoudre les erreurs de configuration du processus ?

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

Q : Voulez-vous travailler avec deux backlogs de portefeuille ou plus ?

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 des backlogs de portefeuille aux outils Agile.

Q : Voulez-vous ajouter ou modifier les types d’éléments de travail qui apparaissent dans votre tableau des tâches ou votre backlog produit ?

R : Si vous avez ajouté un type d’élément de travail personnalisé et souhaitez l’ajouter au backlog ou au tableau des tâches, vous pouvez. Vous ne pouvez pas les avoir dans les deux endroits. Découvrez comment lire ajouter des types d’éléments de travail aux backlogs et aux tableaux.

Articles connexes

• Configurer des fonctionnalités après une mise à niveau
• Référence d’élément XML control
• Modifier la disposition du formulaire d’élément de travail
• Modifier une définition de type d’élément de travail pour ajouter du contenu web à un formulaire d’élément de travail
• Personnalisation de votre expérience de suivi du travail
• Index des champs d’élément de travail
• witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail