Broadleaf Microservices
  • v1.0.0-latest-prod

Release Notes for 1.8.11-GA

Requirements

  • JDK 11 is required for Broadleaf release trains 1.7.0-GA, and beyond.

  • JDK 17 is supported for Broadleaf release trains 1.8.1-GA, and beyond.

New Features & Notable Changes

  • Added support for Product Business Types

  • Added support to leverage a new DataTracking concept called Active Flag (ActiveFlagAware) for Product and Variant that behaves similarly to active dates. If the flag is false, then the entity is not returned.

  • Added CatalogServiceMarketplaceCatalogChangeListener to conditionally process Marketplace Application Catalog change events and build reindex requests for the catalog’s products.

    • Includes properties to enable/disable the processing of specific catalog change events (i.e. assignments to the application, removal from the application, or updates to the catalog’s status), see MarketplaceCatalogReindexProperties

Product Business Types

Product Business Types allow administrators to define business types that can be applied to products. These business types can be used to filter products in the admin and can be used to define custom product views and fields. This feature is disabled by default.

To enable this feature, set the following property in your properties file:

broadleaf:
  catalog:
    metadata:
      products:
        enable-business-types: true

Enabling this feature will add a new section to the admin called "Business Types". This section allows you to define business types that can be applied to products. It also updates the Product Browse view within the admin to allow you to filter products by business type.

Product and Variant Maintenance View Changes

The Product Maintenance View has undergone changes to its structure and contents to improve the out of box experience. This class is used to return fields that have been removed or hidden by default for Product and Variant maintenance. All fields are still present on the domains themselves, only the metadata has been modified.

  • To enable showing all now-hidden product fields use broadleaf.catalog.metadata.legacy.products.show-hidden-fields

  • To enable showing all now-hidden variant fields use broadleaf.catalog.metadata.legacy.variants.full-variant-form

  • An application-legacy.yml spring profile was also added to MS Demo to demonstrate reenabling this properties as well. It looks like this:

    broadleaf:
      catalog:
        metadata:
          legacy:
            products:
              show-hidden-fields: true
            variants:
              full-variant-form: true

Changes made to the Product Form

  • Individually Sold was moved to the Advanced Form inside of a new Miscellaneous group

  • Eligible for Pickup, Available Online, and MSRP are no longer represented in metadata.

  • The Fulfillment Pricing and Ratings & Review groups have been removed. These include the fields Fulfillment Flat Rates, Number of Reviews, Overall Rating, and Rating Units.

  • Default price was re-labelled "Price".

Changes made to the Variant Form

For Variants, it is easier to list what fields are still represented in metadata instead of which were removed:

  • Sku

  • Name: This is derived from the Product’s now by default.

  • Product Option Attribute Values (e.g., Color, Size)

  • Default Price: This is derived from the Product’s now by default.

  • Sale Price: This is derived from the Product’s now by default.

  • Active Start Date: This is derived from the Product’s now by default.

  • Online (or Is Active): This is derived from the Product’s now by default.

  • External ID

  • Custom Attributes

Bug Fixes

  • Fixed performance issue with DefaultProductHydrationService#hydrateDefaultVariant where a query was being executed per product

  • Added validation to prevent a product being added to the same category more than once.