Partilhar via


Adicionar um idioma a um relatório no Construtor de Traduções

Quando você abre um projeto .pbix no Construtor de Traduções pela primeira vez, a grade de tradução exibe uma linha para cada tabela, medida e coluna não ocultas no modelo de dados subjacente do projeto. A grade de conversão não exibe linhas para objetos de modelo de dados no modelo de dados que estão ocultos da exibição de relatório. Os objetos ocultos não são exibidos em um relatório e não exigem traduções.

A captura de tela a seguir mostra o ponto de partida para um modelo de dados simples antes de ser modificado para oferecer suporte a idiomas secundários.

Screenshot shows Translations Builder with no languages added.

Nota

Se você ainda não instalou o Construtor de traduções, consulte Criar relatórios em vários idiomas com o Construtor de traduções.

Se você examinar a grade de tradução para este projeto .pbix, poderá ver que as três primeiras colunas contêm colunas somente leitura usadas para identificar cada tradução de metadados. Cada conversão de metadados tem um Tipo de objeto, uma propriedade e um nome. As traduções para a propriedade Caption são sempre usadas. Você pode adicionar traduções para as propriedades Description e DisplayFolder , se necessário.

A quarta coluna na grade de tradução sempre exibe as traduções para o idioma e a localidade padrão do modelo de dados, que neste caso é inglês [en-US].

Screenshot shows a grid of string values for the default language and locale.

Nota

O Construtor de Traduções permite atualizar as traduções para o idioma padrão. Use esta técnica com moderação. Pode ser confuso porque as traduções para o idioma padrão não são carregadas no Power BI Desktop.

Adicionar idiomas

O Construtor de Traduções fornece uma opção Adicionar idioma para adicionar idiomas secundários ao modelo de dados do projeto.

O Construtor de Traduções não adiciona traduções de metadados para um idioma específico. Em vez disso, ele adiciona traduções de metadados para um nome de cultura que identifica um idioma e uma localidade. Para obter mais informações, consulte Usar valores de localidade em relatórios do Power BI em vários idiomas.

O Construtor de Traduções abstrai as diferenças entre um idioma e um nome de cultura para simplificar a experiência do usuário. Os criadores de conteúdo podem pensar em termos de idiomas em vez de nomes de culturas.

Para adicionar um ou mais idiomas secundários, siga estas etapas.

  1. Selecione Adicionar idioma para exibir a caixa de diálogo Adicionar idioma.

  2. Selecione um idioma na lista ou use Ctrl para selecionar vários idiomas.

  3. Selecione Adicionar idioma.

    Screenshot shows the Add Language button in Translations Builder.

    O idioma ou idiomas adicionados agora aparecem na lista Idiomas Secundários .

    Screenshot shows the Add Language dialog box with a language selected and the Add Language button highlighted.

  4. No Power BI Desktop, selecione Salvar.

    Screenshot shows the Power BI Desktop window with the save icon highlighted.

    Importante

    O Construtor de Traduções pode modificar o modelo de dados carregado na memória, mas não pode salvar as alterações na memória de volta para o arquivo .pbix subjacente. Retorne sempre ao Power BI Desktop e selecione o comando Salvar depois de adicionar idiomas ou criar ou atualizar traduções.

Adicionar um novo idioma adiciona uma nova coluna de células editáveis à grade de traduções.

Screenshot shows Translations Builder grid with an empty column for the new language.

Se os criadores de conteúdo falarem todos os idiomas envolvidos, eles poderão adicionar e atualizar traduções para idiomas secundários diretamente na grade de tradução com uma experiência de edição semelhante ao Excel.

Screenshot shows Translations Builder grid with the new column populated.

Testar traduções no serviço do Power BI

Não é possível verificar seu trabalho em vários idiomas no Power BI Desktop. Em vez disso, você deve testar seu trabalho no serviço do Power BI em um espaço de trabalho associado a uma capacidade Premium. Depois de adicionar suporte de tradução com o Construtor de traduções, siga estas etapas:

  1. No Power BI Desktop, salve as alterações no arquivo .pbix subjacente.

  2. Na faixa de opções Página Inicial, selecione Publicar.

    Screenshot shows the Power BI Desktop Home ribbon with the Publish button highlighted.

  3. Na caixa de diálogo Publicar no Power BI, realce um espaço de trabalho e escolha Selecionar.

  4. Quando a publicação terminar, selecione o link para abrir o projeto no serviço do Power BI.

Depois que o relatório for carregado com seu idioma padrão, selecione a barra de endereço do navegador e adicione o seguinte parâmetro de idioma à URL do relatório.

?language=es-ES

Ao adicionar o parâmetro language ao final da URL do relatório, atribua um valor que seja um nome de cultura válido. Depois de adicionar o parâmetro language e pressionar Enter, você pode verificar se o parâmetro foi aceito pelo navegador à medida que recarrega o relatório.

Se você esquecer de adicionar o ponto de interrogação (?) ou se não formatar o parâmetro language corretamente, o navegador rejeitará o parâmetro e o removerá da URL. Depois de carregar corretamente um relatório usando um valor de parâmetro de idioma de es-ES, você verá a experiência do usuário de toda a interface do usuário do serviço Power BI mudar de inglês para espanhol.

Screenshot shows a Power BI service experience with es-ES selected and Spanish values displayed.

O relatório também exibe as traduções em espanhol para os nomes das colunas e medidas.

Implementar fluxo de trabalho em vários idiomas

Depois de testar seu trabalho e verificar se as traduções estão funcionando corretamente, você pode armazenar o arquivo .pbix em um sistema de controle de origem, como o GitHub ou o Azure Repos. Essa abordagem pode fazer parte de uma estratégia de gerenciamento do ciclo de vida do aplicativo (ALM), na qual o suporte para idiomas secundários e traduções evolui ao longo do tempo.

Ao começar a trabalhar com idiomas secundários e traduções para localizar um projeto .pbix, siga o mesmo conjunto de etapas:

  1. Faça alterações no Power BI Desktop.
  2. Publique o projeto .pbix no serviço do Power BI.
  3. Teste seu trabalho com um navegador no serviço do Power BI usando o parâmetro language .
  4. Repita estes passos até concluir todas as traduções.

Incorporar relatórios do Power BI usando um idioma e uma localidade específicos

Se estiver a desenvolver com a incorporação do Power BI, pode utilizar a API JavaScript do Power BI para carregar relatórios com um idioma e uma localidade específicos. Essa tarefa é realizada estendendo o config objeto passado para powerbi.embed com um localeSettings objeto que contém uma language propriedade, conforme mostrado no código a seguir.

let config = {
  type: "report",
  id: reportId,
  embedUrl: embedUrl,
  accessToken: embedToken,
  tokenType: models.TokenType.Embed,
  localeSettings: { language: "de-DE" }
};

let report = powerbi.embed(reportContainer, config);