Zdieľať cez

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

  • Článok

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 Nastavenia >Nastavenia> Nastavenia.

      Screenshot of the settings, settings, settings, menu option in Power B I service.

    3. Na karte Všeobecné vyberte položku Jazyk. V Nastavenia Jazyk vyberte jazyk, ktorý má služba Power BI používať, a potom vyberte položku Použiť.

      A screenshot showing the language settings in Power BI service.

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 nekalizovaný vlastný vizuál vytvorený pomocou pbiviz new príkazu zobrazí polia Category Data (Údaje kategórie) a Measure Data (Údaje mierky) na table vlastností.

A screenshot showing the category data and measure data fields in a newly created Power BI visual.

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:

A VS code screenshot of a visual project folder.The string resources folder has two sub folders, one for Arabic and one for Hebrew.

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ť.

A VS code screenshot of a visual project folder. Each sub-folder in the string resources folder has a resources dot resjson file.

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+

Ak chcete podporiť lokalizáciu 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)

Súvisiaci obsah

Pomôcky pre formátovanie

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