Partager via

Ajouter Markdown à un tableau de bord

  • Article

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

Le widget Markdown est un outil polyvalent qui vous permet de prendre en charge votre équipe et vos parties prenantes en ajoutant des informations précieuses directement à votre tableau de bord. Vous pouvez l’utiliser pour afficher les éléments suivants :

  • Objectifs de l’équipe
  • Liens vers les backlogs d’équipe ou les tableaux
  • Liens vers des métriques
  • Liens vers d’autres éléments situés dans un partage réseau, tels qu’un site OneNote, un site SharePoint ou des pages wiki
  • Dates importantes ou échéances cibles

En utilisant le widget Markdown, vous pouvez vous assurer que les informations essentielles sont facilement accessibles et visibles par votre équipe et vos parties prenantes. L’exemple suivant montre des informations et des liens d’équipe : Capture d’écran de l’exemple de widget Markdown.

Prérequis

  • Accès :
  • Autorisations :
    • Tableaux de bord d’équipe : Pour ajouter, modifier ou gérer un tableau de bord d’équipe, répondez aux exigences suivantes :
      • Soyez membre de l’équipe.
      • Être membre du groupe Administrateurs du projet.
  • Accès :
    • Toute personne disposant d’un accès au projet , y compris parties prenantes, peut afficher les tableaux de bord.
    • Au moins un accès Basic ou des dashboard permissions.md) vous ont été accordés, ou être membre du groupe des administrateurs de projet.
  • Outils : Activez Analytics pour que les widgets Analytics fonctionnent avec votre tableau de bord.

Remarque

Les données affichées dans un graphique ou un widget sont soumises aux autorisations accordées à l’utilisateur connecté. Par exemple, si un utilisateur n’a pas les autorisations nécessaires pour afficher les éléments de travail sous un chemin d’accès à une zone spécifique, ces éléments ne s’affichent pas dans un widget de résultats de requête sur le tableau de bord. Pour plus d’informations, consultez faq sur l’utilisation des tableaux de bord.

Syntaxe Markdown prise en charge

Le widget Markdown prend en charge les fonctionnalités standard CommonMark, telles que :

  • En-têtes
  • Paragraphes et sauts de ligne
  • Éléments blockquote
  • Ligne horizontale
  • Accentuation (gras, italique, barré)
  • Tables
  • Listes, ordonnées et non triées
  • Liens
  • Images
  • Échappement de caractères

Pour plus d’informations, veuillez consulter la section Guide de syntaxe pour l’utilisation de Markdown de base.

Pour des raisons de performances, le widget Markdown n’ajoute pas la prise en charge de nombreuses fonctionnalités étendues, dont beaucoup sont prises en charge dans le wiki. Les fonctionnalités étendues entravent le temps de chargement des widgets. Par exemple, les fonctionnalités Markdown étendues suivantes ne sont pas prises en charge dans le widget Markdown :

  • Syntaxe HTML incorporée
  • Mise en surbrillance du code (wiki/autres prennent en charge le codage de couleurs prenant en charge la syntaxe du langage, CommonMark affiche simplement le code en tant que texte préformaté brut)
  • Listes de contrôle
  • Caractères emoji
  • Documents joints
  • Formules mathématiques

Ajouter le widget Markdown

Procédez comme suit pour ajouter le widget Markdown. Pour ajouter un tableau de bord, consultez Ajouter, renommer et supprimer des tableaux de bord.

  1. Connectez-vous à votre projet (https://dev.azure.com/{Your_Organization/Your_Project}).

  2. Sélectionnez Tableaux de bord.

  3. Sélectionnez Modifier. Le catalogue de widgets s’ouvre automatiquement.

  4. Ajoutez ou faites glisser le widget Markdown sur le tableau de bord où vous le souhaitez.

    Capture d’écran montrant le widget Markdown.

  5. Sélectionnez Modification terminée pour quitter la modification du tableau de bord. Cette action ignore le catalogue de widgets. Vous pouvez ensuite configurer le widget Markdown en fonction des besoins.

  6. Sélectionnez plus d’actions >icône d’engrenageConfigurer.

    Capture d’écran montrant trois points pour plus d’actions et le bouton Configurer mis en surbrillance.

  7. (Facultatif) Ajustez la taille du widget selon les besoins pour qu’il corresponde au contenu de Markdown. La plus grande taille est de 10 mosaïques larges par 10 mosaïques de hauteur. Vous pouvez toujours ajuster la taille ultérieurement.

  8. Entrez le texte et la syntaxe Markdown dans la boîte de dialogue de configuration. Pour obtenir une syntaxe prise en charge, consultez les instructions de syntaxe pour les fichiers Markdown, les widgets, les wikis et les commentaires de demande de tirage( pull request).

    Capture d’écran montrant la boîte de dialogue de configuration du widget Markdown.

    Remarque

    • Les liens vers des documents sur des partages de fichiers utilisant file:// ne sont pas pris en charge. Cette restriction est implémentée à des fins de sécurité.
    • Pour créer un lien vers une page wiki, utilisez la syntaxe suivante :
      /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName
    • Pour créer un lien vers un fichier de référentiel, une page ou une image dans le projet, choisissez Sélectionner un fichier markdown, choisissez votreréférentiel , Branchet Chemin d’accès dans les menus déroulants.

  9. Enregistrer vos modifications.