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.

Un nome delle impostazioni cultura è in genere costituito da un identificatore lingua minuscolo e da un identificatore delle impostazioni locali maiuscolo separati da un segno meno. Il nome delle impostazioni cultura en-US identifica un utente negli Stati Uniti che 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 cultura 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 la traduzione dei metadati, elencare i nomi delle impostazioni cultura che si prevede di supportare. Quindi, ampliare il modello semantico aggiungendo le traduzioni dei metadati per ogni nome delle impostazioni cultura.

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

Ogni traduzione dei metadati è associata a un nome delle impostazioni cultura specifico. I nomi delle impostazioni cultura fungono da chiavi di ricerca che vengono 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. Considerare che i nomi degli oggetti del modello semantico fungono da gruppo 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.

Caricare un report in Power BI

Quando un utente passa a un report di Power BI con una richiesta HTTP GET, il browser trasmette un'intestazione HTTP denominata Accept-Language con un valore impostato su un nome delle impostazioni cultura valido. Lo screenshot seguente mostra una richiesta GET che trasmette un valore di intestazione Accept-Language di 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 propri dispositivi gli utenti possono controllare il nome delle impostazioni cultura passato 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.

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 pubblicano un modello semantico con lingua predefinita en-US e traduzioni dei metadati per altri tre nomi delle impostazioni cultura, tra cui 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-Language fr-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 delle impostazioni cultura di fr-CA, i nomi delle misure vengono caricati usando 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 esegue il fallback al 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.

È consigliabile aggiungere la traduzione dei metadati per qualsiasi nome delle impostazioni cultura da supportare. In questo esempio aggiungere tre insiemi di traduzioni in francese per supportare i nomi delle impostazioni cultura 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.

Implementare le traduzioni usando 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 cultura del contesto di caricamento del report corrente. 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 chiama la funzione USERCULTURE nell'espressione DAX per una tabella o una colonna calcolata, viene restituito il nome delle impostazioni cultura della lingua predefinita del modello semantico. La chiamata di USERCULTURE in una misura restituisce il nome delle impostazioni cultura per l'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 altre informazioni, vedere Informazioni sui dati principali di DAX in Power BI Desktop.

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

È possibile tradurre in modo dinamico scrivendo un'espressione DAX in una misura con logica condizionale in base al nome delle impostazioni cultura 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