Skip to main content

2019.3 to 2020.0

1. Index Search: Transition to New Index Schema​

What changed​

ADITO 2020 introduces a new index schema that replaces the older version. The previous schema is now only supported in a limited capacity.

Why it matters​

The new index schema improves indexing capabilities and performance but requires the old index to be deleted before creating a new one. Continuing to use the old index may lead to inconsistencies or degraded performance.

  • Locate the existing index folder, typically found in the server's data directory (e.g., $PROJECTHOME/data/default for the "default" system).
  • Completely delete the index folder to remove the old index.
  • Allow the system to create a new index using the updated schema during the next startup or indexing process.
warning

Creating a new index from scratch can be time-consuming depending on the volume of data. This process may impact performance on production environments.

Schedule the update during off-peak hours, such as evenings or times when minimal users are active, to reduce disruption.

2. Index Collection Naming: Configurable Collection Name Property​

What changed​

ADITO 2020 allows customization of the index collection name through the collectionName property in the instance configuration.

Why it matters​

Customizing the collection name provides better organization and clarity within the indexing system, enabling easier management of multiple indices.

  • Navigate to the instance configuration location in your xRM 2020 project: system -> default -> _____CONFIGURATION -> Modules -> Indexsearch.
  • Set the collectionName property according to your naming preferences.

Naming rules:

  • If left empty (default), the collection name will be <ProjectName>_<SystemName>.
  • Names must only contain letters, digits, dashes (-), or underscores (_).
  • Names must not start with a dash.
  • Names must not contain any whitespace characters.