I18n Item Transformation

Einleitung

Mindbreeze bietet eine Internationalisierung für Metadaten. Dazu wird beim Indizieren das I18n Item Transformation Plugin verwendet.

I18nItemTransformation Plugins

Um die Internationalisierung zu nutzen, muss das I18nItemTransformation Plugin zu Ihrer Mindbreeze-Installation hinzugefügt werden, indem das entsprechende Plugin geladen wird (die Item Transformation Services werden mit dem Paket “ Mindbreeze Item Transformation Plugins” ausgeliefert).

Das Plugin muss auch in Ihrer Mindbreeze Lizenz inkludiert sein.

Konfiguration

• Aktivieren Sie das Plugin für jeden gewünschten Index mithilfe der Manager UI:
  • Wechseln Sie zum Reiter „Indices“ und aktivieren Sie „Advanced Settings“
  • Scrollen Sie runter zum Abschnitt „Item Transformation Services”
  • Wählen Sie das “I18nItemTransformation” Plugin und klicken Sie auf „Add“
  • Klicken Sie unter „Resource Settings“ auf das Plus Symbol für eine neue I18n Property.

• Property Name: Der Name des Metadatums für welches die Internationalisierung durchgeführt werden soll.
• I18n Resource Directory: Das Verzeichnis wo die Übersetzungsdateien liegen. Der Name der Datei definiert die Sprache z.B. de.csv oder en.csv. Alle Dateien in einem Verzeichnis müssen das gleiche Format haben.
• I18n Resource Format: Das Dateiformat der Übersetzungsdateien.
  • CSV: In der ersten Spalte stehen die Werte des Metadatums und in der zweiten Spalte die entsprechenden Übersetzungen. Z.B.

404;Nicht gefunden

401;Nicht autorisiert

• JSON: Diese Datei besteht aus einer Liste von JSON Schlüssen/Wert Paare. Z.B.

{

    "404": "Nicht gefunden",

    "401": "Nicht autorisiert"

}

• Canonical Language: Wenn gesetzt, werden nicht nur Übersetzungen zum Metadatum hinzugefügt, sondern es wird auch der eigentliche Metadatum-Wert transformiert. Der neue Wert entspricht der Übersetzung des Metadatums in der angegebenen „Canonical Language“. Standardwert: nicht gesetzt. Diese Einstellung wird empfohlen, wenn mehrdeutige Übersetzungen (d.h. mehrere Übersetzungen auf den gleichen Wert) existieren und Probleme mit Hierarchische Facetten/Filter vorliegen. Hinweis: Beachten Sie unbedingt mögliche Warnungen im Log. Siehe Abschnitt „Troubleshooting“

Damit die Änderungen wirksam werden, muss nach der Konfiguration eine Neuindizierung oder eine Vollständige Invertierung des Index durchgeführt werden.

Hinweise für Standardmetadaten

Es ist nicht direkt möglich „Standardmetadaten“ wie title oder extension zu transformieren. Andere Metadaten, die spezifisch für einen Connector sind (z.B. color oder path) funktionieren direkt ohne Weiteres.

Falls Standardmetadaten transformiert werden sollen, empfehlen wir folgenden Workaround: Es muss im Index ein „Precomputed Synthesized Metadatum“ erstellt werden, über welches dann transformiert wird. Zum Beispiel für das Standardmetadatum extension kann ein Precomputed Synthesized Metadatum mit „Name“: transform_extension und „Property Expression“: extension hinzugefügt werden. Anschließend muss bei der Konfiguration des I18nItemTransformation Plugins dann als „Property Name“ das Precomputed Synthesized Metadatum mit Wert transform_extension gesetzt werden.

Troubleshooting

Das I18nItemTransformation Plugin Log finden Sie an folgender Stelle:

/data/logs/log-messdkjavasandbox2-Index@{{IndexPort}}_JAVA_0_Default/current/log-messdkjavasandbox2.log

z.B.:

/data/logs/log-messdkjavasandbox2-Index@23100_JAVA_0_Default/current/log-messdkjavasandbox2.log

Fehlende Übersetzungen im Vergleich zu Übersetzungen in anderen Sprachen

Folgende Meldung im Log:

... com.mindbreeze.enterprisesearch.datasource.transformation.i18n.itemtransformer.I18nVerification INTERNALWARNING: Missing translations detected for property "recipe". Please check the following table and add the missing translations.

... com.mindbreeze.enterprisesearch.datasource.transformation.i18n.itemtransformer.I18nVerification INTERNALWARNING:

Language;Missing Translation Code

de;apple pie

de;cheese cake

… bedeutet, dass für das Metadatum „recipe“ grundsätzlich Übersetzungen in andere Sprachen für die Werte (Code) „apple pie“ und „cheese cake“ existieren. Jedoch in der Sprache „de“ fehlen die Übersetzungen für „apple pie“ und „cheese cake“.

Bitte ergänzen Sie Ihre Übersetzungen in den angegebenen Sprachen.

Fehlende Übersetzungen im Vergleich zu Indizierte Dokumente:

Folgende Meldung im Log:

...com.mindbreeze.enterprisesearch.datasource.transformation.i18n.itemtransformer.I18nItemTransformationService INTERNALWARNING: No i18n text within https://mysite.mindbreeze.com/applepie found for value apple pie of property recipe

… bedeutet, dass ein Dokument mit dem Key „https://mysite.mindbreeze.com/applepie“ indiziert wurde, welches für das Metadatum „recipe“ und den Wert „apple pie“ keine Übersetzung hat.

Bitte ergänzen Sie Ihre Übersetzungen.

Inkonsistente Übersetzungen

Folgende Meldung im Log:

...com.mindbreeze.enterprisesearch.datasource.transformation.i18n.itemtransformer.I18nVerification INTERNALWARNING: Inconsistent translations detected for property "recipe" between the canonical language (de) other languages. This can lead to problematic behavior. (e.g. with hierarchical facets) Please check the following table and fix the translations to be consistent across all translated languages.

...com.mindbreeze.enterprisesearch.datasource.transformation.i18n.itemtransformer.I18nVerification INTERNALWARNING:

Canonical Language;Code;Canonical Translation;Other Language;Other Translation

de;apple pie;Kuchen;es;tarta de manzana

de;cheese cake;Kuchen;es;tarta de queso

…bedeutet, dass die Übersetzungen der Sprachen „de“ und „es“ inkonsistent sind. (Diese Meldung wird nur ausgegeben, wenn die Einstellung „Canonical Language“ konfiguriert ist) In diesem Fall wird „apple pie“ und „cheese cake“ in der „de“ Übersetzung auf dasselbe Wort „Kuchen“ übersetzt. In der "es" Übersetzung jedoch auf die zwei Ausdrücke „tarta de manzana“ und „tarta de queso“. Diese Mehrdeutigkeit kann in manchen Anwendungsfällen, wie z.B. Hierachische (Path) Metadaten, welche mit Filter/Facets eingeschränkt werden, zu Problemen führen.

Bitte ändern Sie Ihre Übersetzungen so, dass alle Sprachen konsistent sind. In diesem Beispiel können Sie entweder die "es" Übersetzung in beiden Fällen auf nur „tarta“ ändern, oder Sie können in der "de" Übersetzung unterschiedliche Wörter, z.B. „Apfelkuchen“ und „Käsekuchen“ verwenden.