Hinzufügen von Markdown zu einer Dashboard
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Das Markdown-Widget ist ein vielseitiges Tool, mit dem Sie Ihr Team und Ihre Projektbeteiligten unterstützen können, indem Sie ihrem Dashboard wertvolle Informationen direkt hinzufügen. Sie können es verwenden, um die folgenden Elemente anzuzeigen:
- Teamziele
- Links zu Team-Backlogs oder Boards
- Links zu Metriken
- Links zu anderen Elementen, die sich in einer Netzwerkfreigabe befinden, wie z. B. eine OneNote- oder SharePoint-Website oder Wiki-Seiten
- Wichtige Termine oder Zieltermine
Mithilfe des Markdown-Widgets können Sie sicherstellen, dass wichtige Informationen für Ihr Team und Ihre Projektbeteiligten leicht zugänglich und sichtbar sind.
Das folgende Beispiel zeigt Teaminformationen und Links: 
Voraussetzungen
- Zugriff:
- Jeder mit Projektzugriff, einschließlich Stakeholder, kann Dashboards einsehen.
- Mindestens Basiszugriff oder spezielle Dashboard-Berechtigungen.
- Berechtigungen:
- Teamdashboards: Um ein Teamdashboard hinzuzufügen, zu bearbeiten oder zu verwalten, erfüllen Sie die folgenden Anforderungen:
- Mitglied des Teams sein.
- Mitgliedschaft in der Gruppe Projektadministratoren.
- Teamdashboards: Um ein Teamdashboard hinzuzufügen, zu bearbeiten oder zu verwalten, erfüllen Sie die folgenden Anforderungen:
- Zugriff:
- Jeder mit Projektzugriff, einschließlich Stakeholder, kann Dashboards einsehen.
- Mindestens Basiszugriff oder spezifische Dashboard-Berechtigungen.md), die Ihnen gewährt werden, oder Sie sind Mitglied der Gruppe Projektadministratoren.
- Tools: Haben Sie Analytics für Analytics-Widgets aktiviert, um mit Ihrem Dashboard zu arbeiten.
- Zugriff:
- Jeder, der Zugriff auf ein Projekt hat, einschließlich Stakeholdern, kann Dashboards anzeigen.
- Als Mitglied des Projekts und über grundlegenden Zugriff verfügen Sie über bestimmte Dashboardberechtigungen für das ausgewählte Dashboard, als Mitglied der Gruppe "Projektadministratoren" oder als Mitglied der Teamadministratorrolle.
- Tools:
- Installieren oder aktivieren Sie die Analytics Marketplace-Erweiterung. Analytics-Widgets sind nicht verfügbar, wenn Analytics nicht installiert, aktiviert oder ausgeführt wird.
- Lassen Sie Analytics für Analytics-Widgets aktiviert, um mit Ihrem Dashboard zu arbeiten.
Hinweis
Daten, die in einem Diagramm oder Widget angezeigt werden, unterliegen den Berechtigungen, die dem angemeldeten Benutzer gewährt werden. Wenn ein Benutzer beispielsweise nicht berechtigt ist, Arbeitsaufgaben unter einem bestimmten Bereichspfad anzuzeigen, werden diese Elemente nicht in einem Abfrageergebnis-Widget im Dashboard angezeigt. Weitere Informationen finden Sie in den häufig gestellten Fragen zur Verwendung von Dashboards.
Unterstützte Markdown-Syntax
Das Markdown-Widget unterstützt CommonMark-Standardfeatures, z. B.:
- Überschriften
- Absätze und Zeilenumbrüche
- Blockquotes
- Horizontale Regel
- Hervorhebung (fett, kursiv, durchgestrichen)
- Tabellen
- Listen, sowohl sortiert als auch ungeordnet
- Verknüpfungen
- Bilder
- Escapezeichen
Weitere Informationen finden Sie unter Syntax-Anleitung für die grundlegende Verwendung von Markdown.
Aus Leistungsgründen bietet das Markdown-Widget keine Unterstützung für viele erweiterte Features, von denen viele im Wiki unterstützt werden. Erweiterte Funktionen würden die Ladezeit des Widgets beeinträchtigen. Beispielsweise werden die folgenden erweiterten Markdown-Features im Markdown-Widget nicht unterstützt:
- Eingebettete HTML-Syntax
- Codemarkierung (Wiki/andere unterstützen sprachsyntaxfähige Farbcodierung, CommonMark rendert Code einfach als vorformatierten Text)
- Checklists
- Emoji-Zeichen
- Anlagen
- Mathematische Formeln
Hinzufügen des Markdown-Widgets
Führen Sie die folgenden Schritte aus, um das Markdown-Widget hinzuzufügen. Informationen zum Hinzufügen eines Dashboards finden Sie unter Hinzufügen, Umbenennen und Löschen von Dashboards.
Melden Sie sich bei Ihrem Projekt an (
https://dev.azure.com/{Your_Organization/Your_Project}).Wählen Sie Dashboards aus.
Wählen Sie
Bearbeiten. Der Widgetkatalog wird automatisch geöffnet.Fügen Sie das Markdown-Widget auf das Dashboard hinzu oder ziehen Sie es an die gewünschte Position.
Wählen Sie "Bearbeitung fertig" aus, um die Dashboardbearbeitung zu beenden. Mit dieser Aktion schließen Sie den Element-Katalog. Anschließend können Sie das Markdown-Widget nach Bedarf konfigurieren.
Wählen Sie
weitere Aktionen >
Konfigurieren.
(Optional) Passen Sie die Widgetgröße nach Bedarf an den Inhalt des Markdowns an. Die größte Größe beträgt 10 Kacheln breit und 10 Kacheln hoch. Sie können die Größe später jederzeit anpassen.
Geben Sie Text und Markdown-Syntax in das Konfigurationsdialogfeld ein. Unterstützte Syntax finden Sie unter Syntaxleitfaden für Markdown-Dateien, Widgets, Wikis und Pullanforderungskommentare.
Hinweis
- Links zu Dokumenten in Dateifreigaben, die
file://verwenden, werden nicht unterstützt. Diese Einschränkung wird für Sicherheitszwecke implementiert. - Verwenden Sie die folgende Syntax, um eine Verknüpfung mit einer Wiki-Seite zu erstellen:
/ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName - Um einen Link zu einer Repository-Datei, einer Seite oder einem Image innerhalb des Projekts zu erstellen, wählen Sie Markdown-Datei auswählen, wählen Sie Ihr Repository, Branch und Pfad aus den Dropdown-Menüs.
- Links zu Dokumenten in Dateifreigaben, die
Speichern Sie Ihre Änderungen.