Partilhar via


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>Configurações>configurações.

      Screenshot of the settings, settings, settings, menu option in Power B I service.

    3. Na guia Geral, selecione Idioma. Nas Definições de Idioma, selecione o idioma que pretende que o Power BI utilize e, em seguida, selecione Aplicar.

      A screenshot showing the language settings in Power BI service.

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, mostrará os campos Dados da Categoria e Dados da Medida no painel de propriedades.

A screenshot showing the category data and measure data fields in a newly created Power BI visual.

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:

A VS code screenshot of a visual project folder.The string resources folder has two sub folders, one for Arabic and one for Hebrew.

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.

A VS code screenshot of a visual project folder. Each sub-folder in the string resources folder has a resources dot resjson file.

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 localização com o argumento de chave de cadeia de getDisplayName 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 forma:

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 Linguagem
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