Aggiungere una lingua a un report in Translations Builder

Quando si apre per la prima volta un progetto con estensione .pbix in Translations Builder, nella griglia di conversione viene visualizzata una riga per ogni tabella, misura e colonna visibili nel modello di dati sottostante del progetto. La griglia di conversione non visualizza righe per gli oggetti modello di dati che sono nascosti nel modello di dati dalla visualizzazione report. Gli oggetti nascosti non vengono visualizzati in un report e non richiedono traduzioni.

Lo screenshot seguente mostra il punto di partenza per un modello di dati semplice prima che venga modificato per supportare le lingue secondarie.

Se si esamina la griglia di traduzione per questo progetto con estensione .pbix, è possibile visualizzare le prime tre colonne contenenti colonne di sola lettura usate per identificare ogni traduzione dei metadati. Ogni conversione dei metadati ha un tipo di oggetto, una proprietà e un nome. Le traduzioni per la proprietà Didascalia vengono sempre utilizzate. Se necessario, è possibile aggiungere traduzioni per le proprietà Description e DisplayFolder.

La quarta colonna nella griglia di traduzione visualizza sempre le traduzioni per la lingua e le impostazioni locali predefinite del modello di dati, che in questo caso è English [en-US].

Aggiungere lingue

Translations Builder offre un'opzione Aggiungi lingua per aggiungere lingue secondarie al modello di dati del progetto.

Translations Builder non aggiunge traduzioni di metadati per una lingua specifica. Aggiunge invece traduzioni di metadati per un nome delle impostazioni cultura che identifica sia una lingua che le impostazioni locali. Per ulteriori informazioni, vedere Uso dei valori delle impostazioni locali nei report in più lingue di Power BI.

Translations Builder astrae le differenze tra una lingua e un nome delle impostazioni cultura per semplificare l'esperienza utente. Gli autori di contenuti possono pensare in termini di lingue anziché nomi di impostazioni cultura.

Per aggiungere una o più lingue secondarie, seguire questa procedura.

1. Selezionare Aggiungi lingua per visualizzare la finestra di dialogo Aggiungi lingua.

2. Selezionare una lingua nell'elenco o usare CTRL per selezionare più lingue.

3. Selezionare Aggiungi lingua.

   

   La lingua o le lingue aggiunte vengono ora visualizzate nell'elenco Lingue secondarie.

   

4. In Power BI Desktop, selezionare Salva.

   

   Importante

   Translations Builder può modificare il modello di dati caricato in memoria, ma non può salvare le modifiche in memoria nel file con estensione .pbix sottostante. Tornare sempre a Power BI Desktop e selezionare il comando Salva dopo aver aggiunto, creato o aggiornato le traduzioni.

L'aggiunta di una nuova lingua aggiunge una nuova colonna di celle modificabili alla griglia delle traduzioni.

Se gli autori di contenuti parlano tutte le lingue coinvolte, possono aggiungere e aggiornare traduzioni per le lingue secondarie direttamente nella griglia di traduzione con un'esperienza di modifica simile a Excel.

Testare le traduzioni nel servizio Power BI

Non è possibile verificare il lavoro in più lingue in Power BI Desktop. È invece necessario testare il lavoro nel servizio Power BI in un'area di lavoro associata a una capacità Premium. Dopo aver aggiunto il supporto per la traduzione con Translations Builder, seguire questa procedura:

1. In Power BI Desktop, salvare le modifiche apportate al file con estensione .pbix sottostante.

2. Nella scheda Home della barra multifunzione selezionare Pubblica.

   

3. Nella finestra di dialogo Pubblica in Power BI, evidenziare un'area di lavoro e quindi Seleziona.

4. Al termine della pubblicazione, selezionare il collegamento per aprire il progetto nel servizio Power BI.

Dopo il caricamento del report con la lingua predefinita, selezionare la barra degli indirizzi del browser e aggiungere il parametro lingua seguente all'URL del report.

?language=es-ES

Quando si aggiunge il parametro lingua alla fine dell'URL del report, assegnare un valore che corrisponda a un nome di impostazioni cultura valido. Dopo aver aggiunto il parametro lingua e aver premuto INVIO, è possibile verificare che il parametro sia stato accettato dal browser durante il ricaricamento del report.

Se si dimentica di aggiungere il punto interrogativo (?) o se non si formatta correttamente il parametro lingua, il browser rifiuta il parametro e lo rimuove dall'URL. Dopo aver caricato correttamente un report usando il valore del parametro lingua di es-ES, si noterà che l'esperienza utente per l'intera interfaccia utente del servizio Power BI passa dall'inglese allo spagnolo.

Il report visualizza anche le traduzioni in spagnolo per i nomi delle colonne e delle misure.

Implementare un flusso di lavoro a più lingue

Dopo aver testato il lavoro e verificato che le traduzioni funzionino correttamente, è possibile archiviare il file con estensione .pbix in un sistema di controllo del codice sorgente, ad esempio GitHub o Azure Repos. Questo approccio può far parte di una strategia di gestione del ciclo di vita delle applicazioni (ALM) in cui il supporto per le lingue secondarie e le traduzioni si evolve nel tempo.

Quando si inizia a lavorare con le lingue secondarie e le traduzioni per localizzare un progetto con estensione .pbix, seguire lo stesso set di passaggi:

1. Apportare modifiche in Power BI Desktop.
2. Pubblicare il progetto con estensione .pbix nel servizio Power BI.
3. Testare l'uso di un browser nel servizio Power BI usando il parametro lingua.
4. Ripetere questi passaggi fino a completare tutte le traduzioni.

Incorporare report di Power BI usando una lingua e impostazioni locali specifiche

Se si sviluppa con l'incorporamento di Power BI, è possibile usare l'API JavaScript di Power BI per caricare i report con una lingua e impostazioni locali specifiche. Questa attività viene eseguita estendendo l'oggetto config passato a powerbi.embed con un oggetto localeSettings che contiene una proprietà language, come illustrato nel codice seguente.

let config = {
  type: "report",
  id: reportId,
  embedUrl: embedUrl,
  accessToken: embedToken,
  tokenType: models.TokenType.Embed,
  localeSettings: { language: "de-DE" }
};

let report = powerbi.embed(reportContainer, config);

Contenuto correlato

• Aggiungere una tabella Etichette localizzate a un report di Power BI