Usare i temi del report in Power BI Desktop

SI APPLICA A: Power BI Desktop Servizio Power BI

In Power BI Desktop i temi dei report consentono di applicare modifiche alla struttura dell'intero report, ad esempio usando i colori aziendali, modificando i set di icone o applicando una nuova formattazione visuale predefinita. Quando si applica un tema del report, tutti gli oggetti visivi del report usano per impostazione predefinita i colori e la formattazione del tema selezionato. Alcune eccezioni sono descritte più avanti in questo articolo.

È possibile selezionare i temi del report passando alla barra multifunzione Visualizza. Nella sezione Temi, selezionare la freccia a discesa, quindi selezionare il tema desiderato. I temi disponibili sono simili ai temi inclusi in altri prodotti Microsoft, ad esempio Microsoft PowerPoint.

Screenshot del menu a discesa Temi.

Esistono due tipi di temi di report:

  • I temi di report predefiniti forniscono diversi tipi di schemi di colori predefiniti. È possibile selezionare i temi del report predefiniti direttamente dal menu di Power BI Desktop.

  • I temi di report personalizzati forniscono un controllo granulare di numerosi aspetti del tema di un report, come descritto in Personalizzare temi di report più avanti in questo articolo. È possibile creare temi di report personalizzati modificando un tema corrente e salvandolo come tema personalizzato oppure creando un tema personalizzato usando un file JSON.

Modalità di applicazione di un tema del report

Per applicare un tema di report a un report di Power BI Desktop, è possibile selezionare una delle opzioni seguenti:

Nota

È possibile applicare temi solo in Power BI Desktop. Non è possibile applicare temi ai report esistenti nel servizio Power BI.

Applicare un tema del report predefinito

Per effettuare una selezione tra i temi di report predefiniti disponibili, usare la procedura seguente. Vedere la tabella Temi di report predefiniti per la sequenza di colori predefinita per ogni tema.

  1. Nella barra multifunzione Visualizza, selezionare la freccia a discesa accanto a Temi.

  2. Effettuare una selezione tra i temi nel menu a discesa visualizzato, inclusi i nuovi Temi accessibili.

    Screenshot del menu a discesa temi di Power BI, con tutte le selezioni evidenziate.

    Il tema del report è ora applicato al report.

  3. È possibile anche esplorare la raccolta di temi creati dai membri della Community di Power BI selezionando Raccolta temi nel menu a discesa Temi.

    Screenshot del menu a discesa Temi di Power BI, con Raccolta temi evidenziato.

    Dalla raccolta è possibile selezionare un tema e scaricare il file JSON associato.

    Per installare il file scaricato, selezionare Cerca temi dall'elenco a discesa Temi, passare al percorso in cui è stato scaricato il file JSON e selezionarlo per importare il tema in Power BI Desktop come nuovo tema.

    In caso di esito positivo, Power BI visualizza una finestra di dialogo per confermare il completamento dell'importazione.

    Screenshot della finestra di dialogo di importazione del tema completata.

Temi del report predefiniti

La tabella seguente visualizza i modelli di temi del report predefiniti disponibili.

Tema del report predefinito Sequenza di colori predefinita
Predefiniti Diagramma della sequenza di colori per il tema predefinito.
Highrise Diagramma della sequenza di colori per il tema Highrise.
Direzione Diagramma della sequenza di colori per il tema Executive.
Frontiera Diagramma della sequenza di colori per il tema Frontier.
Innovazione Diagramma della sequenza di colori per il tema Innovate.
Aprire la mano a fiore Diagramma della sequenza di colori per il tema Bloom.
Marea Diagramma della sequenza di colori per il tema Tidal.
Temperatura Diagramma della sequenza di colori per il tema Temperature.
Solare Diagramma della sequenza di colori per il tema Solar.
Divergente Diagramma della sequenza di colori per il tema Divergent.
Storm Diagramma della sequenza di colori per il tema Storm.
Classico Diagramma della sequenza di colori per il tema Classic.
Parco cittadino Diagramma della sequenza di colori per il tema City park.
Classe Diagramma della sequenza di colori per il tema Classroom.
Color blind safe Diagramma della sequenza di colori per il tema Color blind safe.
Elettrico Diagramma della sequenza di colori per il tema Electric.
Contrasto elevato Diagramma della sequenza di colori per il tema High contrast.
Tramonto Diagramma della sequenza di colori per il tema Sunset.
Crepuscolo Diagramma della sequenza di colori per il tema Twilight.
Accessible predefinito Diagramma della sequenza di colori per il tema Accessible predefinito.
Accessible city park Diagramma della sequenza di colori per il tema Accessible city park.
Accessible tidal Diagramma della sequenza di colori per il tema Accessible tidal.
Accessible neutral Diagramma della sequenza di colori per il tema Accessible neutral.
Accessible orchid Diagramma della sequenza di colori per il tema Accessible orchid.

