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.

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.

     

  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.

     

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;

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.

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:

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.

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

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.

Conteúdos relacionados

Formatação utils

Perguntas? Pergunte à comunidade do Power BI