Dodawanie języka lokalnego do wizualizacji usługi Power BI

Usługa Power BI obsługuje szereg języków lokalnych. Możesz pobrać język ustawień regionalnych usługi Power BI i użyć go do wyświetlania zawartości w wizualizacji.

Na poniższych kartach przedstawiono przykłady tej samej przykładowej wizualizacji wykresu słupkowego wyświetlającej zawartość w różnych językach. Każdy z tych wykresów słupkowych został utworzony przy użyciu innego języka regionalnego (angielski, baskijski i hindi), który jest wyświetlany w etykietce narzędzia.

Jak dodać lokalny język usługi Power BI do wizualizacji

Aby dodać lokalny język usługi Power BI do wizualizacji, wykonaj następujące kroki:

1. Skonfiguruj środowisko, aby wyświetlić język, który nie jest angielski.

2. Pobierz lokalny język usługi Power BI.

3. Ustawianie nazw wyświetlanych wizualizacji

4. Utwórz folder językowy.

5. Dodaj plik zasobów dla każdego języka.

6. Utwórz nowe wystąpienie localizationManager.

7. Wywołaj funkcję getDisplayName.

Krok 1. Konfigurowanie środowiska w celu wyświetlania języka, który nie jest angielski

Aby przetestować wizualizację, ustaw usługę Power BI na język, który nie jest angielski. W tej sekcji pokazano, jak zmienić ustawienia programu Power BI Desktop i usługa Power BI, tak aby używały lokalnego języka, który nie jest angielski.

• Power BI Desktop — pobieranie zlokalizowanej wersji programu Power BI Desktop z programu https://powerbi.microsoft.com

• usługa Power BI — jeśli używasz usługa Power BI (portal internetowy), zmień język w ustawieniach:

  1. Zaloguj się do PowerBI.com.

  2. Przejdź do Ustawienia> Ustawienia> Ustawienia.

     

  3. Na karcie Ogólne wybierz pozycję Język. W obszarze Język Ustawienia wybierz język, którego ma używać usługa Power BI, a następnie wybierz pozycję Zastosuj.

     

Krok 2. Pobieranie języka ustawień regionalnych usługi Power BI

Lokalny język usługi Power BI jest przekazywany jako ciąg wywoływany locale podczas inicjowania wizualizacji. Jeśli język ustawień regionalnych zostanie zmieniony w usłudze Power BI, wizualizacja zostanie wygenerowana ponownie w nowym języku.

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

Krok 3. Ustawianie nazw wyświetlanych wizualizacji

Każda wizualizacja wyświetla informacje w okienku właściwości. Na przykład nielokalizowana wizualizacja niestandardowa utworzona za pomocą pbiviz new polecenia spowoduje wyświetlenie pól Dane kategorii i Dane miary w okienku właściwości.

Pola wyświetlania okienka właściwości są zdefiniowane w pliku capabilities.json . Każde pole wyświetlania jest definiowane displayName przy użyciu właściwości . Dodaj element displayNameKey do każdej nazwy wyświetlanej, którą chcesz zlokalizować.

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

Krok 4. Tworzenie folderu językowego

Aby utworzyć zlokalizowane wizualizacje, projekt musi mieć folder językowy. W projekcie utwórz folder o nazwie stringResources. Folder zawiera jeden podfolder dla każdego języka lokalnego, który ma obsługiwać wizualizacja. Aby na przykład obsługiwać język arabski i hebrajski, dodaj dwa foldery w następujący sposób:

Krok 5. Dodawanie pliku zasobów dla każdego języka

Dla każdego języka, który ma obsługiwać wizualizacja, dodaj plik JSON resources.resjson w odpowiednim folderze podrzędnym stringResources . Te pliki zawierają informacje o języku ustawień regionalnych i zlokalizowane wartości ciągów dla każdego displayNameKey , co chcesz zamienić.

Każdy plik JSON definiuje jeden obsługiwany język ustawień regionalnych. Dodaj wszystkie ciągi lokalizacji, których będziesz używać do każdego pliku resources.resjson .

Przykłady

• resources.resjson plik z rosyjskimi ciągami dla każdego displayNameKeypliku .

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

• resources.resjson plik z ciągami hebrajskimi dla każdego displayNameKeyelementu .

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

Krok 6. Tworzenie nowego wystąpienia localizationManager

Utwórz nowe localizationManager wystąpienie w kodzie wizualizacji.

private localizationManager: ILocalizationManager;

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

Krok 7. Wywoływanie funkcji getDisplayName

Po utworzeniu nowego localizationManager wystąpienia można wywołać funkcję menedżera getDisplayName lokalizacji za pomocą argumentu klucza ciągu zdefiniowanego w pliku resources.resjson.

Na przykład poniższy kod zwraca wartość Legend dla en-US i Обозначения dla ru-RU.

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

Lokalizacja okienka formatowania i okienka analizy

Aby obsługiwać lokalizację składników okienka formatowania i okienka analizy, ustaw zlokalizowany ciąg jako następujący:

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

Aby uzyskać informacje na temat lokalizowania modelu formatowania, zobacz lokalizacja okienka formatowania.
Aby uzyskać informacje o narzędziach modelu formatowania, zobacz Formatowanie utils modelu — lokalizacja.

Obsługiwane języki

Poniższa tabela zawiera listę wszystkich języków obsługiwanych w usłudze Power BI oraz ciąg locale zwracany przez zmienną dla każdego z nich.

Powiązana zawartość

Narzędzia formatowania

Pytania? Zapytaj społeczność usługi Power BI