Partager via


Ajouter des badges d’état pour votre dépôt GitHub

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

Ajoutez la syntaxe Markdown à un fichier du dépôt GitHub README.md pour afficher le statut de votre tableau sous forme de badge. Copiez la syntaxe à partir de vos paramètres de carte et collez-la dans le fichier README.

Cette syntaxe fonctionne à la fois pour les connexions GitHub.com et GitHub Enterprise Server. Pour GitHub Enterprise Server, votre serveur doit être accessible au réseau pour Azure DevOps Services.

Prerequisites

Category Requirements
Permissions Administrateur d’équipe pour l’équipe du conseil ou membre du groupe Administrateurs de projet .
Intégration de GitHub Projet connecté au dépôt GitHub dans lequel vous souhaitez afficher le badge.
Tableau Un tableau existant pour l’équipe. Chaque équipe obtient automatiquement un tableau. Pour plus d’informations, consultez À propos des équipes et des outils Agile.
Accès au référentiel Accès contributeur au référentiel GitHub où vous ajoutez le badge.

Ajouter un badge d’état

  1. Connectez-vous à Azure Boards et ouvrez votre tableau.

  2. Sélectionnez l’icône d’engrenage pour ouvrir les paramètres de carte.

    Capture d’écran des paramètres du tableau d’ouverture.

  3. Sélectionnez Badge d’état, puis sélectionnez ou désactivez Autoriser les utilisateurs anonymes à accéder au badge d’état. Lorsque cette option est désactivée, les utilisateurs qui ne sont pas connectés peuvent toujours afficher le badge.

    Capture d’écran de la boîte de dialogue Paramètres du tableau, onglet Badge de statut.

  4. Sélectionnez un type de badge, puis sélectionnez Copier pour copier la syntaxe Markdown.

    • Afficher uniquement les colonnes « En cours » : exclut les premières et les dernières colonnes.

    • Inclure toutes les colonnes : affiche toutes les colonnes, y compris la première et la dernière.

    • Colonnes personnalisées : définissez columnOptions=2 et ajoutez une liste délimitée par des virgules de colonnes. Encoder des espaces comme %20 (par exemple, In%20Progress).

      Exemple de syntaxe :

     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)
    

    Le badge rendu ressemble à l’image suivante.

    Capture d’écran montrant le badge affiché.

  5. Cliquez sur Enregistrer.

    L’option Autoriser les utilisateurs anonymes à accéder à l’option de badge d’état est le seul paramètre configurable. La sélection du type de badge modifie uniquement la syntaxe Markdown disponible pour la copie.

  6. Ouvrez le README.md fichier dans votre dépôt GitHub et collez la syntaxe copiée.

    Le badge s’affiche avec des valeurs qui correspondent à votre tableau.