Ajouter Markdown à un tableau de bord

  • Article

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

Utilisez le widget Markdown pour prendre en charge votre équipe et vos parties prenantes en ajoutant des informations telles que :

  • Objectifs de l’équipe.
  • Liens vers :
    • Backlogs ou tableaux d’équipe.
    • Métriques.
    • Autres éléments situés dans un partage réseau tel qu’un site OneNote, un site SharePoint ou des pages wiki.
  • Dates importantes ou échéances cibles.

Voici un exemple :
Capture d’écran d’un 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 ayant accès à un projet, y compris les parties prenantes, peut afficher les tableaux de bord.
    • Soyez membre du projet et disposez au moins d’un accès de base, disposez d’autorisations de tableau de bord spécifiques accordées à vous ou êtes membre du groupe 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
  • Caractères d’échappement

Pour plus d’informations sur l’utilisation, consultez conseils sur la syntaxe pour l’utilisation de base de Markdown.

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

Connectez-vous à un projet

Pour ajouter le widget Markdown à un tableau de bord, vous vous connectez à votre projet à l’aide d’un navigateur web pris en charge.

Ouvrez un navigateur web, connectez-vous à votre projet, puis sélectionnez Tableaux de bord de vue d’ensemble>.

Capture d’écran du portail web, ouvrez Tableaux de bord.

Si vous devez basculer vers un autre projet, sélectionnez le logo Azure DevOps pour parcourir tous les projets.

Ajouter le widget Markdown

Si vous avez besoin d’ajouter un tableau de bord, consultez Ajouter, renommer et supprimer des tableaux de bord.

Pour ajouter le widget Markdown au tableau de bord, sélectionnez Modifier. Le catalogue de widgets s’ouvre automatiquement.

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

    Capture d’écran du widget Markdown.

  2. Sélectionnez Modification terminée pour quitter la modification du tableau de bord. Cela va ignorer le catalogue de widgets. Vous pouvez ensuite configurer le widget Markdown en fonction des besoins.

  3. Sélectionnez l’icône l’icône d’engrenage d’engrenage pour ouvrir la boîte de dialogue de configuration du widget.

    Pour modifier un widget Markdown, vous devrez peut-être être administrateur d’équipe, membre du groupe Administrateurs de projet ou accorder des autorisations. Pour plus d’informations, consultez Définir des autorisations de tableau de bord.

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

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

  5. Entrez le texte et la syntaxe Markdown dans la configuration de 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).

    Ici, nous affichons un texte simple avec une liste à puces de quatre liens

    Capture d’écran de La configuration de Markdown, entrée de texte.

    Conseil

    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, cliquez sur le fichier et utilisez l’URL complète.

    Cela affiche le widget suivant :

    Capture d’écran du portail web, exemple de widget Markdown.

    Remarque

    Les liens vers des documents sur des partages de fichiers utilisant file:// ne sont pas pris en charge. Cette restriction a été implémentée à des fins de sécurité.

  6. Si vous le souhaitez, vous pouvez choisir de pointer vers un fichier dans votre référentiel.

    Capture d’écran du widget Configurer Markdown avec un fichier de dépôt.