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

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

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

Utilisez des modèles d’élément de travail pour créer des éléments de travail avec des valeurs prédéfinies et appliquer des mises à jour cohérentes entre des éléments similaires. Cet article traite des flux de travail des modèles dans le portail Web et, pour les environnements hérités, dans Visual Studio 2015 ou une version antérieure. Pour obtenir des exemples, consultez Exemples de modèles d’élément de travail.

Pour la plupart des équipes, utilisez le portail web. Utilisez Visual Studio 2015 avec Power Tools uniquement lorsque vous vous appuyez toujours sur la gestion des modèles basés sur Team Explorer.

Les modèles d’élément de travail sont différents des modèles de processus. Pour plus de contexte, consultez À propos des processus et des modèles de processus ainsi que le guide du processus par défaut pour Basic, Agile, Scrum et Capability Maturity Model Integration (CMMI).

Choisir votre flux de travail

Utilisez ce tableau pour choisir le meilleur flux de travail pour votre scénario.

Si vous souhaitez... Utilisez... Pourquoi
Créer, gérer et appliquer des modèles dans les Azure DevOps actuelles Portail web (principal) Prend en charge les modèles propres à l’équipe dans l’interface web standard.
Réutiliser les valeurs par défaut partagées par type d’élément d’équipe et de travail Modèles enregistrés Aide les équipes à appliquer des champs et des valeurs cohérents.
Partager un lien direct qui ouvre un élément de travail prérempli URL de modèle Idéal pour le partage léger dans les tableaux de bord, les wikis et les conversations.
Continuer à utiliser les flux de travail basés sur des modèles dans Team Explorer Visual Studio 2015 avec Power Tools (hérité) Utilisez uniquement lorsque votre environnement dépend toujours des outils hérités.

Prérequis

Workflow Spécifications
Portail web (principal) - Accès à une organisation et à un projet Azure DevOps.
- Pour gérer les modèles, soyez membre de l’équipe propriétaire des modèles.
- Pour appliquer des modèles, disposez d’un accès Contributeur au projet.
- Utilisez un navigateur pris en charge et ouvrez Azure DevOps dans le portail web.
Visual Studio 2015 avec Power Tools (hérité) - Utilisez ce flux de travail uniquement si votre environnement dépend toujours de la gestion des modèles Team Explorer.
- Installez Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- Les modèles créés dans ce flux de travail sont délimités par l’utilisateur et apparaissent uniquement dans Team Explorer.

Restrictions relatives à l’utilisation de modèles

Les modèles de portail web et les modèles Visual Studio sont des magasins distincts. Un modèle créé dans un client n’apparaît pas dans l’autre client.

Type de modèle Scope Où vous pouvez le gérer Où vous pouvez l’appliquer
Modèle de portail web À l’échelle de l’équipe Portail web Portail web
modèle Visual Studio Étendue utilisateur Visual Studio Visual Studio

Vous pouvez toujours utiliser l’URL de l’un ou l’autre type de modèle pour créer des éléments de travail dans le portail web.

Tâches du modèle prises en charge

La disponibilité des tâches dépend du client que vous utilisez. Utilisez le portail web pour les flux de travail de Azure DevOps principaux et utilisez Visual Studio 2015 avec Power Tools uniquement pour les scénarios hérités.

Le tableau suivant montre la prise en charge par le client.

Tâche de modèle Portail web Visual Studio
Capture d’un élément de travail en tant que modèle ✅ Soutenu ✅ Soutenu
Gestion des modèles d’élément de travail
(Définir, modifier, supprimer, copier le lien, créer une copie et renommer)
✅ Soutenu ✅ Soutenu
Copier le lien (URL) d’un modèle ✅ Soutenu ✅ Soutenu
Ajouter un élément de travail à l’aide d’un modèle ✅ Soutenu ✅ Soutenu
Définir un modèle d’élément de travail ✅ Soutenu ✅ Soutenu
Application d’un modèle à un ou plusieurs éléments de travail ✅ Soutenu ✅ Soutenu
Ajout et suppression d’étiquettes dans les modèles ❌ Non pris en charge ✅ Soutenu
Définir un modèle avec un lien hypertexte ✅ Soutenu ❌ Non pris en charge

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