Personalizzare i temi del report

È possibile personalizzare e standardizzare la maggior parte degli elementi visualizzati nella sezione Formatto del riquadro Visualizzazioni, tramite personalizzazioni eseguite direttamente in Power BI Desktop o tramite un file JSON del tema del report. L'obiettivo è offrire all'utente il controllo completo sull'aspetto predefinito del report a un livello granulare.

È possibile personalizzare i temi dei report nei modi seguenti:

Personalizzare e salvare un tema in Power BI Desktop

Per personalizzare un tema direttamente in Power BI Desktop, è possibile selezionare un tema simile a quello che si desidera creare e apportare alcune modifiche. Selezionare prima di tutto un tema simile e usare la procedura seguente:

  1. Dalla barra multifunzione Visualizza, selezionare il pulsante a discesa Temi quindi selezionare Personalizza tema corrente.

    Screenshot del menu a discesa Temi di Power BI, con Personalizza tema corrente evidenziato.

  2. Viene visualizzata una finestra di dialogo in cui è possibile apportare modifiche al tema corrente e salvare le impostazioni come nuovo tema.

    Screenshot della finestra di dialogo Personalizza tema.

Le impostazioni di temi personalizzabili rientrano nelle categorie seguenti, che rispecchiano quelle della finestra Personalizza tema:

  • Nomi e colori: le impostazioni del nome e del colore del tema includono colori temi, colori sentimento, colori divergenti e colori strutturali (Avanzato).
  • Testo: le impostazioni del testo includono la famiglia, le dimensioni e i colori dei caratteri che definiscono le impostazioni predefinite della classe di testo primaria per etichette, titoli, schede e KPI, e intestazioni di schede.
  • Oggetti visivi: le impostazioni degli oggetti visivi includono sfondo, bordo, intestazione e descrizioni comando.
  • Pagina: le impostazioni degli elementi della pagina includono motivi e sfondi.
  • Riquadro filtro: le impostazioni del riquadro filtro includono colore di sfondo, trasparenza, colore dei caratteri e delle icone, dimensioni e schede di filtri.

Dopo avere apportato le modifiche, selezionare Applica e salva per salvare il tema. A questo punto, il tema può essere usato nel report corrente ed esportato.

La personalizzazione del tema corrente in questo modo è rapida e semplice. Tuttavia, è possibile anche apportare modifiche più precise ai temi, che richiedono la modifica del file JSON del tema.

Suggerimento

È possibile personalizzare le opzioni più comuni del tema del report usando i controlli della finestra di dialogo Personalizza tema. Per un controllo maggiore, è possibile esportare il file JSON di un tema e apportare manualmente regolazioni precise modificando le impostazioni in tale file. È possibile rinominare tale file JSON ottimizzato e importarlo in un secondo momento.

Aggiornare il tema di base

Power BI apporta modifiche ai temi, incluse le nuove impostazioni predefinite per la formattazione, come parte di un nuovo tema di base. Per evitare ripercussioni sui report esistenti, queste modifiche non vengono propagate ai temi personalizzati. Se è stato personalizzato un tema predefinito, è possibile che non vengano visualizzate correzioni ai problemi o aggiornamenti dei report senza l’aggiornamento dei temi di base.

Se si utilizza un tema non aggiornato, nella barra multifunzione Visualizza selezionare il pulsante a discesa Temi, quindi selezionare Personalizza tema corrente. Se il tema non è aggiornato, verrà visualizzato un banner nella parte superiore del tema che invita a eseguire l’aggiornamento al tema di base più recente.

Selezionare Aggiorna tema per visualizzare le modifiche, quindi selezionare Applica.

Screenshot che mostra l'opzione Aggiorna tema.

Importare i file del tema del report personalizzati

È anche possibile importare il file di un tema di report personalizzato seguendo questa procedura:

  1. Nella barra multifunzione Visualizza, selezionare il pulsante a discesa Temi>Esplora temi.

    Screenshot del menu a discesa Temi di Power BI, con Esplora temi evidenziato.

    Viene visualizzata una finestra che è possibile usare per passare al file del tema JSON.

  2. Nell'immagine seguente è possibile visualizzare i file dei temi Holiday. Vedere la selezione di esempio di un tema Holiday per il mese di marzo, St Patricks Day.json.

    Screenshot della finestra di dialogo che elenca i file JSON dei temi Holiday.

    Al termine del caricamento del file del tema, Power BI Desktop visualizza una notifica.

    Screenshot della finestra di dialogo di importazione del tema completata.

Vedere la sezione File JSON del tema del report di esempio in questo articolo per continuare a esplorare il file St Patricks Day.json.

Permanenza dei colori del tema nei report

