Compilar unha aplicación multilingüe

Artigo
03/10/2022
3 minutos de lectura

Neste artigo, obterá información sobre como crear unha aplicación multilingüe con experiencia localizada. Con este método, pode usar compoñentes de aplicacións de lenzo e facer que as traducións estean dispoñibles nunha aplicación mediante unha sintaxe de fórmula uniforme.

Importante

O método descrito neste artigo usa compoñentes para aplicacións de lenzo e está en versión preliminar pública. Para obter máis información, consulte Crear un compoñente para aplicacións de lenzo

Crear un compoñente de tradución

Cando se traballa cunha aplicación en varios idiomas, o primeiro paso é crear un compoñente reutilizable para a tradución. Neste compoñente almacenará unha táboa que actúe como o dicionario de todas as traducións que necesitará. Usarase unha propiedade de saída para fornecer cadeas de saída desta táboa de dicionario en función do idioma do usuario que executa a aplicación que usa este compoñente.

Inicie sesión en Power Apps.
No panel esquerdo, seleccione Aplicacións.
En Aplicacións, seleccione Bibliotecas de compoñentes (versión preliminar).
Seleccione + Nova biblioteca de compoñentes (versión preliminar).
Insira un nome, como "Translation components" e seleccione Crear para abrir o compoñente en Power Apps Studio.
Cambie o nome de "Component1" seleccionando ... no panel esquerdo e logo seleccione Renomear como "Translation component".
Seleccione no panel de propiedades da parte dereita da pantalla + Nova propiedade personalizada.
Estableza os seguintes valores de propiedade:

Nome da propiedade Valor

Nome para mostrar Idioma

Nome Idioma

Descripción O idioma ao que quere traducir o texto.

Tipo de propiedade Entrada

Tipo de datos Texto
Seleccione a caixa de verificación Executar OnReset cando cambie o valor.
Seleccione Crear.

Nota

Esta propiedade de entrada recibirá o ID de configuración rexional (LCID) actual do usuario que iniciou sesión.
Seleccione no panel de propiedades da parte dereita da pantalla + Nova propiedade personalizada.
Estableza os seguintes valores de propiedade:

Nome da propiedade Valor

Nome para mostrar Etiquetas

Nome Etiquetas

Descripción Etiquetas traducidas.

Tipo de propiedade Saída

Tipo de datos Rexistro
Seleccione Crear.

Nota

Esta propiedade de saída expón as etiquetas traducidas en función do ID de configuración rexional de entrada.
Na parte superior esquerda da pantalla, seleccione o despregable da lista de propiedades e escolla a propiedade OnReset para o compoñente.
Copie e pegue a seguinte fórmula na barra de fórmulas para a propiedade OnReset.
```
Set(
 varTranslations,
 Table(
         {
             Language: "en-us",
             Labels: {
                 Title: "UI Tips for building canvas apps",
                 JobTitle: "Power Platform Specialist"
             }
         },
         {
             Language: "pt-br",
             Labels: {
                 Title: "Dicas de UI para construir canvas apps",
                 JobTitle: "Especialista de Power Platform"
             }
         }
     )
    )
```
A fórmula usa a función Set() para crear unha táboa coas etiquetas en diferentes idiomas como un dicionario. Para personalizar esta táboa como o dicionario das súas traducións, cambie os nomes dos controis, como Title, JobTitle, Platform, Close, Open, Cancel etc. Pode engadir ou eliminar traducións para os nomes dos controis en función dos requisitos da súa empresa.

A táboa tamén debería ter unha entrada para cada idioma que admita a aplicación. Cada entrada terá unha propiedade Labels que conterá o contido traducido de todos os botóns, entradas e etiquetas posibles da aplicación.
Na parte superior esquerda da pantalla, seleccione o despregable da lista de propiedades e escolla a propiedade Labels para o compoñente.
Copia e patea a seguinte fórmula na barra de fórmulas Etiquetas propiedade.
```
   LookUp(
    varTranslations,
    Language = Lower(
        Coalesce(
            Self.Language,
            Language()
        )
    )).Labels
```
A fórmula atopa a entrada de tradución correcta en función da entrada Language usando a función Lookup(). No caso de que o idioma non estea establecido, a fórmula usa o idioma do usuario actual como filtro mediante a función Coalesce.
Seleccione Ficheiro -> Gardar para gardar a biblioteca de compoñentes.
Seleccione Publicar para publicar a biblioteca de compoñentes.

Suxestión

Para obter máis información sobre como crear, gardar e publicar a biblioteca de compoñentes, vaia a Crear unha biblioteca de compoñentes de exemplo

Nome da propiedade	Valor
Nome para mostrar	Idioma
Nome	Idioma
Descripción	O idioma ao que quere traducir o texto.
Tipo de propiedade	Entrada
Tipo de datos	Texto

Nome da propiedade	Valor
Nome para mostrar	Etiquetas
Nome	Etiquetas
Descripción	Etiquetas traducidas.
Tipo de propiedade	Saída
Tipo de datos	Rexistro

