Language Função

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui funções do Power Platform CLI Dataverse Power Pages

Retorna a marcação de idioma do usuário atual.

Descrição

A Language função retorna o idioma, o script e a região do usuário atual como uma marca de idioma.

Use as informações de idioma para personalizar seu aplicativo entre as localidades. Por exemplo, se você estiver criando um aplicativo usado na Itália e na França, poderá usar Language para exibir automaticamente cadeias de caracteres italianas e francesas para seus usuários nesses locais diferentes.

Language Tags

Uma marca de idioma pode estar em um dos três formatos:

Retornar valor	Descrição
"lg‑RE"	lg é a abreviação de dois caracteres para o idioma e RE é a abreviação de dois caracteres para a região. É o tipo de retorno mais comum. Por exemplo, "en-GB" é retornado para o Reino Unido.
"lg"	lg é a abreviação de dois caracteres para o idioma. É o formato usado quando o Power Apps tem informações sobre o idioma, mas não tem informações para a região específica.
"lg‑scrp‑RE"	lg é a abreviação de dois caracteres para o idioma, scrp é a abreviação de quatro caracteres para o script e RE é a abreviação de dois caracteres para a região.

O Power Apps usa o formato de marca de idiomas de IETF BCP-47.

Para ver a lista de marcas de idioma com suporte, digite Value("1",) na barra de fórmulas ou no modo de exibição avançado e role pela lista de localidades sugeridas para o segundo argumento.

As funções Text e Value também usam marcas de idioma. Use essas funções para converter de e para cadeias de caracteres de texto de uma maneira conhecida globalmente. Ao passar uma marca de idioma para essas funções e a região não faria diferença, você pode usar apenas a parte do idioma da marca.

Sintaxe

Language()

Exemplos

Localidade do usuário

Supõe-se que o sistema operacional do host e/ou o navegador estejam usando a localidade padrão para o local.

Fórmula	Local	Valor de Devolução
Language()	Lisboa, Portugal	"pt-PT"
Language()	Rio de Janeiro, Brasil	"pt-BR"
Language()	Atlanta, EUA	"en-US"
Language()	Manchester, Reino Unido	"en-GB"
Language()	Paris, França	"fr-FR"
Language()	Roseau	"en"
Language()	Belgrado, Sérvia	"sr-cyrl-RS" ou "sr-latn-RS", dependendo das configurações do sistema do usuário

Tabela de localização

Uma abordagem simples para a localização é criar uma planilha do Excel mapeando um TextID definido pelo autor para um texto traduzido para o idioma do usuário. Embora você possa usar uma coleção ou qualquer outra fonte de dados para esta tabela, escolhemos o Excel porque é fácil editar e gerenciar fora do aplicativo por tradutores.

1. Crie a seguinte tabela no Excel:

   

   A entrada com espaço em branco para a Language coluna será usada como o padrão se não houver nenhuma cadeia de caracteres de texto específica encontrada para um determinado idioma. Essa entrada deve aparecer após todas as outras entradas para um determinado TextID.

   Para nossos propósitos, precisamos apenas examinar o idioma da localidade e não a região. Se considerações regionais fossem importantes, poderíamos incluir o valor completo da marca de idioma na tabela acima.

2. Use a faixa de opções Insert, o comando Table, para tornar isso em uma tabela do Excel adequada. Por padrão, ele se chama Table1 , mas você pode nomeá-lo como quiser com a faixa de opções Ferramentas/Design de Tabela e o Nome da Tabela: caixa de texto no lado esquerdo.

3. Salve o arquivo do Excel no sistema de arquivos local.

4. No Power Apps, no painel direito, clique ou toque na guia Fontes de Dados e clique ou toque em Adicionar fonte de dados.

5. Clique ou toque em Adicionar dados estáticos ao seu aplicativo, clique ou toque no arquivo do Excel que você salvou e clique ou toque em Abrir.

6. Selecione a tabela que você criou e clique ou toque em Conectar.

Em seu aplicativo, onde quer que você tenha usado o texto "Olá" antes, use esta fórmula em vez disso:

• LookUp( Table1, TextID = "Hello" && (LanguageTag = Left( Language), 2 ) || IsBlank( LanguageTag ))). LocalizedText

Essa fórmula procurará o valor LocalizedText apropriado para o idioma do usuário e, se isso não for encontrado, retornará à versão em branco padrão.

Cadeias de caracteres traduzidas em outros idiomas podem ser mais longas do que em seu idioma. Em muitos casos, os rótulos e outros elementos que exibem as cadeias de caracteres em sua interface do usuário são necessários para serem mais amplos para acomodar.

Serviço de tradução

Você pode traduzir o texto sob demanda usando um serviço de tradução, como o serviço Microsoft Translator:

1. No Power Apps, clique ou toque a guia Fontes de Dados e, em seguida, clique ou toque em Adicionar fonte de dados.
2. Clique ou toque em Microsoft Translator.

Em seu aplicativo, onde quer que tenha usado o texto "Hello" antes, use esta fórmula em vez disso:

• MicrosoftTranslator.Translate( "Hello", Language() )

O serviço Microsoft Translator usa as mesmas marcas de idioma retornada pela Language função.

Essa abordagem vem com algumas desvantagens quando comparada com o exemplo anterior que utilizou uma tabela pré-traduzida de cadeias de caracteres de texto:

• A tradução leva tempo para ser concluída, exigindo uma chamada para um serviço em toda a rede. Isso resulta em um atraso para ver o texto traduzido em seu aplicativo.
• A tradução é mecânica e pode não ser o que você prevê ou ser a melhor opção para a situação em seu aplicativo.