Een meertalige app bouwen

Artikel
03/16/2023

In dit artikel leert u hoe u een meertalige app maakt met gelokaliseerde ervaring. Met deze methode kunt u onderdelen van de canvas-app gebruiken en vertalingen beschikbaar maken in een app met behulp van een uniforme formulesyntaxis.

Belangrijk

De methode die in dit artikel wordt beschreven, gebruikt onderdelen voor canvas-apps die zich in de openbare preview bevinden. Zie Een onderdeel maken voor canvas-apps voor meer informatie

Een onderdeel voor vertaling maken

Wanneer u met een meertalige app werkt, bestaat de eerste stap eruit een herbruikbaar onderdeel voor vertaling te maken. In dit onderdeel slaat u een tabel op die fungeert als het woordenboek van alle vertalingen die u nodig hebt. Er wordt een uitvoereigenschap gebruikt om uitvoertekenreeksen uit deze woordenboektabel op te geven op basis van de taal van de gebruiker die de app uitvoert waarin dit onderdeel wordt gebruikt.

Meld u aan bij Power Apps.
Selecteer Apps in het linkerdeelvenster.
Selecteer onder Apps Onderdelenbibliotheken (preview).
Selecteer Nieuwe onderdelenbibliotheek (preview).
Voer een naam in, zoals "Onderdelen voor vertaling" en selecteer Maken om het onderdeel te openen in Power Apps Studio.
Hernoem "Onderdeel1" door ... te selecteren in het linkerdeelvenster en selecteer vervolgens Hernoemen als "Onderdeel voor vertaling".
Selecteer in het eigenschappenvenster aan de rechterkant van het scherm + Nieuwe aangepaste eigenschap.
Stel de volgende eigenschapswaarden in:

Eigenschapsnaam Weergegeven als

Weergavenaam Taal

Meetcriterium Taal

Beschrijving De taal waarnaar u de tekst wilt vertalen.

Eigenschapstype Invoer

Gegevenstype Tekst
Schakel het selectievakje OnReset verhogen wanneer waarde wordt gewijzigd in.
Selecteer Maken.

Notitie

Deze invoereigenschap ontvangt de huidige landinstellings-id (LCID) van de aangemelde gebruiker.
Selecteer in het eigenschappenvenster aan de rechterkant van het scherm + Nieuwe aangepaste eigenschap.
Stel de volgende eigenschapswaarden in:

Eigenschapsnaam Weergegeven als

Weergavenaam Etiketten

Meetcriterium Etiketten

Beschrijving Vertaalde labels.

Eigenschapstype Uitvoer

Gegevenstype Opnemen
Selecteer Maken.

Notitie

Met deze uitvoereigenschap worden de vertaalde labels weergegeven op basis van de ingevoerde landinstellings-id.
Selecteer in de linkerbovenhoek van het scherm de vervolgkeuzelijst met de eigenschappenlijst en kies de eigenschap OnReset voor het onderdeel.
Kopieer en plak de volgende formule in de formulebalk voor de eigenschap 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"
             }
         }
     )
    )
```
In de formule wordt de functie Set() gebruikt om een tabel te maken met de labels in verschillende talen als woordenboek. Als u deze tabel wilt aanpassen als het woordenboek voor uw vertalingen, wijzigt u de namen van de besturingselementen, zoals Title, JobTitle, Platform, Close, Open, Cancel enzovoort. U kunt vertalingen voor namen van besturingselementen toevoegen of verwijderen, afhankelijk van uw zakelijke vereisten.

De tabel moet ook een vermelding bevatten voor elke taal die uw app ondersteunt. Elke vermelding heeft de eigenschap Labels die de vertaalde inhoud van alle mogelijke knoppen, invoer en labels in uw app bevat.
Selecteer in de linkerbovenhoek van het scherm de vervolgkeuzelijst met de eigenschappenlijst en kies de eigenschap Labels voor het onderdeel.
Kopieer en plak de volgende formule in de formulebalk voor de eigenschap Labels.
```
   LookUp(
    varTranslations,
    Language = Lower(
        Coalesce(
            Self.Language,
            Language()
        )
    )).Labels
