Usare un riquadro markdown nei dashboard di Azure per visualizzare il contenuto personalizzato

  • Articolo

È possibile aggiungere un riquadro markdown ai dashboard di Azure per visualizzare il contenuto statico personalizzato. Ad esempio, è possibile visualizzare istruzioni di base, un'immagine o un set di collegamenti ipertestuali in un riquadro markdown.

Aggiungere un riquadro markdown al dashboard

  1. Selezionare Dashboard dal menu portale di Azure.

  2. Nella visualizzazione dashboard selezionare il dashboard in cui dovrebbe essere visualizzato il riquadro markdown personalizzato e quindi selezionare Modifica.

    Screenshot che mostra l'opzione di modifica del dashboard nella portale di Azure.

  3. Nella raccolta riquadri individuare il riquadro denominato Markdown e selezionare Aggiungi. Il riquadro viene aggiunto al dashboard e si apre il riquadro Modifica markdown.

  4. Immettere i valori per Titolo e Sottotitolo, che vengono visualizzati nel riquadro dopo il passaggio a un altro campo.

    Screenshot che mostra come aggiungere un titolo e un sottotitolo a un riquadro markdown.

  5. Selezionare una delle opzioni per includere il contenuto markdown: modifica inline o Inserimento di contenuto tramite URL.

    • Selezionare Modifica inline se si vuole immettere direttamente markdown.

      Screenshot che mostra l'immissione di contenuto inline

    • Selezionare Inserisci contenuto usando l'URL se si vuole usare il contenuto markdown esistente ospitato online.

      Screenshot che mostra l'immissione dell'URL

      Nota

      Per maggiore sicurezza, creare un file markdown e archiviarlo in un BLOB dell'account di archiviazione di Azure in cui è abilitata la crittografia. Per un controllo aggiuntivo, configurare la crittografia con le chiavi gestite dal cliente archiviate in Azure Key Vault. È quindi possibile puntare al file usando l'opzione Inserisci contenuto tramite URL . Solo gli utenti con autorizzazioni per il file possono visualizzare il contenuto markdown nel dashboard. Potrebbe essere necessario impostare una regola CORS (Cross-Origin Resource Sharing) nell'account di archiviazione in modo che il portale di Azure (https://portal.azure.com/) possa accedere al file markdown nel BLOB.

  6. Selezionare Fine per chiudere il riquadro Modifica markdown. Il contenuto viene visualizzato nel riquadro Markdown, che è possibile ridimensionare trascinando l'handle nell'angolo inferiore destro.

    Screenshot che mostra il riquadro markdown personalizzato in un dashboard.

Limitazioni e funzionalità del contenuto markdown

È possibile usare qualsiasi combinazione di testo normale, sintassi Markdown e contenuto HTML nel riquadro markdown. Il portale di Azure usa una libreria open source denominata marked per trasformare il contenuto nel codice HTML visualizzato nel riquadro. Il codice HTML generato da marked viene preelaborato dal portale prima del rendering. Questo passaggio consente di assicurarsi che la personalizzazione non influisca sulla sicurezza o sul layout del portale. Durante la preelaborazione, viene rimossa qualsiasi parte del codice HTML che rappresenta una potenziale minaccia. I tipi di contenuto seguenti non sono consentiti dal portale:

  • JavaScript: <script> i tag e le valutazioni JavaScript inline vengono rimossi.
  • iframe: <iframe> i tag vengono rimossi.
  • Stile: <style> i tag vengono rimossi. Gli attributi di stile in linea negli elementi HTML non sono ufficialmente supportati. Alcuni elementi di stile in linea possono essere accettabili, ma se interferiscono con il layout del portale, potrebbero smettere di funzionare in qualsiasi momento. Il riquadro markdown è destinato al contenuto statico di base che usa gli stili predefiniti del portale.

Passaggi successivi