Čítať v angličtine

Zdieľať cez


Pridanie lokálneho jazyka do vizuálu služby Power BI

Power BI podporuje celý rad lokálnych jazykov. Jazyk miestnych nastavení služby Power BI môžete načítať a použiť ho na zobrazenie obsahu vo vizuáli.

Na nasledujúcich kartách sa zobrazujú príklady toho istého vizuálu s pruhovým grafom , ktorý zobrazuje obsah v rôznych jazykoch. Každý z týchto pruhových grafov bol vytvorený s použitím iného miestneho nastavenia (angličtina, baskičtina a hindčina), ktorý sa zobrazuje v popise.

Poznámka

  • Správca lokalizácie v kóde vizuálu je podporovaný od rozhrania API 1.10.0 a novších verzií.
  • Lokalizácia nie je podporovaná na ladenie vizuálu počas vývoja.

Pridanie lokálneho jazyka služby Power BI do vizuálu

Ak chcete do vizuálu pridať lokálny jazyk Power BI, postupujte podľa týchto krokov:

  1. Nastavte prostredie tak, aby zobrazoval jazyk, ktorý nie je angličtina.

  2. Získajte lokálny jazyk služby Power BI.

  3. Nastavenie zobrazovaných názvov vizuálov

  4. Vytvorte priečinok jazyka.

  5. Pridajte súbor prostriedkov pre každý jazyk.

  6. Vytvorte novú inštanciu parametra localizationManager.

  7. Zavolajte funkciu getDisplayName.

Krok 1 – Nastavte prostredie tak, aby zobrazoval jazyk, ktorý nie je angličtina

Ak chcete otestovať svoj vizuál, nastavte službu Power BI na jazyk, ktorý nie je angličtina. V tejto časti sa dozviete, ako zmeniť nastavenia aplikácie Power BI Desktop a služby služba Power BI tak, aby používali lokálny jazyk, ktorý nie je angličtina.

  • Power BI Desktop – stiahnite si lokalizovanú verziu aplikácie Power BI Desktop zo stránky https://powerbi.microsoft.com

  • služba Power BI – Ak používate služba Power BI (webový portál), zmeňte jazyk v nastaveniach:

    1. Prihláste sa do PowerBI.com.

    2. Prejdite do časti Nastavenia>Všeobecné.

      Snímka obrazovky znázorňujúca možnosť ponuky Nastavenia vo všeobecnosti v službe Power BI.

    3. Vyberte položku Výber jazyka zobrazenia a vyberte jazyk, ktorý má služba Power BI používať.

      Snímka obrazovky znázorňujúca nastavenia jazyka v službe Fabric. >

Krok 2 – Načítanie miestneho nastavenia jazyka Power BI

Lokálny jazyk služby Power BI sa odovzdáva ako reťazec nazývaný locale počas inicializácie vizuálu. Ak sa jazyk miestneho nastavenia zmení v službe Power BI, vizuál sa opäť vygeneruje v novom jazyku.

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

Poznámka

V aplikácii locale Power BI Desktop vlastnosť obsahuje jazyk nainštalovanej aplikácie Power BI Desktop.

Krok 3 – nastavte zobrazované názvy vizuálov

Každý vizuál zobrazuje informácie na table vlastností. Napríklad nekalkalizovaný vlastný vizuál vytvorený pomocou pbiviz new príkazu zobrazuje polia Kategória údajov a Údaje mierky na table vlastností.

Snímka obrazovky znázorňujúca údaje kategórie a údajové polia mierky v novovytvorenom vizuáli služby Power BI.

Polia zobrazenia tably vlastností sú definované v súbore capabilities.json . Každé pole zobrazenia je definované pomocou displayName vlastnosti. Pridajte hodnotu displayNameKey ku každému zobrazovanému názvu, ktorý chcete lokalizovať.

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

Krok 4 – Vytvorte priečinok jazyka

Ak chcete vytvárať lokalizované vizuály, projekt musí mať jazykový priečinok. V projekte vytvorte priečinok s názvom stringResources. Priečinok obsahuje jeden podpriečinok pre každý lokálny jazyk, ktorý má váš vizuál podporovať. Ak chcete napríklad podporovať arabčinu a hebrejčinu, pridajte dva priečinky nasledujúcim spôsobom:

Snímka obrazovky programu VS Code znázorňujúca priečinok projektu vizuálu. Priečinok prostriedkov reťazca má dva podpriečinky, jeden pre arabčinu a jeden pre hebrejčinu.

