Introduction

Welcome to Intershop Commerce Management 7.10 LTS. 

Based on your feedback and in order to support the planning of updates, upgrades and enhancements, Intershop Commerce Management 7.10 includes long-term support (LTS) releases from ICM Patch Version 7.10.26. For more information, refer to Concept - Continuous Releases.

This Public Release Note contains information about the latest features of Intershop Commerce Management. In addition, it serves as a quick reference for the latest documentation.

References

For release notes for continuous releases, refer to Public Release Note - Intershop Commerce Management B2C/B2X 7.10.

Assemblies

Intershop Commerce Management B2C

Intershop Commerce Management B2X

New & Noteworthy

Microsoft SQL Server Support

With ICM 7.10.2 Intershop supports Microsoft SQL Server 2017 as alternative to Oracle Database. All features including Replication are supported by SQL Server. We also support Oracle Database 12c Release 2 now.

Intershop Progressive Web App

The Intershop Progressive Web App is an essential component of Intershop's new cloud strategy and an alternative storefront for Intershop Commerce Management. Through the clear separation of the Intershop Commerce Suite back-end from the visualization layer and the introduction of clearly defined Synaptic Commerce® APIs, partners and customers can design and customize the Intershop Storefront easier than ever before. Web Developers can use the Intershop PWA to implement storefront applications based on the Intershop Commerce Management (ICM) WebShop REST API and/or 3rd party systems. The Intershop PWA has a four-week release cycle, with new features being added on an ongoing basis.

Microsoft Dynamics 365 Integration

Intershop is developing Microservices to connect the Intershop Commerce Management 7.10 with Microsoft Dynamics 365 for Finance and Operations. The intention is to enhance the performance of the Dynamics 365 ERP-System by using automated Microservices to ensure data consistency, correctness and fast processing. The Microservice architecture allows a flexible adoption to customer-projects and a fast and agile integration in existing software-landscapes. The connectors for Orders and Inventory are part of the ICM 7.10 GA release. On an ongoing basis further standard connectors for Products, Customers and Prices will be made available for the Intershop Commerce Management 7.10 via a four-week release cycle.

Limitations

ICM 7.10.2 supports Microsoft SQL Server.

Selective inbound product sharing does not work in hotfix release 7.10.32.20 (78692). If you are using this feature, please use hotfix release 7.10.32.22 instead.

Release Documents

System Requirements

To read about the newest system requirement, please refer to:

• System Requirements - Intershop Commerce Management B2C/B2X 7.10 (valid from 7.10.6.0)

The Reference - CI Dependencies of Intershop Commerce Management provides a mapping of all:

• CI-versions of the ICM
• Intershop CI Bootstrap version
• Intershop Gradle Tools version
• Intershop Responsive Starter Store version

Feature Lists

Please see our feature lists for more details about the new release:

Concepts & Cookbooks

For a list of all available ICM 7.10 documents, use the ICM 7.10 filter in our Knowledge Base.

Migration Guides

For migrations within 7.10 versions refer to the following documents:

Changelog

Hotfix Release 7.10.38.23

• DBPrepare is required for the following change, see Concept - DBPrepare:
  • Updated views: ieproductcategoryassignment, V_PRODUCTSHARING (81446)

Hotfix Release 7.10.38.21

• An issue related to replication in Oracle Database has been identified and resolved via custom fix.
  The fix provided in Support Article - Prevent Replication Error in ICM 7.10.38.20/21-LTS Oracle Environments ensures optimal performance.
• Added a dry-run functionality for server health checks. See Guide - 7.10.38.21 Server Health Checks and Concept - Server Health Checks.
• REST API changes: the read-only properties externalId and externalUrn have been added to the address resource object. This compatible change affects the following APIs:
  • Reference - Address Check REST API 1.1.0
  • Reference - Basket REST API 0.2.0
  • Reference - Customer REST API 1.2.0
  • Reference - Order REST API 0.2.0
  • Reference - Subscription (Recurring Order) REST API 1.1.0

Hotfix Release 7.10.38.20

• An issue related to replication in Oracle Database has been identified and resolved via custom fix.
  The fix provided in Support Article - Prevent Replication Error in ICM 7.10.38.20/21-LTS Oracle Environments ensures optimal performance.
• A migration of PreferenceDefinitions from the a-responsive to the icm-as-business repository was necessary. See Guide - 7.10.38.20 Migrate PreferenceDefinitions from a_responsive.

Hotfix Release 7.10.38.16

