Tłumaczenia i pomoc
Podsumowanie:Funkcja tłumaczeń służy do zarządzania wersjami językowymi aplikacji tworzonych na platformie nAxiom. Pozwala ona dodawać nowe języki oraz eksportować i importować tłumaczenia nazw i opisów elementów interfejsu użytkownika oraz obiektów biznesowych zdefiniowanych w nAxiom. Zmiana wersji językowej interfejsu aplikacji odbywa się automatycznie na podstawie języka przypisanego w profilu użytkownika.
☛ AdminSPA >
ADMINISTRACJA>Tłumaczenia i pomoc
W tym temacie
Implementacja mechanizmu tłumaczeń
Idea obsługi różnych wersji językowych polega na tym, że wszystkie wartości tekstowe widoczne w interfejsie użytkownika są reprezentowane w tabelach bazy danych przez identyfikatory GUID, a ich wyświetlane wartości są pobierane z tabel core.TranslationDefinitions i core.Translations.
Funkcjonalność można objaśnić na przykładzie opisu definicji dokumentu. Podczas tworzenia nowej definicji w tabeli Core.BusinessDocuments w kolumnie Description jest zapisywany identyfikator GUID. Jednocześnie do tabeli core.TranslationDefinitions dodawany jest wpis określający definicję tłumaczenia. Konstrukcja tej tabeli jest następująca:
| Nazwa kolumny | Typ danych | Zezwól NULL | Opis |
|---|---|---|---|
| Id | int | Kolumna klucza głównego, identyfikator rekordu w tabeli | |
| RecordId | int | Identyfikator rekordu w tabeli z kolumny TableName | |
| TableName | nvarchar(MAX) | Nazwa tabeli obiektów, której dotyczy definicja tłumaczenia | |
| Field | nvarchar(MAX) | Nazwa pola, do którego odwołuje się definicja tłumaczenia | |
| Description | nvarchar(MAX) | Pomocniczy opis identyfikujący źródłowy obiekt tłumaczenia, np. Dokument biznesowy: Opis | |
| Guid | uniqueidentifier | Identyfikator GUID wartości tekstowej | |
| RowGuid | uniqueidentifier | Identyfikator GUID bieżącego rekordu | |
| RecordRowGuid | uniqueidentifier | Identyfikator GUID rekordu w tabeli z kolumny TableName |
Przykładowy wpis do tabeli core.TranslationDefinitions, który określa definicję tłumaczenia wartości tekstowej z kolumny Description w pierwszym rekordzie tabeli BusinessDocuments, może wyglądać jak niżej:
- Id: 1
- RecordId: 1
- TableName: BusinessDocuments
- Field: Description
- Description: Dokument biznesowy: Opis
- Guid: 1CB31058-415F-4F45-B46D-D3A05BBFC2B9
- RowGuid: C4A8C819-7BFB-4B92-B118-576C6DD45C71
- RecordRowGuid: 631FFC2D-0BE7-4C0D-8993-A95BB3B52B7E
Natomiast rzeczywiste wartości tekstowe odpowiadające zapisanemu w definicji identyfikatorowi GUID są zapisywane w tabeli core.Translations:
| Nazwa kolumny | Typ danych | Zezwól NULL | Opis |
|---|---|---|---|
| Id | int | Kolumna klucza głównego, identyfikator rekordu w tabeli | |
| LanguageId | int | Identyfikator języka | |
| TranslationDefinitionId | int | Identyfikator definicji tłumaczenia z tabeli core.TranslationDefinitions | |
| Value | nvarchar(MAX) | Wartość tekstowa odpowiednia dla identyfikatora języka | |
| RowGuid | uniqueidentifier | Identyfikator GUID bieżącego rekordu |
Strona Tłumaczenia i pomoc
Wartości z obu tabel są wyświetlane w AdminSPA na stronie Tłumaczenia i pomoc (ADMINISTRACJA > Tłumaczenia i pomoc).
Kolumny wyświetlanej tabeli odpowiadają kolumnom tabel źródłowych. Dostępne są funkcje filtrowania i sortowania, które ułatwiają znalezienie żądanego wpisu. Kliknięcie przycisku Edycja powoduje wyświetlenie okna dialogowego, w którym można zmienić tekst tłumaczenia.
Dodatkowo, z lewej strony u góry są dostępne trzy przyciski:
-
Eksportuj: eksportuje wyświetlaną listę w formacie programu MS Excel; plik jest zapisywany w domyślnym folderze przeglądarki dla plików pobieranych. -
Wczytaj z pliku: wyświetla okno wyboru pliku w celu wybrania pliku z tłumaczeniami; w wyeksportowanym pliku należy wstawić tłumaczenia w kolumnie odpowiedniego języka. -
Dodaj język: wyświetla okno dialogowe, w którym należy zdefiniować nowy język; dostępne pola:-
Nazwa: nazwa języka. -
Kod: dwuliterowy kod języka. -
Kopiuj z języka: lista rozwijana umożliwiająca wybór języka źródłowego, z którego ma zostać wybrane tłumaczenie.
Okno Dodaj język -
Funkcja tłumaczeń jest też dostępna w oknie kreatora formularzy, aby ją wywołać należy kliknąć przycisk Tłumaczenia i pomoc z prawej strony u góry.
Zmiana wersji językowej
nAxiom automatycznie przełącza wersję językową aplikacji w przypadku użytkownika, który w swoim profilu ma zadeklarowany język inny niż polski. Na ilustracjach poniżej przedstawiono przykładowy wygląd widoku listy i widoku formularza po stronie front-office.
Powiązane tematy: