Partager via


Référence des éléments XML de configuration de processus

Les fichiers de configuration de processus déterminent la disposition et les fonctionnalités suivantes : vitesse de journal des travaux en souffrance du produit et d'équipe, journal des itérations en souffrance, capacité de l'équipe, et graphiques d'avancement, mappage de tâche, commentaires des parties prenantes, et mon travail.Vous pouvez exporter ces fichiers de configuration, AgileConfiguration et CommonConfiguration, de votre projet d'équipe ou y accéder à partir de le modèle de processus que vous téléchargez de Visual Studio Team Foundation Server 2012.Vous personnalisez la disposition des pages journal en modifiant les définitions spécifiées dans AgileConfiguration, et vous personnalisez des zones communes à plusieurs fonctionnalités en modifiant les définitions spécifiées dans CommonConfiguration.

Pour une vue d'ensemble des fonctionnalités que vous pouvez personnaliser, consultez Personnaliser le journal des travaux en souffrance et le tableau des tâches à l'aide de la configuration du processus.

[!REMARQUE]

Pour plus d'informations sur la façon dont une équipe utilise les pages de mappage de journal des travaux en souffrance et de tâche, consultez Planification et itérations Agile.

Dans cette rubrique

  • AgileConfiguration : structure de la syntaxe et éléments

  • CommonConfiguration : structure de la syntaxe et éléments

AgileConfiguration : structure de la syntaxe et éléments

Vous personnalisez la page journal en modifiant les éléments contenus dans l'élément d' AgileProjectConfiguration .Pour personnaliser la page de journal des travaux en souffrance du produit, modifiez les éléments dans l'élément d' ProductBacklog , et personnaliser les pages journal des itérations en souffrance, modifiez les éléments contenus dans les éléments d' IterationBacklog .

L'exemple XML suivant illustre la structure de code qui définit la configuration de processus agile contenue dans le fichier d'AgileConfiguration.xml.Cet exemple correspond à la syntaxe par défaut définie pour MSF for Agile Software développement v6.0.

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

Retour au début

Hh500408.collapse_all(fr-fr,VS.110).gifÉléments XML pour les pages du journal

Le tableau suivant décrit les éléments enfants de l'élément racine d' AgileProjectConfiguration .Vous pouvez utiliser ces éléments pour spécifier les colonnes et les champs qui doivent s'afficher dans la page de journal des travaux en souffrance.

Élément

Description et syntaxe

Remarques

AddPanel

L'élément conteneur utilisé pour spécifier le « quick » ajoutent l'expérience, les champs apparaissent dans la zone de panneau où de nouveaux éléments du journal sont définis.

<AddPanel>
    <Fields>
       <Field . . . />
       . . .
   </Fields>
</AddPanel>

Obligatoire.Une instance que.

Vous devez spécifier au moins un élément d' Fields .

Le « quick » ajoutent l'expérience apparaît uniquement sur la page de journal des travaux en souffrance du produit dans Team Web Access.

Column

Spécifie un champ à afficher comme colonne sur une page en souffrance.

<Column refname="FieldReferenceName"  width="FieldWidth" />

Obligatoire.

Pour chaque colonne que vous souhaitez voir apparaître sur les pages qui affichent une liste de journal des travaux en souffrance, vous devez spécifier le nom de référence d'un champ défini pour le type d'élément de travail associé aux éléments du journal des travaux en souffrance.Vous devez spécifier un entier positif pour la largeur du champ.

Columns

Spécifie une collection d'éléments Column.

<Columns>
   <Column . . . />
   . . .
</Columns>

Obligatoire.Une instance unique pour chaque IterationBacklog et éléments parents d' ProductBacklog .

Vous devez spécifier les colonnes que vous souhaitez voir apparaître sur les pages qui affichent le journal des travaux en souffrance du produit ou un journal des itérations en souffrance.

Field

Spécifie un champ à afficher dans le panneau de la page de journal des travaux en souffrance du produit.

<Field refname=”FieldReferenceName” />

Obligatoire.Un ou plusieurs éléments contenus dans l'élément parent d' Fields .

Lorsque vous définissez un élément de travail pour ajouter au journal, vous pouvez spécifier une valeur pour les champs que vous répertoriez dans la section d' AddPanel du processus de configuration.

La configuration par défaut spécifie le champ Titre comme seul champ à afficher, comme le montre l'exemple de code suivant :

<AddPanel>
   <Fields>
      <Field refname="System.Title" />
   </Fields>
</AddPanel>

Fields

Spécifie une collection d'éléments Field.

<Fields>
<Field . . . />
   . . .
</Fields>

Obligatoire.Une instance que définie pour l'élément parent d' AddPanel .

Vous spécifiez les champs que vous souhaitez spécifier rapidement en ajoutant des éléments au journal des travaux en souffrance du produit.

IterationBacklog

Élément conteneur utilisé pour personnaliser la disposition des pages qui affichent des éléments de travail assignés à une itération spécifique.

<IterationBacklog workItemCountLimit="MaximumLimit"  >
   <Columns> . . . </Columns>
   . . . 
</IterationBacklog > 

Obligatoire.Une instance que.

Vous spécifiez le nombre de colonnes, les largeurs de colonne, et les champs qui remplissent chaque colonne pour ces pages qui affiche la liste des éléments du journal des travaux en souffrance assignés à une itération.

Par défaut, le mappage de tâche est limitée à un total de 500 éléments de travail.Vous pouvez modifier cette limite en spécifiant une valeur pour l'attribut d' workItemCountLimit .

ProductBacklog

Élément conteneur utilisé pour personnaliser la disposition de la page qui affiche le journal des travaux en souffrance du produit et qui contient un panneau pour ajouter des éléments de travail au journal des travaux en souffrance.

<ProductBacklog>
   <Columns> . . . </Columns>
   <AddPanel> . . . </ AddPanel>
</ProductBacklog >

Obligatoire.Une instance que.

Vous spécifiez le nombre de colonnes, les largeurs de colonne, et les champs qui remplissent chaque colonne pour ces pages qui affiche la liste des éléments du journal des travaux en souffrance assignés au journal des travaux en souffrance du produit.Le journal des travaux en souffrance du produit affiche tous les éléments actifs dans le journal des travaux en souffrance, y compris ceux qui ont été assignés à une itération.

Retour au début

CommonConfiguration : structure de la syntaxe et éléments

Vous personnalisez la page de carte de tâche à l'aide de l'élément d' CommonProjectConfiguration , qui prend en charge plusieurs éléments enfants.TypeFields spécifient le champ utilisé dans les types d'éléments de travail pour capturer des informations spécifiques.De nombreuses autres éléments enfants, par exemple, RequirementWorkItems, TaskWorkItems, et BugWorkItems spécifient le groupe de catégories à associer à ces types référencés par des fonctionnalités de configuration de processus particulier.

L'exemple XML suivant illustre la structure de code qui définit la configuration de processus commune contenue dans le fichier de CommonConfiguration.xml.Cet exemple correspond à la syntaxe par défaut définie pour MSF for Agile Software développement v6.0.

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
  </TypeFields>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

Retour au début

Hh500408.collapse_all(fr-fr,VS.110).gifÉléments XML pour les zones courantes

Le tableau suivant décrit les éléments enfants de l'élément d' CommonProjectConfiguration .Ces éléments configurent les zones que les pages de support qui affichent les deux dans Team Web Access, l' Team Explorer et la demande de commentaires formulaire.

Important

Les valeurs assignées à CategoryName doivent correspondre à un groupe de catégories défini pour le projet d'équipe.Vous spécifiez des groupes de catégorie dans le fichier de définition de catégories.Pour la dernière version de Visual Studio ALM, cinq catégories définies.Pour plus d'informations, consultez Catégories, configuration de processus, et désactiver la création de types spécifiques d'éléments de travail.

Élément

Description et syntaxe

Remarques

BugWorkItems

Spécifie la catégorie qui correspond aux éléments de travail Bogue et associe les états du flux de travail des éléments du journal avec les metastates.

<BugWorkItems category=”CategoryName”>
    <States>
       <State . . . />
       . . .
   </States>
</BugWorkItems

Obligatoire.CategoryName doit correspondre à une catégorie définie pour le projet d'équipe.

DayOfWeek

Spécifie un jour de la semaine correspondant à un jour non-travaillant.

<DayOfWeek>NameOfADay</DayOfWeek>

Enfant obligatoire de l'élément d' Weekends .

Les noms valides correspondent aux jours anglais de la semaine : Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, et Saturday.

RemarqueRemarque
Vous devez spécifier le jour d'une semaine en anglais, indépendamment de la langue de l'installation de Team Foundation Server.

FeedbackResponseWorkItems

Spécifie la catégorie qui correspond aux types d'éléments de travail qui sont utilisés pour capturer la réponse de commentaires et associe les états du flux de travail de ces éléments avec des metastates.