• The DBPrepare parameter "--drop-useless-indexes" has been removed without replacement. Indexes are checked only during the initialization of a database now, not during migration.

Hotfix Release 7.10.38.14

• DBPrepare is required for the following changes, see Concept - DBPrepare:
  • Fix for not null constraints that are missing because of an issue prior to release 7.10.38.11. See Guide - 7.10.38.14 Fix NOT NULL Constraints for details
  • Fix for Inbound Product Sharing option "Activate selected shared products" leading to sharing of all products (77855)
  • Fix for Inbound Product Sharing option "Activate selected shared products", where it was not possible to select any product (78692)
  • Fix for runtime issue of DeleteDomainReferences job (76311)
• Various improvements in the Rating & Review REST API
  • The item details of the review now contain:
    • the boolean attribute own to reflect whether the currently authenticated user is created forthe review
    • a new processable "statusCode" indicating the status of the review
  • On review creation the title and content of a review are checked for profanity now
  • See Guide - 7.10 REST API Changes
• The details of a user now additionally contain the string attribute login in the Contact Center REST API
  • See Guide - 7.10 REST API Changes
• When importing Product Attribute Groups, it is now validated whether the assigned domain and the current import domain match. If they do not match, the affected Product Attribute Group will not be imported (78678)
  • To restore the old behavior (no validation of domains), it is possible to set the following property: intershop.import.validator.productattributegroup.validateDomain=false

Hotfix Release 7.10.38.11

• The following changes were made to the PriceList import.
  
  • A new JDBC based import for PriceList was implemented to increase the performance.
  • This new import currently supports only import mode Initial and Delete.
  • It is still in Beta state, this means it is still in testing phase and should be used with caution.
  • For details see Concept - Pricing: JDBC Import and Cookbook - Pricing - Recipe: Enable PriceList JDBC Import.

Patch Release 7.10.38.9

Migration Guides

Please consult the following migration guidelines when upgrading to 7.10.38.9 LTS:

• Guide - 7.10 API Changes
• Guide - 7.10 REST API Changes
• Guide - 7.10.34.0 Encrypted Passwords in Managed Services
• Guide - 7.10.37.1 Cleanup of Leading and Trailing Custom Attribute Names
• Guide - 7.10.38 Data Migration for File Content Display in TinyMCE
• Guide - 7.10.38.9 Rework Job ProcessActivePromotionProducts

• Guide - 7.10.38.9 Rework Job ResetBudgetsSpentJob

• Guide - 7.10.38.9 BasketLineItemPositioning Default Preference
• Guide - 7.10.38.9 Rest API ProductHandler Rework
• Guide - 7.10.38.9 Move System-Managed Pagelet Creation From System Startup to DBPrepare
• Guide - 7.10.38.9 Quantity Units of Scale Price Quantities
• Guide - 7.10.38.9 Library Updates on Patch Level

Changes for 7.10.38.9

• DBPrepare is required for the following change, see Concept - DBPrepare:
  • Fixed errors in the back office when using v_product, when at least one local product has many category assignments (75226)
• The integrated WYSIWYG Editor "Tiny MCE" was updated to the latest version 5.6.2. In this context some interaction and visual design aspects have been improved and bugs have been fixed. See HTML Editor in the ICM Online Help.
• Various improvements in the Product & Category REST API
• /products usually retrieved product lists from the search index, however had a fallback to the database. This had an impact on performance, especially for large amounts of products in combination with a large number of requested attributes. Thus, the database fallback has been removed. So, in case there is no search index available, the API will return error code 503 (Service Unavailable). In case you need the database fallback, please see the following bullet point.
• Stabilization leads to better performance of product list calls (i.e. /products and /categories/{category path}/products). This is achieved by requesting the data from the search index and by querying only the absolutely necessary data. Please note that we changed the ProductHandler and removed the usage of some pipelines. See Guide - 7.10.38.9 Rest API ProductHandler Rework. In case your project did customization in this area, you can easily switch back to the old handler which still uses the old pipelines and contains the database fallback. However, please note that the corresponding code was set to deprecated, and will be removed in a future version. So you should plan to update your customization.
• /products has the query parameter "amount" which previously had no limit. To avoid serious performance issues, we added a limit of 200. If your project absolutely requires larger amounts, e.g., because your custom PWA does not implement paging yet, you can increase the limit.
• Authenticated calls for the resources ProductsResource and ProductListResource will now check if the provided spgid matrix parameter matches with the user.
• See Guide - 7.10 REST API Changes
• The "last update" time of a search index which is displayed in the back office was changed from "last time of change regardless of success" to "last start time of a successful search index build/update".
• A configurable option has been (re-)added to the Shopping Cart & Checkout section of the Application configuration interface in the back office which allows for activation or deactivation of automatic line item repositioning. See Concept - Basket Handling and Checkout | Basket Configurations and Managing Shopping Cart Preferences | Line Item Positioning in the ICM Online Help.
  • A migration routine for preserving the current behavior was added - see Guide - 7.10.38.9 BasketLineItemPositioning Default Preference.
