Udostępnij przez


Funkcja Language

Dotyczy: Aplikacje kanwy Copilot Studio Desktop przepływy interfejsu wiersza polecenia platformy Power Platform funkcje Dataverse Power Pages

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

Popis

Funkcja Language zwraca język, skrypt i region bieżącego użytkownika jako tag języka.

Użyj informacji o języku, aby dopasować aplikację do ustawień regionalnych. Jeśli na przykład tworzysz aplikację używaną we Włoszech i Francji, możesz użyć Language jej do automatycznego wyświetlania włoskich i francuskich ciągów dla użytkowników w tych różnych lokalizacjach.

Language Tagi

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

Wartość zwracana Popis
"lg-RE" lg to dwuznakowy skrót języka, a RE to dwuznakowy skrót regionu. Jest to najbardziej typowy typ zwracany. Na przykład "en-GB" jest zwracany dla Zjednoczonego Królestwa.
"LG" LG to dwuznakowy skrót określający język. Jest to format używany, gdy usługa Power Apps zawiera informacje o języku, ale nie ma informacji dla określonego 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 Wartość("1", na pasku formuły lub 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. Podczas przekazywania tagu języka do tych funkcji i regionu nie miałoby to znaczenia, możesz użyć tylko części języka tagu.

Składnia

Language()

Przykłady

Ustawienia regionalne użytkownika

Zakłada się, ż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ń systemowych 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. Chociaż można użyć kolekcji lub dowolnego innego źródła danych dla tej tabeli, wybraliśmy program Excel, ponieważ łatwo jest edytować aplikację i zarządzać nią poza aplikacją przez tłumaczy.

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

    Tabela lokalizacji.

    Wpis z wartością pustą dla Language kolumny jest używany jako domyślny, jeśli nie znaleziono określonego ciągu tekstowego dla danego języka. 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. Jeśli zagadnienia regionalne były ważne, możemy uwzględnić pełną wartość tagu języka w powyższej tabeli.

  2. Na wstążce Wstawianie użyj polecenia Tabela, aby utworzyć poprawną tabelę programu Excel. Domyślnie ma ona nazwę Table1 , ale możesz nazwać ją dowolną nazwą za pomocą wstążki Narzędzia tabel/Projekt i pole tekstowe 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 pozycję 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 pozycję Otwórz.

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

W aplikacji wszędzie tam, gdzie wcześniej użyto tekstu "Hello" , użyj tej formuły:

  • LookUp( Tabela1, TextID = "Hello" && (LanguageTag = Left( Language(), 2 ) || IsBlank( LanguageTag ))). Zlokalizowany tekst

Ta formuła będzie wyszukiwać odpowiednią wartość LocalizedText dla języka użytkownika, a jeśli nie zostanie znaleziona, powróci do domyślnej pustej wersji.

Przetłumaczone ciągi w innych językach mogą być dłuższe niż w Twoim języku. W wielu przypadkach etykiety i inne elementy, które wyświetlają ciągi w interfejsie użytkownika, są potrzebne do szerszego uwzględnienia.

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 tych samych tagów języka, które Language zwraca funkcja.

Takie podejście ma pewne wady w porównaniu z poprzednim przykładem, w którym użyto wstępnie przetłumaczonej tabeli ciągów tekstowych:

  • Tłumaczenie zajmuje trochę czasu, co wymaga wywołania usługi w całej sieci. Powoduje to opóźnienie, aby zobaczyć przetłumaczony tekst w aplikacji.
  • Tłumaczenie jest mechaniczne i może nie być tym, co przewidujesz lub jest najlepszym wyborem dla sytuacji w aplikacji.