Adicionar o idioma local ao visual do Power BI

O Power BI dá suporte a uma variedade de idiomas locais. Você pode recuperar o idioma de localidade do Power BI e usá-lo para exibir conteúdo em seu visual.

As guias a seguir mostram exemplos do mesmo gráfico de barras de exemplo exibindo conteúdo em idiomas diferentes. Cada um desses gráficos de barras foi criado usando um idioma de localidade diferente (inglês, basco e hindi) que é exibido na dica de ferramenta.

Nota

  • O gerenciador de localização no código do visual é suportado pela API 1.10.0 e superior.
  • A localização não é suportada para depuração do visual durante o desenvolvimento.

Como adicionar o idioma local do Power BI ao seu visual

Para adicionar o idioma local do Power BI ao seu visual, siga estas etapas:

  1. Configure seu ambiente para exibir um idioma que não seja o inglês.

  2. Obtenha o idioma local do Power BI.

  3. Definir os nomes de exibição visuais

  4. Crie uma pasta de idiomas.

  5. Adicione um arquivo de recursos para cada idioma.

  6. Crie uma nova instância localizationManager.

  7. Chame a função getDisplayName.

Etapa 1 - Configurar seu ambiente para exibir um idioma que não seja o inglês

Para testar seu visual, defina o Power BI para um idioma que não seja o inglês. Esta seção mostra como alterar as configurações do Power BI Desktop e do serviço Power BI, para que eles usem um idioma local que não seja o inglês.

  • Power BI Desktop - Baixe a versão localizada do Power BI Desktop em https://powerbi.microsoft.com

  • Serviço do Power BI - Se estiver a utilizar o serviço do Power BI (portal Web), altere o idioma nas definições:

    1. Inicie sessão no PowerBI.com.

    2. Navegue até Configurações>gerais.

      Captura de tela das configurações, geral, opção de menu no serviço Power B I.

    3. Selecione Selecionar idioma de apresentação para selecionar o idioma que pretende que o Power BI utilize.

      Captura de tela mostrando as configurações de idioma na Malha. >

Etapa 2 - Obter o idioma da localidade do Power BI

O idioma local do Power BI é passado como uma cadeia de caracteres chamada locale durante a inicialização do visual. Se um idioma de localidade for alterado no Power BI, o visual será gerado novamente no novo idioma.

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

Nota

No Power BI Desktop, a locale propriedade contém o idioma do Power BI Desktop instalado.

Etapa 3 - Definir os nomes de exibição visuais

Cada visual exibe informações no painel de propriedades. Por exemplo, um visual personalizado não localizado criado usando o pbiviz new comando mostra os campos Dados de Categoria e Dados de Medida no painel de propriedades.

Uma captura de tela mostrando os dados de categoria e os campos de dados de medida em um visual do Power BI recém-criado.

Os campos de exibição do painel de propriedades são definidos no arquivo capabilities.json . Cada campo de exibição é definido usando uma displayName propriedade. Adicione um displayNameKey a cada nome de exibição que você deseja localizar.

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

Etapa 4 - Criar uma pasta de idioma

Para criar visuais localizados, seu projeto precisa ter uma pasta de idioma. Em seu projeto, crie uma pasta chamada stringResources. A pasta contém uma subpasta para cada idioma local que você deseja que seu visual suporte. Por exemplo, para suportar árabe e hebraico, adicione duas pastas da seguinte maneira:

Uma captura de tela de código VS de uma pasta de projeto visual. A pasta de recursos de cadeia de caracteres tem duas subpastas, uma para árabe e outra para hebraico.

Etapa 5 - Adicionar um arquivo de recursos para cada idioma

Para cada idioma que você deseja que seu visual suporte, adicione um arquivo JSON resources.resjson na subpasta stringResources apropriada. Esses arquivos contêm as informações de idioma da localidade e os valores de cadeia de caracteres localizados para cada displayNameKey um que você deseja substituir.

Uma captura de tela de código VS de uma pasta de projeto visual. Cada subpasta na pasta de recursos de cadeia de caracteres tem um arquivo resjson de pontos de recursos.

Cada arquivo JSON define um único idioma de localidade suportado. Adicione todas as cadeias de caracteres de localização que você usará em cada arquivo resources.resjson .

Exemplos

  • resources.resjson com strings russas para cada displayNameKeyarquivo .

    {
        ...
        "Role_Legend": "Обозначения",
        "Role_task": "Задача",
        "Role_StartDate": "Дата начала",
        "Role_Duration": "Длительность"
        ...
    }
    
  • resources.resjson com strings hebraicas para cada displayNameKeyarquivo .

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

Etapa 6 - Criar uma nova instância localizationManager

Crie uma nova localizationManager instância no código do seu visual.

private localizationManager: ILocalizationManager;

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

Etapa 7 - Chamar a função getDisplayName

Depois de criar uma nova localizationManager instância, você pode chamar a função do gerenciador de getDisplayName localização com o argumento de chave de cadeia de caracteres definido em resources.resjson.

Por exemplo, o código a seguir retorna Legend para en-US e Обозначения para ru-RU.

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

Painel de formato e localização do painel de análise

Nota

Relevante para a API versão 5.1+

Para dar suporte à localização no painel de formato e nos componentes do painel de análise, defina a cadeia de caracteres localizada da seguinte maneira:

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

Para localizar o modelo de formatação, consulte Localização do painel de formato.
Para localizar o modelo de formatação utils , consulte formatar o modelo utils - localização.

Idiomas suportados

A tabela a seguir contém uma lista de todos os idiomas com suporte no Power BI e a cadeia de caracteres que a locale variável retorna para cada um.

Cadeia de caracteres de localidade Idioma
ar-SA العربية (árabe)
bg-BG български (búlgaro)
ca-ES català (catalão)
cs-CZ čeština (Checo)
da-DK dansk (dinamarquês)
de-DE Deutsche (Alemão)
el-GR ελληνικά (grego)
en-US Português (Inglês)
es-ES español service (Espanhol)
et-EE eesti (estónio)
eU-ES Euskal (Basco)
fi-FI suomi (finlandês)
fr-FR français (Francês)
gl-ES galego (galego)
he-IL עברית (hebraico)
hi-IN हिन्दी (Hindi)
hr-HR hrvatski (croata)
hu-HU magyar (húngaro)
id-ID Bahasa Indonesia (Indonésio)
it-IT italiano (Italiano)
ja-JP 日本の (japonês)
kk-KZ Қазақ (Cazaque)
ko-KR 한국의 (Coreano)
lt-LT Lietuvos (lituano)
lv-LV Latvijas (letão)
ms-MY Bahasa Melayu (Malaio)
nb-NO norsk (norueguês)
nl-NL Nederlands (Holandês)
pl-PL polski (Polaco)
pt-BR português (Português)
pt-PT português (Português)
ro-RO românesc (romeno)
ru-RU русский (Russo)
sk-SK slovenský (eslovaco)
sl-SI slovenski (esloveno)
sr-Cyrl-RS српски (sérvio)
sr-Latn-RS srpski (sérvio)
sv-SE svenska (sueco)
th-TH ไทย (tailandês)
tr-TR Türk (turco)
uk-UA український (ucraniano)
vi-VN tiếng Việt (vietnamita)
zh-CN 中国 (Chinês-Simplificado)
zh-TW 中國 (chinês-trandicional)

Formatação utils

Perguntas? Pergunte à comunidade do Power BI