Usare i temi dei report in Power BI Desktop

SI APPLICA A: Power BI Desktop servizio Power BI

Con i temi dei report di Power BI Desktop è possibile applicare modifiche di progettazione all'intero report, ad esempio usando colori aziendali, modificando i set di icone o applicando una nuova formattazione visiva predefinita. Quando si applica un tema del report, tutti gli oggetti visivi del report usano i colori e la formattazione del tema selezionato come valori predefiniti. 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 e quindi selezionare il tema desiderato. I temi disponibili sono simili ai temi visualizzati in altri prodotti Microsoft, ad esempio Microsoft PowerPoint.

I due tipi di temi del report:

• I temi dei report predefiniti offrono diversi tipi di combinazioni di colori predefinite. È possibile selezionare i temi dei report predefiniti direttamente dal menu di Power BI Desktop.

• I temi del report personalizzati offrono un controllo granulare su molti aspetti di un tema del report, come descritto in Personalizzare i temi del report più avanti in questo articolo. È possibile creare temi del report personalizzati modificando un tema corrente e quindi salvandolo come tema personalizzato o creando un tema personalizzato usando un file JSON.

Modalità di applicazione di un tema del report

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

• Selezionare tra i temi dei report predefiniti disponibili incorporati in Power BI Desktop.
• Personalizzare un tema usando la finestra di dialogo Personalizza tema .
• Importare un file JSON del tema personalizzato.

Applicare un tema del report predefinito

Seguire questa procedura per selezionare i temi del report predefiniti disponibili. Vedere la tabella dei temi dei 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. Selezionare tra i temi nel menu a discesa visualizzato, inclusi i nuovi temi accessibili.

   

   Il tema del report viene ora applicato al report.

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

   

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

   Per installare il file scaricato, selezionare Sfoglia i temi dal menu 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.

   Al termine, Power BI visualizza una finestra di dialogo in cui l'importazione ha avuto esito positivo.

   

Temi dei report predefiniti

Nella tabella seguente vengono illustrati i temi predefiniti disponibili del report.

Tema del report predefinito	Sequenza di colori predefinita
Valori predefiniti
Highrise
Direzione
Frontiera
Innovazione
Aprire la mano a fiore
Marea
Temperatura
Solare
Divergente
Storm
Classico
Parco cittadino
Classe
Sicuro da colore
Elettrico
Contrasto elevato
Tramonto
Crepuscolo
Impostazione predefinita accessibile
Parco cittadino accessibile
Marea accessibile
Accessibile neutrale
Orchidea accessibile

Personalizzare i temi del report

È possibile personalizzare e standardizzare la maggior parte degli elementi elencati nella sezione Formato del riquadro Visualizzazioni , tramite personalizzazioni effettuate direttamente in Power BI Desktop o tramite un file JSON del tema del report. L'obiettivo è fornire il controllo completo sull'aspetto predefinito del report su un livello granulare.

È possibile personalizzare i temi del report nei modi seguenti:

• Personalizzare e salvare un tema in Power BI Desktop
• Creare e personalizzare un file JSON del tema del report personalizzato

Personalizzare e salvare un tema in Power BI Desktop

Per personalizzare un tema direttamente in Power BI Desktop, è possibile selezionare un tema vicino a quello desiderato e apportare alcune modifiche. Selezionare prima di tutto il tema che si chiude e seguire questa procedura:

1. Nella barra multifunzione Visualizza selezionare il pulsante a discesa Temi e selezionare Personalizza tema corrente.

   

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

   

È possibile trovare impostazioni del tema personalizzabili nelle categorie seguenti, riflesse nella finestra Personalizza tema :

• Nome e colori: le impostazioni nome e colore del tema includono colori del tema, colori sentiment, colori divergenti e colori strutturali (Avanzate).
• Testo: le impostazioni di testo includono famiglia di caratteri, dimensioni e colore, che imposta le impostazioni predefinite della classe di testo principale per etichette, titoli, schede e indicatori KPI e intestazioni di tabulazione.
• Oggetti visivi: le impostazioni visive includono sfondo, bordo, intestazione e descrizioni comando.
• Pagina: le impostazioni degli elementi della pagina includono sfondo e sfondo.
• Riquadro filtro: le impostazioni del riquadro filtro includono colore di sfondo, trasparenza, colore del carattere e icona, dimensioni e schede di filtro.