Quando il report viene pubblicato nel servizio Power BI, i colori del tema del report restano applicati al report. La sezione Colori del pannello Formato riflette il tema del report.

Per visualizzare i colori disponibili in un tema del report:

  1. Selezionare l'area di disegno del report o uno degli oggetti visivi nell'area di disegno.

  2. Dalla sezione Formato del riquadro Visualizzazioni, selezionare Colore.

    Viene visualizzata la tavolozza del report Colori tema.

    Screenshot della tavolozza Colori tema con le selezioni predefinite.

Nell'esempio, dopo avere applicato le varie tonalità di verde e marrone incluse nel tema del report St. Patrick's Day, è possibile visualizzare i colori del tema. I colori fanno parte del tema del report importato e applicato.

I colori nella tavolozza dei colori sono relativi al tema corrente. Ad esempio, si supponga di scegliere il terzo colore dall'alto per un punto dati. Se in seguito si passa a un tema diverso, il colore del punto dati viene aggiornato automaticamente al terzo colore della riga superiore nel nuovo tema, come accade quando si modificano i temi in Microsoft Office.

Impostando il tema di un report, i colori predefiniti usati negli oggetti visivi in tutto il report cambiano. Power BI mantiene un elenco costituito da centinaia di colori per garantire la disponibilità di una notevole quantità di colori unici per gli oggetti visivi da visualizzare in un report. Quando Power BI assegna i colori alla serie di un oggetto visivo, i colori vengono selezionati come colori di serie assegnati. Quando si importa un tema, il mapping dei colori per la serie di dati viene reimpostato.

Serie dinamica

Power BI tiene traccia del colore per una serie dinamica e usa lo stesso colore per il valore in altri oggetti visivi. In una serie dinamica, il numero di serie presentate negli oggetti visivi può variare a seconda delle misure, dei valori o di altri aspetti. Ad esempio, se si visualizza Profitto per area in un report, è possibile che siano presenti cinque oppure nove aree di vendita. Poiché il numero di aree è dinamico, viene considerato una serie dinamica.

I singoli membri di una serie dinamica reclamano un colore dalla tavolozza dei colori dei dati durante la lettura. Ad esempio, se un oggetto visivo include un set di membri Profitto per area e anche un secondo oggetto visivo include un set di membri Profitto per area ma il set di membri è disgiunto, il primo oggetto visivo per cui viene completata la richiesta di dati si riserva i colori precedenti. Siccome i colori per i singoli membri di serie dinamiche non vengono archiviati in modo esplicito, questo comportamento può causare la modifica casuale dei colori, a seconda degli oggetti visivi caricati per primi. È sempre possibile assegnare membri specifici a un particolare colore usando il riquadro di formattazione: vedere altre informazioni su come modificare il colore di un singolo punto dati.

Serie statiche

Al contrario, per le serie statiche, il numero di serie e il relativo ordine è noto. Profitti e ricavi, ad esempio, sono serie statiche. Nelle serie statiche Power BI assegna i colori in base all'indice interno alle tavolozze del tema. Per eseguire l'override dell'assegnazione dei colori predefiniti, è possibile selezionare un colore dal riquadro di formattazione in Colori dati. Per visualizzare tutti i potenziali valori delle serie e impostarne anche i colori, potrebbe essere necessario modificare le selezioni del filtro dei dati. Se si imposta in modo esplicito un colore per un singolo oggetto visivo usando il riquadro Proprietà, il tema importato non si applica a nessuno di tali colori definiti in modo esplicito.

Per annullare l’applicazione esplicita del colore e consentire l’applicazione del tema a tali colori selezionati in modo esplicito, usare Ripristina impostazioni predefinite nella sezione Colori dati dell'oggetto visivo per cui il colore è stato impostato in modo esplicito.

Casi in cui i colori del tema del report non rimangono applicati ai report

Si supponga di applicare un set di colori (o un singolo colore) personalizzato a un punto dati in un oggetto visivo usando l'opzione Colore personalizzato nel selettore colori. Quando si applica un tema del report, questo non sostituisce il colore personalizzato del punto dati.

Si immagini, inoltre, che si desideri impostare manualmente il colore di un punto dati usando la sezione Colori tema. Quando si applica un nuovo tema del report, questi colori non vengono aggiornati. Per ripristinare i colori predefiniti in modo che vengano aggiornati quando si applica un nuovo tema del report, selezionare Ripristina impostazioni predefinite o selezionare un colore dalla tavolozza Colori tema nel selettore colori.

Screenshot del menu a discesa Visualizzazioni, con Ripristina impostazione predefinita evidenziato.

Molti oggetti visivi di Power BI non si applicano ai temi dei report.

File di temi del report personalizzati pronti all'uso

