- v1.0.0-latest-prod
Catalog Services provides additional facilities to support search engines' needs for indexing catalog data, primarily Products. Out-of-the-box Broadleaf provides a Search microservice that integrates with Catalog Services and Apache Solr to enable searching Product data.
The entry-point for indexing requests is the ProductEndpoint. The ProductEndpoint supports two requests of relevance for gathering products to index:
#readAllProductIdsIgnoreNarrowing: This endpoint allows an search indexer to request large batches of the IDs for the products to be indexed, and it then breaks them into smaller batches to use to fetch the actual Products.
This improves the overall efficiency of indexing and keeps batch sizes smaller (byte-wise).
The usage pattern for this endpoint is to provide a max size and then use RSQL filters to specify the cursor position.
#readAllProductsIgnoreNarrowingHydrated: This endpoint allows fetching the actual Products to be indexed along with all of the data from its relationships (like its parent Categories) in a single request.
This is similar to what we do to support a product details page but for search-indexing-specific data.
|
Tip
|
See the Search Service’s indexing documentation for the particulars of how Broadleaf handles indexing out-of-box. |
The #readAllProductsIgnoreNarrowingHydrated endpoint will return a list of ConsolidatedProducts.
A ConsolidatedProduct contains all of the fields of a Product along with the following:
variants: All of the product’s Variants
primaryCategory: The product’s primary parent Category
Contains an object with the id, name, and URL of the category
explicitCategories: The product’s other parent Categories that reference it explicitly
This is a list of objects with the id, name, and URL of each category
categories: Categories that contain this product directly or indirectly such as through their own sub-categories.
This is a list of objects with the id, name, and URL of each category
dataDrivenEnums: All of product’s Data Driven Enums, which include product’s brand, merchandising type, and target demographic.
This is a list of objects with the id, type, value, and display value of each data driven enum
productSortingWithinCategories: Maps a parent Category’s ID to the relative sort order of the product therein compared to the ordering of the other product’s in the category.
catalogOverrides: The IDs of descendant catalogs in which this context version of the product has been overridden.
If this product is in catalog "A", and catalog "B" inherits this product from catalog "A" but contains a local change for this product, then the catalog "A" version product will contain the ID B in its catalogOverrides.
catalogOmissions: The IDs of descendant catalogs in which this context version of the product has been omitted as a result of one or more filters.
If this product is in catalog "A", and catalog "B" inherits this product from catalog "A" but contains a filter that removes it from the view of catalog "B", then the catalog "A" version product will contain the ID B in its catalogOmissions.
sandboxOverrides: The IDs of descendant sandboxes in which this context version of the product has been overridden.
If this product is in sandbox "A", and sandbox "B" inherits this product from sandbox "A" but contains a local change for this product, then the sandbox "A" version product will contain the ID B in its sandboxOverrides.
translations: Translations for the product and all translatable fields in the consolidated objects.
local: Locale wherein the translation is applicable
entityType: The type of entity the translation belongs to
archived: Whether this product has been archived in the request’s context.
advancedTags: References to all the AdvancedTags related to the product via ProductTags.
The refs contain the following properties
id: ID of the advanced tag
name: Name of the advanced tag.
This is what normally is indexed for faceting and searching.
type: The type of the advanced tag.
This can be used to group the tags into separate facets such as a "Feature" facet or a "Discount Type" facet.
The Search Field for the facet can take advantage of our support for JSON path syntax when setting the property path, e.g., advancedTags[?(@.type == "FEATURED")].name.
searchableByName: Whether the tag is also supposed to be searchable as a term and not just used for faceting.
Similar to type, a Search Field can be set up with this property to include only searchable tags: advancedTags[?(@.searchableByName)].name.
sandboxOwner: The owner of the sandboxed product if it’s in a user sandbox.
This service is responsible for retrieving and building the the ConsolidatedProducts. By default it defers the work of consolidating the different relationships of a Product together to the ProductConsolidationContributors. Then, it uses the ConsolidatedProductPostProcessor for any additional data hydration.
The process starts by retrieving the products, including any that are archived.
Then, all of the Categories that these products belong to are retrieved.
Next, the catalog inheritance lines are computed. These are computed from the top-down and bottom-up to determine inherited properties, overrides, and omissions.
Then, the ProductConsolidationContributors are invoked to handle hydrated additional relationships owned by the Catalog Services onto the ConsolidatedProduct.
Last, the ConsolidatedProductPostProcessor is invoked to perform any additional setup or hydration based on the consolidation performed previously.
These services are responsible for contributing a subset of information for a ConsolidatedProduct such as the product’s Variants. They provide a simple means of adding in additional augmentations to the ConsolidatedProduct response by registering a new contributor.
OptionTemplateProductConsolidationContributor: This contributor is responsible for retrieving the option templates referenced by this product’s options as well as their translations.
PrimaryAssetProductConsolidationContributor: This contributor is responsible for retrieving the product’s primary Asset.
CategoryProductConsolidationContributor: This contributor is responsible for setting the product’s various Category relationships.
VariantProductConsolidationContributor: This contributor is responsible for retrieving the product’s Variants.
TranslationProductConsolidationContributor: This contributor is responsible for retrieving the translations for all the displayable text fields on the various entities involved in the resulting ConsolidatedProduct.
It is important for this to run last so that all relevant translations can be gathered.
ProductTagConsolidationContributor: This contributor is responsible for retrieving the product’s related ProductTags.
This will also contribute the translations for the related tag since they are not catalog discriminated, so the normal process used by TranslationProductConsolidationContributor will not workâtranslations are owned by AdvancedTags.
This should be run after TranslationProductConsolidationContributor so that the translations are not overwritten.
DataDrivenEnumConsolidationContributor: This contributor is responsible for retrieving the product’s Data Driven Enums as well as their translations, which include product’s brand, merchandising type, and target demographic.
Unlike Assets and Variants, Data Driven Enums are independent of Product and don’t have a direct relationship with it like other entities do.
Therefore, the consolidation of their translations is done here instead of TranslationProductConsolidationContributor.
This should be run after TranslationProductConsolidationContributor so that the translations are not overwritten.
Additionally, an abstract class, ContextualProductConsolidationContributor, is implemented to support common behaviors of the contributors dealing with ContextStateAware entities, which in the default case is all of the contributors.
|
Note
|
|
This service is responsible for any additional setup or hydration necessary for the ConsolidatedProduct. By default, it handles setting [catalogOverrides], [catalogOmissions], and [sandboxOverrides].