Dopo aver apportato le modifiche, selezionare Applica e salva per salvare il tema. È ora possibile usare il tema nel report corrente ed esportarlo.

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

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 non disturbare i 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 agli aggiornamenti dei report senza aggiornare i temi di base.

Per verificare se si usa un tema obsoleto, nella barra multifunzione Visualizza selezionare il pulsante a discesa Temi e selezionare Personalizza tema corrente. Se il tema non è aggiornato, vedrai un banner nella parte superiore del tema, invitandoti ad aggiornare il tema di base più recente.

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

Importare file di tema del report personalizzati

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

1. Sulla barra multifunzione Visualizza selezionare il pulsante >a discesa Temi Sfoglia per i temi.

   

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

2. Nell'immagine seguente è possibile visualizzare i file dei temi delle festività. Vedere l'esempio di selezione di un tema festività per marzo, St Patricks Day.json.

   

   Quando il file del tema è stato caricato correttamente, Power BI Desktop visualizza un messaggio di operazione riuscita.

   

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

In che modo i colori del tema del report vengono associati ai report

Quando si pubblica il report nella servizio Power BI, i colori del tema del report rimangono con esso. La sezione Colori del riquadro 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. Nella sezione Formato del riquadro Visualizzazione selezionare Colore.

   Verrà visualizzata la tavolozza Colori tema del tema del report.

   

Nell'esempio, dopo aver applicato la moltitudine di colori verde e marrone dal tema del report di San Patrick, è 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. Si supponga, ad esempio, di selezionare il terzo colore della riga superiore per un punto dati. Successivamente, se si passa a un tema diverso, il colore del punto dati viene aggiornato automaticamente al terzo colore della riga superiore nel nuovo tema, proprio come si noterà quando si modificano i temi in Microsoft Office.

L'impostazione di un tema del report modifica i colori predefiniti usati negli oggetti visivi in tutto il report. Power BI gestisce un elenco costituito da centinaia di colori per garantire che gli oggetti visivi abbiano molti colori univoci da visualizzare in un report. Quando Power BI assegna colori alla serie di un oggetto visivo, i colori vengono selezionati come colori della serie vengono assegnati. Quando si importa un tema, viene reimpostato il mapping dei colori per le serie di dati.

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ò cambiare in base a misure, valori o altri aspetti. Ad esempio, se si mostra Profit by Region in un report, potrebbero essere presenti cinque aree di vendita o nove. Il numero di aree è dinamico, quindi viene considerato una serie dinamica.

I singoli membri di una serie dinamica sostengono un colore della tavolozza dei colori dei dati durante la lettura. Ad esempio, se un oggetto visivo ha un set profit by Region di membri e un secondo oggetto visivo ha anche un set di membri Profit by Region, ma il set di membri è disgiunto, il primo oggetto visivo in cui la richiesta di dati è stata completata riserva i colori precedenti. Poiché i colori per i singoli membri delle 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 determinato colore usando il riquadro di formattazione: vedere altre informazioni su come modificare il colore di un singolo punto dati.

Serie statica

Viceversa, per la serie statica, il numero di serie e il relativo ordine è noto. Ad esempio, i ricavi profit e revenue sono serie statiche. Nella serie statica Power BI assegna i colori in base all'indice all'interno delle tavolozze dei temi. È possibile eseguire l'override dell'assegnazione di colore predefinita selezionando un colore nel riquadro di formattazione in Colori dati. Potrebbe essere necessario modificare le selezioni del filtro dei dati per visualizzare tutti i valori di serie potenziali e impostare anche i relativi colori. Se si imposta un colore in modo esplicito come singolo oggetto visivo usando il riquadro Proprietà , il tema importato non si applica a nessuno di questi colori definiti in modo esplicito.

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

Situazioni in cui i colori del tema del report non vengono attaccati ai report

Si supponga di applicare un set di colori personalizzato o un singolo colore a un punto dati in un oggetto visivo usando l'opzione Colore personalizzato nella selezione colori . Quando si applica un tema del report, non viene eseguito l'override del colore del punto dati personalizzato.