• The 'stores' REST resource now provides latitude and longitude.
• The job "ProcessActivePromotionProducts" has been reworked - see Guide - 7.10.38.9 Rework Job ProcessActivePromotionProducts.
• The demo store references release 3.1.0 of the SolrCloud Search Service Adapter with changes in query parsing and index build behavior.
• The handling of scale price quantities has been changed, see Guide - 7.10.38.9 Quantity Units of Scale Price Quantities for details.
• The creation of system-managed pagelet has been moved from system start to the database preparation, see Guide - 7.10.38.9 Move System-Managed Pagelet Creation From System Startup to DBPrepare.
• The deletion of price lists in the back office has been reworked for better performance. That includes skipping the product locking. In case the old deletion needs to be used or customization has been done in pipeline "BatchProcessPriceList", you can easily switch between both delete implementations in the mentioned pipeline.
• The product price REST API now supports min / max prices for product variations and min / summed up prices for retail sets. See also Guide - 7.10 REST API Changes | Product Price REST API.
• The jQuery framework used by the back office was updated from version 1.11.1 to version 3.6.0. Together with this update the back office Javascipt was migrated to work with jQuery 3.x. To migrate your back office customizations, see the jQuery Core 3.0 Upgrade Guide.
• Please note the library updates as stated in Guide - 7.10.38.9 Library Updates on Patch Level and consider that these might require migration efforts on custom source projects.

Furthermore, all new features and changes of the latest non-LTS patch releases are included, i.e. 7.10.33.1 to 7.10.37.1 For details, see Public Release Note - Intershop Commerce Management B2C/B2X 7.10 | Changelog.

Hotfix Release 7.10.32.22

• DBPrepare is required for the following changes, see Concept - DBPrepare:
  • Fix for Inbound Product Sharing option "Activate selected shared products", where it was not possible to select any product (78692)
  • Fix for runtime issue of DeleteDomainReferences job via DB migration (76311)

Hotfix Release 7.10.32.20

• DBPrepare is required for the following changes, see Concept - DBPrepare:
  • Fixed runtime issue of DeleteDomainReferences job

  • Fix for Inbound Product Sharing option "Activate selected shared products" leading to sharing of all products (77855)

    Selective inbound product sharing does not work in this release (78692). If you are using this feature, please do not use this hotfix release.

Hotfix Release 7.10.32.17

• DBPrepare is required for the following change, see Concept - DBPrepare:

  • Fixed errors in the back office when using v_product, when at least one local product has many category assignments (75226)

Hotfix Release 7.10.32.13

• The handling of scale price quantities has been changed, see Guide - 7.10.38.9 Quantity Units of Scale Price Quantities for details.

Hotfix Release 7.10.32.8

• ICM 7.10.32.8 requires a DBPrepare for the following changes, see Concept - DBPrepare:

  • Channel product search now returns the correct results when sharing to the channel is enabled and not all products are shared.

  • Numeric columns in tables being defined during creation of a replication environment now contain decimal places.

Hotfix Release 7.10.32.6

• Storefront: The main navigation subcategories depth can now be controlled via CMS in Intershop Commerce Management, see Cookbook - Storefront Navigation.
• Adjustments in creating a staging environment require a DBPrepare, see Concept - DBPrepare.

Patch Release 7.10.32.0

Migration Guides

Please consult the following migration guidelines when upgrading to 7.10.32.0 LTS:

• Guide - 7.10 API Changes
• Guide - 7.10.26.4 New Pattern for SSO Redirect URIs
• Guide - 7.10.26.4-LTS Change Behavior for Job ProductPriceChangeEvents - Refresh Product Prices
• Guide - 7.10.31.0 Migration to Tomcat 9
• Guide - 7.10.27.0 New Job and ProcessChains for Search Index Maintenance
• Guide - 7.10.30.0 Recycle Bin Removed from Product Replication
• Guide - 7.10.31.2 Changed Fragment Navigation Interaction
• Guide - 7.10.32.0 Contact Us E-Mail
• Guide - 7.10.32.0 Removal of Deprecated Code of bc_pmc

