Share via


Markdown toevoegen aan een dashboard

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

Gebruik de Markdown-widget om uw team en belanghebbenden te ondersteunen door informatie toe te voegen, zoals:

  • Teamdoelen.
  • Koppelingen naar:
    • Teamachterstanden of borden.
    • Statistieken.
    • Andere items die zich in een netwerkshare bevinden, zoals een OneNote-, SharePoint-site of wikipagina's.
  • Belangrijke datums of doeldeadlines.

Hier volgt een voorbeeld:
Schermopname van een Markdown-voorbeeldwidget.

Vereisten

  • Toegang:
  • Machtigingen:
    • Teamdashboards: Als u een teamdashboard wilt toevoegen, bewerken of beheren, voldoet u aan de volgende vereisten:
      • Wees lid van het team.
      • Lid zijn van de groep Projectbeheerders.

Notitie

Gegevens die in een grafiek of widget worden weergegeven, zijn onderworpen aan de machtigingen die zijn verleend aan de aangemelde gebruiker. Als een gebruiker bijvoorbeeld geen machtigingen heeft om werkitems onder een specifiek gebiedspad weer te geven, worden deze items niet weergegeven in een widget voor queryresultaten op het dashboard. Zie Veelgestelde vragen over het gebruik van dashboards voor meer informatie.

Ondersteunde Markdown-syntaxis

De Markdown-widget ondersteunt standaardfuncties van CommonMark, zoals:

  • Koppen
  • Alinea's en regeleinden
  • Blokcitaten
  • Horizontale lijn
  • Nadruk (vet, cursief, doorhalen)
  • Tabellen
  • Lijsten, zowel geordende als ongeordend
  • Koppelingen
  • Afbeeldingen
  • Escape-tekens

Zie syntaxisrichtlijnen voor het basisgebruik van Markdown voor meer informatie over gebruik.

Om prestatieredenen voegt de Markdown-widget geen ondersteuning toe voor veel uitgebreide functies, waarvan veel worden ondersteund in de wiki. Uitgebreide mogelijkheden zouden de laadtijd van widget belemmeren. De volgende uitgebreide Markdown-functies worden bijvoorbeeld niet ondersteund in de Markdown-widget:

  • Ingesloten HTML-syntaxis
  • Codemarkering (wiki/anderen ondersteunen taalsyntaxisbewuste kleurcodering, CommonMark geeft alleen code weer als vooraf opgemaakte tekst)
  • Controlelijsten
  • Emojitekens
  • Bijlagen
  • Wiskundige formules

Verbinding maken met uw project

Als u de Markdown-widget wilt toevoegen aan een dashboard, maakt u verbinding met uw project met behulp van een ondersteunde webbrowser.

Open een webbrowser, maak verbinding met uw project en selecteer Overzichtsdashboards>.

Schermopname van webportal, dashboards openen.

Als u wilt overschakelen naar een ander project, selecteert u het Azure DevOps-logo om door alle projecten te bladeren.

De Markdown-widget toevoegen

Als u een dashboard wilt toevoegen, raadpleegt u Dashboards toevoegen, wijzigen en verwijderen.

Als u de Markdown-widget aan het dashboard wilt toevoegen, selecteert u Bewerken. De widgetcatalogus wordt automatisch geopend.

  1. Voeg de Markdown-widget toe of sleep deze naar het dashboard waar u deze wilt plaatsen.

    Schermopname van markdownwidget.
  2. Selecteer Gereed bewerken om dashboardbewerking af te sluiten. Hiermee wordt de widgetcatalogus gesloten. Vervolgens kunt u de Markdown-widget zo nodig configureren.

  3. Selecteer het tandwielpictogram tandwielpictogram om het configuratiedialoogvenster voor de widget te openen.

    Als u een Markdown-widget wilt bewerken, moet u mogelijk een teambeheerder, een lid van de groep Projectbeheerders of machtigingen krijgen. Zie Dashboardmachtigingen instellen voor meer informatie.

  4. Pas zo nodig de grootte van de widget aan zodat deze past bij de inhoud van de Markdown die u invoert. De grootste grootte is 10 tegels breed en 10 tegels hoog. U kunt dit later altijd aanpassen.

    Schermopname van het dialoogvenster Configuratie van Markdown-widget, grootte wijzigen.
  5. Voer de tekst en markdownsyntaxis in de configuratie in het configuratiedialoogvenster in. Zie syntaxisrichtlijnen voor Markdown-bestanden, widgets, wiki's en opmerkingen bij pull-aanvragen voor ondersteunde syntaxis.

    Hier laten we enkele eenvoudige tekst zien met een lijst met opsommingstekens van vier koppelingen

    Schermopname voor Markdown configureren, tekstinvoer.

    Tip

    Gebruik de volgende syntaxis om een koppeling naar een wikipagina te maken:
    /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

    Als u een koppeling wilt maken naar een opslagplaatsbestand, pagina of afbeelding in het project, klikt u uitgebreid op het bestand en gebruikt u de volledige URL.

    Hiermee wordt de volgende widget weergegeven:

    Schermopname van webportal, Markdown-voorbeeldwidget.

    Notitie

    Koppelingen naar documenten op bestandsshares die worden gebruikt file:// , worden niet ondersteund. Deze beperking is geïmplementeerd voor beveiligingsdoeleinden.

  6. Desgewenst kunt u selecteren om naar een bestand in uw opslagplaats te verwijzen.

    Schermopname van de Markdown-widget configureren met een opslagplaatsbestand.