Aggiungere la lingua locale all'oggetto visivo di Power BI

Power BI supporta una gamma di lingue locali. È possibile recuperare il linguaggio delle impostazioni locali di Power BI e usarlo per visualizzare il contenuto nell'oggetto visivo.

Le schede seguenti mostrano esempi dello stesso oggetto visivo grafico a barre di esempio che visualizza il contenuto in lingue diverse. Ognuno di questi grafici a barre è stato creato usando una lingua delle impostazioni locali diversa (inglese, basco e hindi) che viene visualizzata nella descrizione comando.

Grafico a barre in inglese

Grafico a barre basco

Grafico a barre hindi

Nota

• Il gestore di localizzazione nel codice dell'oggetto visivo è supportato dall'API 1.10.0 e versioni successive.
• La localizzazione non è supportata per il debug dell'oggetto visivo durante lo sviluppo.

Come aggiungere il linguaggio locale di Power BI all'oggetto visivo

Per aggiungere il linguaggio locale di Power BI all'oggetto visivo, seguire questa procedura:

1. Configurare l'ambiente per visualizzare una lingua che non è l'inglese.

2. Ottenere la lingua locale di Power BI.

3. Impostare i nomi visualizzati degli oggetti visivi

4. Creare una cartella della lingua.

5. Aggiungere un file di risorse per ogni lingua.

6. Creare una nuova istanza di localizationManager.

7. Chiamare la funzione getDisplayName.

Passaggio 1- Configurare l'ambiente per visualizzare una lingua che non è l'inglese

Per testare l'oggetto visivo, impostare Power BI su una lingua non inglese. Questa sezione illustra come modificare le impostazioni di Power BI Desktop e servizio Power BI, in modo che usino una lingua locale che non sia l'inglese.

• Power BI Desktop - Scaricare la versione localizzata di Power BI Desktop da https://powerbi.microsoft.com

• servizio Power BI : se si usa servizio Power BI (portale Web), modificare la lingua nelle impostazioni:

  1. Accedere a PowerBI.com.

  2. Passare a Impostazioni> Impostazioni> Impostazioni.

     

  3. Nella scheda Generale selezionare Lingua. Nella Impostazioni Lingua selezionare la lingua da usare in Power BI e quindi selezionare Applica.

     

Passaggio 2: Ottenere la lingua locale di Power BI

Il linguaggio locale di Power BI viene passato come stringa chiamata locale durante l'inizializzazione dell'oggetto visivo. Se una lingua delle impostazioni locali viene modificata in Power BI, l'oggetto visivo viene generato nuovamente nel nuovo linguaggio.

private locale: string;
...
this.locale = options.host.locale;

Nota

In Power BI Desktop la locale proprietà contiene la lingua di Power BI Desktop installata.

Passaggio 3- Impostare i nomi visualizzati degli oggetti visivi

Ogni oggetto visivo visualizza le informazioni nel riquadro delle proprietà. Ad esempio, un oggetto visivo personalizzato non localizzato creato tramite il pbiviz new comando mostra i campi Dati categoria e Dati misura nel riquadro delle proprietà.

I campi di visualizzazione del riquadro delle proprietà sono definiti nel file capabilities.json . Ogni campo di visualizzazione viene definito usando una displayName proprietà . Aggiungere un displayNameKey oggetto a ogni nome visualizzato che si desidera localizzare.

{
    "dataRoles": [
        {
            "displayName": "Category Data",
            "displayNameKey": "VisualCategoryDataNameKey1",
            "name": "category",
            "kind": "Grouping"
        },
        {
            "displayName": "Measure Data",
            "displayNameKey": "VisualMeasureDataNameKey2",
            "name": "measure",
            "kind": "Measure"
        }
    ]
}

Passaggio 4 - Creare una cartella della lingua

Per creare oggetti visivi localizzati, il progetto deve avere una cartella del linguaggio. Nel progetto creare una cartella denominata stringResources. La cartella contiene una sottocartella per ogni lingua locale che si vuole che l'oggetto visivo supporti. Ad esempio, per supportare l'arabo e l'ebraico, aggiungere due cartelle nel modo seguente:

Passaggio 5- Aggiungere un file di risorse per ogni lingua

