Funkcja Language

Dotyczy: Aplikacje oparte na kanwie Przepływy pulpitu Power Platform CLI

Zwraca tag języka bieżącego użytkownika.

Popis

Funkcja Language zwraca język, skrypt i region dla bieżącego użytkownika w postaci tagu języka.

Użyj informacji o języku, aby dopasować aplikację do ustawień regionalnych. Na przykład jeśli tworzysz aplikację, która będzie używana we Włoszech i Francji, możesz użyć funkcji Language, aby automatycznie wyświetlać włoskie lub francuskie ciągi użytkownikom w tych lokalizacjach.

Tagi języka

Tag języka może mieć jeden z trzech formatów:

Wartość zwracana opis
"lg‑RE" lg to dwuznakowy skrót języka, a RE to dwuznakowy skrót regionu. To jest najczęściej używany typ zwracany. Na przykład dla Wielkiej Brytanii jest zwracana wartość „en-GB”.
"lg" lg to dwuznakowy skrót języka. Ten format jest używany, gdy usługa Power Apps ma informacje o języku, ale nie ma informacji dla konkretnego regionu.
"lg‑scrp‑RE" lg to dwuznakowy skrót języka, scrp to czteroznakowy skrót skryptu, a RE to dwuznakowy skrót regionu.

Usługa Power Apps używa formatu tagu języka zgodnego ze standardem IETF BCP-47

Aby wyświetlić listę obsługiwanych tagów języka, wpisz Value( "1", ) na pasku formuły lub w widoku zaawansowanym i przewiń listę ustawień regionalnych sugerowanych dla drugiego argumentu.

Funkcje Text i Value także używają tagów języka. Użyj tych funkcji do tłumaczenia ciągów tekstowych z uwzględnieniem globalizacji. Przy przekazywaniu do nich tagu języka w sytuacji, gdy region jest nieistotny, możesz użyć tylko części języka tagu.

Składnia

Language()

Przykłady

Ustawienia regionalne użytkownika

Przyjęto założenie, że system operacyjny hosta i/lub przeglądarka używają domyślnych ustawień regionalnych dla lokalizacji.

Wzór Lokalizacja Wartość zwracana
Language() Lizbona, Portugalia "pt-PT"
Language() Rio de Janeiro, Brazylia "pt-BR"
Language() Atlanta, Stany Zjednoczone "en-US"
Language() Manchester, Wielka Brytania "en-GB"
Language() Paryż, Francja "fr-FR"
Language() Roseau, Dominika "en"
Language() Belgrad, Serbia „sr-cyrl-RS” lub „sr-latn-RS” w zależności od ustawień systemu użytkownika

Tabela lokalizacji

Proste podejście do lokalizacji polega na utworzeniu arkusza kalkulacyjny programu Excel mapującego autora zdefiniowanego za pomocą właściwości TextID na tekst przetłumaczony na język użytkownika. Mimo że dla tej tabeli można użyć kolekcji lub dowolnego innego źródła danych, wybraliśmy program Excel, ponieważ umożliwia tłumaczom łatwą edycję i zarządzanie poza aplikacją.

  1. Utwórz następującą tabelę w programie Excel:

    Tabela lokalizacji.

    Pozycja blank (wartość pusta) w kolumnie Language będzie służyć jako wartość domyślna, jeśli dla danego języka nie zostanie znaleziony konkretny ciąg tekstowy. Ta pozycja musi występować po wszystkich pozostałych pozycjach dla danej wartości TextID.

    Dla naszych potrzeb wystarczy wyszukiwanie tylko języka ustawień regionalnych, bez regionu. Gdyby region miał znaczenie, w powyższej tabeli umieścilibyśmy pełną wartość tagu języka.

  2. Na wstążce Wstawianie użyj polecenia Tabela, aby utworzyć poprawną tabelę programu Excel. Domyślnie będzie miała ona nazwę Tabela1, lecz można określić dowolną nazwę za pomocą wstążki Narzędzia tabel/Projekt i pola tekstowego Nazwa tabeli: po lewej stronie.

  3. Zapisz plik programu Excel w lokalnym systemie plików.

  4. W usłudze Power Apps w okienku po prawej stronie kliknij lub naciśnij kartę Źródła danych, a następnie kliknij lub naciśnij polecenie Dodaj źródło danych.

  5. Kliknij lub naciśnij pozycję Dodaj dane statyczne do aplikacji, kliknij lub naciśnij zapisany plik programu Excel, a następnie kliknij lub naciśnij polecenie Otwórz.

  6. Wybierz utworzoną tabelę, a następnie kliknij lub naciśnij polecenie Połącz.

Wszędzie w aplikacji tam, gdzie dotychczas był używany tekst „Hello”, wstaw zamiast niego następującą formułę:

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

Ta formuła wyszukuje wartość LocalizedText odpowiednią dla języka użytkownika, a jeśli taka wartość nie zostanie znaleziona, zostanie użyta domyślna wartość blank (wartość pusta).

Należy pamiętać, że ciągi przetłumaczone na inne języki mogą być znacznie dłuższe niż w oryginalnym języku. W wielu przypadkach etykiety i inne elementy wyświetlające ciągi w interfejsie użytkownika należy dostosować, aby pomieścić tekst.

Usługa tłumaczenia

Tekst można tłumaczyć na żądanie przy użyciu usługi tłumaczenia, takiej jak usługa Microsoft Translator:

  1. W usłudze Power Apps w okienku po prawej stronie kliknij lub naciśnij kartę Źródła danych, a następnie kliknij lub naciśnij polecenie Dodaj źródło danych.
  2. Kliknij lub naciśnij pozycję Microsoft Translator.

Wszędzie w aplikacji tam, gdzie dotychczas był używany tekst „Hello”, wstaw zamiast niego następującą formułę:

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

Usługa Microsoft Translator używa takich samych tagów języka co zwracane przez funkcję Language.

To podejście ma pewne wady w porównaniu z poprzednim przykładem, w którym wykorzystano tabelę wstępnie przetłumaczonych ciągów tekstowych:

  • Wykonanie tłumaczenia trwa pewien czas, ponieważ wymaga wywołania usługi przez sieć. Powoduje to opóźnienie wyświetlania przetłumaczonego tekstu w aplikacji.
  • Tłumaczenie zostanie wykonane przez oprogramowanie i będzie mogło różnić się od oczekiwanego oraz niekoniecznie będzie dobrze pasować do kontekstu w aplikacji.