Utiliser des modèles d’élément de travail

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

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Avec les modèles d’élément de travail, vous pouvez créer rapidement des éléments de travail dont les champs couramment utilisés par votre équipe sont préremplis. Les modèles d’élément de travail permettent de créer des éléments de travail et d’effectuer des mises à jour en bloc de plusieurs éléments de travail. Vous pouvez ajouter et gérer des modèles d’élément de travail sur le portail web ou dans Visual Studio 2015 (et versions antérieures). Pour obtenir des exemples d’utilisation de modèles d’élément de travail, consultez Exemples de modèles d’élément de travail.

Les modèles d’élément de travail sont distincts des modèles de processus. Pour plus d’informations, consultez À propos des processus et des modèles de processus ou ces articles spécifiques aux modèles de processus : De base, Agile, Scrum ou CMMI.

Tâches du modèle prises en charge

La disponibilité des options de tâche du modèle dépend de la version du client et de la plateforme. Vous pouvez ajouter et gérer des modèles d’élément de travail sur le portail web ou dans Visual Studio 2015 (et versions antérieures). Pour plus d'informations, consultez la section Configuration requise de cet article.

Dans le tableau suivant, ✔️ indique que la tâche est disponible sur le portail web ou dans Visual Studio 2015 (et versions antérieures) (Vérifiez que vous avez sélectionné la version du contenu correspondant à la version de votre plateforme).

---

Tâche

Portail web

Visual Studio 2015

---

Capture d’un élément de travail en tant que modèle

✔️

✔️

---

Gestion des modèles d’élément de travail
(Définir, modifier, supprimer, copier le lien, créer une copie et renommer)

✔️

✔️

---

Copie du lien (URL) d’un modèle

✔️

✔️

---

Ajout d’un élément de travail à l’aide d’un modèle

✔️

✔️

---

Définition d’un modèle d’élément de travail

✔️

✔️

---

Application d’un modèle à un ou plusieurs éléments de travail

✔️

✔️

---

Ajout et suppression d’étiquettes dans les modèles

✔️

---

Définition d’un modèle à l’aide d’un lien hypertexte

✔️

---

Conseil

Les modèles définis sur le portail web sont distincts des modèles définis dans Visual Studio. Ceux du portail web ne peuvent être gérés et appliqués aux éléments de travail que sur le portail web. De même, il n’est possible de gérer, d’afficher et d’appliquer les modèles Visual Studio qu’aux éléments de travail de Visual Studio. Vous avez toutefois la possibilité d’utiliser les URL des deux types de modèles pour ajouter des éléments de travail sur le portail web.

Prérequis

• Pour gérer les modèles d’élément de travail dans le portail web, vous devez rejoindre l’équipe qui les possède. Vous pouvez ensuite ajouter, modifier ou supprimer des modèles en fonction des besoins.

• Vous devez être contributeur de projet et membre de l’équipe pour utiliser des modèles d’élément de travail dans le portail web. Vous pouvez ensuite appliquer des modèles à des éléments de travail existants.

• Pour ajouter, capturer ou modifier des modèles d’élément de travail dans Visual Studio Team Explorer, installez Microsoft Visual Studio Team Foundation Server 2015 Power Tools. Ces modèles s’affichent uniquement dans votre vue de Team Explorer.

Capture d’un élément de travail en tant que modèle

Selon la plateforme, la version et le client que vous utilisez, vous devrez peut-être suivre différentes étapes pour capturer un élément de travail.

Portail Web

Un GUID est affecté aux modèles capturés sur le portail web.

1. Sur le portail web, ouvrez l’élément de travail à utiliser comme base pour un modèle.

2. Sélectionnez l’icône d’actions pour ouvrir le menu. Choisissez Modèles, puis Capturer.

   

   Donnez un nom au modèle, sélectionnez l’équipe sous laquelle vous souhaitez l’enregistrer et, éventuellement, définissez ou effacez des champs. Enregistrez le modèle lorsque vous avez terminé.

   

3. Enregistrez le modèle, puis sélectionnez Copier le lien pour capturer l’URL du modèle.

4. Vous pouvez coller le lien URL dans un navigateur pour créer un élément de travail ou le fournir à d’autres personnes pour leur permettre d’ajouter des éléments de travail. Par exemple, insérez-le sous forme de lien hypertexte vers un wiki de projet, un tableau de bord avec widget Markdown ou une autre ressource réseau partagée.

   Utilisez l’URL chaque fois que vous souhaitez ajouter un élément de travail du type que vous avez spécifié avec ses valeurs prédéfinies.

Visual Studio 2015

Pour créer des éléments de travail à partir de modèles dans Visual Studio ou Team Explorer, vous pouvez utiliser des fichiers de modèle d’élément de travail (extension .wt). Ces fichiers sont accessibles à partir de la page Éléments de travail.

1. Si vous n’avez pas encore installé Microsoft Visual Studio Team Foundation Server 2015 Power Tools, faites-le maintenant. Vous devez installer ce logiciel afin d’accéder à l’outil Power Tools Modèles d’élément de travail pour Visual Studio.

