A key aspect of the Guided Search integration involves treating product categories both as category items in the product catalog repository and as Guided Search dimension values. In some contexts categories are accessed via their category IDs, while in other contexts they are accessed via their dimension value IDs.

To manage the relationship between categories and dimension values, the Guided Search integration maintains a cache that maps each Oracle Commerce Platform category ID to the equivalent Guided Search product.category dimension value ID. The cache supports two-way lookup, so either value can be obtained if the other one is known.

If your Guided Search environment includes multiple MDEX engines (for example, if you use a separate MDEX for each language), a separate dimension value cache is maintained for each MDEX. This avoids any collisions that might be caused by multiple MDEX engines using the same dimension value IDs.