Breadcrumbs

i18nCustom

Versionshinweise

11.2

Code

Groovy
String I18nUtils.i18nCustom(String key, Locale language, Object... parameter)

Beschreibung

Erzeugt einen internationalisierten Text anhand einer an anderer Stelle mehrsprachig hinterlegten Textvorgabe.

Parameter

  • key: Identifikator einer Sprachvariable (mehr dazu siehe unten), z.B. “QuoteCustomerEmpty”

  • language: gibt die Sprache an, z.B. SessionConstants.LOCALE für die momentane Anwendungs-Sprache oder LocaleConstants.ENGLISH, LocaleConstants.GERMAN usw. für eine bestimmte Sprache.

  • parameter: optionale kommaseparierte Liste von Werten, die anstelle von Platzhaltern {0}, {1}, {2} usw. in den Text eingebaut werden.

Rückgabe

Gibt den internationalisierten Text zurück. Wurde der angegebene key in der Tabelle der Sprachvariablen nicht gefunden, so wird er selbst zurückgegeben.

Hintergrund: Sprachvariablen

Sprachvariablen sind Texte, die in mehreren Sprachen hinterlegt sind.

image-20260724-093222.png

  • Man kann beliebig viele neue Sprachvariablen anlegen.

  • Die Sprachvariablen finden sich zum Beispiel im Scriptbibliotheks-Editor oben rechts.

  • Die dort hinterlegten Sprachvariablen stehen nicht nur in der einzelnen Scriptbibliothek zur Verfügung, sondern anwendungsweit.

  • Die Sprachvariablen bilden eine Tabelle.

  • Die erste Spalte heißt “Schlüssel” und dient zum Ansteuern der Zeile. Das ist ein an dieser Stelle frei vergebener String und hat nichts mit Schlüsselwerten, ILookup oder Schlüsselfeldern zu tun.

  • Die weiteren Spalten stehen für die unterstützen Sprachen.

Beispiele für Einträge:

Schlüssel

Deutsch

Englisch

Französisch

QuoteCustomerEmpty

Im Angebot {0} ist das Feld Kunde leer.

In offer {0}, the customer field is empty.

Dans l'offre {0}, le champ « Client » est vide.

FileCopyErrorOccured

Beim Kopieren der Datei {0} nach {1} trat der Fehlercode {2} auf.

Error {2} occured while copying file {0} to location {1}.

L'erreur {2} s'est produite lors de la copie du fichier {0} vers l'emplacement {1}.

Beispiele für die Nutzung:

Groovy
I18nUtils.i18nCustom("QuoteCustomerEmpty", SessionConstants.Locale, sQuoteNo); // mit sQuoteNo = "ANG 12345"
// Ergibt "Im Angebot ANG 12345 ist das Feld Kunde leer." wenn die Anwendungssprache deutsch ist.
// Ergibt "Dans l'offre ANG 12345, le champ « Client » est vide." wenn die Anwendungssprache französisch ist.

I18nUtils.i18nCustom("FileCopyErrorOccured", LocaleConstants.ENGLISH, src, dst, "ERR13");
// Ergibt z.B. "Error ERR13 occured while copying file C:\temp\example.txt to Q:\dataexchange\example.txt."