Usare valori delle impostazioni locali nei report in più lingue di Power BI

Ogni report caricato nel servizio Power BI viene inizializzato con un contesto utente che identifica una lingua e un'area geografica, note come impostazioni locali. Nella maggior parte dei casi le impostazioni locali identificano un paese/area geografica. Il servizio Power BI tiene traccia della combinazione della lingua e delle impostazioni locali dell'utente usando un nome delle impostazioni cultura.

Il nome di una lingua/cultura è in genere costituito da un identificatore di lingua in minuscolo e da un identificatore delle impostazioni locali in maiuscolo, separati da un trattino. Il nome delle impostazioni locali en-US identifica un utente che si trova negli Stati Uniti e parla inglese. Un nome delle impostazioni cultura es-ES identifica un utente in Spagna che parla spagnolo. Un nome delle impostazioni cultura fr-FR identifica un utente in Francia che parla francese. Un nome delle impostazioni locali de-DE identifica un utente in Germania che parla tedesco.

Per un elenco dei valori dei nomi delle impostazioni cultura, vedere Codici lingua ISO 639 e Piattaforma di esplorazione online.

Organizzare un progetto per la traduzione dei metadati

All'inizio di un progetto che prevede la creazione di un nuovo modello semantico di Power BI con traduzione dei metadati, elenca i nomi delle impostazioni cultura che intendi supportare. Successivamente, estendi il modello semantico aggiungendo le traduzioni dei metadati per ogni nome di impostazioni locali.

Il diagramma seguente mostra un modello semantico con la lingua predefinita impostata su en-US. Il modello semantico è stato esteso con traduzioni dei metadati per altri tre nomi di lingua e impostazioni locali: es-ES, fr-FR e de-DE.

Ogni traduzione dei metadati è associata a un nome di cultura specifico. I nomi delle impostazioni locali fungono da chiavi di ricerca usate per aggiungere e recuperare le traduzioni dei metadati nel contesto di un modello semantico di Power BI.

Non è necessario fornire le traduzioni dei metadati per la lingua predefinita del modello semantico. Power BI può usare i nomi degli oggetti del modello semantico solo direttamente per il nome delle impostazioni cultura in oggetto. Un modo di considerare questo aspetto è che i nomi degli oggetti del modello semantico fungono da set virtuale di traduzioni dei metadati per la lingua predefinita.

È possibile aggiungere in modo esplicito la traduzione dei metadati per la lingua predefinita. Usare questo approccio con moderazione. Power BI Desktop non supporta il caricamento delle traduzioni dei metadati nella propria progettazione report. Al contrario, Power BI Desktop carica solo i nomi degli oggetti del modello semantico. Se si aggiungono in modo esplicito le traduzioni dei metadati per la lingua predefinita, i report di Power BI hanno un aspetto diverso in Power BI Desktop rispetto al servizio Power BI.

Carica un report in Power BI

Quando un utente accede a un report di Power BI tramite una richiesta HTTP GET, il browser trasmette un'intestazione HTTP denominata Accept-Language il cui valore è impostato su un nome di impostazioni cultura valido. La schermata seguente mostra una richiesta GET che trasmette un valore dell'intestazione Accept-Language pari a en-US.

Quando il servizio Power BI carica un report, legge il nome delle impostazioni cultura passato nell'intestazione Accept-Language e lo usa per inizializzare la lingua e le impostazioni locali del contesto di caricamento del report. Nei loro dispositivi, gli utenti possono controllare quale nome delle impostazioni locali viene trasmesso nel valore dell'intestazione Accept-Language configurando le impostazioni regionali.

Quando si apre un report di Power BI nel servizio Power BI, è possibile eseguire l'override del valore dell'intestazione Accept-Language aggiungendo il parametro language alla fine dell'URL del report e impostandone il valore su un nome delle impostazioni cultura valido. Ad esempio, è possibile testare il caricamento di un report per un utente in Canada che parla francese impostando il valore del parametro language su fr-CA.

Le impostazioni locali non sono supportate nelle app per dispositivi mobili Power BI

L'override del language parametro non è supportato nelle app per dispositivi mobili Power BI. Quando si apre un report in un'app per dispositivi mobili, l'app usa le impostazioni locali correnti del dispositivo. Non è possibile aggiungere un parametro di query language a un deep link per dispositivi mobili e pensare che l'app carichi il report in quella lingua. Per cambiare le impostazioni locali usate in un'app per dispositivi mobili, modifica le impostazioni regionali sul dispositivo.

Supportare più impostazioni locali per una singola lingua

Potrebbe essere necessario supportare più impostazioni locali per una singola lingua parlata. Considerare uno scenario con utenti che parlano francese ma vivono in paesi diversi, ad esempio Francia, Belgio e Canada. Si pubblica un modello semantico con una lingua predefinita di en-US e traduzioni dei metadati per altri tre nomi di impostazioni locali, inclusi es-ES, fr-FR e de-DE.

