Projektsprache übersetzen (lokalisieren)

PLCnext Engineer unterstützt die Übersetzung von Kommentaren und HMI-Texten in andere Landessprachen.
Aktuell sind zwei Methoden verfügbar:

Die HMI-Applikation bietet das vordefinierte applikationsspezifische lokale Tag LanguageCode. Mit Hilfe dieses Tags kann die Anzeigesprache benutzerdefinierter Zeichenketten (z.B. Objektbeschriftungen usw.) bei der Ausführung der HMI-Applikation umgeschaltet werden. Die HMI-Applikation liest dann die vorbereiteten Übersetzungen aus dem 'Ressourcen'-Editor ein.
Weitere Informationen finden Sie im Thema "HMI-Applikation lokalisieren".
Die Funktionsbausteine GET_LANG_STRING und GET_LANG_WSTRING können im Applikationscode verwendet werden. Die FBs lesen vorbereitete Übersetzungen von Variablenkommentaren, anwenderdefinierten Texten (wie z.B. Meldungstexten) und freien Code-Kommentaren aus dem 'Ressourcen'-Editor und schreiben diese in eine anwenderdefinierte String-Variable. Eine solche String-Variable mit dem "Zieltext" kann in der Applikation weiter verarbeitet und/oder in der HMI-Applikation visualisiert werden.
Weitere Informationen finden Sie im unten stehenden Abschnitt "Lokalisieren mit den FBs GET_LANG_STRING/GET_LANG_WSTRING".

Standardsprache und Zielsprachen auswählen

Um die Lokalisierungsfunktion verwenden zu können, müssen im 'Optionen'-Dialog eine Standardsprache und mindestens eine alternative Sprache eingestellt sein:

Wählen Sie 'Extras > Optionen'.
Wählen Sie im linken Bereich die Kategorie 'Lokalisierung | Standardspracheinstellungen'.
Wählen Sie im rechten Bereich eine 'Standard'-Sprache aus.
Definieren Sie eine alternative Sprache (Zielsprache, auf die umgeschaltet werden kann): Wählen Sie im Bereich 'Alternative' den gewünschten Eintrag und klicken Sie auf 'Alternative hinzufügen'. Die Sprache wird in die Liste der 'Alternative (Sprachen)' eingefügt (die Liste zeigt die im Projekt verfügbaren Landessprachen). Wiederholen Sie diesen Schritt für jede gewünschte Sprache.
(Im Bereich 'Verfügbar' können keine weiteren Sprachen hinzugefügt werden.)
Schließen Sie den 'Optionen'-Dialog mit 'OK'.
Starten Sie PLCnext Engineer neu, um die Änderungen anzuwenden.

Lokalisieren mit den FBs GET_LANG_STRING/GET_LANG_WSTRING

Bevor Sie die nachfolgenden Schritte ausführen, stellen Sie sicher, dass die Lokalisierungsfunktion im 'Optionen'-Dialog aktiviert ist und die gewünschten Zielsprachen in die Liste der alternativen Sprachen hinzugefügt wurden. Lesen Sie hierzu die Beschreibung oben.

Falls Variablenkommentare zu übersetzen sind: Öffnen Sie die Variablentabelle der betreffenden POE.
Aktivieren Sie das Kontrollkästchen 'Übersetzen' für alle gewünschten Variablen.

Hinweis
Die Variableneigenschaft 'Übersetzen' ist nicht in Datenlisten verfügbar. Statt die globale Deklaration als übersetzbar zu definieren, müssen Sie dies bei der jeweiligen Extern-Deklaration in der lokalen Variablentabelle tun.

Die 'Ressourcen'-Tabelle der POE wird automatisch aktualisiert, auch wenn sie bereits offen ist.

Öffnen Sie den 'Ressourcen'-Editor jeder POE, deren Texte übersetzt werden sollen.
Im 'Ressourcen'-Editor sind alle übersetzbaren Variablenkommentare (Abschnitt 'Variablen') und freie Kommentare im Abschnitt 'Code' bereits gesammelt.
Im Abschnitt 'Anwender' können Sie freie anwenderdefinierte Texte eingeben.
Geben Sie die Übersetzungen in die Spalten mit den Zielsprachen ein. (Welche Sprachen/Spalten verfügbar sind, hängt von den Einstellungen im Dialog 'Optionen' ab.)
Ein Mechanismus zur Unterstützung externer computergestützter Übersetzung wird bald verfügbar sein.
Fügen Sie den Funktionsbaustein GET_LANG_STRING oder GET_LANG_WSTRING in ein Code-Arbeitsblatt ein. Die FBs sind in der Bibliothek 'PLCnext Controller' enthalten.
Verbinden Sie die Formalparameter des Funktionsbausteins. Weitere Informationen finden Sie in der Beschreibung des Funktionsbausteins ‣ GET_LANG_STRING
×‣ GET_LANG_WSTRING
×.
Ein String in der 'Ressourcen'-Tabelle ist wie folgt zu spezifizieren: POEname.Tabellenabschnitt.ID
Beispiel

Um die deutsche Übersetzung des Englischen Textes Sorry occupied in der POE Main abzurufen, setzen Sie die FB-Eingänge wie folgt:
STRING_NAME = Main.Anwender.GarageFull und
LANG_CODE = de

Die Strings an den FB-Eingängen LANG_CODE und STRING_NAME können beispielsweise aus einem vorgelagerten Codeteil mit String-Funktionen (Zeichenfolge-Funktionen, wie z.B. Concat, Find, etc.) stammen.
Durch eine Weiterverarbeitung des am FB-Ausgang LOCALIZED_STRING ausgegebenen Strings kann der übersetzte Text z.B. in der HMI-Applikation visualisiert oder zur Steuerung der Applikation im Code ausgewertet werden.