Поделиться через

Добавление локального языка в визуальный элемент Power BI

  • Статья

Power BI поддерживает ряд локальных языков. Вы можете получить язык языкового стандарта Power BI и использовать его для отображения содержимого в визуальном элементе.

На следующих вкладках показаны примеры одного и того же визуального элемента линейчатой диаграммы , отображающего содержимое на разных языках. Каждая из этих линейчатых диаграмм была создана с помощью другого языка языкового стандарта (английский, Баск и Хинди), который отображается в подсказке.

Примечание.

  • Диспетчер локализации в коде визуального элемента поддерживается из API 1.10.0 и более поздних версий.
  • Локализация не поддерживается для отладки визуального элемента во время разработки.

Добавление локального языка Power BI в визуальный элемент

Чтобы добавить локальный язык Power BI в визуальный элемент, выполните следующие действия:

  1. Настройте среду для отображения языка, который не является английским.

  2. Получите локальный язык Power BI.

  3. Настройка визуальных отображаемых имен

  4. Создайте языковую папку.

  5. Добавьте файл ресурсов для каждого языка.

  6. Создайте экземпляр localizationManager.

  7. Вызовите функцию getDisplayName.

Шаг 1. Настройка среды для отображения языка, который не является английским

Чтобы протестировать визуальный элемент, установите Power BI на язык, который не является английским. В этом разделе показано, как изменить параметры Power BI Desktop и служба Power BI, чтобы они использовали локальный язык, который не является английским.

  • Power BI Desktop— скачивание локализованной версии Power BI Desktop из https://powerbi.microsoft.com

  • служба Power BI. Если вы используете служба Power BI (веб-портал), измените язык в параметрах:

    1. Войдите в PowerBI.com.

    2. Перейдите к Параметры> Параметры> Параметры.

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

    3. На вкладке "Общие " выберите язык. В Параметры языка выберите нужный язык Power BI и нажмите кнопку "Применить".

      A screenshot showing the language settings in Power BI service.

Шаг 2. Получение языкового стандарта Power BI

Локальный язык Power BI передается в виде строки, вызываемой locale во время инициализации визуального элемента. Если язык языкового стандарта изменяется в Power BI, визуальный элемент создается снова на новом языке.

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

Примечание.

В Power BI Desktop свойство содержит язык установленного Power BI Desktop locale .

Шаг 3. Настройка отображаемых визуальных имен

Каждый визуальный элемент отображает сведения в области свойств. Например, нелокализованный пользовательский визуальный элемент, созданный с помощью pbiviz new команды, будет отображать поля "Данные категории" и "Измерять данные" в области свойств.

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

Поля отображения области свойств определяются в файле capabilities.json . Каждое поле отображения определяется с помощью displayName свойства. Добавьте каждое displayNameKey отображаемое имя, которое необходимо локализовать.

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

Шаг 4. Создание языковой папки

Чтобы создать локализованные визуальные элементы, проект должен иметь языковую папку. В проекте создайте папку с именем stringResources. Папка содержит одну вложенную папку для каждого локального языка, который будет поддерживаться визуальным элементом. Например, чтобы поддерживать арабский и иврит, добавьте две папки следующим образом:

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

Шаг 5. Добавление файла ресурсов для каждого языка

Для каждого языка, которого вы хотите поддерживать визуальный элемент, добавьте JSON-файл resources.resjson в соответствующую под папку stringResources . Эти файлы содержат языковые сведения о языковом стандарте и локализованные строковые значения для каждого displayNameKey из них, который требуется заменить.

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

Каждый JSON-файл определяет один поддерживаемый язык языкового стандарта. Добавьте все строки локализации, которые вы будете использовать в каждом файле resources.resjson .

Примеры

  • resources.resjson-файл с российскими строками для каждогоdisplayNameKey.

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

  • resources.resjson-файл со строками иврита для каждого displayNameKey.

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

Шаг 6. Создание нового экземпляра localizationManager

Создайте новый localizationManager экземпляр в коде визуального элемента.

private localizationManager: ILocalizationManager;

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

Шаг 7. Вызов функции getDisplayName

После создания нового localizationManager экземпляра можно вызвать функцию диспетчера getDisplayName локализации с аргументом ключа строки, определенным в resources.resjson.

Например, следующий код возвращает условные обозначения для en-US и Обозначения для ru-RU.

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

Локализация области форматирования и аналитики

Примечание.

Относится к API версии 5.1+

Чтобы поддерживать локализацию компонентов области форматирования и области аналитики, задайте локализованную строку следующим образом:

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

Локализация модели форматирования см. в разделе локализации области форматирования.
Для локализации используемых моделей форматирования см. utils модели форматирования — локализация.

Поддерживаемые языки

В следующей таблице содержится список всех языков, поддерживаемых в Power BI, и строка, возвращаемая locale переменной для каждой из них.

Строка языкового стандарта Язык
ar-SA ة (арабский)
bg-BG бллгарски (болгарский)
ca-ES català (каталонский)
cs-CZ čeština (Чехия)
da-DK dansk (датский)
de-DE Deutsche (немецкий)
el-GR λλ (греческий)
en-US Английский (английский)
es-ES español service (испанский)
et-EE eesti (Эстония)
eU-ES Эускал (Баск)
fi-FI suomi (финский)
fr-FR français (французский)
gl-ES galego (Галицин)
he-IL ערת (иврит)
hi-IN हिन्दी (Хинди)
hr-HR hrvatski (хорватский)
hu-HU magyar (венгерский)
id-ID Бахасса Индонезия (индонезийский)
it-IT italiano (итальянский)
ja-JP 日本の (японский)
kk-KZ ҚАзак (казах)
ko-KR 한국의 (корейский)
lt-LT Литувос (Литовец)
lv-LV Latvijas (латышский)
ms-MY Бахаса Мелайу (Малайя)
nb-NO norsk (норвежский)
nl-NL Nederlands (голландский)
pl-PL polski (польский)
pt-BR português (португальский)
pt-PT português (португальский)
ro-RO românesc (румынский)
ru-RU русский (русский)
sk-SK slovenský (словацкий)
sl-SI slovenski (Словенский)
sr-Cyrl-RS српски (сербский)
sr-Latn-RS srpski (сербский)
sv-SE svenska (шведский)
th-TH ไทย (Тайский)
tr-TR Türk (турецкий)
uk-UA укранськи (украинский)
vi-VN tiếng Việt (Вьетнамский)
zh-CN 中国 (китайский-упрощенный)
zh-TW 中國 (китайский-Tranditional)

Связанный контент

Форматирование используемых элементов

Вопросы? Спросите сообщество Power BI