In alternativa, si supponga di voler impostare 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 impostazione predefinita oppure selezionare un colore dalla tavolozza Colori tema nella selezione colori.

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

File di tema del report personalizzati che è possibile usare al momento

Vuoi iniziare a usare i temi dei report? Vedere i temi del report personalizzati nella raccolta temi o i file JSON del tema del report personalizzati seguenti, che è possibile scaricare e importare nel report di Power BI Desktop:

• Tema waveform. Questo tema del report è stato introdotto nel post di blog che ha annunciato la prima versione dei temi del report. Scaricare Waveform.json.

  

• Tema descrittivo per i colori non vedenti. Questo tema del report è più facile da leggere per gli ipovedenti. Scaricare Colorblind Cassaforte-Longer.json.

  

• Tema di San Valentino.

  

  Ecco il codice per il file JSON di San Valentino:

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

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

• Crepuscolo di girasoli
• Prugna
• Autunno
• Contrasto elevato

I temi dei report possono rendere i report di Power BI Desktop un riflesso colorato dell'utente, dell'organizzazione o anche della stagione corrente o delle festività.

Altre origini dei temi dei report

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

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

Esportare i 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 del 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, che altri temi si basano su quando vengono importati.

Per esportare il tema attualmente applicato da Power BI Desktop:

1. Selezionare Visualizza e selezionare il menu a discesa Temi .

   

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

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

Formato di file JSON del tema del report

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

{
    "name": "Custom Theme"
}

nameOltre a , tutto il resto è facoltativo, il che significa che è possibile aggiungere solo le proprietà che si desidera formattare specificamente al file del tema. È possibile continuare a usare le impostazioni predefinite di Power BI per il resto.

In un file JSON del tema del report si definisce solo la formattazione che si vuole modificare. Impostazioni non si specifica nel file JSON ripristinare le impostazioni predefinite di Power BI Desktop.

Quando si crea un file JSON, è possibile specificare che tutti i grafici usano una dimensione del carattere pari a 12, che determinati oggetti visivi usano una famiglia di caratteri specifica o che le etichette dati siano disattivate per tipi di grafico specifici. Usando un file JSON, è possibile creare un file del tema del report che standardizzi i grafici e i report, semplificando la coerenza dei report dell'organizzazione.

Quando si importa il file del tema, Power BI lo convalida per assicurarsi che possa leggerne il contenuto completo. Se Power BI trova campi che non riconosce, viene visualizzato un messaggio che informa che il file del tema non è valido e invita l'utente a reimportare con un file del tema corretto. Power BI pubblica anche 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 del tema siano sempre aggiornati.

Power BI convalida i temi personalizzati in base a uno schema JSON. Questo schema JSON è disponibile per il download per l'uso 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 dello schema JSON del tema del report.

Un file di tema ha quattro componenti principali:

• Colori tema
• Colori strutturali
• Classi di testo
• Stili di visualizzazione

Le sezioni seguenti descrivono ognuna in dettaglio.

Impostare i colori del tema

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

• dataColors: questi codici esadecimali determinano il colore delle forme che rappresentano i dati negli oggetti visivi di Power BI Desktop. Questo elenco può avere tutti i colori desiderati. Dopo che tutti i colori di questo elenco sono stati usati, se l'oggetto visivo necessita ancora di più colori, ruota leggermente la tavolozza dei colori del tema con regolazione saturazione/tonalità e ciclo oltre e oltre per generare colori univoci senza ripetizioni.
• good, neutral, : badqueste proprietà impostano i colori di stato usati dal grafico a cascata e dall'oggetto visivo KPI.
• maximumminimum, center, null: questi colori impostano i vari colori sfumatura nella finestra di dialogo di formattazione condizionale.

Un tema di base che definisce questi colori potrebbe apparire come segue:

