Share via

Language-funktio

  • Artikkeli

Koskee seuraavia: Pohjaan perustuvat sovellukset Työpöytätyökulut Power Platform CLI

Palauttaa nykyisen käyttäjän kielitunnisteen.

Description

Language-funktio palauttaa nykyisen käyttäjän kielen, komentosarjan ja alueen kielitunnisteena.

Kielitietojen avulla voit tehdä sovelluksestasi paikallisen version. Jos esimerkiksi olet luomassa sovellusta, jota käytetään Italiassa ja Ranskassa, voit määrittää Language-funktion avulla merkkijonot näkymään automaattisesti kunkin alueen paikallisella kielellä.

Kielitunnisteet

Kielitunnisteen muotoilussa voidaan käyttää seuraavia kolmea vaihtoehtoa:

Palautusarvo Description
"lg‑RE" lg on kielen kaksikirjaiminen lyhenne ja RE alueen kaksikirjaiminen lyhenne. Tämä on yleisin palautustyyppi. Esimerkiksi Yhdistyneen kuningaskunnan kielitunnisteena palautetaan ”en-GB”.
"lg" lg on kielen kaksikirjaiminen lyhenne. Tätä muotoa käytetään, kun Power Apps tietää kielen, mutta ei aluetta.
"lg‑scrp‑RE" lg on kielen kaksikirjaiminen lyhenne, scrp komentorivin nelikirjaiminen lyhenne ja RE alueen kaksikirjaiminen lyhenne.

Power Apps käyttää kielitunnisteen muotoa IETF BCP-47.

Voit tarkastella tuettujen kielitunnisteiden luetteloa kirjoittamalla kaavariville tai lisänäkymään Value( "1", ) ja selaamalla toiselle argumentille ehdotettuja kielialueita.

Myös Text- ja Value-funktiot käyttävät kielen tunnisteita. Näiden funktioiden avulla voit kääntää merkkijonoja globaalisti toimivalla tavalla. Kun välität näihin funktioihin kielitunnisteen, mutta alueella ei ole merkitystä, voit käyttää tunnisteen pelkkää kieliosaa.

Syntaksi

Language()

Esimerkit

Käyttäjän aluekohtaiset asetukset

Oletuksena on, että isäntäkäyttöjärjestelmä tai -selain käyttävät sijaintipaikan oletuskieltä.

Kaava Sijainti Palautusarvo
Language() Lissabon, Portugali "pt-PT"
Language() Rio de Janeiro, Brasilia "pt-BR"
Language() Atlanta, USA "en-US"
Language() Manchester, Yhdistynyt kuningaskunta "en-GB"
Language() Pariisi, Ranska "fr-FR"
Language() Roseau, Dominica "en"
Language() Belgrad, Serbia ”sr-cyrl – RS” tai ”sr-latn – RS”, käyttäjän järjestelmän asetusten mukaan

Lokalisointitaulukko

Yksinkertainen lokalisointimenetelmä on luoda Excel-taulukko, joka yhdistetään tekijän määrittämällä tunnuksella (TextID) käyttäjän kielelle käännettyyn tekstiin. Taulukon pohjana voi käyttää kokoelmaa tai mitä tahansa muuta tietolähdettä, mutta valitsimme Excelin, koska kääntäjien on helppo muokata ja hallita sitä sovelluksen ulkopuolella.

  1. Luo Excelissä seuraava taulukko:

    Lokalisointitaulukko.

    Jos jollakin kielellä ei ole olemassa tiettyä tekstimerkkijonoa, sen tilalla käytetään Language-sarakkeessa olevaa tyhjää merkintää. Tämän merkinnän täytyy esiintyä kaikkien muiden tietylle tekstitunnukselle (TextID) varattujen merkintöjen perässä.

    Näitä tarkoituksia varten tarvitsemme vain kielen, emme aluetta. Jos alueelliset seikat olisivat tärkeitä, olisimme voineet lisätä yllä olevaan taulukkoon koko kielitunnisteen.

  2. Käytä Lisää-valintanauhan Taulukko-komentoa, jotta tästä muodostuu asianmukainen Excel-taulukko. Oletusarvoinen nimi on Taulukko1, mutta voit muuttaa nimen käyttämällä Taulukkotyökalut/Rakenne- valintanauhaa ja kaukana vasemmassa reunassa olevaa Taulukkonimi-tekstiruutua.

  3. Tallenna Excel-tiedosto paikalliseen tiedostojärjestelmään.

  4. Napsauta tai napauta Power Appsin oikeanpuoleisessa ruudussa olevaa Tietolähteet-välilehteä ja napsauta tai napauta sitten Lisää tietolähde.

  5. Napsauta tai napauta Lisää sovellukseen staattisia tietoja (Add static data to your app). Napsauta tai napauta tallentamaasi Excel-tiedostoa ja sitten Avaa.

  6. Valitse luomasi taulukko ja napsauta tai napauta Yhdistä.

Siirry siihen sovelluksen kohtaan, jossa olisit aiemmin käyttänyt tekstiä "Hello", ja käytä sen sijaan tätä kaavaa:

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

Tämä kaava hakee sopivan LocalizedText-arvon, joka on käännetty käyttäjän kielelle. Jos lokalisoitua arvoa ei löydy, kaava ottaa käyttöön oletusmuotoisen tyhjän version.

Huomaa, että käännetyt merkkijonot voivat olla muissa kielissä huomattavasti pidempiä kuin omassa kielessäsi. Monissa tapauksissa käyttöliittymäsi merkkijonot näyttävien selitteiden ja muiden elementtien täytyy olla suurempia.

Käännöspalvelu

Voit kääntää tekstiä tarpeen mukaan käyttämällä käännöspalvelua, kuten Microsoft Translatoria:

  1. Napsauta tai napauta Power Appsin oikeanpuoleisessa ruudussa olevaa Tietolähteet-välilehteä ja napsauta tai napauta sitten Lisää tietolähde.
  2. Napsauta tai napauta Microsoft Translator.

Siirry siihen sovelluksen kohtaan, jossa olisit aiemmin käyttänyt tekstiä "Hello", ja käytä sen sijaan tätä kaavaa:

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

Microsoft Translator-palvelu käyttää samoja kielitunnisteita, jotka Language-funktio palauttaa.

Tähän menetelmään liittyy joitakin haittapuolia verrattuna edelliseen esimerkkiin, jossa käytettiin valmista käännöstaulukkoa:

  • Kääntämiseen kuluu aikaa, sillä palvelu on kutsuttava verkon yli. Tämä aiheuttaa viiveen ennen kuin käännetty teksti näkyy sovelluksessasi.
  • Käännöksestä tulee mekaaninen, ja se ei välttämättä täytä odotuksiasi tai ole paras mahdollinen ratkaisu sovelluksen senhetkiseen käyttötarkoitukseen.