Utilisez la procédure qui correspond à votre client : portail web (principal) ou Visual Studio 2015 et versions antérieures (héritées).

Chaque modèle que vous capturez dans le portail web obtient un GUID unique. Procédez comme suit pour capturer un élément de travail en tant que modèle et copier son lien.

  1. Dans le portail web, ouvrez l’élément de travail que vous souhaitez utiliser comme source de modèle.

  2. À droite, sélectionnez Plus d’actions>Modèles>Capture :

    Capture d’écran montrant comment sélectionner les définitions de champ d’élément de travail de capture en tant qu’option de modèle dans le menu Autres actions.

  3. Dans le modèle de capture, configurez les champs obligatoires et facultatifs :

    • Équipe (obligatoire) : sélectionnez l’équipe à associer au modèle.

    • Nom (obligatoire) : entrez un nom de modèle.

    • Champs : Utilisez Ajouter pour inclure des champs, Supprimer pour supprimer des champs et définir la valeur de champ si nécessaire.

    • Remarques : Ajouter un contexte de modèle. Lorsque vous créez un élément de travail à partir du modèle, ce texte apparaît comme la première entrée dans le thread de discussion .

    Capture d’écran montrant comment configurer des champs dans la boîte de dialogue Capturer un modèle dans le portail web.

  4. Sélectionnez Enregistrer, puis copiez le lien pour copier l’URL du modèle.

    Utilisez l’URL pour créer des éléments de travail du même type avec des valeurs prédéfinies. Pour connaître les scénarios de partage courants, consultez Créer un élément de travail à partir d’une URL de modèle et ajouter un lien de modèle à un tableau de bord d’équipe.

  5. Vérifiez que le modèle apparaît dans la liste de modèles de l’équipe sélectionnée pour ce type d’élément de travail et que le lien copié ouvre un nouveau formulaire d’élément de travail avec des valeurs prédéfinies.

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

Pour chaque type d’élément de travail, vous pouvez afficher et gérer des modèles définis par votre équipe. Vous pouvez ajouter, modifier, copier, supprimer, renommer et copier un lien de modèle.

Procédez comme suit pour ouvrir des modèles d’élément de travail dans le portail web :

  1. Dans le portail web, ouvrez Project paramètres.

  2. Sous Tableaux, sélectionnez Configuration de l’équipe.

  3. Si vous avez besoin d’une autre équipe, utilisez le sélecteur d’équipe dans la piste de navigation.

  4. Dans la page Tableaux , sélectionnez Modèles :

    Screenshot qui montre comment accéder à la liste des modèles enregistrés dans Azure DevOps à partir des paramètres project, boards, configuration d’équipe, templates.

  5. Sélectionnez un type d’élément de travail, tel que Bogue, Fonctionnalité ou Cas de test, pour afficher ou ajouter des modèles pour ce type :

    Capture d’écran des modèles définis pour le type d’élément de travail « bug ».

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

Procédez comme suit pour créer un modèle d’élément de travail dans le portail web :

  1. Dans la page de type d’élément de travail, sélectionnez Nouveau modèle :

    Capture d’écran montrant comment ajouter un nouveau modèle pour le type d’élément de travail Bug.

    Note

    Si vous envisagez d’utiliser Markdown dans un champ de texte volumineux, ajoutez <br> des balises pour gérer les sauts de ligne et assurez-vous que le markdown s’affiche correctement.

  2. Dans la boîte de dialogue Nouveau modèle , entrez un nom (obligatoire), puis ajoutez les champs et valeurs facultatifs.

  3. Cliquez sur Enregistrer. L’option Copier le lien devient disponible.

  4. Sélectionnez Copier le lien pour copier l’URL du modèle.

  5. Vérifiez que le modèle est répertorié pour le type d’élément de travail sélectionné et que le lien copié ouvre un nouveau formulaire d’élément de travail avec des valeurs de modèle.

Après avoir enregistré un modèle, vous pouvez le mettre à jour, le supprimer, copier son lien ou créer une copie.