{
    "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 i colori strutturali

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

La tabella seguente illustra le sei classi di colori che è possibile formattare. I nomi delle classi Color corrispondono ai nomi nella sottosezione "Avanzate" della sezione "Nome e colori" nella finestra di dialogo Personalizza tema.

Nome preferito della classe color	Chiamato anche	Che cosa formatta
firstLevelElements	foreground	Colore di sfondo etichetta (all'esterno dei punti dati) Colore linea di tendenza Colore predefinito della casella di testo Valori di tabella e matrice e colori dei caratteri totali Colore dell'asse delle barre dei dati Etichette dati scheda Colore del valore del callout del misuratore Colore obiettivo KPI Colore del testo KPI Colore dell'elemento filtro dei dati (in modalità messa a fuoco) Colore del carattere dell'elemento a discesa filtro dei dati Colore del tipo di carattere numerico del filtro dei dati Colore carattere intestazione filtro dei dati Colore linea rapporto grafico a dispersione Colore linea di previsione grafico a linee Colore linea guida mappa Riquadro filtro e colore del testo della scheda Testo e colore icona delle descrizioni comandi degli oggetti visivi moderni (anteprima)
secondLevelElements	foregroundNeutralSecondary	Classi di testo secondarie leggere Colori etichetta Colore etichetta legenda Colore etichetta asse Colore carattere intestazione tabella e matrice Colore della linea di destinazione e destinazione Colore dell'asse di tendenza KPI Colore del dispositivo di scorrimento filtro dei dati Colore carattere elemento filtro dei dati Colore del contorno del filtro dei dati Colore del passaggio del mouse sul grafico a linee Colore del titolo della scheda a più righe Colore tratto grafico a nastri Colore bordo mappa forma Colore carattere testo pulsante Colore linea icona pulsante Colore struttura pulsante
thirdLevelElements	backgroundLight	Colore griglia asse Colore griglia tabella e matrice Colore di sfondo dell'intestazione del filtro dei dati (in modalità messa a fuoco) Colore contorno scheda a più righe Colore riempimento forma Colore di sfondo dell'arco del misuratore Colore di sfondo della scheda 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 in grigio legenda Colore etichetta categoria scheda Colore delle etichette delle categorie di schede a più righe Colore della barra della scheda mulit-row Colore del tratto della frequenza di conversione grafico a imbuto Colore del carattere del testo del pulsante disabilitato Colore linea icona pulsante disabilitato
background		Colore di sfondo etichetta (all'interno dei punti dati) Colore di sfondo degli elementi dell'elenco a discesa Filtro dei dati Colore tratto grafico ad anello Colore tratto mappa ad albero Colore di sfondo del grafico combinato Colore riempimento pulsante Riquadro filtro e colore di sfondo della scheda filtro disponibile Colore di sfondo delle descrizioni comando visive moderne (anteprima)
secondaryBackground	backgroundNeutral	Colore struttura griglia tabella e matrice Colore predefinito della mappa delle forme Colore di riempimento della barra multifunzione del grafico a nastri (quando l'opzione match series è disattivata) Colore di riempimento del pulsante disabilitato (quando il colore di sfondo non FFFFFFè ). Colore del contorno del pulsante disabilitato (quando il colore di sfondo non FFFFFFè ). Linee separatori delle descrizioni comando visive moderne e colore al passaggio del mouse (anteprima)
tableAccent		Colore struttura griglia tabella e matrice (se presente).

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"
}

Impostare le impostazioni predefinite per il testo formattato

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

È sufficiente impostare quattro 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 all'etichetta, titolo a titolo, schede e indicatori KPI da chiamare e intestazioni tabulazioni all'intestazione.

Altre classi di testo, considerate classi secondarie, derivano automaticamente le relative proprietà dalle classi primarie associate. Spesso, una classe secondaria seleziona una sfumatura più chiara del colore del testo o una percentuale maggiore o inferiore delle dimensioni del testo rispetto alla classe primaria.

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

La tabella seguente mostra:

• Ognuna delle quattro classi di testo primarie, i formati e le impostazioni predefinite.
• Ogni classe secondaria, il relativo formato 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 scheda Indicatori KPI
Intestazione	N/D	di autorizzazione	Segoe UI Semibold #252423 12 pt	Intestazioni di fattori di influenza chiave
Title		title	DIN #252423 12 pt	Titolo dell'asse delle categorie Titolo asse dei valori Titolo scheda a più righe * Intestazione del filtro dei dati
-	Titolo grande	largeTitle	14 pt	Titolo dell'oggetto visivo
Label		label	Segoe UI #252423 10 pt	Intestazioni di colonna tabella e matrice Intestazioni di riga matrice Griglia di tabelle e matrici Valori di tabella e matrice
-	Semibold	semiboldLabel	Segoe UI Semibold	Testo del profilo fattori di influenza chiave
-	Grande	largeLabel	12 pt	Etichette dati schede a più righe
-	Piccola	smallLabel	9 pt	Etichette di riga di riferimento * Etichette dell'intervallo di date del filtro dei dati Stile testo di input numerico filtro dei dati Casella di ricerca filtro dei dati Testo di influenza chiave fattori di influenza
-	Chiaro	lightLabel	#605E5C	Testo legenda Testo pulsante Etichette dell'asse delle categorie Etichette dati grafico a imbuto Etichette di tasso di conversione grafico a imbuto Destinazione del misuratore Etichetta categoria grafico a dispersione Elementi del filtro dei dati
-	Grassetto	boldLabel	Segoe UI Bold	Subtotali matrice Totali complessivi matrice Totali tabella
-	Grande e Chiaro	largeLightLabel	#605E5C 12 pt	Etichette delle categorie di schede Etichette del misuratore Etichette delle categorie di schede a più righe
-	Piccolo e chiaro	smallLightLabel	#605E5C 9 pt	Etichette dati Etichette dell'asse dei valori

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

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

• bold:Vero
• titleBold:Vero

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 preferisce le regole di ereditarietà (ad esempio, se non si vogliono totali in grassetto), è possibile formattare in modo esplicito le classi secondarie nel file del tema, proprio come è possibile formattare le classi primarie.

Impostare le impostazioni predefinite delle proprietà visive (visualStyles)

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

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

Per le visualName sezioni e cardName , usare un oggetto visivo e un nome di scheda specifici. Attualmente, styleName è sempre un asterisco (*), ma in una versione futura sarà possibile creare stili diversi per gli oggetti visivi e assegnare loro nomi (analogamente alla funzionalità di stile tabella e matrice). propertyName è un'opzione di formattazione ed propertyValue è il valore per l'opzione di formattazione.

Per visualName e cardName, usare un asterisco tra virgolette se si desidera applicare tale impostazione a tutti gli oggetti visivi o alle schede con una proprietà . Se si usa un asterisco sia per i nomi degli oggetti visivi che per i nomi delle schede, si applica effettivamente 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 gli stili di visualizzazione:

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

In questo esempio vengono specificate le impostazioni seguenti:

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

Trovare le proprietà visive 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 di Visual Studio Code per lo schema JSON, è possibile definire un tema come indicato di seguito con "reportThemeSchema.json" scaricato dal repository dello schema 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:

Suggerimenti per l'impostazione dei valori

Ecco alcuni suggerimenti utili qui sull'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 solo il valore stesso non tra virgolette.

• Quando si usa dateTime, la data deve essere una data ISO tra virgolette singole, con "datetime" all'inizio. Vedere l'esempio seguente:

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

• I colori che usano un codice esadecimale personalizzato per sostituire FFFFFF utilizzano il formato seguente. I valori esadecimali a 3 cifre o a 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 per RightCenter la posizione della legenda o Data value, percent of total per l'etichetta dati a torta. Le enumerazioni vengono in genere formattate come stringhe.

File JSON del tema del report di esempio

Di seguito è riportato il file St Patricks Day.json nel suo intero:

   {
       "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: nome del tema del report. Questo campo è l'unico campo obbligatorio.
• dataColors: elenco di codici esadecimali di colore da usare per i dati negli oggetti visivi di Power BI Desktop. Questo elenco può avere il numero di colori desiderato o il minor numero di colori desiderati.
• background, foregrounde tableAccent: classi Color. Le classi colore consentono di impostare molti colori strutturali nel report contemporaneamente.

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

Considerazioni e limitazioni

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

I temi predefiniti interessati da questa limitazione includono i temi seguenti:

• 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 di testo, è possibile usare in modo sicuro le altre schede della finestra di dialogo senza problemi. Tuttavia, se si desidera utilizzare le classi di testo con uno dei temi interessati, sono disponibili le opzioni seguenti:

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

Il testo nel report sarà diverso, ma sarà possibile accedere alla scheda testo nella finestra di dialogo tema.