Skapa en app med flera språk

2023-03-15

I den här artikeln lär du dig hur du skapar en flerspråkig app med lokaliserad upplevelse. Med den här metoden kan du använda komponenterna i appen och göra översättningar tillgängliga i en app med en enhetlig formelsyntax.

Viktigt

Metoden som beskrivs i den här artikeln använder komponenter för appar som finns i förhandsgranskning för allmänheten. Mer information finns i Skapa en komponent för arbetsyteappar

Skapa en översättningskomponent

När du arbetar med en app för flera språk är det första steget att skapa en återanvändbar komponent för översättning. I den här komponenten lagrar du en tabell som fungerar som ordlista för alla översättningar som behövs. En utdataegenskap används för att tillhandahålla utdatasträngar från den här ordlistan utifrån språket för användaren som kör appen som använder komponenten.

Logga in på Power Apps.
I vänstra hörnet, välj Appar.
Under Appar, välj Komponentbibliotek (förhandsgranskning).
Välj + Nytt komponentbibliotek (förhandsversion).
Ange ett namn, till exempel "Översättningskomponenter", och välj Skapa för att öppna komponenten i Power Apps Studio.
Byt namn på Komponent 1 genom att markera ... i den vänstra rutan och välj Byt namn till "Översättningskomponent".
Välj i egenskapspanelen till höger på skärmen + Ny anpassad egenskap.
Ange följande egenskapsvärden:

Egenskapsnamn Värde

Visningsnamn Språk

Namn Språk

Beskrivning Det språk som texten ska översättas till.

Egenskapstyp Indata

Datatyp Text
Välj kryssruta Höj OnReset när värdet ändras.
Välj Skapa.

Anteckning

Den här indataegenskapen får det aktuella språk-ID (LCID) för den inloggade användaren.
Välj i egenskapspanelen till höger på skärmen + Ny anpassad egenskap.
Ange följande egenskapsvärden:

Egenskapsnamn Värde

Visningsnamn Etiketter

Namn Etiketter

Beskrivning Översatta etiketter.

Egenskapstyp Utdata

Datatyp Post
Välj Skapa.

Anteckning

Den här utdataegenskapen visar de översatta etiketterna baserat på indata-språk-ID.
Välj egenskapslistrutan längst upp till vänster på skärmen och välj egenskapen OnReset för komponenten.
Kopiera och klistra in följande formel i formelfältet för egenskapen 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"
             }
         }
     )
    )
```
Formeln använder Set()-funktion för att skapa en tabell med etiketterna på olika språk som en ordlista. Om du vill anpassa tabellen som en ordlista för dina översättningar ändrar du Rubrik, JobTitle, Plattform, Stäng, Öppna, Avbryt och så vidare. Du kan lägga till eller ta bort översättningar för kontrollnamn beroende på företagets krav.

Tabellen bör också ha en post för varje språk som appen har stöd för. Varje post har en Labels egenskap som innehåller det översatta innehållet på alla knappar, indata och etiketter som finns i appen.
Välj egenskapslistrutan längst upp till vänster på skärmen och välj egenskapen Labels för komponenten.
Kopiera och klistra in följande formel i formelfältet för egenskapen Labels.
```
   LookUp(
    varTranslations,
    Language = Lower(
        Coalesce(
            Self.Language,
            Language()
        )
    )).Labels
```
Formeln hittar rätt översättningspost baserat på inmatningen Språk med hjälp av funktionen Lookup(). Om språket inte anges använder formeln den aktuella användarens språk som filter via funktionen Coalesce.
Välj Fil -> Spara för att spara komponentbiblioteket.
Om du vill publicera komponentbiblioteket väljer du Publicera.

Tips

Mer information om hur du skapar, sparar och publicerar komponentbibliotek finns i Skapa ett exempel komponentbibliotek

Egenskapsnamn	Värde
Visningsnamn	Språk
Namn	Språk
Beskrivning	Det språk som texten ska översättas till.
Egenskapstyp	Indata
Datatyp	Text

Egenskapsnamn	Värde
Visningsnamn	Etiketter
Namn	Etiketter
Beskrivning	Översatta etiketter.
Egenskapstyp	Utdata
Datatyp	Post

Översättning komponentbiblioteket skapas, sparas och publiceras för användning.

Använda översättningskomponenten i appen

Tidigare skapade du biblioteket med översättningskomponenten för att återanvändas. I det här avsnittet skapar du en app som använder biblioteket för översättningskomponenten och demonstrerar språköversättningen utifrån det valda språket.

Börja med att skapa en tom arbetsyteapp med layouten Telefon.
Till vänster på skärmen, välj + (infoga).
Längst ned till vänster på skärmen, välj Hämta fler komponenter.
Välj Översättningskomponent.

.

Anteckning

Namnet kan vara ett annat om du sparade komponentbiblioteket som du skapade tidigare med ett annat namn.
Välj Importera.
Till vänster på skärmen, välj + (infoga).
Under Bibliotekskomponenter väljer du Översättningskomponent för att lägga till komponenten i appen.
Till vänster på skärmen, välj trädvyn.
Välj översättningskomponent.
Välj egenskapslistrutan längst upp till vänster på skärmen och välj egenskapen Synligt för komponenten.
Ange värdet för egenskapen Synligt till falskt om du vill göra komponenten osynlig i appen.
Under Indata i listan med kontroller, välj Växla.
Välj egenskapslistrutan längst upp till vänster på skärmen och välj egenskapen OnChange för komponenten.
Uppdatera formeln för egenskapen OnCheck för låskontrollen till följande.
```
    Set(varLanguage,"pt-br")
```
I den här formeln anger växla en variabel med namnet varLanguage med värdet "pt-br" med funktionen Set(), för språkkod portugisiska (BR).
Uppdatera formeln för egenskapen OnUncheck för låskontrollen till följande.
```
    Set(varLanguage,"en-us")
```
I den här formeln anger växla en variabel med namnet varLanguage med värdet "en-us" med funktionen Set(), för språkkod engelska (US).
Till vänster på skärmen, välj översättningskomponent.
Välj egenskapslistrutan längst upp till vänster på skärmen och välj egenskapen Språk för komponenten.
Ange formelvärdet för egenskapen Språk till varLanguage. Variabeln varLanguage bestäms av den växling som konfigurerats tidigare. När växla kontrolleras anges språket till "pt-br". När det är avmarkerat anges språket som "en-us".
Till vänster på skärmen, välj + (infoga).
Välj Textetikett.
Uppdatera Etikett-kontrollens namn till Rubrik från höger på skärmen med egenskapsfönstret.
Markera textetikett igen om du vill lägga till ytterligare en etikett.
Uppdatera Etikett-kontrollens namn till JobTitle .
Ange etiketterna Rubrik och JobTitle nedanför låskontrollen så att båda etiketterna visas.
Ange egenskapen Text för etiketterna Rubrik och JobTitle från övre vänstra sidan av skärmen till följande.

Label Formel

Title 'Translation component_1'.Labels.Title

JobTitle 'Translation component_1'.Labels.JobTitle

Anteckning

Ersätt "Översättningskomponent_1" i den här formeln till namnet på komponenten i appen, om det är annorlunda.

På samma sätt kan du använda olika etiketter och egenskaper enligt definitionen i komponenten som du skapade tidigare för att skicka fler egenskapsvärden. Till exempel, förutom Rubrik och JobTitle, kan du skapa fler egenskaper, till exempel Beskrivning eller Instruktioner i komponentbiblioteket med den översatta texten. Och använd sedan sådana egenskaper på respektive etiketter 'Translation component_1'.Labels.Description eller 'Translation component_1'.Labels.Instructions.
Välj Fil -> Spara, uppdatera namnet på appen och välj Spara för att spara appen. Mer information: Spara och publicera en app

Label	Formel
Title	`'Translation component_1'.Labels.Title`
JobTitle	`'Translation component_1'.Labels.JobTitle`

Testa appen med språköversättning

Appen använder nu översättningskomponenten. Gå till Power Apps och välj den app som ska köras.

När du väljer låstangenten ändras språket till portugisiska (BR) för etiketterna. När det är avmarkerat anges språket som Engelska (US).

Översättningsdemo.

Med den här metoden kan du nu skapa en egen komponent med översättningsordboken som passar verksamhetens krav. Skapa sedan fler appar som använder komponenten som ger företagsanvändarna möjlighet att använda olika språk.

Se även

Lägga till och konfigurera kontroller
Förstå variabler
Formelreferens

Dela via

Skapa en app med flera språk

Skapa en översättningskomponent

Använda översättningskomponenten i appen

Testa appen med språköversättning

Se även

Ytterligare resurser