Hinzufügen von Status-Badges für Ihr GitHub Repo

Artikel
01/15/2024

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

Sie können eine Markdownsyntax zu einer README.md-Datei eines GitHub-Repositorys hinzufügen, um die Status Ihres Kanban-Boards in diesem Repository anzuzeigen. Der Status wird angezeigt, indem Sie die Syntax hinzufügen, die Sie aus ihren Kanban-Boardeinstellungen auswählen.

Hinweis

Erfordert Azure DevOps Server 2019, Update 1 oder höher.

Die angezeigte Syntax funktioniert unabhängig davon, ob Sie Ihr Projekt mit einem GitHub.com- oder Ihrem GitHub Enterprise Server-Repository verbunden haben. Was GitHub Enterprise Server betrifft, muss ihr Server über das Netzwerk Azure DevOps Services zugänglich sein.

Voraussetzungen

Ihr Azure Boards-Projekt muss mit dem GitHub-Repository verbunden sein, in dem die Commits und Pull Requests vorhanden sind, mit denen Sie eine Verknüpfung herstellen möchten. Weitere Informationen finden Sie unter Integration von Azure Boards mit GitHub.
Sie müssen über ein Kanban-Board verfügen, das Sie konfigurieren möchten. Wenn Sie ein Team hinzufügen, fügen Sie ein Kanban-Board für dieses Team hinzu. Weitere Informationen finden Sie unter Informationen zu Teams und Agile-Tools.
Sie müssen der Teamadministratorrolle für die Einstellungen des Teams, die Sie ändern möchten, hinzugefügt werden oder Mitglied der Sicherheitsgruppe Projektadministratoren sein. Informationen zum Hinzufügen finden Sie unter Hinzufügen eines Teamadministrators oder Ändern von Berechtigungen auf Projektebene.
Um den Statusbadge zum GitHub.com-Repository hinzuzufügen, müssen Sie ein Mitwirkender des Repositorys sein.

Hinzufügen eines Statusbadges

Melden Sie sich bei Azure Boards an, und öffnen Sie Ihr Kanban-Board.
Wählen Sie das Zahnradsymbol aus, um das Board zu konfigurieren und allgemeine Teameinstellungen festzulegen.
Wählen Sie Statusbadge aus, und aktivieren oder deaktivieren Sie dann das Kontrollkästchen Anonymen Benutzern den Zugriff auf den Statusbadge gewähren. Wenn diese Option nicht aktiviert ist, wird Benutzern, die nicht angemeldet sind, der Statusbadge weiterhin angezeigt.
Wählen Sie den gewünschten Badgetyp und dann das Kopiersymbol aus, um die Markdownsyntax für den Badge zu kopieren.
- Nur Spalten "In Bearbeitung" anzeigen ignoriert die erste und die letzte Spalte.
- Alle Spalten einschließen schließt die erste und die letzte Spalte des Boards ein.
- Sie können den Satz von Spalten anpassen, indem Sie 2 für columnOptions und dann eine durch Trennzeichen getrennte Liste der anzuzeigenden Boardspalten angeben. Beispiel: ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, wie in der folgenden Syntax dargestellt. Für Spaltenbezeichnungen, die Leerzeichen enthalten, müssen Sie den Leerraum mit %20codieren. Beispielsweise In%20Progress.
```
 [![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/)
```
Ein Badge ähnlich des folgenden wird angezeigt:
Klicken Sie auf Speichern, wenn Sie fertig sind.

Die einzige Einstellung, die Sie konfigurieren können, ist di Option Anonymen Benutzern den Zugriff auf den Statusbadge gestatten. Der Badgetyp unter Einstellungen wechselt nur die Markdownsyntax, damit Sie aus den Werten Beispielmarkdown und Bild-URL kopieren können.
Öffnen Sie die README-Datei in Ihrem GitHub-Repository, und fügen Sie die kopierte Syntax ein, damit der Badge angezeigt wird.

Sie sollten dasselbe Vorschaubild sehen, das Sie mit Werten ausgewählt haben, die Ihrem Kanban-Board entsprechen.