Krok 5 – Pridanie súboru prostriedkov pre každý jazyk

Pre každý jazyk, ktorý má váš vizuál podporovať, pridajte súbor resources.resjson JSON do príslušného podpriečinka stringResources . Tieto súbory obsahujú informácie o jazyku miestneho nastavenia a hodnoty lokalizovaného reťazca pre každý displayNameKey , ktorý chcete nahradiť.

Snímka obrazovky programu VS Code znázorňujúca priečinok projektu vizuálu. Každý podpriečinok v priečinku prostriedkov reťazca má súbor resources dot resjson.

Každý súbor JSON definuje jeden podporovaný jazyk miestneho nastavenia. Pridajte všetky lokalizované reťazce, ktoré budete používať, do každého súboru resources.resjson .

Príklady

  • resources.resjson súbor s ruskými reťazcami pre každú displayNameKey.

    {
        ...
        "Role_Legend": "Обозначения",
        "Role_task": "Задача",
        "Role_StartDate": "Дата начала",
        "Role_Duration": "Длительность"
        ...
    }
    
  • súbor resources.resjson so hebrejskymi reťazcami pre každú displayNameKeyentitu .

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

Krok 6 – Vytvorte novú inštanciu parametra localizationManager

Vytvorte novú localizationManager inštanciu v kóde vizuálu.

private localizationManager: ILocalizationManager;

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

Krok 7 – zavolajte funkciu getDisplayName

Po vytvorení novej localizationManager inštancie môžete zavolať funkciu správcu getDisplayName lokalizácie s argumentom kľúča reťazca, ktorý ste definovali v súbore resources.resjson.

Nasledujúci kód napríklad vráti legendu pre en-US a Обознаниз for ru-RU.

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

Lokalizácia tably Formát a tably analýzy

Poznámka

Relevantné pre rozhranie API verzie 5.1+

Na podporu lokalizácie na table formátu a súčasti tably analýzy nastavte lokalizovaný reťazec takto:

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

Informácie o lokalizácii modelu formátovania nájdete v téme Lokalizácia tably formátu.
Informácie o lokalizácii pomôcok formátovania modelu nájdete v téme Pomôcky formátovania modelu – lokalizácia.

Podporované jazyky

Nasledujúca tabuľka obsahuje zoznam všetkých jazykov podporovaných v službe Power BI a reťazec, ktorý locale premenná vráti pre každý z nich.

Reťazec miestneho nastavenia Jazyk
ar-SA الرية (arabčina)
bg-BG блгарски (bulharčina)
ca-ES català (katalánčina)
cs-CZ čeština
da-DK dansk (dánčina)
de-DE Deutsch (nemčina)
el-GR ελληνικά (gréčtina)
sk-SK Angličtina (angličtina)
es-ES español (španielčina)
et-EE eesti (estónčina)
eU-ES Euskal (baskičtina)
fi-FI suomi (fínčina)
fr-FR français (francúzština)
gl-ES galego (galícijčina)
he-IL רי (hebrejčina)
hi-IN (hindčina)
hr-HR hrvatski (chorvátčina)
hu – HU magyar (maďarčina)
id-ID Bahasa Indonesia (indonézština)
it-IT italiano (taliančina)
sk-SK 日のの (japončina)
kk-KZ аза (kazaština)
ko-KR (kórejčina)
lt-LT Lietuvos (litovčina)
lv-LV Latvijas (lotyština)
ms-MY Bahasa Melayu (Malajčina)
nb-NO norsk (nórčina)
nl-NL Nederlands (holandčina)
pl-PL polski (poľština)
pt-BR português (portugalčina)
pt-PT português (portugalčina)
ro-RO românesc (rumunčina)
ru-RU Русский (ruština)
sk-SK slovenčina
sl-SI slovenski (slovinčina)
sr-Cyrl-RS српски (srbčina)
sr-Latn-RS srpski (srbčina)
sv-SE svenska (švédčina)
th-TH ไทย (thajčina)
tr-TR Türk (turečtina)
uk-UA український (ukrajinčina)
vi-VN ting Vit (vietnamčina)
zh-CN 中国 (zjednodušená čínština)
zh-TW 中國 (tranditionalčina čínština)

Pomôcky pre formátovanie

Máte nejaké otázky? Spýtajte sa komunity Power BI