ダッシュボードのローカライズ

ローカリゼーションサービスを使用すると、カスタムロジックに基づいてさまざまなダッシュボード要素をローカライズできます。また、フィールドのカスタム書式設定を設定する機能も提供します。

ローカライズがサポートされる要素

ローカライズできるダッシュボード要素:

ダッシュボードのタイトル
フィルタータイトル
表示形式フィルター
フィールドラベル
集計フィールドラベル

ローカリゼーションサービスの使用

この例で使用されているダッシュボードは、Marketing サンプルダッシュボードです。

ダッシュボードのタイトルのローカライズの例

Marketing サンプルの初期状態:

Initial state of the Marketing Sample

以下の手順に従って、Marketing ダッシュボードのタイトルを Localized Marketing にローカライズします。

ダッシュボードのローカライズを許可するには、カスタム実装に LocalizationProvider プロパティを設定する必要があります。
```
RevealSdkSettings.LocalizationProvider = new UpMediaLocalizationProvider()
```

IRVLocalizationProvider を実装します:

public class UpMediaLocalizationProvider : IRVLocalizationProvider
{
    public IRVLocalizationService GetLocalizationService()
    {
      return new UpMediaLocalizationService();
    }
}

以下に示すように、IRVLocalizationService に GetLocalizedString メソッドを実装して、ダッシュボードのタイトルをローカライズします。

public class UpMediaLocalizationService : IRVLocalizationService
{
    public RVFormattingSpec GetFormattingSettingsForField(string fieldName, RVDashboardDataType dataType, RVFormattingSpec currentSettings, bool isAggregated)
    {
        return null;
    }

    public string GetLocalizedString(string originalValue, RVLocalizationElementType type)
    {
        if (type == RVLocalizationElementType.DashboardTitle && originalValue == "Marketing")
        {
            return "Localized Marketing";
        }

        return originalValue;
    }
}

アプリを再度実行すると、ローカライズされたダッシュボードのタイトル (Localized Marketing) が表示されます。

Localized Marketing Sample Title

フィールドラベルのローカライズの例

以下に、同じダッシュボードの複数の要素をローカライズする方法の例を示します。

以下は、Marketing サンプルの表示形式 (Actual Spend vs Budget) で初期状態の 1 つの例です:

initial state of the Actual Spend vs Budget visualization

Date フィールドラベルをローカライズするには、Date フィールドのローカリゼーションを処理するロジックを UpMediaLocalizationService に追加する必要があります。

public class UpMediaLocalizationService : IRVLocalizationService
{
    public RVFormattingSpec GetFormattingSettingsForField(string fieldName, RVDashboardDataType dataType, RVFormattingSpec currentSettings, bool isAggregated)
    {
        return null;
    }

    public string GetLocalizedString(string originalValue, RVLocalizationElementType type)
    {
        if (type == RVLocalizationElementType.DashboardTitle && originalValue == "Marketing")
        {
            return "Localized Marketing";
        }
        else if (type == RVLocalizationElementType.FieldLabel && originalValue == "Date")
        {
            return "Localized Date";
        }

        return originalValue;
    }
}

Actual Spend vs Budget の Date フィールドラベルが Localized Date に変更されました。

localized date field label

手順の例に従って、その他のダッシュボード要素をローカライズできます。

ローカリゼーションサービスを使用して書式設定を変更する

現在、ローカリゼーションサービスを使用して、数値フィールドと非集計日付フィールドの書式設定を変更できます。

数値フィールドの書式設定の変更の例

以下の Spend vs Budget 表示形式の初期状態では、米ドル ($) 通貨で書式設定された数値フィールドを示します。

Original numeric field in US Dollars currency format

通貨書式を変更するには、新しい書式設定を作成し、IRVLocalizationService の実装の *GetFormattingSettingsForField メソッドでそれらを返す必要があります。

コードスニペットは、数値の書式設定を日本円(¥) に変更し、小数桁なしで表示する方法を示します。

public class UpMediaLocalizationService : IRVLocalizationService
{
    public RVFormattingSpec GetFormattingSettingsForField(string fieldName, RVDashboardDataType dataType, RVFormattingSpec currentSettings, bool isAggregated)
    {
        if (fieldName == "Spend" && dataType == RVDashboardDataType.Number && isAggregated == true)
        {
            var newSettings = new RVNumberFormattingSpec()
            {
                ApplyMkFormat = false,
                CurrencySymbol = "¥",
                DecimalDigits = 0,
                FormatType = RVDashboardNumberFormattingType.Currency,
                NegativeFormat = RVDashboardNegativeFormatType.MinusSign,
                ShowGroupingSeparator = true
            };

            return newSettings;
        }

        return null;
    }

    public string GetLocalizedString(string originalValue, RVLocalizationElementType type)
    {
       ...
    }
}

現在、金額は別の通貨で表示されます。

Changed numeric field in Japanese Yen currency format

日付フィールドの書式設定の変更の例

現在、集計された日付フィールドの書式設定の変更は、ローカリゼーションサービスでは設定できず、ピボットの値には影響しません。これを実現するには、書式設定サービスを使用する必要があります。

ローカリゼーションサービスでは、非集計日付フィールドの書式設定を変更できます。

まず、集計データを除外するために、Actual Spend vs Budget 表示形式をグリッドに変更します。

Visualization in Grid format

Date フィールドの書式設定を変更するには、GetFormattingSettingsForField メソッドのロジックに設定を追加する必要があります。以下のコードスニペットは、January 01、2001 のように、日付形式を変更して月のフルネームを表示する方法を示しています。

public RVFormattingSpec GetFormattingSettingsForField(string fieldName, RVDashboardDataType dataType, RVFormattingSpec currentSettings, bool isAggregated)
{
    if (fieldName == "Spend" && dataType == RVDashboardDataType.Number && isAggregated == true)
    {
        var newSettings = new RVNumberFormattingSpec()
        {
            ApplyMkFormat = false,
            CurrencySymbol = "¥",
            DecimalDigits = 0,
            FormatType = RVDashboardNumberFormattingType.Currency,
            NegativeFormat = RVDashboardNegativeFormatType.MinusSign,
            ShowGroupingSeparator = true
        };

        return newSettings;
    }
    else if (fieldName == "Date" && dataType == RVDashboardDataType.Date && isAggregated == false)
    {
        var newSettings = new RVDateFormattingSpec()
        {
            DateFormat = "MMMM dd,yyyy"
        };

        return newSettings;
    }

    return null;
}

備考

フィールド名が Localized Date ではなく Date であるかどうかを確認する必要があることに注意してください。これは、フィールドの名前に基づいて書式設定が適用されるためです。この場合、Date はフィールドの名前で、Localized Date は表示されるラベルです。ダッシュボードを編集する場合、フィールドラベルは変更できますが、フィールド名は元の名前のままです。

アプリを再度実行し、表示形式をグリッドに変更すると、更新された日付形式が表示されます。

ローカライズがサポートされる要素​

ローカリゼーション サービスの使用​

ダッシュボードのタイトルのローカライズの例​

フィールド ラベルのローカライズの例​

ローカリゼーション サービスを使用して書式設定を変更する​

数値フィールドの書式設定の変更の例​

日付フィールドの書式設定の変更の例​