Funzione Language

Si applica a: App Canvas Copilot Studio Desktop flussi Power Platform Funzioni di Dataverse dell'interfaccia della riga di comando di Power Platform Power Pages

Restituisce il tag di lingua dell'utente corrente.

Descrizione

La Language funzione restituisce la lingua, lo script e l'area dell'utente corrente come tag di lingua.

Usare le informazioni sulla lingua per personalizzare un'app per varie impostazioni locali. Ad esempio, se stai creando un'app usata in Italia e Francia, puoi usare Language per visualizzare automaticamente le stringhe italiane e francesi agli utenti in queste posizioni diverse.

Language Tag

Un tag di lingua può avere tre formati:

Valore restituito	Descrizione
"lg‑RE"	lg è l'abbreviazione di due caratteri per la lingua e RE è l'abbreviazione di due caratteri per la regione. È il tipo restituito più comune. Ad esempio, "en-GB" viene restituito per il Regno Unito.
"singolo"	lg è l'abbreviazione di due caratteri per la lingua. È il formato usato quando Power Apps contiene informazioni sulla lingua, ma non contiene informazioni per l'area specifica.
"lg‑scrp‑RE"	lg è l'abbreviazione di due caratteri per la lingua, scrp è l'abbreviazione di quattro caratteri per la scrittura e RE è l'abbreviazione di due caratteri per la regione.

Power Apps usa il formato del tag di lingua IETF BCP-47.

Per visualizzare l'elenco dei tag di lingua supportati, digitare Value("1",) nella barra della formula o nella visualizzazione avanzata e scorrere l'elenco delle impostazioni locali suggerite per il secondo argomento.

Le funzioni Text e Value usano anche i tag di lingua. Usare queste funzioni per la traduzione di stringhe di testo in modo globale. Quando si passa un tag di lingua a queste funzioni e l'area non fa la differenza, è possibile usare solo la parte della lingua del tag.

Sintassi

Language()

Esempi

Impostazioni locali dell'utente

Si presuppone che il sistema operativo host e/o il browser usino le impostazioni locali predefinite per il percorso.

Formula	Titolo	Valore restituito
Language()	Lisbona, Portogallo	"pt-PT"
Language()	Rio de Janeiro, Brasile	"pt-BR"
Language()	Atlanta, Stati Uniti	"en-US"
Language()	Manchester, Regno Unito	"en-GB"
Language()	Parigi, Francia	"fr-FR"
Language()	Roseau, Repubblica dominicana	"en"
Language()	Belgrado, Serbia e Montenegro	"sr-cyrl-RS" o "sr-latn-RS", a seconda delle impostazioni di sistema dell'utente

Tabella di localizzazione

Un approccio semplice alla localizzazione consiste nel creare un foglio di calcolo di Excel eseguendo il mapping di un autore definito TextID per un testo tradotto nella lingua dell'utente. Sebbene sia possibile usare una raccolta o qualsiasi altra origine dati per questa tabella, è stato scelto Excel perché è facile da modificare e gestire all'esterno dell'app da parte dei traduttori.

1. In Excel, creare la tabella seguente:

   

   La voce con spazio vuoto per la Language colonna viene usata come predefinita se non è presente alcuna stringa di testo specifica per una determinata lingua. Questa voce deve essere inclusa dopo tutte le altre voci per un determinato TextID.

   A questo scopo, è necessario esaminare la lingua delle impostazioni locali e non dell'area geografica. Se le considerazioni internazionali sono importanti, è possibile includere il valore completo del tag di lingua nella tabella precedente.

2. Usare il comando Tabella della barra multifunzione Inserisci per eseguire questa operazione in una tabella di Excel. Per impostazione predefinita, è denominato Table1 , ma è possibile assegnarvi un nome qualsiasi con la barra multifunzione Strumenti tabella/Progettazione e la casella di testo Nome tabella: sul lato sinistro.

3. Salvare il file di Excel nel file system locale.

4. Nel riquadro di destra di Power Apps fare clic o toccare la scheda Origini dati e quindi fare clic o toccare Aggiungi origine dati.

5. Toccare o fare clic su Aggiungi dati statici all'app, fare clic o toccare il file di Excel salvato e quindi fare clic o toccare Apri.

6. Selezionare la tabella creata e quindi fare clic o toccare Connetti.

Nell'app, ovunque tu usassi il testo "Hello" prima, usa questa formula:

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

Questa formula cercherà il valore LocalizedText appropriato per la lingua dell'utente e, se non viene trovato, eseguirà il fallback sulla versione vuota predefinita.

Le stringhe tradotte in altre lingue potrebbero essere più lunghe di quelle presenti nella lingua. In molti casi, le etichette e altri elementi che visualizzano le stringhe nell'interfaccia utente sono necessarie per essere più ampie per adattarsi.

Servizio di traduzione

È possibile tradurre il testo su richiesta tramite un servizio di traduzione, ad esempio il servizio Microsoft Translator:

1. In Power Apps, nel riquadro di destra, toccare o fare clic sulla scheda Origini dati e quindi scegliere Aggiungi origine dati.
2. Fare clic su o toccare Microsoft Translator.

Nell'app, nel punto in cui dovrebbe essere usato il testo "Hello" in precedenza, usare invece questa formula:

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

Il servizio Microsoft Translator usa gli stessi tag di lingua restituiti dalla Language funzione.

Questo approccio presenta alcuni svantaggi rispetto all'esempio precedente che ha utilizzato una tabella pretraslata di stringhe di testo:

• Il completamento della traduzione richiede tempo, richiedendo una chiamata a un servizio attraverso la rete. Si verifica un ritardo per visualizzare il testo tradotto nella tua app.
• La traduzione è meccanica e potrebbe non essere quello che si prevede o essere la scelta migliore per la situazione all'interno della tua app.