Si vuole provare subito a usare i temi del report? Vedere i temi dei report personalizzati nella raccolta di temi o i seguenti file JSON di temi di report personalizzati approntati che è possibile scaricare e importare nel report Power BI Desktop:

  • Tema Waveform. Questo tema è stato introdotto nel post di blog in cui è stato annunciato il primo rilascio dei temi dei report. Scaricare Waveform.json.

    Screenshot che mostra il tema JSON Waveform.

  • Tema Color blind friendly. Questo tema del report è facile da leggere per le persone con difficoltà visive. Scaricare ColorblindSafe-Longer.json.

    Screenshot del tema JSON Color blind safe longer.

  • Tema dedicato al giorno di San Valentino.

    Screenshot del tema JSON Valentine's Day.

    Ecco il codice per il file JSON dedicato al giorno di San Valentino:

         {
             "name": "Valentine's Day",
             "dataColors": ["#990011", "#cc1144", "#ee7799", "#eebbcc", "#cc4477", "#cc5555", "#882222", "#A30E33"],
             "background":"#FFFFFF",
             "foreground": "#ee7799",
             "tableAccent": "#990011"
         }
    

Ecco altri temi dei report che è possibile usare come punti di partenza:

Con i temi del report è possibile aggiungere un tocco creativo ai report di Power BI Desktop, applicando i colori preferiti dall'utente o dall'organizzazione o quelli caratteristici di una stagione o di una festività.

Altre origini dei temi dei report

Il repository GitHub seguente include JSON di esempio per tutti i diversi componenti nel file dei temi JSON: Modelli di temi di Power BI.

Provare anche a cercare "generatore di temi di Power BI" in Bing.

Esportare temi dei report

È possibile esportare il tema del report attualmente applicato direttamente da Power BI Desktop in un file JSON. Dopo aver esportato un tema di report, è possibile riutilizzarlo in altri report. Questa opzione consente di esportare il file JSON per la maggior parte dei temi predefiniti. Le uniche eccezioni sono i temi di base, Classico e Predefinito, su cui si basano gli altri temi quando vengono importati.

Per esportare il tema attualmente applicato da Power BI Desktop:

  1. Selezionare Visualizza, quindi selezionare il menu a discesa Temi.

    Screenshot del menu a discesa Temi, con Salva tema corrente evidenziato.

  2. Nella parte inferiore del menu a discesa, selezionare Salva tema corrente.

  3. Dalla finestra di dialogo Salva con nome, passare a una directory in cui salvare il file JSON e selezionare Salva.

Formato di file JSON dei temi dei report

Al livello più basilare, il file JSON del tema include una sola riga obbligatoria: name.

{
    "name": "Custom Theme"
}

Diversamente da name, tutto il resto è facoltativo, per cui è possibile aggiungere al file del tema solo le proprietà che si desidera formattare in modo specifico. Per il resto, è possibile continuare a usare le impostazioni predefinite di Power BI.

In un file JSON del tema del report si definisce solo la formattazione che si vuole modificare. Le impostazioni non specificate nel file JSON ridiventano quelle predefinite di Power BI Desktop.

Quando si crea un file JSON, è possibile specificare che tutti i grafici devono usare un carattere di dimensione 12, che determinati oggetti visivi devono usare una particolare famiglia di caratteri oppure che le etichette dati sono disattivate per determinati tipi di grafici. Tramite un file JSON è possibile creare un file del tema del report che definisce grafici e report standard, per semplificare la creazione di report coerenti nell'organizzazione.

Quando si importa il file del tema, Power BI lo convalida per accertarsi che possa leggerne il contenuto completo. Se Power BI trova campi che non riconosce, viene visualizzato un messaggio che indica che il file del tema non è valido e invita l'utente a ripetere l’importazione con un file del tema corretto. Power BI, inoltre, pubblica lo schema usato per controllare il file del tema in un percorso pubblico, aggiornandolo automaticamente ogni volta che viene modificato in Power BI, in modo da garantire che i file dei temi siano sempre aggiornati.

Power BI convalida i temi personalizzati in base a uno schema JSON. Questo schema JSON è scaricabile per utilizzarlo con un IDE che supporta la convalida JSON che consente di identificare le opzioni di formattazione disponibili ed evidenziare la formattazione del tema non valida. Altre informazioni sono disponibili nel repository degli schemi JSON dei temi dei report.

Nota

La modifica di un tema del report JSON personalizzato nella finestra di dialogo Personalizza tema è sicura. La finestra di dialogo non modifica le impostazioni del tema che non è in grado di controllare e aggiorna le modifiche apportate al tema del report.

Un file del tema ha quattro componenti principali:

Le sezioni seguenti descrivono dettagliatamente ogni componente.

Impostare colori dei temi