2. Ouvrez ou exécutez une requête qui recense l’élément de travail dont vous souhaitez capturer les champs.

3. Cliquez avec le bouton droit sur l’élément de travail du type voulu dont vous souhaitez capturer les champs, puis sélectionnez Capturer le modèle dans le menu contextuel.

   

4. Dans la boîte de dialogue, utilisez les cases à cocher pour sélectionner tous les champs que vous souhaitez enregistrer dans le modèle. Ensuite, ajoutez un nom et, éventuellement, une description au modèle.

   

5. Enregistrez le modèle. Il s’affiche à la racine du volet Team Explorer, sous la section Modèles.

Gestion des modèles d’élément de travail

Pour chaque type d’élément de travail, vous pouvez voir et gérer les modèles définis par votre équipe. Vous pouvez effectuer différentes actions sur les modèles, telles que l’ajout, la modification, la copie, la suppression, le renommage et l’obtention du lien.

Portail Web

1. À partir du portail web, ouvrez les Paramètres du projet.

   

   Développez Tableaux et choisissez Configuration de l’équipe. Si vous devez basculer vers une autre équipe, utilisez le sélecteur d’équipe.

2. Sélectionnez Modèles.

   Sélectionnez n’importe quel type d’élément de travail pour afficher les modèles correspondants ou en ajouter.

Gestion des modèles d’un type d’élément de travail

Sélectionnez Paramètres de projet>Configuration d’équipe>Modèles. un type d’élément de travail pour afficher ses modèles définis.

Par exemple, choisissez Récit utilisateur afin d’afficher les modèles définis pour capturer les récits utilisateur.

Création d’un modèle d’élément de travail

1. Dans la page de type d’élément de travail, sélectionnez Nouveau modèle pour créer un modèle à partir de zéro.

   

2. Donnez un nom au modèle et, éventuellement, ajoutez ou supprimez des champs. Enregistrez le modèle lorsque vous avez terminé.

3. Pour obtenir l’URL du modèle, choisissez Copier le lien. Vous pouvez utiliser cette URL pour créer des éléments de travail basés sur le modèle.

Modifier, supprimer, copier un lien ou créer une copie

Sur la page du type d’élément de travail, sélectionnez l’icône d’actions d’un modèle existant pour accéder aux options de menu Modifier, Supprimer, Copier le lien ou Créer une copie.

• Modifier : sélectionnez Modifier et Enregistrer pour enregistrer vos modifications.
• Supprimer : sélectionnez Supprimer, puis Supprimer à nouveau dans la boîte de dialogue de confirmation de suppression du modèle. Une fois que vous avez supprimé un modèle, vous ne pouvez pas le récupérer.
• Copier le lien : sélectionnez Copier le lien. Utilisez l’URL chaque fois que vous souhaitez ajouter un élément de travail du type que vous avez spécifié avec ses valeurs prédéfinies. Vous pouvez enregistrer l’URL sous forme de fichier texte, l’ajouter à une page web en tant que lien hypertexte, le copier vers un réseau partagé ou l’envoyer à votre équipe par e-mail. Vous pouvez également ajouter un lien au tableau de bord de l’équipe.
• Créer une copie : sélectionnez Créer une copie. Nommez le modèle, ajoutez et supprimez éventuellement des champs, puis Enregistrez lorsque vous avez terminé.

Visual Studio 2015

Vous pouvez utiliser Visual Studio avec Power Tools pour gérer vos propres modèles d’élément de travail. Pour chaque type d’élément de travail, vous pouvez voir vos modèles définis et effectuer différentes actions sur ceux-ci. Vous pouvez ajouter, modifier, supprimer, copier et copier des modèles. Vous pouvez partager vos modèles avec d’autres utilisateurs en leur envoyant l’URL du modèle ou en enregistrant le modèle en tant que fichier .wt.

• Gérez les modèles dans le volet Team Explorer.

  

  Le nœud Modèles racine représente le parent de tous vos modèles. Vous pouvez créer une structure de répertoires au-dessous en ajoutant des dossiers. Cliquez avec le bouton droit sur le nœud Modèles ou un dossier, puis sélectionnez Nouveau dossier dans le menu contextuel.

• Coupez, copiez, collez, renommez et supprimez des modèles et dossiers à l’aide du menu contextuel. Vous pouvez également glisser-déplacer des modèles dans des dossiers. Si vous souhaitez modifier plusieurs modèles, utilisez Maj-clic pour sélectionner une plage ou Ctrl-clic pour ajouter des modèles individuellement à votre sélection, puis cliquez avec le bouton droit.

Définir un modèle

1. Dans la section Modèles, cliquez avec le bouton droit sur Modèles et choisissez de créer un modèle à partir de zéro.

   

2. Fournissez un nom dans la boîte de dialogue et Enregistrez votre modèle.

   

3. Sélectionnez Copier le lien pour capturer l’URL du modèle que vous pourrez utiliser pour ajouter des éléments de travail à l’aide du modèle.

Modification, utilisation, copie et suppression d’un modèle