Obligatoire.Ne personnalisez pas.

CategoryName doit correspondre à un groupe de catégories défini pour le projet d'équipe.

FeedbackRequestWorkItems

Spécifie la catégorie qui correspond aux types d'éléments de travail qui sont utilisés pour capturer des demandes de commentaires et associe les états du flux de travail de ces éléments avec des metastates.

Obligatoire.Ne personnalisez pas.

CategoryName doit correspondre à un groupe de catégories défini pour le projet d'équipe.Spécifiez les groupes de catégories à l'aide de le fichier Categories.xml.

RequirementWorkItems

Spécifie la catégorie qui correspond aux éléments du journal des travaux en souffrance, tels que les récits utilisateur, spécifications, et des éléments du journal des travaux en souffrance du produit et associe les états du flux de travail des éléments du journal avec les metastates.

<RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >
   <States>
      <State . . . />
      . . .
   </States>
</RequirementWorkItems>

Obligatoire.

CategoryName doit correspondre à un groupe de catégories défini pour le projet d'équipe.Spécifiez les groupes de catégories à l'aide de le fichier Categories.xml.

State

Affecte un état de flux de travail à un metastate.Metastates représentent un regroupement des états de flux de travail qui prennent en charge la gestion des états du flux de travail sur une carte ou autre de tâche des composants de configuration de processus.

<State type="TypeName" value="ValueName"/>

Obligatoire.

Les valeurs valides pour TypeName correspondent à une valeur assignée à STATE dans le flux de travail défini pour les types d'éléments de travail qui sont présents au groupe de catégorie, respectivement.

Les valeurs valides pour ValueName correspondent à une les valeurs énumérées suivantes : dans le flux de travail défini pour les types d'éléments de travail qui sont présents au groupe de catégorie, respectivement.

  • Agile :

    • Proposed: Indique les éléments de travail qui sont nouveaux, pas encore validées, ou pas encore en cours de travaillé sur.

    • InProgress: Indique les éléments de travail qui ont été apportées ou activement sont travaillés sur.

    • Complete: indique les éléments de travail qui ont été implémentés.

  • Bogue : Outre les metastates agiles, inclut le metastate d' Resolved qui indique les bogues qui ont été résolus.

  • Commentaires : Requested, Received, Reviewed, et Declined.

Pour plus d'informations, consultez l' états de flux de travail, metastates, et configuration de processus.

States

Spécifie une collection d'éléments d' State qui associent les états du flux de travail de types d'éléments de travail à des metastates.

<States>
   <State . . . />
   . . .
</States>

Élément requis pour BugWorkItems, FeedbackResponseWorkItems, FeedbackRequestWorkItems, RequirementWorkItems les éléments et d' TaskWorkItems .

Les éléments d'State permettent de modifier des états de flux de travail aux metastates.

TaskWorkItems

Spécifie la catégorie qui correspond aux tâches et associe les états du flux de travail des tâches avec des metastates.

<TaskWorkItems category="CategoryName">
   <States>
      <State . . . />
      . . .
   </States>
</TaskWorkItems>

Obligatoire.

CategoryName doit correspondre à un groupe de catégories défini pour le projet d'équipe.Vous spécifiez des groupes de catégorie à l'aide de le fichier Categories.xml.

Les pages de journal des travaux en souffrance et de mappage répertorient les éléments de travail qui correspondent aux valeurs d'état spécifiées dans l'élément d' States .

TypeField

Spécifie le nom de référence d'un champ dont la valeur est référencée pour prendre en charge un type d'activité pour les fonctionnalités prises en charge.Spécifiez cet élément dans l'élément conteneur d' TypeFields .

<TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / >

Spécifier le format est uniquement valide lorsque type="RemainingWork".Vous pouvez spécifier n'importe quelle chaîne de texte pour TimeUnitString que vous souhaitez voir apparaître dans les barres de capacité de la page active du journal des itérations et sur le mappage de tâche.

Obligatoire.Vous devez spécifier les champs qui correspondent aux champs que vous utilisez dans les types d'éléments de travail pour capturer des informations spécifiques.