In name è possibile aggiungere seguenti le proprietà di base correlate al colore dei dati:

  • dataColors: questi codici esadecimali determinano il colore delle forme che rappresentano dati in oggetti visivi Power BI Desktop. L'elenco può contenere il numero di colori desiderato. Dopo che tutti i colori di questo elenco sono stati usati, se l'oggetto visivo richiede ancora altri colori, ruota lievemente la tavolozza dei colori dei temi con regolazione di saturazione e tonalità in ciclo, per generare colori unici senza ripetizioni.
  • good, neutral, bad: queste proprietà impostano i colori di stato usati dal grafico a cascata e dall’oggetto visivo KPI.
  • maximum, center, minimum, null: questi colori impostano i vari gradienti di colore nella finestra di dialogo della formattazione condizionale.

Un tema semplice che definisce questi colori può avere un aspetto simile al seguente:

{
    "name": "Custom Theme",
    "dataColors": [
        "#118DFF",
        "#12239E",
        "#E66C37",
        "#6B007B",
        "#E044A7",
        "#744EC2",
        "#D9B300",
        "#D64550",
        "#197278",
        "#1AAB40"
    ],
    "good": "#1AAB40",
    "neutral": "#D9B300",
    "bad": "#D64554",
    "maximum": "#118DFF",
    "center": "#D9B300",
    "minimum": "#DEEFFF",
    "null": "#FF7F48"
}

Impostare colori strutturali

Successivamente, è possibile aggiungere varie classi di colori, ad esempio background e firstLevelElements. Queste classi impostano i colori strutturali per gli elementi del report, ad esempio la griglia dell'asse, i colori di evidenziazione e i colori di sfondo per gli elementi visivi.

La tabella seguente visualizza le sei classi di colori che è possibile formattare. Il nomi di classe di colori corrispondono ai nomi riportati nella sottosezione "Avanzate" della sezione "Nome e colori" della finestra di dialogo Personalizza tema.