• Pour modifier un modèle, le supprimer ou effectuer une autre action dessus, ouvrez son menu contextuel (clic droit) et choisissez l’option souhaitée.

  

• Afin de rendre plus accessibles les modèles fréquemment utilisés, vous pouvez définir un modèle par défaut pour chaque type d’élément de travail. Pour ce faire, cliquez avec le bouton droit sur un modèle dans Team Explorer et sélectionnez Définir par défaut. Une coche s’affiche sur l’icône pour indiquer qu’il s’agit désormais du modèle par défaut.

Définition du répertoire de modèles

• Pour modifier le répertoire dans lequel les modèles sont stockés, sélectionnez le lien Configurer ou accédez-y dans Outils>Options>Microsoft Team Foundation Server>Modèles d’élément de travail. Utilisez cette boîte de dialogue pour définir le chemin de votre magasin de modèles. Placez vos modèles dans un emplacement réseau pour les partager avec votre équipe.

Ajout d’un élément de travail à l’aide d’un modèle

La méthode principale pour ajouter un élément de travail à l’aide d’un modèle consiste à ouvrir le lien du modèle dans une fenêtre de navigateur. Pour obtenir le lien du modèle, consultez la section Modifier, supprimer, copier un lien, créer une copie.

Application d’un modèle à un ou plusieurs éléments de travail actuels ou nouveaux

Vous pouvez appliquer un modèle à un seul élément de travail ou effectuer une mise à jour en bloc de plusieurs éléments de travail.

Portail Web

Application d’un modèle dans un élément de travail

1. Ouvrez un nouvel élément de travail ou un élément de travail existant que vous souhaitez mettre à jour à l’aide des champs définis dans un modèle. Sélectionnez l’icône d’actions pour ouvrir le menu, choisissez Modèles, puis sélectionnez le nom d’un modèle prédéfini.

   

   Seuls les modèles définis pour les équipes dont vous faites partie apparaissent.

   Conseil

   Actualisez votre navigateur pour découvrir les derniers modèles ajoutés. Si vous ne voyez aucun modèle, il se peut qu’il n’y ait aucun type d’élément de travail.

2. Enregistrez l’élément de travail pour appliquer les modifications. Les champs modifiés sont notés dans le champ Historique.

Application d’un modèle à plusieurs éléments de travail

1. Pour mettre à jour plusieurs éléments de travail en bloc, commencez par les sélectionner dans le backlog ou dans la liste des résultats d’une requête, puis ouvrez le menu Actions de l’un d’eux. Tous les éléments de travail sélectionnés doivent être du même type (par exemple soit des récits utilisateur, soit des bogues).

2. Choisissez le modèle à appliquer.

   

3. Les modifications des champs sont automatiquement appliquées, et les éléments de travail enregistrés. Pour plus d’informations sur les mises à jour en bloc, consultez Modification en bloc des éléments de travail.

Visual Studio 2015

1. Ouvrez ou exécutez une requête qui recense le ou les éléments de travail dont vous souhaitez capturer les champs.

2. Cliquez avec le bouton droit sur les éléments de travail (qui doivent être du même type) et choisissez Appliquer le modèle dans le menu contextuel.

   

3. Sélectionnez le modèle à utiliser, puis OK.

   

4. Enregistrez l’élément de travail.

Ajout et suppression d’étiquettes dans les modèles

Vous pouvez ajouter des étiquettes à un modèle. Elles seront appliquées à l’élément de travail lorsque vous utiliserez le modèle. Pour ajouter plusieurs étiquettes, séparez-les par une virgule (,).

Si vous ne spécifiez aucune étiquette à supprimer, toutes les étiquettes présentes dans un élément de travail resteront définies. Ceci est vrai même lorsque vous appliquerez un modèle d’élément de travail à un élément de travail existant.

Définition d’un modèle d’élément de travail non planifié à l’aide d’un lien hypertexte

Vous pouvez spécifier un modèle d’élément de travail comportant plusieurs valeurs de champ selon la syntaxe suivante. Utilisez l’URL chaque fois que vous souhaitez ajouter un élément de travail du type que vous avez spécifié avec ses valeurs prédéfinies.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Par exemple, la syntaxe suivante spécifie une tâche d’élément de travail dont le titre est TaskTitle. Elle donne une valeur aux champs AssignedTo, Description, Tags, Activity et IterationPath.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Conseil

Une limite de 2000 caractères est imposée par certains clients de navigateur.

Vous pouvez enregistrer l’URL en tant que fichier texte ou l’ajouter à un tableau de bord ou à une page web en tant que lien hypertexte.

Ajout d’un lien de modèle à un tableau de bord d’équipe

Vous pouvez ajouter des liens vers un widget Markdown qui s’affiche dans le tableau de bord de votre équipe sur le portail web. Ces liens ouvrent un élément de travail dont les champs définis par le modèle sont préremplis.

Par exemple, le widget suivant contient des liens vers trois modèles.

Pour plus d’informations sur le widget Markdown, consultez Ajout de Markdown à un tableau de bord et widgets Markdown.

Articles connexes

• FAQ Azure Boards
• Exemples de modèles d’élément de travail