Aggiungere Markdown a un dashboard

Articolo
02/20/2025

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

Il widget Markdown è uno strumento versatile che consente di supportare il team e gli stakeholder aggiungendo informazioni preziose direttamente al dashboard. È possibile usarlo per visualizzare gli elementi seguenti:

Obiettivi del team
Collegamenti ai backlog del team o alle bacheche del team
Collegamenti alle metriche
Collegamenti ad 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 obiettivo

Usando il widget Markdown, è possibile assicurarsi che le informazioni essenziali siano facilmente accessibili e visibili al team e agli stakeholder. L'esempio seguente mostra le informazioni e i collegamenti del team:

Prerequisiti

Categoria	Requisiti
Livelli di accesso	- membro del progetto. - Almeno l'accesso di base o le autorizzazioni specifiche del dashboard .
Autorizzazioni	Per aggiungere, modificare o gestire un dashboard del team: membro del team e membro del gruppo Amministratori del Progetto .

Categoria	Requisiti
Livelli di accesso	- membro del progetto. - Almeno l'accesso di base o le autorizzazioni specifiche del dashboard .
Autorizzazioni	Per aggiungere, modificare o gestire un cruscotto del team: Membro del team o membro del gruppo Amministratori del progetto .
Strumenti	Per i widget di Analisi funzionare con il tuo dashboard: Analytics abilitato.

Categoria	Requisiti
Livelli di accesso	- membro del progetto. - Almeno l'accesso di base o autorizzazioni specifiche del dashboard .
Autorizzazioni	Per aggiungere, modificare o gestire un dashboard del team: membro del team e membro del gruppo Project Administrators o assegnato al ruolo di amministratore del team .
Strumenti	- Estensione Analytics Marketplace. I widget di Analisi non sono disponibili se Analytics non è installato, abilitato o in esecuzione. - Per far funzionare i widget di Analytics con la tua dashboard: Analytics deve essere abilitato.

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 specifico, tali elementi non vengono visualizzati in un widget dei risultati della query nel dashboard. Per altre informazioni, vedere Domande frequenti sull'uso dei dashboard.

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
Escape di caratteri

Per altre informazioni, vedere linee guida 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

Per aggiungere il widget Markdown, seguire questa procedura. Per aggiungere un dashboard, vedere Aggiungere, rinominare ed eliminare dashboard.

Accedi al tuo progetto (https://dev.azure.com/{Your_Organization/Your_Project})
Selezionare Dashboard.
Selezionare Modifica. Il catalogo widget viene aperto automaticamente.
Aggiungere o trascinare il widget Markdown nel dashboard in cui si vuole trovarlo.
Selezionare Fine modifica per uscire dalla modifica del dashboard. Questa azione ignora il catalogo dei widget. È quindi possibile configurare il widget Markdown in base alle esigenze.
Selezionare altre azioni >Configura.
(Facoltativo) Regolare le dimensioni del widget in base alle esigenze per adattare il contenuto del Markdown. La dimensione più grande è 10 riquadri larghezza di 10 riquadri alti. È sempre possibile regolare le dimensioni in un secondo momento.
Immettere testo e sintassi Markdown nella finestra di dialogo di configurazione. Per la sintassi supportata, vedere Indicazioni sulla sintassi per file Markdown, widget, wiki e commenti delle richieste pull.
Nota
- I collegamenti ai documenti nelle condivisioni di file che usano file:// non sono supportati. Questa restrizione viene implementata a scopo di sicurezza.
- Per collegarsi a una pagina wiki, usare la sintassi seguente:
  /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName
- Per collegare a un file di repository, una pagina o un'immagine all'interno del progetto, scegliere Selezionare un file markdown, quindi scegliere il Repository, il Branche il Percorso dai menu a discesa.
Salva le modifiche.