Personnaliser les pages Journal des travaux en souffrance
Vous pouvez personnaliser les fonctionnalités du journal des Team Web Access pour spécifier différents types d'éléments de travail, des champs, et de colonnes qui apparaissent sur les pages.La page journal permet d'accéder à deux types de pages.La page de journal des travaux en souffrance du produit répertorie ces éléments du journal des travaux en souffrance du produit qui doivent être développés mais est jusqu'à présent non enregistrée.Les pages du journal des itérations répertorient les éléments du journal assignés à une itération spécifique.Pour en savoir plus sur l'utilisation des pages de journal des travaux en souffrance, consultez l' Planification et itérations Agile.
Si votre projet d'équipe a été créé à l'aide d'un modèle de processus différente de celles fournies par Microsoft ou vous avez personnalisé les définitions de types d'éléments de travail ou modifié leur flux de travail, vous devrez peut-être personnaliser un des fichiers de définition pour la configuration de processus.
Vous personnalisez les pages journal en exportant les fichiers de définition XML pour votre projet d'équipe, ou téléchargez la version la plus récente des modèles de processus pour votre projet d'équipe.Les fichiers de définition XML utilisés pour personnaliser les pages du journal sont des catégories, l'AgileConfiguration, et le CommonConfguration.Pour plus d'informations sur l'exportation ces fichiers ou les télécharger le, consultez Personnaliser les catégories pour les types d'éléments de travail [witadmin], Gestion de la configuration de processus witadmin [], et le Télécharger la dernière version des modèles de processus.
Dans cette rubrique
« Quick » ajoutez l'expérience
Colonnes et l'ordre des colonnes
Types d'éléments de travail qui sont considérés comme des éléments du journal
Rapidité de l'équipe
Travail restant, capacité-par-activité, et jours non-travaillants
Configuration requise
Pour exécuter l'outil en ligne de commande des witadmin , vous devez être membre du groupe Team Foundation Administrators ou membre du groupe Project Administrators pour le projet.Pour plus d'informations, consultez Autorisations de Team Foundation Server.
Pour afficher la page de journal des travaux en souffrance, vos autorisations d'accès au Web d'équipe doivent être définies à complet.Des exigences supplémentaires en matière de licences peuvent s'appliquer.Pour plus d'informations, consultez Accès aux fonctionnalités dans Team Web Access.
« Quick » ajoutez l'expérience
Utilisation du « quick » ajouter la fonctionnalité, vous pouvez spécifier les champs et les types d'éléments de travail disponibles pour ajouter rapidement des éléments au journal.Vous pouvez ajouter ou supprimer des champs qui apparaissent dans le panneau que l'équipe l'utilise pour enregistrer de nouveaux éléments du journal.La configuration par défaut spécifie uniquement Titre (System.Title) for agile et scrum, et inclut type de spécification (Microsoft.VSTS.CMMI.RequirementType) pour CMMI.
[!REMARQUE]
Pour ajouter des types d'éléments de travail à « rapide add » l'expérience, les ajouter à la catégorie de spécifications comme décrit dans Types d'éléments de travail qui sont considérés comme des éléments du journal.
Pour personnaliser le rapide ajoutez le panneau
Pour exécuter l'outil en ligne de commande des witadmin , ouvrez une fenêtre d'invite de commandes où Visual Studio ou Team Explorer est installé et entrez :
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
Sur une édition 64 bits de Windows, remplacez %programfiles% par %programfiles(x86)%.
Sélectionnez la commande suivante substituant les données des arguments indiqués ici, où CollectionURL spécifie l'URL d'une collection de projets d'équipe, Nomprojet spécifient le nom d'un projet d'équipe défini dans la collection, et DirectoryPath spécifie le nom et l'emplacement du fichier exporte.Choisissez Entrée.
witadmin exportagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"
Un exemple de CollectionURL est http://MyServer:8080/tfs/TeamProjectCollectionName.
Ouvrez le fichier d'AgileConfiguration dans le bloc-notes, puis affectez à l'élément d' AddPanel .
Ajoutez un élément d' Field qui spécifie le nom de référence du champ que vous souhaitez ajouter au panneau.
Conseil Si vous avez ajouté des champs obligatoires à un élément de journal des travaux en souffrance sans spécifier une valeur par défaut pour eux, vous devez envisager d'ajouter ces champs au rapide ajoutez l'expérience.
Si votre projet d'équipe est configuré de synchronisation avec Project Server, vous pouvez ajouter le champ utilisé pour envoyer des éléments de travail dans Project Server (Microsoft.Sync.ProjSrv.Submit).
Par exemple, la syntaxe suivante ajoute l'élément Priorité dans le panneau.
<AddPanel> <Fields> <Field refname="System.Title" /> <Field refname="Microsoft.VSTS.Common.Priority" /> </Fields> </AddPanel>
[!REMARQUE]
Pour la catégorie de spécification, vous définissez des types d'éléments de travail à inclure dans le journal des travaux en souffrance du produit, et pour les éléments de travail, vous définissez des champs.Vous devez spécifier le nom de référence d'un champ défini pour un type d'élément de travail que vous incluez dans la catégorie de spécifications.Pour plus d'informations, consultez Référence des champs d'éléments de travail pour Visual Studio ALM.
L'illustration suivante montre le panneau après avoir importé le fichier.
Retour au début
Colonnes et séquence de colonne pour les pages du journal
Vous pouvez ajouter ou supprimer des colonnes, modifier l'ordre des colonnes, ou modifier la largeur de colonne pour les pages qui affichent le journal des travaux en souffrance du produit ou un journal des itérations en souffrance.
Pour personnaliser la disposition de colonne
Dans la fenêtre d'invite de commandes pour witadmin, sélectionnez la commande suivante, en substituant les données des arguments indiqués ici, où CollectionURL spécifie l'URL d'une collection de projets d'équipe, Nomprojet spécifient le nom d'un projet d'équipe défini dans la collection, et DirectoryPath spécifie le nom et l'emplacement du fichier exporte.Choisissez Entrée.
witadmin exportagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"
Ouvrez le fichier d'AgileConfiguration dans le bloc-notes, puis localisez l'élément d' Columns dans la section d' ProductBacklog pour la page de journal des travaux en souffrance du produit, ou l' IterationBacklog pour les pages du journal des itérations en souffrance.
Pour ajouter une nouvelle colonne, ajoutez un élément d' Column qui spécifie le nom de référence du champ que vous souhaitez ajouter.
Par exemple, la syntaxe suivante ajoute l'élément Priorité aux colonnes qui apparaissent pour la page de journal des travaux en souffrance du produit.Les colonnes apparaissent dans l'ordre dans lequel elles sont répertoriées dans cette section.
<ProductBacklog> <Columns> <Column refname="Microsoft.VSTS.Common.Priority" width="400" /> <Column refname="System.Title" width="400" /> <Column refname="System.State" width="100" /> <Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" /> <Column refname="System.IterationPath" width="200" /> </Columns> . . . </ProductBacklog>
Éventuellement, vous pouvez supprimer une colonne pour un champ.
(Facultatif) pour modifier la largeur d'une colonne, modifiez la valeur assignée à width, spécifiée en pixels.
Par exemple, vous pouvez modifier la largeur des points de récit à 100 pixels en spécifiant la syntaxe suivante.
<Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="100" />
Sélectionnez la commande suivante pour importer le fichier de définition :
witadmin importagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"
Cliquez sur F5 pour actualiser la page Web pour qu' Team Web Access reflète les modifications.
Retour au début
Types d'éléments de travail qui sont considérés comme des éléments du journal
Les éléments du journal correspondent aux types des éléments de travail ajoutés à la catégorie de spécifications.Les éléments qui apparaissent dans la page de journal des travaux en souffrance du produit correspondent aux éléments de travail dont l'état de flux de travail est associé au metastate d' Proposed ou le metastate d' InProgress qui n'ont pas encore été assignés à une itération.Pour plus d'informations sur ces rapports, consultez l' états de flux de travail, metastates, et configuration de processus.
Pour ajouter un type d'élément de travail en tant qu'élément de journal des travaux en souffrance, vous devez configurer les éléments suivants :
Ajoutez le type d'élément de travail de la catégorie de spécifications (Microsoft.RequirementCategory).
Configurez les metastates pour le type d'élément de travail dans le fichier de CommonConfiguration s'ils diffèrent de celles déjà définis.
Ajoutez le champ utilisé à l'effort de suivi à la définition du type d'élément de travail.Par exemple, pour agile, ajoutez la définition de champ suivante :
<FIELD name="Story Points" refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Double" reportable="measure" formula="sum" >
Pour plus d'informations sur la façon dont le champ utilisé pour suivre l'effort est utilisé, consultez Team la vitesse.Pour plus d'informations, consultez Ajouter un champ et modifier la disposition d'un type d'élément de travail existant.
Pour spécifier les types d'éléments de travail du journal qui apparaissent
Dans la fenêtre d'invite de commandes pour witadmin, tapez la commande suivante, en substituant les données des arguments indiqués ici, où CollectionURL spécifie l'URL d'une collection de projets d'équipe, Nomprojet spécifient le nom d'un projet d'équipe défini dans la collection, et DirectoryPath spécifie le nom et l'emplacement du fichier exporte.Choisissez Entrée.
witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"
Ouvrez les catégories dans le bloc-notes, puis définissez l'élément d' CATEGORY pour "Requirement Category".
Pour ajouter un nouveau type d'élément de travail, ajoutez un élément d' WORKITEMTYPE qui spécifie le nom d'un autre type d'élément de travail que vous souhaitez ajouter.
Par exemple, la syntaxe suivante ajoute le type d'élément de travail « bogue de téléphone » à la catégorie de spécification pour un projet d'équipe qui utilise le modèle de processus scrum.
<CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory"> <DEFAULTWORKITEMTYPE name="Product Backlog Item" /> <WORKITEMTYPE name="Bug" /> <WORKITEMTYPE name="Phone Bug" /> </CATEGORY>
Important
Vous devez spécifier un type d'élément de travail défini pour votre projet d'équipe.De plus, vous ne pouvez pas ajouter un type d'élément de travail de la catégorie de spécification qui a également été ajoutée à la catégorie de tâche.
Sélectionnez la commande suivante pour importer le fichier de définition :
witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\Categories.xml"
Cliquez sur F5 pour actualiser la page Web pour qu' Team Web Access reflète les modifications.
Pour assigner des metastates aux états du flux de travail de types d'éléments de travail du journal
En reprenant de la procédure précédente, exportez le fichier de définition pour CommonConfiguration pour votre projet d'équipe en tapant la commande suivante dans une fenêtre d'invite de commandes :
witadmin exportcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
Ouvrez le fichier de CommonConfiguration dans le bloc-notes, puis affectez à l'élément d' RequirementWorkItems .
Pour assigner un état de flux de travail, ajoutez un élément d' STATE qui spécifie le nom du rapport et de son metastate type.
Par exemple, la syntaxe suivante spécifie les quatre états pour la catégorie de spécification de types d'éléments de travail, assignant deux d'entre eux au même metastate d' "Proposed".
<RequirementWorkItems category="Microsoft.RequirementCategory" plural="Backlog items"> <States> <State value="New" type="Proposed" /> <State value="Approved" type="Proposed" /> <State value="Committed" type="InProgress" /> <State value="Done" type="Complete" /> </States> </RequirementWorkItems
Important
Vous devez spécifier une valeur pour l'élément d' State qui correspond à un état de flux de travail valide.Un état de flux de travail est valide dans ce cas un état défini pour un type d'élément de travail qui est inclus dans la catégorie de spécifications pour votre projet d'équipe.De plus, vous devez assigner un metastate type défini dans le groupe agile ; autrement dit, vous pouvez assigner Proposed, InProgress, ou Complete.
(Facultatif) vous pouvez modifier l'en-tête de colonne assignée aux éléments du journal en modifiant la valeur assignée à plural pour l'élément d' RequirementWorkItems .
Par exemple, la syntaxe suivante modifie l'en-tête de colonne d' "Backlog items" par "Stories":
<RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
Sélectionnez la commande suivante pour importer le fichier de définition :
witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
Cliquez sur F5 pour actualiser la page Web pour qu' Team Web Access reflète les modifications.
Retour au début
Rapidité de l'équipe
Vous pouvez modifier le champ utilisé pour calculer la rapidité de l'équipe.Le champ par défaut correspond au champ utilisé pour estimer la taille de vos éléments du journal.Si vous modifiez le champ, puis vérifiez que vous ajoutez une définition d'élément d' FIELD du nouveau champ aux définitions de tous les types d'éléments de travail inclus dans la catégorie de spécifications.
La configuration par défaut fait référence au même champ assigné à l'élément de journal des travaux en souffrance qui stocke le niveau d'effort.Les modèles de processus par défaut pour Visual Studio ALM référencent les champs individuels pour type="Effort", notamment : Points de récit pour agile (Microsoft.VSTS.Scheduling.StoryPoints), planification la taille for CMMI (Microsoft.VSTS.Scheduling.Size), et l'effort scrum (Microsoft.VSTS.Scheduling.Effort).Le champ que vous spécifiez pour type="Effort" est utilisé pour calculer la rapidité de l'équipe et prendre en charge des prévision.
Pour modifier le champ utilisé pour calculer la rapidité de l'équipe
Recherchez la section pour TypeFields dans le fichier de CommonConfigurations.
Recherchez l'entrée spécifiée pour type="Effort".
Pour personnaliser, modifiez le champ assigné à refname.
Par exemple, l'exemple suivant spécifie FabrikamFiber.Points en tant que champ utilisé pour estimer la taille des éléments du journal :
<TypeField refname="FabrikamFiber.Points" type="Effort" />
Retour au début
Travail restant, capacité-par-activité, et jours non-travaillants
Les champs utilisés pour spécifier le travail restant, l'activité, et les jours non-travaillants sont utilisés lors de le calcul capacité, le travail restant, et les graphiques d'avancement.Les informations de capacité sont calculées automatiquement pour l'équipe entière, chaque membre de l'équipe, et des activités spécifiées après des informations sur la capacité du membre de l'équipe et les éléments ont été ajoutés au journal pour une itération suivante.Pour plus d'informations, consultez Planifier une itération.
La configuration par défaut référence les champs suivants définis pour le type d'élément de travail Tâche et les éléments du CommonConfigurations fichier en effectuant les calculs :
Travail restant (Microsoft.VSTS.Scheduling.RemainingWork) à stocker prévu et travail restant.Le champ que vous spécifiez doit correspondre au même champ spécifié dans la définition du type d'élément de travail que vous utilisez pour effectuer le travail, qui est généralement le type de tâche pour tous les modèles de processus.
[!REMARQUE]
Vous pouvez stocker le travail en heures ou de jours, ou que est ce qu'unité de temps vous souhaitez.Vous souhaiterez être cohérent dans les unités que vous utilisez pour effectuer le travail et pour définir la capacité pour les membres de l'équipe.
Activité (Microsoft.VSTS.Common.Activity) pour associer des tâches avec l'activité et afficher des barres de capacité-par- activité.
DayOfWeek pour spécifier les jours non-travaillants.
Vous devez modifier les jours non-travaillants où les jours que votre équipe fait différer hors de le samedi et du dimanche.
Pour modifier le champ utilisé pour les calculs de travail restant
En reprenant de la procédure précédente, localisez la section pour TypeFields dans le fichier de CommonConfigurations.
Modifiez le champ spécifié pour type="RemainingWork".
Pour personnaliser, modifiez le champ assigné à refname pour l'entrée suivante pour TypeField , et modifiez éventuellement la désignation de format d' format="{0} h" par format="{0}TimeUnitString".Par exemple, la syntaxe suivante spécifie heures à la place de la chaîne de texte par défaut h,
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="{0} hours"
[!REMARQUE]
La chaîne que vous spécifiez pour le format est utilisée dans le panneau de journal des travaux en souffrance et de tâche pages où le travail restant est signalée.Par exemple, en stockant la capacité-par- activité ou la capacité chaque membre de l'équipe, ou en regard de l'en-tête de colonne pour les états de tâche sur la tâche embarquez.
Pour modifier le champ utilisé pour les calculs de capacité-par- activité
En reprenant de la procédure précédente, localisez la section pour TypeFields dans le fichier de CommonConfigurations.
Modifiez le champ spécifié pour type="Activity".
Pour personnaliser, modifiez le champ assigné à refname pour l'entrée suivante pour TypeField .
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity"/>
Pour modifier les jours non-travaillants utilisés pour calculer la capacité et l'avancement
En reprenant de la procédure précédente, localisez l'élément d' Weekends dans le fichier de CommonConfigurations.
Pour modifier un jour, modifiez la valeur qui apparaît dans l'un des éléments d' DayOfWeek .
Par exemple, si votre équipe ne fonctionne pas - à Friday et à Saturday, puis spécifiez la syntaxe suivante :
<Weekends> <DayOfWeek>Friday</DayOfWeek> <DayOfWeek>Saturday</DayOfWeek> </Weekends>
[!REMARQUE]
Vous devez spécifier le jour d'une semaine en anglais, indépendamment de la langue de l'installation d' Team Foundation Server.
Éventuellement, vous pouvez ajouter un élément d' DayOfWeek si votre équipe travaille uniquement quatre jours hors de la semaine.
Sélectionnez la commande suivante pour importer le fichier de définition :
witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
Cliquez sur F5 pour actualiser la page Web pour qu' Team Web Access reflète les modifications.
Voir aussi
Concepts
Créer un journal des travaux en souffrance ou y ajouter des éléments