Home
Home
German Version
Support
Impressum
25.2 Release ►

Start Chat with Collection

    Main Navigation

    • Preparation
      • Connectors
      • Create an InSpire VM on Hyper-V
      • Initial Startup for G7 appliances
      • Setup InSpire G7 primary and Standby Appliances
    • Datasources
      • Configuration - Atlassian Confluence Connector
      • Configuration - Best Bets Connector
      • Configuration - Box Connector
      • Configuration - COYO Connector
      • Configuration - Data Integration Connector
      • Configuration - Documentum Connector
      • Configuration - Dropbox Connector
      • Configuration - Egnyte Connector
      • Configuration - GitHub Connector
      • Configuration - Google Drive Connector
      • Configuration - GSA Adapter Service
      • Configuration - HL7 Connector
      • Configuration - IBM Connections Connector
      • Configuration - IBM Lotus Connector
      • Configuration - Jira Connector
      • Configuration - JVM Launcher Service
      • Configuration - LDAP Connector
      • Configuration - Microsoft Azure Principal Resolution Service
      • Configuration - Microsoft Dynamics CRM Connector
      • Configuration - Microsoft Exchange Connector
      • Configuration - Microsoft File Connector (Legacy)
      • Configuration - Microsoft File Connector
      • Configuration - Microsoft Graph Connector
      • Configuration - Microsoft Loop Connector
      • Configuration - Microsoft Project Connector
      • Configuration - Microsoft SharePoint Connector
      • Configuration - Microsoft SharePoint Online Connector
      • Configuration - Microsoft Stream Connector
      • Configuration - Microsoft Teams Connector
      • Configuration - Salesforce Connector
      • Configuration - SCIM Principal Resolution Service
      • Configuration - SemanticWeb Connector
      • Configuration - ServiceNow Connector
      • Configuration - Web Connector
      • Configuration - Yammer Connector
      • Data Integration Guide with SQL Database by Example
      • Indexing user-specific properties (Documentum)
      • Installation & Configuration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Configuration - Caching Principal Resolution Service
      • Installation & Configuration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts for Microsoft SharePoint
      • User Defined Properties (SharePoint 2013 Connector)
      • Whitepaper - Mindbreeze InSpire Insight Apps in Salesforce
      • Whitepaper - Web Connector - Setting Up Advanced Javascript Usecases
    • Configuration
      • CAS_Authentication
      • Configuration - Alerts
      • Configuration - Alternative Search Suggestions and Automatic Search Expansion
      • Configuration - Back-End Credentials
      • Configuration - Chinese Tokenization Plugin (Jieba)
      • Configuration - CJK Tokenizer Plugin
      • Configuration - Collected Results
      • Configuration - CSV Metadata Mapping Item Transformation Service
      • Configuration - Entity Recognition
      • Configuration - Exporting Results
      • Configuration - External Query Service
      • Configuration - Filter Plugins
      • Configuration - GSA Late Binding Authentication
      • Configuration - Identity Conversion Service - Replacement Conversion
      • Configuration - InceptionImageFilter
      • Configuration - Index-Servlets
      • Configuration - InSpire AI Chat and Insight Services for Retrieval Augmented Generation
      • Configuration - Item Property Generator
      • Configuration - Japanese Language Tokenizer
      • Configuration - Kerberos Authentication
      • Configuration - Management Center Menu
      • Configuration - Metadata Enrichment
      • Configuration - Metadata Reference Builder Plugin
      • Configuration - Mindbreeze Proxy Environment (Remote Connector)
      • Configuration - Personalized Relevance
      • Configuration - Plugin Installation
      • Configuration - Principal Validation Plugin
      • Configuration - Profile
      • Configuration - Reporting Query Logs
      • Configuration - Reporting Query Performance Tests
      • Configuration - Request Header Session Authentication
      • Configuration - Shared Configuration (Windows)
      • Configuration - Vocabularies for Synonyms and Suggest
      • Configuration of Thumbnail Images
      • Cookie-Authentication
      • Documentation - Mindbreeze InSpire
      • I18n Item Transformation
      • Installation & Configuration - Outlook Add-In
      • Installation - GSA Base Configuration Package
      • JWT Authentication
      • Language detection - LanguageDetector Plugin
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • SAML-based Authentication
      • Trusted Peer Authentication for Mindbreeze InSpire
      • Using the InSpire Snapshot for Development in a CI_CD Scenario
      • Whitepaper - AI Chat
      • Whitepaper - Create a Google Compute Cloud Virtual Machine InSpire Appliance
      • Whitepaper - Create a Microsoft Azure Virtual Machine InSpire Appliance
      • Whitepaper - Create AWS 10M InSpire Appliance
      • Whitepaper - Create AWS 1M InSpire Appliance
      • Whitepaper - Create AWS 2M InSpire Appliance
      • Whitepaper - Create Oracle Cloud 10M InSpire Application
      • Whitepaper - Create Oracle Cloud 1M InSpire Application
      • Whitepaper - MMC_ Services
      • Whitepaper - Natural Language Question Answering (NLQA)
      • Whitepaper - SSO with Microsoft AAD or AD FS
      • Whitepaper - Text Classification Insight Services
    • Operations
      • Adjusting the InSpire Host OpenSSH Settings - Set LoginGraceTime to 0 (Mitigation for CVE-2024-6387)
      • app.telemetry Statistics Regarding Search Queries
      • CIS Level 2 Hardening - Setting SELinux to Enforcing mode
      • Configuration - app.telemetry dashboards for usage analysis
      • Configuration - Usage Analysis
      • Deletion of Hard Disks
      • Handbook - Backup & Restore
      • Handbook - Command Line Tools
      • Handbook - Distributed Operation (G7)
      • Handbook - Filemanager
      • Handbook - Indexing and Search Logs
      • Handbook - Updates and Downgrades
      • Index Operating Concepts
      • Inspire Diagnostics and Resource Monitoring
      • Provision of app.telemetry Information on G7 Appliances via SNMPv3
      • Restoring to As-Delivered Condition
      • Whitepaper - Administration of Insight Services for Retrieval Augmented Generation
    • User Manual
      • Browser Extension
      • Cheat Sheet
      • iOS App
      • Keyboard Operation
    • SDK
      • api.chat.v1beta.generate Interface Description
      • api.v2.alertstrigger Interface Description
      • api.v2.export Interface Description
      • api.v2.personalization Interface Description
      • api.v2.search Interface Description
      • api.v2.suggest Interface Description
      • api.v3.admin.SnapshotService Interface Description
      • Debugging (Eclipse)
      • Developing an API V2 search request response transformer
      • Developing Item Transformation and Post Filter Plugins with the Mindbreeze SDK
      • Development of a Query Expression Transformer
      • Development of Insight Apps
      • Embedding the Insight App Designer
      • Java API Interface Description
      • OpenAPI Interface Description
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
      • Release Notes 22.2 Release - Mindbreeze InSpire
      • Release Notes 22.3 Release - Mindbreeze InSpire
      • Release Notes 23.1 Release - Mindbreeze InSpire
      • Release Notes 23.2 Release - Mindbreeze InSpire
      • Release Notes 23.3 Release - Mindbreeze InSpire
      • Release Notes 23.4 Release - Mindbreeze InSpire
      • Release Notes 23.5 Release - Mindbreeze InSpire
      • Release Notes 23.6 Release - Mindbreeze InSpire
      • Release Notes 23.7 Release - Mindbreeze InSpire
      • Release Notes 24.1 Release - Mindbreeze InSpire
      • Release Notes 24.2 Release - Mindbreeze InSpire
      • Release Notes 24.3 Release - Mindbreeze InSpire
      • Release Notes 24.4 Release - Mindbreeze InSpire
      • Release Notes 24.5 Release - Mindbreeze InSpire
      • Release Notes 24.6 Release - Mindbreeze InSpire
      • Release Notes 24.7 Release - Mindbreeze InSpire
      • Release Notes 24.8 Release - Mindbreeze InSpire
      • Release Notes 25.1 Release - Mindbreeze InSpire
      • Release Notes 25.2 Release - Mindbreeze InSpire
    • Security
      • Known Vulnerablities
    • Product Information
      • Product Information - Mindbreeze InSpire - Standby
      • Product Information - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    I18n Item Transformation

    IntroductionPermanent link for this heading

    Mindbreeze offers metadata internationalization. To do this, the I18n Item Transformation plugin is used for indexing.

    I18n Item Transformation pluginsPermanent link for this heading

    To use internationalization, the I18n Item Transformation plugin must be added to your Mindbreeze installation by loading the corresponding plugin (the Item Transformation Services are delivered with the package “Mindbreeze Item Transformation Plugins“).

    The plugin also has to be included in your Mindbreeze license.

    InstallationPermanent link for this heading

    • Install the plugin using the UI Manager

    ConfigurationPermanent link for this heading

    • Enable the plugin for each desired index using the UI Manager:
      • Go to the “Indices”  tab and activate “Advanced Settings”
      • Scroll down to the section “Item Transformation Services“
      • Select the “I18n Item Transformation” plugin and click “Add”
      • Under Resource Settings, click the plus icon for I18n Property.

    • Property Name: the name of the metadata for which the internationalization is to be carried out.
    • I18n Resource Directory: the directory in which the translation files are located. The name of the file defines the language, e.g. de.csv or en.csv. All files in a directory must have the same format.
    • I18n Resource Format: the file format of the translation files.
      • CSV: The first column contains the metadata values and the second column contains the corresponding translations. For example:

    404; not found

    401; not authorized

    • JSON: This file consists of a list of JSON keys/value pairs. For example:

    {

        "404": "Not found",

        "401": "Not authorized"

    }

    • Canonical Language: If set, not only translations are added to the metadatum, but also the actual metadatum value is transformed. The new value corresponds to the translation of the metadatum in the specified "Canonical Language". Default value: not set. This setting is recommended if ambiguous translations (i.e. multiple translations to the same value) exist and there are problems with hierarchical facets/filters. Note: Make sure you check for possible warnings in the log. See section "Troubleshooting“.

    For the changes to take effect, a re-indexing or a complete inversion of the index must be performed after configuration.

    Notes for Default MetadataPermanent link for this heading

    It is not directly possible to transform "default metadata" like title or extension. Other metadata specific to a connector (e.g. color or path) will work directly.

    If standard metadata is to be transformed, we recommend the following workaround: A "Precomputed Synthesized Metadatum" must be created in the index, which is then used for transforming. For example, for the standard metadata extension, a Precomputed Synthesized Metadata with "Name": transform_extension and "Property Expression": extension can be added. Then, when configuring the I18nItemTransformation plugin, the Precomputed Synthesized Metadatum "Property Name" must be set with value transform_extension.

    TroubleshootingPermanent link for this heading

    The I18nItemTransformation plugin log can be found in the following location:

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

    e.g.:

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

    Missing translations compared to translations in other languagesPermanent link for this heading

    The following message in the 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

    … means that for the metadata "recipe" in general translations exist for the values (code) "apple pie" and "cheese cake" in other languages. However, in the language "de" the translations for "apple pie" and "cheese cake" are missing.

    Please complete your translations in the languages listed.

    Missing translations compared to indexed documents:Permanent link for this heading

    The following message in the 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

    … means that a document with the key "https://mysite.mindbreeze.com/applepie" has been indexed, which does not have a translation for the metadata "recipe" and the value "apple pie".

    Please complete your translations.

    Inconsistent translationsPermanent link for this heading

    The following message in the 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

    … means that the translations of the languages "de" and "es" are inconsistent. (This message is displayed only if the "Canonical Language" setting is configured) In this case, "apple pie" and "cheese cake" in the "de" translation are translated to the same word "Kuchen". However, in the "es" translation they are translated to the two expressions "tarta de manzana" and "tarta de queso". This ambiguity can cause problems in some use cases, such as Hierarchical (Path) metadata, which are constrained with filters/facets.

    Please change your translations so that all languages are consistent. In this example, you can either change the "es" translation to just "tarta" in both cases, or you can use different words in the "de" translation, e.g. "Apfelkuchen" and "Käsekuchen".

    Download PDF

    • I18n Item Transformation

    Content

    • Introduction
    • I18n Item Transformation plugins
    • Troubleshooting

    Download PDF

    • I18n Item Transformation