Pour les pages de mappage de journal des travaux en souffrance et de tâche :

  • Activity: utilisé pour prendre en charge la fonctionnalité de capacité-par-activité.Spécifiez un champ défini pour le type de tâche d'élément de travail que vous utilisez pour spécifier le type d'activité à effectuer.

  • Effort: Spécifie le champ utilisé pour calculer la rapidité de l'équipe.Spécifiez un champ défini pour le type de journal des travaux en souffrance d'élément de travail que vous utilisez pour capturer le niveau d'effort ou l'évaluation relative de la quantité de travail qu'un élément de journal des travaux en souffrance sera nécessaire pour implémenter.

  • Order: Spécifie le champ utilisé pour définir l'ordre de tri des éléments du journal des travaux en souffrance sur les pages de mappage de journal des travaux en souffrance et de tâche d'itération.Spécifiez le champ que vous utilisez pour capturer la priorité relative assignée aux éléments du journal des travaux en souffrance.Les éléments de travail sont répertoriés dans la page selon l'ordre croissant comme défini par le champ pour ce type.

  • RemainingWork: Spécifie le champ utilisé pour calculer les graphiques de travail restant et d'avancement.Spécifiez le champ que vous utilisez pour capturer le nombre d'heures ou de jours qui restent pour terminer une tâche.

    La valeur que vous spécifiez pour format est utilisée dans le mappage de journal des travaux en souffrance et de tâche pages où le travail restant est enregistrée.Par exemple, en stockant la capacité-par-activité ou la capacité par membre de l'équipe, ou en regard de l'en-tête de colonne pour les états de tâche dans la tâche embarquez.

    Pour TimeUnitString, spécifiez une chaîne de texte à utiliser pour refléter la valeur d'heure, telles que les heures ou de jours.

    Par exemple, les valeurs suivantes sont toutes valides :

    format="{0} h"

    format="{0} hours"

    format="hours {0}"

    format="time {0}"

  • Team: Spécifie le champ utilisé pour associer les pages de mappage de journal des travaux en souffrance et de tâche avec une équipe.Ce champ doit rester définit sa valeur par défaut, System.AreaPath.

Pour le formulaire de demande de commentaires :

RemarqueRemarque
Vous ne devez pas avoir à modifier les assignations par défaut effectuées pour les éléments suivants d' TypeField .Ces assignations correspondent aux champs utilisés pour capturer les informations correspondantes dans le type de demande de commentaires d'élément de travail.
  • ApplicationStartInformation: spécifie le champ utilisé pour capturer le chemin d'accès pour exécuter l'application.

  • ApplicationLaunchInstructions: spécifie le champ utilisé pour capturer l'instruction de lancement.

  • ApplicationType: spécifie le champ utilisé pour capturer le type d'application.Les types répertoriés correspondent aux valeurs autorisées spécifiées dans la définition de type pour la demande de commentaires.

TypeFields

Spécifie une collection d'éléments TypeField.

<TypeFields>
   <TypeField . . . />
   . . .
</TypeFields>

Obligatoire.

Vous devez spécifier les types de champs que vous souhaitez référencé prendre en charge les fonctionnalités qui apparaissent dans le journal des travaux en souffrance, le mappage de tâche, et le formulaire de demande de commentaires.

TypeFieldValue

Spécifie le nom d'un type d'application à afficher sur le formulaire de demande de commentaires.

<TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>

Obligatoire.Ne personnalisez pas.

Les assignations par défaut correspondent aux valeurs autorisées spécifiées dans la définition de type pour le formulaire de demande de commentaires.

<TypeFieldValues>
   <TypeFieldValue value="Web application" type="WebApp" />
   <TypeFieldValue value="Remote machine" type="RemoteMachine" />
   <TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>

TypeFieldValues

Spécifie une collection d'éléments TypeFieldValue.

<TypeFieldValues>
   <TypeFieldValue . . . />
   . . .
</TypeFieldValues>

Requis pour TypeFieldValue lorsque type="ApplicationType".

Vous devez spécifier des valeurs pour les types de champs que vous souhaitez voir apparaître dans le formulaire de demande de commentaires.

Weekends

Élément conteneur utilisé pour spécifier les jours non-travaillants.

<Weekends>
   <DayOfWeek> . . . </DayOfWeek >
   . . . 
</ Weekends >

Facultatif.

Spécifiez les jours non-travaillants où vous souhaitez prendre en compte les jours non-travaillants dans le calcul des graphiques de capacité et d'avancement.

Retour au début

Voir aussi

Référence

Gestion de la configuration de processus witadmin []

Concepts

Mettre à jour un projet d'équipe mis à niveau pour accéder à de nouvelles fonctionnalités

Personnaliser le journal des travaux en souffrance et le tableau des tâches à l'aide de la configuration du processus