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

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

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

ビジュアルにローカル 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. Settings>General に移動します。

     

  3. [表示言語 選択 Power BI で使用する言語を選択します。

     >

手順 2 - ロケール Power BI 言語を取得する

ローカル Power BI 言語は、ビジュアルの初期化中に locale という名前の文字列として渡されます。 Power BI でロケール言語が変更された場合、ビジュアルは新しい言語で再度生成されます。

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

手順 3 - ビジュアル表示名を設定する

どのビジュアルでも、情報はプロパティ ペインに表示されます。 たとえば、 pbiviz new コマンドを使用して作成されたローカライズされていないカスタム ビジュアルでは、プロパティ ウィンドウの Category Data フィールドと Measure Data フィールドが表示されます。

プロパティ ペインの表示フィールドは、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 つのフォルダーを追加します。

手順 5 - 各言語のリソース ファイルを追加する

視覚化でサポートしたい言語ごとに、対応する stringResources サブフォルダー内に resources.resjson JSON ファイルを追加します。 これらのファイルには、そのロケール言語の情報と、置き換えるすべての displayNameKey のローカライズされた文字列値が含まれます。

すべての JSON ファイルで 1 つのサポートされるロケール言語を定義します。 使用しようとしているすべてのローカライズ文字列を各 resources.resjson ファイルに追加します。

例

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

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

• 各 に対応する "ヘブライ語" の文字列を含む 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 で定義した文字列キー引数を使用して、ローカライズ マネージャーの 関数を呼び出すことができます。

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

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

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

書式設定ウィンドウと分析ウィンドウ コンポーネントでのローカライズをサポートするには、ローカライズされた文字列を次のように設定します。

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

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

サポートされている言語

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

関連するコンテンツ

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

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