Aggiungere Markdown a un dashboard

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

Usare il widget Markdown per supportare il team e gli stakeholder aggiungendo informazioni come:

• Obiettivi del team.
• Collegamenti a:
  • Backlog o bacheche del team.
  • Metrics (Metriche).
  • Altri elementi che si trovano in una condivisione di rete, ad esempio un sito di OneNote, un sito di SharePoint o pagine wiki.
• Date importanti o scadenze di destinazione.

Ecco un esempio:

Prerequisiti

• È necessario essere membri del progetto.
• Chiunque abbia accesso a un progetto, inclusi gli stakeholder, può visualizzare i dashboard.
• Per aggiungere, modificare o gestire un dashboard del team, è necessario avere accesso di base, essere membro del team, membro del gruppo Project Amministrazione istrators o disporre delle autorizzazioni del dashboard concesse all'utente.
• Per aggiungere, modificare o gestire un dashboard del progetto, è necessario disporre dell'accesso di base o disporre delle autorizzazioni del dashboard per il dashboard del progetto selezionato.

Nota

I dati visualizzati all'interno di un grafico o di un widget sono soggetti alle autorizzazioni concesse all'utente connesso. Ad esempio, se un utente non dispone delle autorizzazioni per visualizzare gli elementi di lavoro in un percorso di area, tali elementi non vengono visualizzati in un widget dei risultati della query in un dashboard. Per altre informazioni, vedere Domande frequenti su dashboard, grafici e report di Azure DevOps, Accesso e autorizzazioni.

Sintassi Markdown supportata

Il widget Markdown supporta le funzionalità standard CommonMark, ad esempio:

• Titoli
• Paragrafi e interruzioni di riga
• Citazioni di paragrafi
• Righello orizzontale
• Enfasi (grassetto, corsivo, barrato)
• Tabelle
• Elenchi, ordinati e non ordinati
• Collegamenti
• Immagini
• Uso di caratteri di escape

Per informazioni dettagliate sull'utilizzo, vedere Indicazioni sulla sintassi per l'utilizzo di markdown di base.

Per motivi di prestazioni, il widget Markdown non aggiunge il supporto per molte funzionalità estese, molte delle quali sono supportate nel wiki. Le funzionalità estese impediscono il tempo di caricamento dei widget. Ad esempio, le funzionalità markdown estese seguenti non sono supportate nel widget Markdown:

• Sintassi HTML incorporata
• Evidenziazione del codice (wiki/altri supportano la codifica a colori compatibile con la sintassi del linguaggio, CommonMark esegue semplicemente il rendering del codice come testo preformattato normale)
• Elenchi di controllo
• Caratteri Emoji
• Allegati
• Formule matematiche

Connessione al progetto

Per aggiungere il widget Markdown a un dashboard, connettersi al progetto usando un Web browser supportato.

Aprire un Web browser, connettersi al progetto e selezionare Dashboard di panoramica>.

Se è necessario passare a un progetto diverso, selezionare il logo di Azure DevOps per esplorare tutti i progetti.

Aggiungere il widget Markdown

Se è necessario aggiungere un dashboard, vedere Aggiungere, rinominare ed eliminare dashboard.

Per aggiungere il widget Markdown al dashboard, selezionare Modifica. Il catalogo widget verrà aperto automaticamente.

1. Aggiungere o trascinare il widget Markdown nel dashboard in cui si vuole trovarlo.

   

2. Selezionare Fine modifica per uscire dalla modifica del dashboard. In questo modo il catalogo widget verrà ignorato. È quindi possibile configurare il widget Markdown in base alle esigenze.

3. Selezionare l'icona a forma di ingranaggio per aprire la finestra di dialogo di configurazione per il widget.

   Per modificare un widget Markdown, potrebbe essere necessario essere un amministratore del team, un membro del gruppo Project Amministrazione istrators o avere le autorizzazioni concesse. Per altre informazioni, vedere Impostare le autorizzazioni del dashboard.

4. Regolare le dimensioni del widget in base alle esigenze per adattare il contenuto del Markdown che verrà immesso. La dimensione più grande è 10 riquadri larghezza di 10 riquadri alti. È sempre possibile modificarlo in un secondo momento.

   

5. Immettere il testo e la sintassi Markdown nella configurazione della finestra di dialogo di configurazione. Per la sintassi supportata, vedere Indicazioni sulla sintassi per file Markdown, widget, wiki e commenti delle richieste pull.

   Qui mostriamo un testo semplice con un elenco puntato di quattro collegamenti

   

   Suggerimento

   Per collegarsi a una pagina wiki, usare la sintassi seguente:
   /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

   To link to a repository file, page, or image within the project, rich-click the file and use the full URL.

   In questo modo viene eseguito il rendering del widget seguente:

   

   Nota

   I collegamenti ai documenti nelle condivisioni file che usano file:// non sono supportati. Questa restrizione è stata implementata a scopo di sicurezza.

6. Facoltativamente, è possibile selezionare per puntare a un file nel repository.

   

Articoli correlati

• Add and manage dashboards (Aggiungere e gestire i dashboard)
• Aggiungere un widget a un dashboard
• Indicazioni sulla sintassi per file Markdown, widget, wiki e commenti delle richieste pull
• Widget del Marketplace