A súa biblioteca de compoñentes de tradución créase, gárdase e publícase para usala.

Usar o compoñente de tradución na aplicación

Anteriormente, creou a biblioteca de compoñentes de tradución para reutilizalo. Nesta sección, creará unha aplicación que empregue a biblioteca de compoñentes de tradución e mostrará a tradución do idioma en función do idioma seleccionado.

Comeza creando un aplicación de lenzo en branco con Teléfono maquetación.
Na parte esquerda da pantalla, seleccione + (Inserir).
Na parte inferior esquerda da pantalla, seleccione Obter máis compoñentes.
Seleccione Compoñente de tradución.

Nota

O nome pode ser diferente se gardou a biblioteca de compoñentes creada anteriormente con outro nome.
Seleccione Importar.
Na parte esquerda da pantalla, seleccione + (Inserir).
En Compoñentes da biblioteca, seleccione Compoñente de tradución para engadir o compoñente a esta aplicación.
Na parte esquerda da pantalla, seleccione a visualización en árbore.
Seleccione o compoñente de tradución.
Na parte superior esquerda da pantalla, seleccione o despregable da lista de propiedades e escolla a propiedade Visible para o compoñente.
Estableza o valor da propiedade Visible en false para facer invisible o compoñente na aplicación.
En Entrada na lista de controis, seleccione Alternar.
Na parte superior esquerda da pantalla, seleccione o despregable da lista de propiedades e escolla a propiedade OnChange para o compoñente.
Actualice a fórmula para a propiedade OnCheck do control de opcións ao seguinte.
```
    Set(varLanguage,"pt-br")
```
Nesta fórmula, a opción establece unha variable chamada varLanguage co valor de "pt-br" usando a función Set(), para o código de idioma portugués (BR).
Actualice a fórmula para a propiedade OnUncheck do control de opcións ao seguinte.
```
    Set(varLanguage,"en-us")
```
Nesta fórmula, a opción establece unha variable chamada varLanguage co valor de "en-us" usando a función Set(), para o código de idioma inglés (US).
Na parte esquerda da pantalla, seleccione o compoñente de tradución.
Na parte superior esquerda da pantalla, seleccione o despregable da lista de propiedades e escolla a propiedade Language para o compoñente.
Estableza o valor da fórmula para a propiedade Language en varLanguage. A variable varLanguage está determinada pola opción configurada anteriormente. Cando se marca a opción, o idioma configúrase en "pt-br". Cando se desmarca, o idioma configúrase en "en-us".
Na parte esquerda da pantalla, seleccione + (Inserir).
Seleccione Etiqueta de texto.
Actualice o nome do control de etiquetas a Title dende o lado dereito da pantalla usando o panel de propiedades.
Seleccione Etiqueta de texto de novo para engadir unha etiqueta máis.
Actualice o nome do control de etiquetas a JobTitle.
Configure as etiquetas Title e JobTitle debaixo do control de opcións para que as dúas etiquetas sexan visibles.
Configure a propiedade Text para as etiquetas Title e JobTitle desde a parte superior esquerda da pantalla do seguinte xeito.

Label Fórmula

Título 'Translation component_1'.Labels.Title

JobTitle 'Translation component_1'.Labels.JobTitle

Nota

Substitúa 'Translation component_1' nesta fórmula co nome do compoñente da súa aplicación, se é diferente.

Do mesmo xeito, pode usar diferentes etiquetas e propiedades, tal e como se definen no compoñente que creou anteriormente para pasar máis valores de propiedades. Por exemplo, ademais de Title e JobTitle, pode crear máis propiedades como Description ou Instructions na biblioteca de compoñentes co texto traducido. Despois, use esas propiedades nas etiquetas respectivas, como 'Translation component_1'.Labels.Description ou 'Translation component_1'.Labels.Instructions.
Seleccione Ficheiro -> Gardar, actualice o nome da súa aplicación e seleccione Gardar para gardar a aplicación. Máis información: Gardar e publicar unha aplicación

Label	Fórmula
Título	`'Translation component_1'.Labels.Title`
JobTitle	`'Translation component_1'.Labels.JobTitle`

Probar a aplicación coa tradución de idiomas

Agora a súa aplicación está a usar o compoñente de tradución. Vaia a Power Apps e seleccione a aplicación para executala.

Cando se seleccione a opción, o idioma cambia a portugués (BR) para as etiquetas. Cando se desmarque, o idioma configúrase de novo en inglés (US).

Demostración da tradución.

Con este enfoque, agora pode crear o seu propio compoñente co dicionario de traducións que se adapte ás súa necesidades empresariais. Despois, cree máis aplicacións de lenzo que empreguen o compoñente que permite aos usuarios comerciais a posibilidade de usar diferentes idiomas.

Consulte tamén

Engadir e configurar controis
Nocións acerca das variables
Referencia da fórmula

Compilar unha aplicación multilingüe

Crear un compoñente de tradución

Usar o compoñente de tradución na aplicación

Probar a aplicación coa tradución de idiomas

Consulte tamén

Comentarios