Migration to the multilingual search2¶
New in version 25.4.
VidiCore comes with the beta version of a new multilingual search feature. Search version 2 requires the usage of the new search version 2 API in conjunction with the new SearchDocument for sending search criteria.
To migrate an existing system to the new multilingual search2, please look into the following instructions.
Note
This feature for multilingual searching is in the beta phase. Following topics are subjects of change while in the beta status.
Language dependency of metadata fields¶
Please check all language dependency attributes of all metadata field definitions. For more information see Metadata fields language dependencies.
When the languageDependent attribute is set to false the field is not allowed to contain language information. Metadata which do contain
a lang attribute in the MetadataValueType but is not configured as languageDependent will cause an exception when creating an item or an collection.
A field which languageDependent attribute is set to true may or may not contain lang attributes in MetadataDocument.
Synch index¶
Synchronize the default index of the search2 for this feature. Therefore it is enough to perform a /APIinit or
the call POST /APIinit/indices when you already initialized the API.
Create / Recreate the default index for search2¶
- For initialized systems which upgrade to version 25.4.0:
- When migrating an already initialized system it is necessary to recreate the search2 default index. Do this with the new index API
Delete index and Index creation. Set the
languageof the IndexDocument toNESTED.
- When migrating an already initialized system it is necessary to recreate the search2 default index. Do this with the new index API
Delete index and Index creation. Set the
- For new systems beginning with the version 25.4.0:
- From this version it is possible to create both default indices with
opensearch init. An additional index creation with both new API-resources is not necessary, when both indices were not already initialized.
- From this version it is possible to create both default indices with
Note
The default index of the search2 will still be in use and is used to contain all information when languageDependent fields do not have set a lang attribute
in the MetadataDocument.
Activate multiple indices¶
To create an index it is necessary to set the configuration useMultipleSearchIndices to true. When changing this property
a reindex of each language index is necessary, e.g.: API/reindex/collection?lang=english, see Re-indexing metadata. Please perform a reindex of the
NESTED index as well.
When this property is changed it is possible to create multilingual indices with Search2 index creation (beta).