Funktionsweise
Die Übersetzung von Systemaktivitäten (z.B. Konfigurationseinstellungen, Fehlermeldungen, Bezeichnungen oder Formularelemente) wird mit PHP-Konstanten ermöglicht. Diese werden in den Sprachdateien gespeichert, die Sie bereits bei der Erstellung der Verzeichnisstruktur angelegt haben (german.php, english.php). Je nach Spracheinstellung im JobRouter wird die entsprechende Sprachdatei automatisch geladen.
Jede Datei definiert dabei die gleichen Konstanten mit der Übersetzung in der jeweiligen Sprache. Diese können sowohl bei der Implementierung in PHP als auch in den Attributen der XML-Konfiguration verwendet werden (vgl. Kapitel XML-Aufbau).
Beispiel
Da die CSV-Systemaktivität sowohl in Deutsch als auch in Englisch verfügbar sein soll, füllen wir zunächst die Sprachdatei german.php mit folgendem Inhalt:
Inhalt der Sprachdatei german.php
<?php
define('CONST_SA_CSV_NAME', 'CSV Export');
define('CONST_SA_CSV_DESCRIPTION', 'Diese Systemaktivität kann dazu verwendet werden, Daten aus einer Untertabelle in eine CSV-Datei zu exportieren.');
define('CONST_SA_CSV', 'CSV');
Tipps
•Damit die Namen der Konstanten absolut eindeutig sind und es nicht zu Konflikten kommt, empfiehlt es sich, das Präfix CONST_SA_<SystemActivityId> für Konstanten zu verwenden, in unserem Fall CONST_SA_CSV_NAME. Daraus ergibt sich außerdem der Vorteil, dass die Konstanten über die Suche im Quelltext schneller gefunden werden können.
•Darüber hinaus empfiehlt es sich, die Systemaktivität unter Verwendung einer einzigen Sprachdatei zu entwickeln und diese Sprachdatei erst nach der Fertigstellung der Systemaktivität in andere Sprachen zu übersetzen, um den Aufwand geringer zu halten.