```
De formule vindt het juiste vertaalitem op basis van de invoer Language met de functie Lookup(). In het geval dat de taal niet is ingesteld, gebruikt de formule de taal van de huidige gebruiker als het filter via de functie Coalesce.
Selecteer Bestand -> Opslaan om de onderdelenbibliotheek op te slaan.
Selecteer Publiceren om de onderdelenbibliotheek te publiceren.

Tip

Ga voor meer informatie over het maken, opslaan en publiceren van de onderdelentbibliotheek naar Een voorbeeldonderdelenbibliotheek maken

Eigenschapsnaam	Weergegeven als
Weergavenaam	Taal
Meetcriterium	Taal
Beschrijving	De taal waarnaar u de tekst wilt vertalen.
Eigenschapstype	Invoer
Gegevenstype	Tekst

Eigenschapsnaam	Weergegeven als
Weergavenaam	Etiketten
Meetcriterium	Etiketten
Beschrijving	Vertaalde labels.
Eigenschapstype	Uitvoer
Gegevenstype	Opnemen

Uw onderdelenbibliotheek voor vertaling wordt gemaakt, opgeslagen en gepubliceerd voor gebruik.

Het onderdeel voor vertaling in uw app gebruiken

Voorheen maakte u de onderdelenbibliotheek voor vertaling voor hergebruik. In deze sectie maakt u een app die gebruikmaakt van de onderdelenbibliotheek voor vertaling en demonstreert u de vertaling op basis van de geselecteerde taal.

Begin door een lege canvas-app te maken met de indeling Telefoon.
Selecteer links van het scherm + (Invoegen).
Selecteer in de linkerbenedenhoek van het scherm Meer onderdelen ophalen.
Selecteer Onderdeel voor vertaling.

Notitie

De naam kan anders zijn als u de eerder gemaakte onderdelenbibliotheek onder een andere naam hebt opgeslagen.
Selecteer Importeren.
Selecteer links van het scherm + (Invoegen).
Selecteer onder Bibliotheekonderdelen Onderdeel voer vertaling om het onderdeel aan deze app toe te voegen.
Selecteer links van het scherm de structuurweergave.
Selecteer het onderdeel voor vertaling.
Selecteer in de linkerbovenhoek van het scherm de vervolgkeuzelijst met de eigenschappenlijst en kies de eigenschap Visible voor het onderdeel.
Stel de waarde van de eigenschap Visible in op onwaar om het onderdeel onzichtbaar te maken in de app.
Selecteer onder Invoer in de lijst met besturingselementen In-/uitschakelen.
Selecteer in de linkerbovenhoek van het scherm de vervolgkeuzelijst met de eigenschappenlijst en kies de eigenschap OnChange voor het onderdeel.
Wijzig de formule voor de eigenschap OnCheck van het besturingselement voor schakelaar in het volgende.
```
    Set(varLanguage,"pt-br")
```
In deze formule wordt met de schakelaar een variabele ingesteld met de naam varLanguage met de waarde van "pt-br" met behulp van de functie Set(), voor Portugese (BR) taalcode.
Wijzig de formule voor de eigenschap OnUncheck van het besturingselement voor schakelaar in het volgende.
```
    Set(varLanguage,"en-us")
```
In deze formule wordt met de schakelaar een variabele ingesteld met de naam varLanguage met de waarde van "en-us" met behulp van de functie Set(), voor Engelse (US) taalcode.
Selecteer links van het scherm het onderdeel voor vertaling.
Selecteer in de linkerbovenhoek van het scherm de vervolgkeuzelijst met de eigenschappenlijst en kies de eigenschap Language voor het onderdeel.
Stel de formulewaarde voor de eigenschap Language in op varLanguage. De variabele varLanguage wordt bepaald door de eerder geconfigureerde schakelaar. Wanneer de schakelaar is ingeschakeld, wordt de taal ingesteld op "pt-br". Wanneer deze niet wordt ingeschakeld, wordt de taal ingesteld op "en-us".
Selecteer links van het scherm + (Invoegen).
Selecteer Tekstlabel.
Wijzig de naam van het labelbesturingselement in Titel rechts van het scherm met behulp van het eigenschappenvenster.
Selecteer nogmaals Tekstlabel om nog een label toe te voegen.
Wijzig de naam van het labelbesturingselement in JobTitle.
Stel de labels Title en JobTitle onder de schakelknop in zodat beide labels zichtbaar zijn.
Stel de eigenschap Text voor Title en JobTitle in de linkerbovenhoek van het scherm in het volgende.

Etiket Formule

Titel 'Translation component_1'.Labels.Title

JobTitle 'Translation component_1'.Labels.JobTitle

Notitie

Vervang 'Onderdeel voor vertaling_1' in deze formule met de naam van het onderdeel in uw app, indien deze anders is.

Op dezelfde manier kunt u verschillende labels en eigenschappen gebruiken, zoals gedefinieerd in het onderdeel dat u eerder hebt gemaakt om meer eigenschapswaarden door te geven. Naast Title en JobTitle kunt u bijvoorbeeld meer eigenschappen maken, zoals Omschrijving of Instructies in de onderdelenbibliotheek met de vertaalde tekst. En gebruik dan dergelijke eigenschappen op de respectieve labels, zoals 'Onderdeel voor vertaling_1'.Labels.Omschrijving of 'Onderdeel voor vertaling_1'.Labels.Instructies.
Selecteer Bestand -> Opslaan, wijzig de naam voor uw app en selecteer vervolgens Opslaan om uw app op te slaan. Meer informatie: Een app opslaan en publiceren

Etiket	Formule
Titel	`'Translation component_1'.Labels.Title`
JobTitle	`'Translation component_1'.Labels.JobTitle`

Uw app testen met vertaling

Uw app gebruikt nu het onderdeel voor vertaling. Ga naar Power Apps en selecteer de app voor uitvoering.

Wanneer de schakelaar wordt geselecteerd, wordt de taal voor de labels gewijzigd in Portugees (BR). Wanneer deze niet wordt geselecteerd, wordt de taal weer ingesteld op Engels (VS).

Demo van vertaling.

Met deze aanpak kunt u nu uw eigen onderdeel maken met het vertaalwoordenboek dat past bij uw zakelijke vereisten. En maak vervolgens meer canvas-apps die het onderdeel gebruiken waarmee zakelijke gebruikers verschillende talen kunnen gebruiken.

Zie ook

Besturingselementen toevoegen en configureren
Variabelen begrijpen
Formuleverwijzing

Delen via

Een meertalige app bouwen

Een onderdeel voor vertaling maken

Het onderdeel voor vertaling in uw app gebruiken

Uw app testen met vertaling

Zie ook

Aanvullende resources