英語で読む

次の方法で共有

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 - https://powerbi.microsoft.comからローカライズされたバージョンの Power BI Desktop をダウンロードする

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

    1. PowerBI.com にサインインします。

    2. Settings>General に移動します。

      Power BI サービスの [全般] メニュー オプションのスクリーンショット。

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

      Fabric の言語設定を示すスクリーンショット。>

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

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

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

注意

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

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

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

新しく作成された Power BI ビジュアル内のカテゴリ データ フィールドとメジャー データ フィールドを示すスクリーンショット。

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

視覚化プロジェクトのフォルダーの VS Code のスクリーンショット。文字列リソース フォルダーには、アラビア語に 1 つとヘブライ語に 1 つの 2 つのサブフォルダーがあります。

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

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

視覚化プロジェクトのフォルダーの VS Code のスクリーンショット。文字列リソース フォルダーの各サブフォルダーには、resources.resjson ファイルがあります。

すべての 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");

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

注意

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 コミュニティでご質問ください