Nome preferito della classe di colori Denominato anche Elemento formattato
firstLevelElements foreground Colore di sfondo delle etichette (se esterne ai punti dati)
Colore della linea di tendenza
Colore predefinito della casella di testo
Colori dei caratteri di valori e totali di tabelle e matrici
Colore dell'asse delle barre dei dati
Etichette dati della scheda
Colore del valore del callout del misuratore
Colore dell'obiettivo KPI
Colore del testo KPI
Colore dell'elemento filtro dei dati (in modalità messa a fuoco)
Colore carattere elemento a discesa del filtro dei dati
Colore carattere dell'input numerico del filtro dei dati
Colore carattere dell'intestazione filtro dei dati
Colore della linea del rapporto del grafico a dispersione
Colore della linea di previsione del grafico a linee
Colore della guida della mappa
Colore del riquadro del filtro e del testo della scheda
Colore dell’icona e del testo di descrizione comando dell’oggetto visivo moderno (anteprima)
secondLevelElements foregroundNeutralSecondary Classi di testo secondarie light
Colori dell'etichetta
Colore etichetta della legenda
Colore etichetta dell'asse
Colore carattere dell'intestazione di tabella e matrice
Colore linea destinazione misuratore e guida di destinazione
Colore asse tendenza dell'indicatore KPI
Colore dispositivo di scorrimento del filtro dei dati
Colore carattere elemento del filtro dei dati
Colore contorno del filtro dei dati
Colore al passaggio sul grafico a linee
Colore del titolo di scheda con più righe
Colore del tratto del grafico a nastri
Colore bordo delle forme mappa
Colore carattere del testo del pulsante
Colore linea dell'icona del pulsante
Colore del contorno del pulsante
thirdLevelElements backgroundLight Colore della griglia dell'asse
Colore della griglia di tabella e matrice
Colore di sfondo dell'intestazione del filtro dei dati (in modalità messa a fuoco)
Colore del contorno della scheda a più righe
Colore del riempimento della forma
Colore di sfondo arco del misuratore
Colore di sfondo scheda del filtro applicato
Colore di riempimento del pulsante disabilitato, quando lo sfondo è FFFFFF
Colore del contorno del pulsante disabilitato, quando lo sfondo è FFFFFF
fourthLevelElements foregroundNeutralTertiary Colore della legenda in grigio
Colore etichetta categoria della scheda
Colore etichette categoria della scheda con più righe
Colore della barra della scheda con più righe
Colore tratto del tasso di conversione del grafico a imbuto
Colore carattere del testo del pulsante disabilitato
Colore linea dell'icona del pulsante disabilitato
background Colore di sfondo delle etichette (se all'interno di punti dati)
Colore di sfondo degli elementi del menu a discesa del filtro dei dati
Colore tratto del grafico ad anello
Colore tratto della mappa ad albero
Colore di sfondo del grafico combinato
Colore di riempimento del pulsante
Colore di sfondo della scheda filtro disponibile e del riquadro filtro
Colore di sfondo della descrizione comando dell’oggetto visivo moderno (anteprima)
secondaryBackground backgroundNeutral Colore contorno della griglia di tabella e matrice
Colore predefinito delle forme mappa
Colore di riempimento della barra del grafico a barre (quando l'opzione Abbina al colore della serie è disattivata)
Colore di riempimento del pulsante disabilitato, quando il colore di sfondo è FFFFFF.
Colore del contorno del pulsante disabilitato, quando il colore di sfondo è FFFFFF.
Colore al passaggio del mouse e linea separatore della descrizione del comando dell’oggetto visivo moderno (anteprima)
tableAccent Colore del contorno della griglia di tabelle e matrici, se presenti.

Ecco un tema di esempio che imposta le classi di colori:

{
    "name": "Custom Theme",
    "firstLevelElements": "#252423",
    "secondLevelElements": "#605E5C",
    "thirdLevelElements": "#F3F2F1",
    "fourthLevelElements": "#B3B0AD",
    "background": "#FFFFFF",
    "secondaryBackground": "#C8C6C4",
    "tableAccent": "#118DFF"
}

Suggerimento

Se viene creato un tema scuro o un altro tema colorato diverso dal tipico stile nero firstLevelElements su bianco background, impostare i valori per altri colori strutturali e i colori della classe di testo primaria. Ciò garantisce che le etichette dei dati nei grafici con sfondo etichetta corrispondano allo stile previsto, siano leggibili e abbiano griglie dell'asse visibili.

Definire le impostazioni predefinite del testo formattato

Successivamente, è possibile aggiungere classi di testo al file JSON. Le classi di testo sono simili alle classi di colori, ma consentono di aggiornare le dimensioni, il colore e la famiglia di caratteri per gruppi di testo nel report.

È necessario impostare solo 4 delle 12 classi, denominate classi primarie, per modificare tutta la formattazione del testo nel report. Queste quattro classi primarie possono essere impostate nella finestra di dialogo Personalizza tema nella sezione Testo: Generale corrisponde a etichetta, Titolo a titolo, Schede e KPI a calloute Intestazioni scheda a intestazione.

Le proprietà delle altre classi di testo, considerate secondarie, derivano automaticamente da quelle delle classi primarie associate. Spesso una classe secondaria seleziona una sfumatura più chiara del colore del testo o una dimensione del testo maggiore o minore in percentuale rispetto alla classe primaria.

Prendere come esempio la classe label. La formattazione predefinita per la classe etichetta è Segoe UI, #252423 (un colore grigio scuro) con un carattere 12 pt. Questa classe viene usata per formattare i valori nella tabella e nella matrice. In genere, i totali in una tabella o una matrice hanno una formattazione simile, ma sono formattati in grassetto con la classe etichetta in grassetto per evidenziarli. Tuttavia, non è necessario specificare tale classe nel JSON del tema. Power BI esegue questa operazione automaticamente. Se si decide di specificare etichette con un tipo di carattere 14 pt nel tema, non è necessario aggiornare anche la classe etichetta in grassetto, perché questa eredita la formattazione del testo dalla classe etichetta.

La tabella seguente mostra:

  • Ognuna delle quattro classi di testo primarie, gli elementi formattati e le impostazioni predefinite.
  • Ogni classe secondaria, gli elementi formattati e l'impostazione predefinita, univoca rispetto alla classe primaria.
Classe primaria Classi secondarie Nome della classe JSON Impostazioni predefinite Oggetti visivi associati
Callout N/D callout DIN
#252423
45 pt
Etichette dati della scheda
Indicatori KPI
Intestazione N/D di autorizzazione Segoe UI Semibold
#252423
12 pt
Intestazioni fattori di influenza chiave
Title title DIN
#252423
12 pt
Titolo asse delle categorie
Titolo asse dei valori
Titolo di scheda con più righe*
Intestazione del filtro dei dati
- Titolo grande largeTitle 14 pt Titolo oggetto visivo
Etichetta label Segoe UI
#252423
10 pt
Intestazioni colonna di tabella e matrice
Intestazioni di riga matrice
Griglia di tabella e matrice
Valori di tabella e matrice
- Semibold semiboldLabel Segoe UI Semibold Testo profilo dei fattori di influenza chiave
- Grande largeLabel 12 pt Etichette dati scheda a più righe
- Piccola smallLabel 9 pt Etichette linea di riferimento*
Etichette intervallo data del filtro dei dati
Stile testo dell'input numerico del filtro dei dati
Casella di ricerca del filtro dei dati
Testo fattore di influenza dei fattori di influenza chiave
- Chiaro lightLabel #605E5C Testo legenda
Testo pulsante
Etichette asse delle categorie
Etichette dati del grafico a imbuto
Etichette tasso di conversione del grafico a imbuto
Destinazione misuratore
Etichetta categoria grafico a dispersione
Elementi filtro dei dati
- Grassetto boldLabel Segoe UI Bold Subtotali della matrice
Totali complessivi della matrice
Totali della tabella
- Large e Light largeLightLabel #605E5C
12 pt
Etichette categorie della scheda
Etichette misuratore
Etichette categoria della scheda a più righe
- Small e Light smallLightLabel #605E5C
9 pt
Etichette dati
Etichette asse Valore

* Gli elementi contrassegnati con una stella sono basati sul primo colore dei dati del tema del report.

È possibile utilizzare l'impostazione booleana bold per regolare il formato. Per rendere il testo in grassetto, usare le impostazioni seguenti:

  • bold: true
  • titleBold: true

Suggerimento

Le varianti light delle classi di testo ereditano il colore chiaro dai colori strutturali definiti sopra. Se viene creato un dark theme, per il colore impostare firstLevelElements (corrispondente al colore del testo primario), secondLevelElements (corrispondente al colore light previsto per il testo) e background (con contrasto sufficiente per entrambi i colori degli elementi di primo e secondo livello).

Vedere il tema di esempio seguente che imposta solo le classi di testo primarie:

{
    "name": "Custom Theme",
    "textClasses": {
        "callout": {
            "fontSize": 45,
            "fontFace": "DIN",
            "color": "#252423"
        },
        "title": {
            "fontSize": 12,
            "fontFace": "DIN",
            "color": "#252423"
        },
        "header": {
            "fontSize": 12,
            "fontFace": "Segoe UI Semibold",
            "color": "#252423"
        },
        "label": {
            "fontSize": 10,
            "fontFace": "Segoe UI",
            "color": "#252423"
        }
    }
}

Poiché le classi secondarie ereditano dalle classi primarie, non è necessario impostarle nel file del tema. Tuttavia, se non si desidera usare regole di ereditarietà, ad esempio se non si desiderano i totali in grassetto, è possibile formattare in modo esplicito le classi secondarie nel file del tema, esattamente come per la formattazione delle classi primarie.

Definire impostazioni predefinite delle proprietà di oggetti visivi (visualStyles)

Infine, per creare un file JSON in formato esteso con un controllo più dettagliato e granulare sulla formattazione in un report, aggiungere una sezione visualStyles al file JSON per annidare le specifiche di formattazione. Vedere l'esempio seguente della sezione visualStyles:

    "visualStyles": {
        "<visualName>": {
            "<styleName>": {
                "<cardName>": [{
                    "<propertyName>": <propertyValue>
                }]
            }
        }
    }

Per le sezioni visualName e cardName, usare un nome oggetto visivo e scheda specifici. Attualmente, styleName è sempre un asterisco (*), ma in una versione futura sarà possibile creare stili diversi per gli oggetti visivi e assegnare loro dei nomi (come con la funzionalità stile per tabelle e matrici). propertyName è un'opzione di formattazione e propertyValue è il valore per tale opzione di formattazione.

Per visualName e cardName, usare un asterisco tra virgolette se si desidera che l'impostazione si applichi a tutti gli oggetti visivi o schede che hanno una proprietà. Se si usa un asterisco sia per il nome dell'oggetto visivo che per il nome della scheda, si applica un'impostazione a livello globale nel report, ad esempio una dimensione del carattere o una famiglia di caratteri specifica per tutto il testo in tutti gli oggetti visivi.

Vedere l'esempio seguente che imposta alcune proprietà tramite stili di oggetti visivi:

{
   "name":"Custom Theme",
   "visualStyles":{
      "*": {
         "*": {
            "*": [{
                "wordWrap": true
            }],
            "categoryAxis": [{
                "gridlineStyle": "dotted"
            }],
            "filterCard": [
              {
                "$id": "Applied",
                "foregroundColor": {"solid": {"color": "#252423" } }
              },
              {
                "$id":"Available",
                "border": true
              }
            ]
         }
      },
      "scatterChart": {
         "*": {
            "bubbles": [{
                  "bubbleSize": -10
            }]
         }
      }
   }
}

Questo esempio applica le impostazioni seguenti:

  • Attiva il ritorno a capo automatico ovunque.
  • Imposta lo stile della griglia punteggiato per tutti gli oggetti visivi con un asse delle categorie.
  • Imposta una formattazione per le schede filtro disponibili e applicate (si noti il formato con "$id" per impostare le differenti versioni delle schede filtro).
  • Imposta le dimensioni delle bolle su -10 per i grafici a dispersione.

Nota

È sufficiente specificare solo gli elementi di formattazione da modificare. Per gli elementi di formattazione non inclusi nel file JSON vengono ripristinate le impostazioni e i valori predefiniti.

Trovare le proprietà dell'oggetto visivo da impostare

Lo schema del tema del report consente di identificare le proprietà disponibili per lo stile con un tema del report. Usando lo schema come riferimento locale nel file del tema, è possibile usare la funzionalità di completamento automatico dell'IDE per identificare le opzioni di formattazione disponibili.

Ad esempio, usando il supporto per lo schema JSON di Visual Studio Code, è possibile definire un tema come indicato di seguito con "reportThemeSchema.json" scaricato dal repository di schemi e inserito nella stessa cartella:

{
    "name": "My custom theme",
    "$schema": "reportThemeSchema.json"
}

Con questa definizione, è possibile usare il completamento automatico in Visual Studio Code per comprendere la struttura e le opzioni di formattazione disponibili. Attivare il completamento automatico in modo esplicito usando la combinazione di tasti Ctrl + Spazio. Il popup della descrizione mostrerà il nome visualizzato e la descrizione dell'elemento di formattazione, come mostrato nel riquadro Formattazione, se disponibile:

Screenshot dell'uso dello schema del tema del report per identificare le opzioni di formattazione disponibili. Il menu di completamento automatico in Visual Studio Code mostra le opzioni di formattazione disponibili.

Suggerimenti per l'impostazione dei valori

Di seguito sono indicati alcuni suggerimenti utili per l’impostazione dei valori.

  • I valori booleani sono true o false.

  • Le stringhe devono essere tra virgolette doppie, come in “questa è una stringa”.

  • I numeri sono visualizzati come valori semplici, senza virgolette.

  • Quando si usa dateTime, la data deve essere una data ISO tra virgolette singole, preceduta da “datetime”. Vedere l'esempio seguente:

    "datetime'2022-10-05T14:48:00.000Z'"

  • I colori che usano un codice esadecimale personalizzato per sostituire FFFFFF usano il formato seguente. I valori esadecimali a 3 o 6 cifre sono accettabili:

    { "solid": { "color": "#FFFFFF" } }
    

È possibile usare un'enumerazione per formattare i menu a discesa impostando le opzioni di menu su una delle opzioni nel riquadro, ad esempio RightCenter per la posizione della legenda o Data value, percent of total per l'etichetta dati a torta. Le enumerazioni generalmente vengono formattate come stringhe.

Esempio di file JSON del tema del report

Di seguito è riportato il file St Patricks Day.json nella sua interezza:

   {
       "name": "St Patrick's Day",
       "dataColors": ["#568410", "#3A6108", "#70A322", "#915203", "#D79A12", "#bb7711", "#114400", "#aacc66"],
       "background":"#FFFFFF",
       "foreground": "#3A6108",
       "tableAccent": "#568410"
   }

Questo file JSON del tema del report include le righe seguenti:

  • name: il nome del tema del report. Questo campo è l'unico campo obbligatorio.
  • dataColors: L’elenco di codici colore esadecimali da usare per i dati in oggetti visivi Power BI Desktop. L'elenco può contenere il numero di colori desiderato.
  • background, foreground e tableAccent: classi di colore. Le classi di colori consentono di impostare contemporaneamente molti colori strutturali nel report.

È possibile copiare questo JSON e usarlo come base per creare un file di tema del report personalizzato da importare. Se si vuole modificare solo i colori base del report, modificare il nome e i codici esadecimali nel file.

Considerazioni e limitazioni

  • Se si usa uno dei temi originali, il tema Classic o un tema personalizzato importato per primo, la sezione di testo della finestra di dialogo del tema non è disponibile per la configurazione.

    I temi predefiniti interessati da questa limitazione includono:

    • Classico
    • Parco cittadino
    • Classe
    • Color blind safe
    • Elettrico
    • Contrasto elevato
    • Tramonto
    • Crepuscolo

    Se si usa uno dei temi interessati e non è necessario modificare le impostazioni del testo, è possibile usare in sicurezza le altre schede della finestra di dialogo senza alcun problema. Tuttavia, se si desidera usare le classi di testo con uno dei temi interessati, sono disponibili due opzioni:

    • Il modo più semplice e rapido per abilitare le classi di testo consiste nel selezionare le opzioni predefinite dei temi.
    • Se si desidera usare il tema personalizzato corrente, per abilitare la scheda del testo:
    1. Esportare il tema corrente.
    2. Selezionare il tema predefinito.
    3. Importare il tema personalizzato esportato nel primo passaggio.

    Il testo del report avrà un aspetto diverso, ma sarà possibile accedere alla scheda del testo nella finestra di dialogo del tema.

  • Gli elementi che sono considerati parte dell'interfaccia non possono essere cambiati usando un tema del report. Sono inclusi i riquadri Filtro, Formato e Dati e la matrice visiva nei calcoli visivi.