Localization Task (Integration-Funktion)

Die Funktion Localization Task (Integration-Funktion) greift auf den Ressourcen-Manager von Lobster Data Platform / Orchestration zu, um über die Sprachverwaltung und ggf. Firmenspezifische Sprachanpassungen eine bestimmte Lokalisierung zu ermitteln oder – umgekehrt – den Resource Name zu einer gegebenen Lokalisierung.

Unabhängig von der Suchrichtung beim Nachschlagen ist dabei die Angabe eines Resource Bundles im Parameter a erforderlich.

Bezüglich der Eindeutigkeit der Zuordnung von Lokalisierungen ist zu berücksichtigen:

Jede Kombination von Resource Bundle und Resource Name definiert per Definition einen systemweit eindeutigen Bezugspunkt für Übersetzungen in unterschiedlichen Sprachen.
Durch Firmenspezifische Sprachanpassungen können die in der Sprachverwaltung definierten globalen Lokalisierungen für bestimmte Firmen und Sprachen übersteuert sein.
Auf der Grundlage von Firmenfreigaben können Firmenspezifische Sprachanpassungen für mehr als eine Firma gelten.
Für dieselbe Firma können Lokalisierungen für eine Bundle/Resource-Kombination konkurrieren, wenn mehrere Firmenspezifische Sprachanpassungen anwendbar sind, die sich inhaltlich überschneiden.
Bei einer Rückwärtssuche ist nicht ausgeschlossen, dass für unterschiedliche Resource Names innerhalb desselben Resource Bundles dieselbe Lokalisierung gewählt wurde. Bei Mehrdeutigkeit wird der erste "passende" Resource Name als Ergebnis zurückgegeben.

images/download/attachments/201674068/image2020-10-8_18-51-2-version-1-modificationdate-1747044309880-api-v2.png

Parameter

Parameter	Beschreibung	Beispiel	Hinweise
a	Resource Bundle	`de.lobster.scm.base.company.CompanyType`	Werte für das Resource Bundle bestehender Einträge können in der Übersicht der Sprachverwaltung nachgeschlagen werden. Das Resource Bundle für Aufzählungen ist immer der interne Name der Aufzählung, egal ob diese vom System bereitgestellt oder benutzerdefiniert sind. Der Beispielwert (links) betrifft die Dynamische Aufzählung für den Firmentyp.
b	Resource Name	`FWD`	Jedes Resource Bundle kann mehrere Resource Name-Einträge enthalten, die innerhalb des Resource Bundles eindeutig benannt sein müssen. Resource Bundles für Aufzählungen verwenden die internen Namen der enthaltenen Werte als Resource Name. Der Beispielwert (links) bezieht sich wiederum auf den Firmentyp und identifiziert den Eintrag, der Standard auf Deutsch als "Spediteur" lokalisiert ist. ►HINWEIS◄ Bei der "Rückwärtssuche" (s. Parameter f) muss hier die Lokalisierung definiert werden, zu der ein passender Resource Name gesucht werden soll.
c	Default Value (optional)	FORWARDER	Der optionale Standardtext wird als Rückgabewert nur herangezogen, wenn das Nachschlagen keinen Wert ergibt. Ist eine leere Zeichenfolge als Lokalisierung gepflegt, dann kommt der Standardtext nicht zum Tragen. Während in der Benutzeroberfläche meistens automatisch der Resource Name als Standardwert erscheint, wenn keinerlei Lokalisierung definiert ist, muss diese Regelung hier ggf. explizit formuliert werden.
d	locale (optional)	de	Die Sprache für die nachgeschlagen werden soll, kann hier optional über ihren internen Namen identifiziert werden. Fehlt die Angabe, wird die Aktuelle Sprache (der bestehenden Anmeldung) verwendet.
e	Owner ID (optional)	52	Optional kann die ID einer Firma angegeben werden, in deren Kontext nachgeschlagen werden soll. Dann werden ggf. anwendbare Firmenspezifische Sprachanpassungen berücksichtigt.
f	reverse mode (optional)	true	Der Wert `true` für diesen optionalen Parameter aktiviert die "Rückwärtssuche" (reverse mode), bei der im Parameter b ein Lokalisierungstext angegeben werden kann, für den im Parameter a definierten Resource Bundle ein passender Resource Name gesucht wird.

Beispiele

Beispiel: Suche nach einer Lokalisierung

images/download/attachments/201674068/image2020-10-8_20-15-35-version-1-modificationdate-1747044309882-api-v2.png

Hier wird die deutsche Lokalisierung für einen im Zielfeld specifiedCompanyType angegebenen Firmentyp nachgeschlagen.
Falls der angegebene Firmentyp unbekannt ist oder für diesen Firmentyp keine deutsche Lokalisierung existiert, wird der Standardwert UNKNOWN zurückgegeben.
Sofern für den Kontext der über das Quellfeld ownerId identifizierten Firma Firmenspezifische Sprachanpassungen anwendbar sind, werden diese ggf. berücksichtigt.
- Der "Sprachgebrauch" im Zielfeld, für das die Funktion hier konfiguriert ist, ist also ggf. spezifisch für den "Besitzer" des Datenobjekts in den Eingangsdaten.

Beispiel: "Rückwärtssuche" nach einem Schlüsselwert einer Dynamischen Aufzählung ausgehend von einer Lokalisierung

images/download/attachments/201674068/image2020-10-8_20-27-56-version-1-modificationdate-1747044309884-api-v2.png

Hier soll ausgehend von einer englischen Lokalisierung "Principal" der zugehörige Resource Name unter den Lokalisierungseinträgen für den Firmentyp ermittelt werden.
Dieser ist identisch mit dem internen Namen des Wertes der betreffenden Dynamischen Aufzählung und lautet im konkreten Beispiel AAL (deutsch: "Auftraggeber").