Cosa accade quando un utente canadese di lingua francese apre un report con un valore dell'intestazione Accept-Languagefr-CA? Il servizio Power BI carica le traduzioni per il francese (fr-FR) o esegue il fallback sui nomi degli oggetti del modello semantico inglese?

Attualmente le misure agiscono in modo diverso rispetto alle tabelle e alle colonne di Power BI. Con le misure, il servizio Power BI tenta di trovare la corrispondenza più vicina. Per il nome della lingua e delle impostazioni locali di fr-CA, i nomi delle misure verrebbero caricati utilizzando le traduzioni dei metadati per fr-FR.

Con tabelle e colonne, il servizio Power BI richiede una corrispondenza esatta tra il nome delle impostazioni cultura nella richiesta e le traduzioni dei metadati supportate. Se non esiste una corrispondenza esatta, il servizio Power BI ripiega sul caricamento dei nomi degli oggetti del modello semantico. In questo scenario i nomi delle tabelle e delle colonne vengono caricati usando i nomi degli oggetti del modello semantico inglese.

Si consiglia di aggiungere la traduzione dei metadati per qualsiasi nome di impostazioni locali che si desidera supportare. In questo esempio, aggiungi tre set di traduzioni in francese per supportare i nomi delle impostazioni locali di fr-FR, fr-BE e fr-CA. Questo approccio gestisce lo scenario in cui le traduzioni in francese per gli utenti in Francia sono diverse dalle traduzioni in francese per gli utenti in Canada.

Implementa le traduzioni utilizzando le misure e USERCULTURE

Un'altra funzionalità di Power BI che consente di creare report in più lingue è la funzione Data Analysis Expressions (DAX) USERCULTURE. Quando viene chiamata all'interno di una misura, la funzione USERCULTURE restituisce il nome delle impostazioni locali del contesto corrente di caricamento del report. Questo approccio consente di scrivere la logica DAX in misure che implementano le traduzioni in modo dinamico.

È possibile implementare le traduzioni in modo dinamico chiamando USERCULTURE in una misura, ma non è possibile ottenere lo stesso risultato con tabelle o colonne calcolate. Le espressioni DAX per le tabelle e le colonne calcolate vengono valutate in fase di caricamento del modello semantico. Se si richiama la funzione USERCULTURE nell'espressione DAX per una tabella calcolata o una colonna calcolata, viene restituito il nome delle impostazioni locali della lingua predefinita del modello semantico. La chiamata a USERCULTURE all'interno di una misura restituisce il nome delle impostazioni locali dell'utente corrente.

Nel report di esempio viene visualizzato il valore restituito USERCULTURE nell'angolo in alto a destra del banner del report. In genere non viene visualizzato un elemento del report come questo in un'applicazione reale.

Questo codice è un semplice esempio di scrittura di un'espressione DAX per una misura che implementa traduzioni dinamiche. È possibile usare un'istruzione SWITCH che chiama USERCULTURE per formare un criterio di base per l'implementazione delle traduzioni dinamiche.

Product Sales Report Label = SWITCH( USERCULTURE() ),
  "es-ES", "Informe De Ventas De Productos",
  "fr-FR", "Rapport Sur Les Ventes De Produits",
  "fr-BE", "Rapport Sur Les Ventes De Produits",
  "fr-CA", "Rapport Sur Les Ventes De Produits",
  "de-DE", "Produktverkaufsbericht",
  "Product Sales Report"
)

Per ulteriori informazioni, vedere Informazioni di base su DAX in Power BI Desktop.

Formattare date e numeri con le impostazioni locali dell'utente corrente

È possibile tradurre dinamicamente scrivendo un'espressione DAX all'interno di una misura con logica condizionale basata sul nome delle impostazioni locali dell'utente. Nella maggior parte dei casi, non è necessario scrivere la logica DAX condizionale in base alle impostazioni locali dell'utente perché gli oggetti visivi di Power BI gestiscono automaticamente la formattazione specifica delle impostazioni locali dietro le quinte.

In uno scenario semplice si compila un report per un gruppo di destinatari composto da specifici utenti che vivono sia a New York (en-US) che a Londra (en-GB). Tutti gli utenti parlano inglese (en), ma alcuni vivono in aree diverse (US e GB) in cui le date e i numeri vengono formattati in modo diverso. Ad esempio, un utente di New York vuole visualizzare le date nel formato mm/dd/yyyy, mentre un utente di Londra vuole visualizzare le date nel formato dd/mm/yyyy.

Tutto funziona nel modo previsto se si configurano le colonne e le misure usando stringhe di formato che supportano la formattazione in base all'area geografica. Per formattare una data, è consigliabile usare una stringa di formato del tipo Data breve o Data estesa perché supportano la formattazione in base all'area geografica.

Ecco alcuni esempi di come viene visualizzato un valore di data formattato con Data breve quando viene caricato in impostazioni locali diverse.

Contenuto correlato

• Creare report in più lingue con Translations Builder