次の方法で共有

Power BI 視覚化にローカル言語を追加する

  • [アーティクル]

Power BI は、さまざまなローカル言語をサポートしています。 Power BI ロケール言語を取得し、それを使用してビジュアルでコンテンツを表示できます。

次のタブは、異なる言語でコンテンツを表示する同じ "サンプル横棒グラフ" の視覚化の例を示しています。 これらの各横棒グラフは、ツールヒントに表示されているさまざまなロケール言語 (英語、バスク語、ヒンディー語) を使用して作成されました。

Note

  • ビジュアルのコードのローカライズ マネージャーは、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 - https://powerbi.microsoft.comからローカライズされたバージョンの Power BI Desktop をダウンロードする

  • Power BI サービス - Power BI サービス (Web ポータル) を使用している場合は、設定内の言語を変更します。

    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;

Note

Power BI Desktop では、locale プロパティには、インストールされている Power BI Desktop の言語が含まれています。

手順 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 という名前のフォルダーを作成します。 このフォルダーには、ビジュアルでサポートするローカル言語ごとに 1 つのサブ フォルダーが含まれています。 たとえば、アラビア語とヘブライ語をサポートするには、次の方法で 2 つのフォルダーを追加します。

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 - 各言語のリソース ファイルを追加する

視覚化でサポートしたい言語ごとに、対応する stringResources サブフォルダー内に resources.resjson JSON ファイルを追加します。 これらのファイルには、そのロケール言語の情報と、置き換えるすべての 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 ファイルで 1 つのサポートされるロケール言語を定義します。 使用しようとしているすべてのローカライズ文字列を各 resources.resjson ファイルに追加します。

例

  • 各 displayNameKey に対応する "ロシア語" の文字列を含む resources.resjson ファイル。

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

  • 各 displayNameKey に対応する "ヘブライ語" の文字列を含む resources.resjson ファイル。

    {
    ...
    "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 インスタンスを作成したら、resources.resjson で定義した文字列キー引数を使用して、ローカライズ マネージャーの getDisplayName 関数を呼び出すことができます。

たとえば、次のコードでは en-US の場合は Legend、ru-RU の場合は Обозначения が返されます。

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

[書式] ペインと [分析] ペインのローカライズ

Note

API バージョン 5.1 以降に関連

[書式] ペインと [分析] ペイン コンポーネントのローカライズをサポートするには、ローカライズ文字列を次のように設定します。

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

書式設定モデルのローカライズについては、[書式] ペインのローカライズに関する記事を参照してください。
書式設定モデルのローカライズ ユーティリティについては、書式設定モデル ユーティリティ - ローカライズに関する記事を参照してください。

サポートされている言語

次の表に、Power BI でサポートされているすべての言語のリストと、 locale 変数が各言語に対して返す文字列を示します。

ロケール文字列 言語
ar-SA العربية (アラビア語)
bg-BG български (ブルガリア語)
ca-ES català (カタルニア語)
cs-CZ čeština (チェコ語)
da-DK dansk (デンマーク語)
de-DE Deutsche (ドイツ語)
el-GR ελληνικά (ギリシャ語)
en-US English (英語)
es-ES español service (スペイン語)
et-EE eesti (エストニア語)
eU-ES Euskal (バスク語)
fi FI suomi (フィンランド語)
fr-FR français (フランス)
gl-ES galego (ガリシア語)
he-IL עברית (ヘブライ語)
hi-IN हिन्दी (ヒンディー語)
hr-HR hrvatski (クロアチア語)
hu-HU magyar (ハンガリー語)
id-ID Bahasa Indonesia (インドネシア語)
it-IT italiano (イタリア語)
ja-JP 日本 (日本語)
kk-KZ Қазақ (カザフ語)
ko-KR 한국의 (韓国語)
lt-LT Lietuvos (リトアニア語)
lv-LV Latvijas (ラトビア語)
ms-MY Bahasa Melayu (マレー語)
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 中國 (繁体中国語)

次のステップ

ユーティリティの書式設定

わからないことがある場合は、 Power BI コミュニティでご質問ください