Dans la page de type d’élément de travail, sélectionnez Autres actions pour un modèle, puis choisissez l’une des options suivantes :

Capture d’écran des options de menu Autres actions pour un modèle sélectionné.

  1. Vérifiez que la liste des modèles reflète votre action (valeurs mises à jour, élément renommé, modèle copié ou modèle supprimé).

  2. Vérifiez que le lien Copier ouvre un nouveau formulaire d’élément de travail avec les valeurs de modèle attendues.

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

Utilisez le lien de modèle dans un navigateur pour créer un élément de travail avec des valeurs prédéfinies.

  1. Obtenir le lien vers le modèle. Pour plus d’informations, consultez Modifier, supprimer, copier un lien, créer une copie.

  2. Collez le lien de modèle dans un navigateur, renseignez les champs requis et enregistrez vos modifications.

  3. Vérifiez que le nouvel élément de travail s’ouvre avec les valeurs définies par le modèle remplies avant d’enregistrer.

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

Appliquez un modèle à un élément de travail nouveau ou existant, ou utilisez un modèle pour les mises à jour en bloc.

Dans le portail web, vous pouvez appliquer un modèle dans un élément de travail ouvert ou entre les éléments de travail sélectionnés.

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

Procédez comme suit pour appliquer un modèle à un élément de travail nouveau ou existant :

  1. Ouvrez un élément de travail nouveau ou existant que vous souhaitez mettre à jour avec des valeurs définies par le modèle.

  2. Sélectionnez Plus d’actions>Modèles, puis sélectionnez le nom d’un modèle prédéfini :

    Capture d’écran montrant comment appliquer un modèle à un élément de travail existant dans le formulaire.

    Note

    La liste modèles affiche les modèles définis pour les équipes dont vous êtes membre. Si la liste est vide, il se peut qu’il n’existe aucun modèle pour le type d’élément de travail. Actualisez votre navigateur pour découvrir les derniers modèles disponibles.

  3. Sélectionnez Enregistrer pour appliquer le modèle. Les modifications de champ sont enregistrées dans le champ Historique des éléments de travail.

  4. Vérifiez que les champs sont mis à jour dans le formulaire et que l’historique des éléments de travail enregistre les modifications enregistrées.

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

Procédez comme suit pour appliquer un modèle à des éléments de travail sélectionnés pour une mise à jour en bloc :

  1. Sélectionnez des éléments de travail dans le backlog ou une liste de résultats de requêtes . Tous les éléments sélectionnés doivent être du même type d’élément de travail, tel que Bogue ou Fonctionnalité.

  2. Sélectionnez Plus d’actions>Modèles pour l’un des éléments de travail sélectionnés, puis sélectionnez le modèle à appliquer.

    Capture d’écran montrant comment appliquer un modèle à plusieurs éléments de travail pour une mise à jour en bloc.

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

  3. Vérifiez que chaque élément de travail sélectionné affiche les valeurs de champ mises à jour et les entrées d’historique correspondantes.

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

Dans Visual Studio version 2015 ou antérieure, vous pouvez ajouter des balises à un modèle. Lorsque vous utilisez le modèle, les balises s’appliquent automatiquement à l’élément de travail. Pour ajouter deux balises ou plus, séparez-les par une virgule (,). Vous ne pouvez pas ajouter de balises dans le portail web.

Capture d’écran de la boîte de dialogue Modifier le modèle montrant comment ajouter ou supprimer des balises.

Si vous ne spécifiez pas de balises à supprimer, toutes les balises d’un élément de travail restent définies. Les balises restent définies même lorsque vous appliquez un modèle d’élément de travail à un élément de travail existant.

Vérifiez dans Visual Studio que le modèle conserve les balises configurées et les éléments de travail appliqués incluent ces balises après l’enregistrement.

Créer un élément de travail à partir d’une URL de modèle

Créez une URL qui ouvre un nouvel élément de travail avec des valeurs de champ prédéfinies. Utilisez cette approche lorsque vous souhaitez un raccourci partageable vers une configuration d’élément de travail commune.