Per ogni linguaggio che si vuole supportare l'oggetto visivo, aggiungere un file JSON resources.resjson nella sottocartella stringResources appropriata. Questi file contengono le informazioni sulla lingua delle impostazioni locali e i valori di stringa localizzati per ogni displayNameKey elemento che si desidera sostituire.

Ogni file JSON definisce un singolo linguaggio delle impostazioni locali supportato. Aggiungere tutte le stringhe di localizzazione che verranno usate in ogni file resources.resjson .

Esempi

• file resources.resjson con stringhe russe per ogni displayNameKey.

  {
      ...
      "Role_Legend": "Обозначения",
      "Role_task": "Задача",
      "Role_StartDate": "Дата начала",
      "Role_Duration": "Длительность"
      ...
  }
  

• file resources.resjson con stringhe in ebraico per ogni displayNameKeyoggetto .

  {
      ...
      "Role_Legend": "מקרא",
      "Role_task": "משימה",
      "Role_StartDate": "תאריך התחלה",
      "Role_Duration": "משך זמן"
      ...
  }
  

Passaggio 6- Creare una nuova istanza di localizationManager

Creare una nuova localizationManager istanza nel codice dell'oggetto visivo.

private localizationManager: ILocalizationManager;

constructor(options: VisualConstructorOptions) {
    this.localizationManager = options.host.createLocalizationManager();
}

Passaggio 7: Chiamare la funzione getDisplayName

Dopo aver creato una nuova localizationManager istanza, è possibile chiamare la funzione del getDisplayName gestore di localizzazione con l'argomento chiave stringa definito in resources.resjson.

Ad esempio, il codice seguente restituisce Legenda per en-US e Обозначения per ru-RU.

let legend: string = this.localization.getDisplayName("Role_Legend");

Localizzazione del riquadro di formattazione e del riquadro di analisi

Nota

Rilevante per l'API versione 5.1+

Per supportare la localizzazione nei componenti del riquadro di formato e del riquadro di analisi, impostare la stringa localizzata come segue:

displayName: this.localization.getDisplayName("Font_Color_DisplayNameKey");
description: this.localization.getDisplayName("Font_Color_DescriptionKey");

Per localizzare il modello di formattazione, vedere Localizzazione del riquadro di formato.
Per localizzare le utilità del modello di formattazione, vedere Formattazione delle utilità del modello - localizzazione.

Lingue supportate

La tabella seguente contiene un elenco di tutte le lingue supportate in Power BI e la stringa restituita dalla locale variabile per ogni linguaggio.

Stringa delle impostazioni locali	Lingua
ar-SA	الاللا
bg-BG	български (bulgaro)
ca-ES	català (catalano)
cs-CZ	čeština (Ceco)
da-DK	dansk (danese)
de-DE	Deutsche (tedesco)
el-GR	ελιηνιιπ (greco)
it-IT	Inglese (inglese)
es-ES	servizio español (spagnolo)
et-EE	eesti (estone)
eU-ES	Euskal (basco)
fi-FI	suomi (finlandese)
fr-FR	français (francese)
gl-ES	galego (Gallego)
he-IL	עוויו (ebraico)
hi-IN	हिन्दी (Hindi)
hr-HR	hrvazki (croato)
hu-HU	magyar (ungherese)
id-ID	Bahasa Indonesia (indonesiano)
it-IT	italiano (italiano)
ja-JP	のの (giapponese)
kk-KZ	Қазақ (Kazakh)
ko-KR	한국의 (coreano)
lt-LT	Lietuvos (lituano)
lv-LV	Latvijas (lettone)
ms-MY	Bahasa Melayu (Malese)
nb-NO	norsk (norvegese)
nl-NL	): (olandese)
pl-PL	polski (polacco)
pt-BR	português (portoghese)
pt-PT	português (portoghese)
ro-RO	românesc (romeno)
ru-RU	русский (russo)
sk-SK	slovenský (slovacco)
sl-SI	slovenski (sloveno)
sr-Cyrl-RS	српски (serbo)
sr-Latn-RS	srpski (serbo)
sv-SE	svenska (svedese)
th-TH	ไทย (Thai)
tr-TR	Türk (turco)
uk-UA	український (ucraino)
vi-VN	tiêng Viêt (vietnamita)
zh-CN	中国 (cinese semplificato)
zh-TW	中國 (Cinese-Tranditional)

Contenuto correlato

Formattazione delle utilità

Domande? Chiedere alla community di Power BI