Changes for 7.10.32.0

• ICM 7.10.32.0 requires a DBMigrate/DBPrepare for the following changes, see Concept - DBPrepare:
  • A new REST API that allows to retrieve product prices including scaled prices is available, see Reference - Pricing REST API 1.0.0 (Beta) and Cookbook - Pricing REST API.
  • It is now possible to disable the A/B test function. This can have a positive impact on performance, see Cookbook - AB Testing for details.
• A new job was added that allows to remove old and outdated batch processes from time to time, seeJob - CleanupBatchProcesses.
• Deprecated code, mainly methods related to content management, was removed. For details, see Guide - 7.10.32.0 Removal of Deprecated Code of bc_pmc.
• The Contact Us e-mail was improved. For details, see Guide - 7.10.32.0 Contact Us E-Mail.
• Optimization of the Responsive Starter Store for Core Web Vitals metrics, this includes:
  • Elimination of render blocking resources
  • Removal of unused JavaScript
  • Preloading of key requests
  • Optimized images

• The number of cached cursors has been increased to improve request processing throughput.
  The default values for cached database cursors and numbers of shared read connections have been increased as follows (IS-32694 - Increase default cached cursors and read connections for JDBCSharedReadConnectionPool):

  Topical numbers of cached cursers and shared read connections

  intershop.cartridges.core.jdbc.maxCachedCursors=100
  intershop.cartridges.core.jdbc.numberOfSharedReadConnections=20

  Important

  Increasing the number of cached cursors also increases the number of open cursors being held by the application. Customers may need to adjust their instance configuration accordingly.

Furthermore, all new features and changes of the latest non-LTS patch releases are included, i.e. 7.10.27.0 to 7.10.31.2 For details, see Public Release Note - Intershop Commerce Management B2C/B2X 7.10 | Changelog.

Hotfix Release 7.10.26.21

• The handling of scale price quantities has been changed, see Guide - 7.10.38.9 Quantity Units of Scale Price Quantities for details.

Hotfix Release 7.10.26.18

• Numeric columns in tables being defined during creation of a replication environment now contain decimal places. This change requires a DBPrepare, see Concept - DBPrepare.

Hotfix Release 7.10.26.11

• Changed fragment navigation in the responsive starter store, see Guide - 7.10.31.2 Changed Fragment Navigation Interaction.
• The Contact Us e-mail was improved. For details, see Guide - 7.10.32.0 Contact Us E-Mail.

Hotfix Release 7.10.26.9

• Requires a database migration run to fix issue IS-32632 - Database migration cannot perform alter on 'STAGING$get_live_tables' for MSSQL

Hotfix Release 7.10.26.4

• New pattern for SSO redirect URI, see Guide - 7.10.26.4 New Pattern for SSO Redirect URIs.

Patch Release 7.10.26.2

• Messaging and cache metrics are now available in Prometheus, see Cookbook - Monitoring with Prometheus for details.
• The searchindexes REST API specifications have been separated from the Backoffice API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management.

• REST API: B2B buyers (admin) can now invite other persons to their customer organization, so they are able to make purchases in this context. 

• A new promotion condition at order level allows to compare the total quantity of items in the basket with a specific amount in several ways.

• The Quoting REST API now supports creating a new quote request from an existing quote request.
• Products REST API: Using the parameter returnSortKeys=true now returns additionally the localized names of the available sorting options. (IS-29415)
• XML Sitemap Generation is available for the Progressive Web App (PWA) application type (intershop.REST), see Concept - URL Rewriting (from 7.10.5) | Rewrite Rules for PWA.
• A new promotion condition at order level allows to compare the order total with a specific purchase amount in several ways.
• MSSQL database optimization: Duplicated indexes are removed. A DBMigrate is required on MSSQL to benefit from the change.
• MSSQL database bugfix: If an index was deleted, it was possible that the wrong index was deleted. A DBMigrate is required on MSSQL to fix the problem.
• MSSQL database optimization: Computed FT_INDEX columns are stored as persistence. A DBMigrate is required on MSSQL to benefit from the change.
• Different REST API versions are now documented correctly and consistently with OpenAPI. This is especially relevant for Basket and Order where two REST API versions are available (see IS-30561 - It is not possible to properly reflect different API versions, and Reference - Intershop Commerce Management 7.10 REST API).