Utilisez des modèles enregistrés pour les valeurs par défaut réutilisables gérées par l’équipe. Utilisez des URL de modèle lorsque le partage de liens directs est l’expérience principale.

  • Utilisez des modèles enregistrés lorsque votre équipe a besoin de valeurs par défaut gérées de manière centralisée.
  • Utilisez des URL de modèle lorsque vous avez besoin d’un partage léger dans des tableaux de bord, des wikis ou des messages.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

L’exemple suivant crée un élément de travail de tâche avec un titre prédéfini, affecté à, description, balises, activité et chemin d’itération.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_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
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[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

Note

Certains clients de navigateur imposent une limite de 2 000 caractères pour les valeurs de champ.

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

Vérifiez que l’ouverture de l’URL charge le type d’élément de travail correct et affiche les valeurs de champ prédéfinies dans le nouveau formulaire d’élément de travail.

Ajoutez des liens de modèle à un widget Markdown sur le tableau de bord de votre équipe dans le portail web. Chaque lien ouvre un nouvel élément de travail avec des valeurs de modèle prédéfinies.

L’exemple suivant montre un widget Markdown avec des liens vers trois modèles :

Capture d’écran d’un widget Markdown avec des liens vers des modèles.

Pour connaître les étapes de configuration, consultez Ajouter Markdown à un tableau de bord, widgets Markdown.

Résoudre les problèmes de modèle

  • Le menu Modèles n’apparaît pas : vérifiez que vous avez accès au projet et que vous utilisez le flux de travail pris en charge par votre client.
  • La liste des modèles est vide dans le portail web : vérifiez que les modèles existent pour le type d’élément de travail sélectionné et que vous êtes membre de l’équipe propriétaire des modèles. Actualisez le navigateur pour charger les derniers modèles.
  • Impossible de gérer un modèle d’équipe : vérifiez que vous êtes membre de l’équipe propriétaire du modèle.
  • Impossible d’appliquer un modèle à plusieurs éléments de travail : vérifiez que tous les éléments de travail sélectionnés sont le même type d’élément de travail.
  • Les options de modèle de Visual Studio ne sont pas disponibles : vérifiez que vous utilisez le processus hérité de Visual Studio 2015 et que Microsoft Visual Studio Team Foundation Server 2015 Power Tools est installé.
  • L’URL du modèle s’ouvre sans valeurs attendues : vérifiez que chaque nom de référence de champ est valide pour le type d’élément de travail cible et que les valeurs sont encodées par URL (par exemple, les espaces sous + ou %20).
  • L’URL du modèle ne parvient pas à se charger : vérifiez que l’URL utilise le type d’élément d’organisation, de projet et de travail approprié, et que vous êtes connecté à un compte avec accès au projet.
  • Certains champs d’un modèle ne sont pas renseignés : vérifiez que les champs existent toujours sur le type d’élément de travail et ne sont pas limités par les règles de personnalisation du processus.

Utiliser l’IA pour créer et appliquer des modèles d’élément de travail

Si vous configurez le serveur MCP Azure DevOps, vous pouvez décrire les tâches liées au modèle en langage naturel au lieu d’effectuer manuellement chaque étape dans le portail web ou Team Explorer.

Traitez les instructions suivantes comme des exemples de scénarios. Les opérations disponibles peuvent varier en fonction de la version du serveur MCP, des outils activés et de vos autorisations.

Avant d’exécuter un prompt, remplacez les espaces réservés par des valeurs issues de votre environnement : <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId> et <IterationPath>.

Tâche Exemple d’invite
Créer un modèle à partir d’un élément Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Créer un modèle Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Appliquer un modèle à un élément Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Appliquer en bloc un modèle Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Créer des éléments de travail à partir d’un modèle Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Générer une URL de modèle Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Mettre à jour un modèle Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Copier un modèle Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Rechercher les équipes manquantes dans un modèle List teams in project <ProjectName> that don't have a Bug template defined
Auditer l’utilisation du modèle Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Note

Si vous utilisez Visual Studio Code, le mode agent est particulièrement utile pour les opérations de modèle complexes.