Welcome to Intershop Commerce Management 7.10.
This Public Release Note contains information about the latest features of Intershop Commerce Management 7.10. In addition, it serves as a quick reference for the latest documentation.
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 (valid to 7.10).
Assembly Name | Description |
|---|---|
com.intershop.assembly:commerce_management_b2c | Base assembly for Intershop Commerce Management B2C (this is the base of all B2C projects). |
com.intershop.responsive:inspired-b2c | Demo store "Inspired" B2C (source of this assembly is the starting point for B2C projects). |
Assembly Name | Description |
|---|---|
com.intershop.assembly:commerce_management_b2x | Base assembly for Intershop Commerce Management B2X (this is the base of all B2B projects). |
com.intershop.responsive:inspired-b2x | Demo store "Inspired" B2X (source of this assembly is the starting point for B2B projects). |
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.
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.
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.
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.
To read about the newest system requirement, please refer to:
System Requirements - Intershop Commerce Management B2C/B2X 7.10
System Requirements - Intershop Commerce Management B2C/B2X 7.10 (valid to 7.10.40)
System Requirements - Intershop Commerce Management B2C/B2X 7.10 (valid to 7.10.5.0)
The Reference - CI Dependencies of Intershop Commerce Management (valid to 7.10) provides a mapping of all:
CI-versions of the ICM
Intershop CI Bootstrap version
Intershop Gradle Tools version
Intershop Responsive Starter Store version
Please see our feature lists for more details about the new release:
For a list of all available ICM 7.10 documents, use the ICM 7.10 filter in our Knowledge Base.
Intershop provides Migration Guidelines to ease the migration from 7.9 to 7.10:
Also see Overview - Migration Best Practice.
For migrations within 7.10 versions refer to the following documents:
The changelog lists the released versions sorted by their version number to cluster non-LTS and LTS releases in favor of a better overview. For information on their release dates, refer to:
For more information on long-term (LTS) releases, refer to Concept - Continuous Releases (valid to 7.10).
Please note the library updates as stated in Guide - 7.10.41.9 Library Updates and consider that these might require migration efforts on custom source projects.
Caches for type code definitions and service permissions have been down ported from ICM 11, see Guide - 7.10.41.8 Type Code Definition and Service Permission Caches for details.
Due to fixed issue 100198, you can now limit the number of pages displayed in a product search result list in the ICM back office by configuration via properties. When dealing with a large number of result items, the results will be displayed faster with this approach.
For details, see Guide - 7.10.41.6 - Query Configuration via Properties.
Please consult the following migration guidelines when upgrading to 7.10.41.2-LTS:
Guide - 7.10.38.20 Migrate PreferenceDefinitions from a_responsive
Guide - 7.10.40.5 Authentication without Information on User Existence
This release includes all new features and changes of the latest non-LTS patch releases, i.e. 7.10.39.2 to 7.10.41.1.
For details, see:
Ubuntu support has been added. See System Requirements - Intershop Commerce Management B2C/B2X 7.10.
JDBC/Batch import has been enabled. See Concept - Pricing (valid to 7.10).
Captcha authorization data for Captcha-protected REST resources can now be sent to the server via the X-Captcha-Token request header instead of the Authorization header. See Cookbook - WebShop REST API for more details.
The new line item discount feature has been implemented. See Online Help.
The file uploads validation feature has been implemented. See Concept - File Uploads Validation and Online Help.
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.
New separated Inventory REST API call allows to receive availableStock and inStock information for SKUs. See Reference - Inventory REST API 1.0.0 (ICM 7.10).
Added a try-run functionality for server health checks. See Guide - 7.10.38.21 Server Health Checks and Concept - Server Health Checks.
Security and maintenance updates of ICM libraries throughout the component sets, removing log4j from nodemanager, see Guide - 7.10.40.4 Library Updates and Guide - 7.10.40.4 NodeManager Logging Without Log4j for details.
Extended Product and Category Rest API:
For the ProductsResource the following extended attributes are supported: customAttributes, reviews, shippingMethods, averageRating, roundedAverageRating. For the ProductListResource the endOfLife and lastOrderDate were added as requestable attributes for the attrs parameter.
For scenarios using 3rd-party inventory backend services with expensive calls, it is now also possible to remove these attributes (availableStock and inStock + their corresponding backend calls) from product detail call (Product and Category Rest API) by configuration (see documentation on product detail call: view and attrs query parameter).
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:
New configuration value has been added to Shop REST API. See Reference - Shop REST API 1.4.0 (ICM 7.10).
New DB Preparer (UpdateApplicationTimeZonePreparer) is available for setting default time zones of applications.
Custom attributes have been added to standard Order XML export on order and line item level. XSD has been adapted accordingly. See Reference - XML Import and Export Specifications (valid to 7.10).
Desired delivery date on order level is now displayed in the back office on the order detail page and in order confirmation e-mail.
New bulk UPDATE & REPLACE mode for improved price list import, see Concept - Pricing | JDBC/Batch-Import and Cookbook - Pricing | Recipe: Change Price List Import Strategy (JDBC/Batch vs. ORM).
New SEO sitemap generation for PWA 3.0 is available, see Concept - URL Rewriting | Rewrite Rules for PWA3.
The beta status of the Punchout REST API has been removed. See Reference - Punchout REST API 2.2.0 (ICM 7.10).
New paging size selector is available in the target group of promotions separately for customers, customer segments, and affiliates in the back office.
The table name in the stored procedure for Oracle database has been fixed (87171).
In this release an issue related to replication in Oracle Database has been identified. Projects that do not use replication and an Oracle Database are not affected.
For details, see Support Article - Prevent Replication Error in ICM 7.10.38.20/21-LTS Oracle Environments.
The handling of registration e-mails for inactive users has been improved. There is a new channel-specific property (SendRegistrationMailOnUserActivation) available now that controls whether registration e-mails are sent when an inactive user is created or when the user is activated.
For information on how to use that functionality in Intershop Commerce Management, refer to Guide - 7.10.39.2 B2B User Registration E-Mail and Managing B2B User Registration E-Mail Preferences in the ICM Online Help.
A new version of the Product & Category REST API is available, see Reference - Product and Category REST API 1.6.0 and Guide - 7.10 REST API Changes.
In this release an issue related to replication in Oracle Database has been identified. Projects that do not use replication and an Oracle Database are not affected.
For details, see Support Article - Prevent Replication Error in ICM 7.10.38.20/21-LTS Oracle Environments.
A new version of the Product & Category REST API is available, see Reference - Product and Category REST API 1.5.0.
The product list call /products can now return the attributes maxOrderQuantity and stepQuantity (if requested via attrs parameter.)
For security reasons manual uploads for product images in the back office can now be configurable restricted to specific media types. This applies also for uploads with ZIP files. For details, see:
The Basket REST API now allows to set the desired delivery date for line items, see 75181 and Reference - Basket REST API 1.3.4 (ICM 7.10).
Non-replication systems had some replication menu entries. These have been removed. No functional changes were made to replication itself (78618).
PWA - added support for design preview:
Content Editors now can test content in the Intershop Progressive Web App before it goes live. Therefore, the Design View for PWA can be opened within the Intershop Commerce Management (back office) and the following preview settings are supported: time, application, and catalog settings.
Please note the library updates as stated in Guide - 7.10.39.1 Library Updates and consider that these might require migration efforts on custom source projects.
DBPrepare is required for the following changes, see Concept - DBPrepare:
Compatible Contact Center REST API changes, see Guide - 7.10 REST API Changes
Job and process chain processes are monitored for their liveness. The default process chain timeout is 1 hour now. For details, see Guide - 7.10 API Changes.
An issue with Google Chrome 116/117 has been identified. For details, see Support Article - Known Issue with Google Chrome Version 116/117.
DBPrepare is required for the following changes, see Concept - DBPrepare:
Wrong table name in stored procedure for Oracle database (87171)
Compatible Wish List REST API changes, for details see Guide - 7.10 REST API Changes
DBPrepare is required for the following change, see Concept - DBPrepare:
Updated views: ieproductcategoryassignment, V_PRODUCTSHARING (81446).
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 propertiesexternalIdandexternalUrnhave been added to the address resource object. This compatible change affects the following APIs:
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.
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.
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
The details of a user now additionally contain the string attribute login in the Contact Center REST API
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
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.
Please consult the following migration guidelines when upgrading to 7.10.38.9-LTS:
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 BasketLineItemPositioning Default Preference
Guide - 7.10.38.9 Move System-Managed Pagelet Creation From System Startup to DBPrepare
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.
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.
The following changes were made to the web adapter. For details see Guide - 7.10 API Changes:
Removed and adjusted default connection time and retry properties for web adapter.
The web adapter now returns HTTP 503 instead of HTTP 500 to the client if no configuration service is available.
The class 'ApiTokenCookieLogin' has a new default method 'removeToken()'.
An issue in the SMTP service has been fixed that was based on the encryption/decryption logic in the managed service configuration. The "@" character in e-mails is now interpreted correctly so that e-mails are sent successfully.
An issue in the SMTP service has been fixed that was based on the encryption/decryption logic in the managed service configuration. The "@" character in e-mails is now interpreted correctly so that e-mails are sent successfully.
A new configurable option has been implemented in the order export section in the back office that allows for deactivation of the order status setting during order export or order submission service. Before this option, the order export service changed the order status into "export failed" in case of unsuccessful order exports. The new functionality gives e-Commerce Managers the possibility to prevent any order state updates in case of exporting orders to the BI Data Hub, a scenario which should generally not influence the order status within the ICM (69724). See Online Help | Order Export and Import | Enabling/Disabling Status Updates for Order Exports.
A new version of the Requisition Approval REST API is available, see Reference - Requisition Approval REST API 1.1.0 (Beta). This change requires a DBPrepare, see Concept - DBPrepare.
This update includes extended data for the requisitions, see Guide - 7.10 REST API Changes for details.
A new version of the Quoting REST API is available, see Reference - Quoting REST API 1.1.0.
This update includes support for retail sets in quotes.
A new version of the Customer REST API is available, see Reference - Customer REST API 1.1.0.
For this update, the Cost Center API was split off and moved into its own specification, see Reference - Cost Center REST API 1.0.0.
The /configurations REST Call is now cached, see Reference - Shop REST API 1.1.0 and Cookbook - Configuration REST API (v1).
TrackingEventOrderCreationHandler (Handler which fires a tracking event when the order has been placed) moved from OrderCreationChain/PostPaymentOrderCreationChain to OrderCreationChain/PendingPaymentOrderCreationChain.
Now, the OrderPlacedEvent will be tracked also in case of using payment methods with redirection.
An issue in the SMTP service has been fixed that was based on the encryption/decryption logic in the managed service configuration. The "@" character in e-mails is now interpreted correctly so that e-mails are sent successfully.
The DBinit preparers have been improved. Previously, in a list of preparer steps, the execution stopped at the first gap in the numbering (e.g., a disabled step) while subsequent steps were not executed. Now all non-disabled steps are executed as the complete list is iterated. This applies to all preparers in ICM.
See Concept - DBMigrate and DBInit Properties File Formats for further information.
The following cXML-related changes require a DBMigrate/DBPrepare, see Concept - DBPrepare:
With a new global setting B2B shop managers are now able to define the locale to be used for transferred cXML Punchout baskets (64032).
In addition, two new attributes for cXML users have been introduced which allow for user-specific adjustments. These are:
The customer import has been extended to import these attributes (65539, 65533). So now each cXML user can have an individual locale being used for the data in the transferred Punchout basket, and an individual unit of measure mapping in order to support multiple procurement systems.
cXML Punchout sessions are now persisted in DB; outdated sessions (which are not transferred back) are automatically cleaned up with a new job, see Job - Cleanup Outdated cXML Punchout Sessions.
Storefront: The main navigation subcategories depth can now be controlled via the CMS in Intershop Commerce Management, see Cookbook - Storefront Navigation.
A new version of the Product & Category API is available, see Reference - Product and Category REST API 1.3.0.
This includes a change in the FilterCollectionRO: In case no search index is found, error code 503 is returned, instead of a "500 server error".
A new version of the Promotion REST API is available, see Reference - Promotion REST API 1.2.0 (ICM 7.10).
This update includes improved caching for the resource /promotions/<promotion-id>, see Guide - 7.10 REST API Changes.
The following jobs are now enabled by default in order to keep the system clean and fast:
An issue in the SMTP service has been fixed that was based on the encryption/decryption logic in the managed service configuration. The "@" character in e-mails is now interpreted correctly so that e-mails are sent successfully.
A new global configuration has been implemented in the cXML Punchout for mapping the unit of measure codes defined for procurement systems to the units used in the online shop, see 64031.
A DocType was added to cXML Punchout responses in order to work with a larger amount of connectable procurement systems, see 62740.
The error handling has been improved in the staging area. In case of inconsistent domain data on the editing and live system (e.g. catalog domains were created directly on the live system), replications will fail in order to prevent broken data in the database. With the new implementation you are being informed via the error log that data cleanup in the production system (live) is required before the replication can be executed successfully again. This allows you to clear the reason for the replication failure independently. Previously technical support was required to get a failed replication being executed successfully again (63776).
The regular use case of, e.g., deleting a catalog on edit and then replicating this to live is not affected by this mechanism and, thus, does not require any data cleanup in the live system before a staging.
The promotion API was updated. When retrieving a list of promotions (product-specific or general) it is now possible to decide whether code-based promotions should be included or not. To determine this option, the new query parameter 'includeCodePromotions' has been introduced (64065), see Reference - Promotion REST API 1.1.0. In previous versions code-based promotions where automatically excluded from the lists.
The Punchout API was updated. The descriptions for 'OCI background search' and the texts for cXML Punchout have been improved, see Reference - Punchout REST API 2.2.0 (ICM 7.10).
DBInit and DBMigrate now use DBPrepare.
Therefore, DBPrepare is required to register all previous preparers if you have used DBInit/DBMirate before 7.10.33, see Guide - 7.10 API Changes and Concept - DBPrepare for details.
Buying Context was introduced for Basket and Order, see also Concept - Buying Context.
This allows to have a more fine-grained structuring of a business customer and its users.
DBPrepare is required for the following changes, see Concept - DBPrepare:
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.
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 handling of scale price quantities has been changed, see Guide - 7.10.38.9 Quantity Units of Scale Price Quantities for details.
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.
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.
Please consult the following migration guidelines when upgrading to 7.10.32.0-LTS:
Guide - 7.10.26.4-LTS Change Behavior for Job ProductPriceChangeEvents - Refresh Product Prices
Guide - 7.10.27.0 New Job and ProcessChains for Search Index Maintenance
Guide - 7.10.30.0 Recycle Bin Removed from Product Replication
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, see Job - 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.
ICM 7.10.31.2 requires a DBMigrate/DBPrepare for various changes, see Concept - DBPrepare :
New database views (V_PRODUCTSHARING, V_PRODUCT) were added. They allow for easier querying on product data and are the base for current and future search improvements. This will not change anything in the behavior of the product back office search. The DBMigrate is mandatory, however.
A bug related to GetSharingSourceDomainsByCatalogInclude.query in MS SQL was fixed .
The Subscription feature (Recurring Order) is now deactivated per default. Existing installations are not affected unless a full DBInit is executed. The feature can be easily reactivated. See Cookbook - Subscriptions | Recipe: Enable/Disable the Subscriptions Feature (Toggle).
Tomcat was updated to Tomcat 9:
This requires some migration steps. See Guide - 7.10.31.0 Migration to Tomcat 9.
The Solr Cloud Adapter dependency must be updated to use version 3.0.0.
This ICM change is not compatible with Solr4. Projects which still use Solr4, please refer to Announcement - Solr 4 - ICM and Tomcat 9 Compatibility for your options.
The cXML order request interface has been implemented in a way that allows projects to easily adjust standard functionality according to the project needs. See Concept - cXML Order Injection for further details.
Image management via Cloudinary CDN is now available, see Overview - Cloudinary Image Server.
Tool for product import performance improvements: Tests have shown that large product imports can be accelerated when the XML indexes on the database are dropped before the import and recreated afterwards. This is faster than the incremental update which is regularly done during the import. Two pipelets are provided for the drop and create operations:
com.intershop.component.product.pipelet.CreateProductXMLIndex
com.intershop.component.product.pipelet.DropProductXMLIndex
These pipelets are not used by default. Add the pipelets to your import job chain or change the default import pipeline and use them there, also see IS-32082 - Pipelet that removes and recreates DB XML Indexes. For further details, see Cookbook - Product Import Performance.
Additional fine-grained roles are available in the user management in the Intershop Organization Management (Operations ), see Organization Management Online Help | Managing Administration User Access Privileges .
A bug related to the DBmigrate execution from STAGING$get_live_tables was fixed for MSSQL, see IS-32632 - Database migration cannot perform alter on 'STAGING$get_live_tables'.
This requires a DBMigrate/DBPrepare, see Concept - DBPrepare .
The replication of recycle bin domains by product replication was removed. This requires a DBMigrate/DBPrepare and further steps, see migration guide: Guide - 7.10.30.0 Recycle Bin Removed from Product Replication.
The REST ObjectMapper is now replaceable via Guice binding.
REST API Changes:
cXML user management is now available in the Punchout API, see Reference - Punchout REST API 2.1.0
Fine-grained roles for system administration users in Intershop Organization Management (Operations), see Organization Management Online Help | Managing Administration User Access Privileges.
This requires a DBMigrate/DBPrepare, see Concept - DBPrepare.
SQL Script Preparer uses UTF-8 character set for scripts, so special characters for foreign languages can be added, see Guide - 7.10 API Changes.
Product import performance was improved. The property intershop.import.bulker.orm.importedToExistingProductsRatio is taken into account when using cache clearing. This means that expensive operations are only executed when necessary. See Concept - Impex Framework.
cXML Punchout support is now available. However, the user has to be created manually in the database, see Reference - Punchout REST API 2.0.0.
This requires a DBMigrate/DBPrepare, see Concept - DBPrepare .
Extension point for creating custom imports: ExtensionPoint ProcessCatalogImport-ValidateCategories now allows SourceFile as input parameter.
The Punchout REST API now supports the OCI functions 'VALIDATE' and 'BACKGROUND_SEARCH'.
The Customer REST API can be now adapted to transmit more attributes, see Cookbook - Customer REST API | Recipe: Add new Attributes to PrivateCustomerRO (for example with Custom Attributes) and following recipes.
Search index configuration: There is now a validation for trailing commas and spaces when importing CSV files containing synonyms.
A bug related to the length of searchandizing target URLs was fixed. Previously, the URL was truncated after 256 characters. The length has now been increased so that up to 4000 characters can be used. A DBMigrate is required to use this feature.
Not executing DBMigrate has no further consequences - the searchandizing URLs can still be used with 256 characters.
New job and process chains for search index and product assignment maintenance, see Guide - 7.10.27.0 New Job and ProcessChains for Search Index Maintenance . This requires a DBMigrate.
Open API specifications are now available on production systems, accessible via Intershop System Management, see Cookbook - Developer Tools ac_swagger | Recipe: Show API Documentation for details.
Introduction of configurable CORS filters. For each application a list of allowedOrigins can be configured.
Added Apache HTTPD support for mod_status and HTTP2, see Guide - 7.10 Build and Deployment.
A new configuration for Single Sign-On (SSO) prevents the automatic registration of users and modification of user data. Project-specific customizations can thus connect external systems and are thus responsible for the stored data.
REST API Changes:
CMS: The CMS REST API that was completed with 7.10.21.0 is no longer BETA.
Punchout API: A new REST operation that allows to transfer the Punchout basket back to the procurement system was added.
Product & Category API:
A new REST endpoint attachments was implemented. It allows to download product attachments. Usually this endpoint is not called directly, instead the product API provides links to the documents which can then be downloaded.
A bug in the products endpoint was fixed: The inStock attribute now (correctly) returns data from the inventory service, see Guide - 7.10 REST API Changes for details.
Promotion: Improved caching for resource /promotions , see Guide - 7.10 REST API Changes.
The handling of scale price quantities has been changed, see Guide - 7.10.38.9 Quantity Units of Scale Price Quantities for details.
Numeric columns in tables being defined during creation of a replication environment now contain decimal places.
This change requires a DBPrepare, see Concept - DBPrepare.
Changed fragment navigation in the responsive starter store, see Guide - 7.10.31.2 Changed Fragment Navigation Interaction.
TheContact Use-mail was improved. For details, see Guide - 7.10.32.0 Contact Us E-Mail.
Requires a database migration run to fix issue IS-32632 - Database migration cannot perform alter on 'STAGING$get_live_tables' for MSSQL
New pattern for SSO redirect URI, see Guide - 7.10.26.4 New Pattern for SSO Redirect URIs.
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 (valid to 7.10).
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).
A new promotion condition at line item level allows to create promotions for specific product(s) based on a product attribute, see Discount Rules in the Intershop Commerce Management online help.
A new promotion functionality allows to stop all other promotions after a promotion is successfully applied.
Single Sign-On is now available for inTRONICS (Azure AD B2C)
The behavior of the page cache invalidation can now be configured, see Cookbook - Page Cache.
The search index list now shows a warning when rebuilding a search index is a risk, e.g. when product or catalog import is running.
REST API Changes:
In the authentication REST API, the /logout path was changed to token/logout , see Guide - 7.10 REST API Changes for details.
Note
This is a REST API break, which will be rolled back with the next release.
REST API Changes:
The Product & Category REST API now allows filtering by variation master SKU.
The following REST API specifications have been separated from the Storefront API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management for each site:
Basket
Customer
Order
Organization
Recommendation
Wishlist
Single Sign-On:
Single Sign-On (SSO) now allows using Azure AD B2C, by configuration of Enterprise Organizations, see Cookbook - Single Sign-On (SSO) | Recipe: Configure Azure AD (B2C)
It is now possible to configure additional scopes to be requested from SSO provider, see Concept - Single Sign-On (SSO) | Example Configuration and Cookbook - Single Sign-On (SSO).
Stronger signature for ICM-specific JWT tokens
New job to recalculate the sales target actual amount for all contracts, see Job - Recalculate the Sales Target Actual Amount for all Contracts.
This requires a DBMigrate.
New role descriptions for B2B roles. For migration information refer to Guide - 7.10 API Changes.
JDBC Oracle driver update, see Guide - 7.10 API Changes and Support Article - Handling the New Dependency of 3rd_oracle Version 19.3.1.0 (valid to 7.10) for details.
REST API Changes:
New REST API operations for handling order approval in buying organizations based on personal budgets or order size limits. This includes:
New REST interfaces to provide lists of approval tasks and their details for specific approvers,
New REST interfaces to provide lists of requisitions (one time or subscription) and their details for specific buyers,
New REST interfaces to perform approvals (accept or reject)
Handling cost centers is not yet included.
The following REST API specifications have been separated from the Storefront API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management for each site:
Authentication
Newsletter Subscription (E-Mail Marketing)
Promotion
Rating & Review
Subscription (Recurring Order)
Shop
Endpoints of the former Localization API are now part of the Shop API
Variation products assigned to one variation master can be retrieved via REST API with /products?MasterSKU=<Master SKU>. The corresponding variation attributes (→ /productfilters?MasterSKU=<Master SKU>) can be used to filter the result set. This allows to create variation master pages in PWAs more efficiently than before. In order to do this, MasterSKU must be indexed in the search index, similar to MasterUUID. This is needed so MasterSKU can be used in the REST API. (The REST API only handles skus, not UUIDs.)
Variation products on variation master pages, as well as in the REST API (/products?MasterSKU=<sku>) can now be sorted as defined in the backoffice, if no other sorting is specified. This requires configuration of the search index. See Guide - 7.10 REST API Changes.
Changes in Single Sign-On (SSO):
The SSO redirect URIs are simplified, parameters are no longer required, see Concept - Single Sign-On (SSO).
The SSO implementations is now independent from Keycloak and supports standard OIDC flows, see Concept - Single Sign-On (SSO).
Single Sign-On support for REST:
Updated Authentication 1.0.0 REST API
REST token handling now supports JSON web token. This requires a DBMigrate. For details see Reference - Usage of JSON Web Token (JWT).
The CMS REST API is complete with version 7.10.21. The beta flag will remain for another ~ 6 months. This time will be used to get feedback from projects and make adjustments where necessary. The CMS REST API allows to get all relevant information about web content from Intershop Commerce Management in order to render it in a progressive web app or any other client.
Extended back office contract start date and end date validation:
Contract creation: start date and end date must be in the future.
Edit contract: contracts in the future are changeable. If a contract is already started, the end date can only be changed for contracts that are still running. Contracts in the past cannot be changed.
Azure AD B2B can now be configured for Single-Sign-On, see Recipe: Configure Azure AD (B2B) in Cookbook - Single Sign-on (SSO). Also refer to Guide - 7.10 API Changes for API changes.
Security updates of libraries, see Guide - 7.10.21.0 Security Update of Libraries.
The attribute supplierSKU was added to the response of /products/<productID>.
The configuration property intershop.import.bulker.orm.importedToExistingProductsRatio for updating/building the search indexes after a product import allows to switch off the index build by setting the ratio to a negative value. In addition the property can be configured domain-specific.
The Notifications API specification has been separated from the Storefront API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management for each site.
Configurations API (Beta): The response data structure was changed from a list to a map representation, see Guide - 7.10 REST API Changes for details.
For MSSQL, an error was fixed that caused the stored procedure sp_deleteUserDataByDomain to run forever if there is data that needs to be deleted in the tables BASICPROFILE/BASICADDRESS related to the deleted DOMAINIDs.
This requires a DBMigrate.
New Single Sign-on (SSO) feature for the Organization Management (Operations) Backoffice, see Guide - 7.10.19.0 SSO for Enterprise Backoffice with Keycloak.
Payment instrument account identifiers can be set up with multiple properties and/or complex types, see Cookbook - Payment | Recipe: Define Account Identifiers for Payment Instruments for details.
The CMS REST API now supports personalized requests.
A new resource /productfilters was introduced for the filter REST API. This allows to show the necessary information and provide filter functionality in a more efficient way. This replaces the existing resource /filters.
Extensions of the B2B customer storefront REST API for budget and role management:
When creating a user for an organization, it is possible to define roles for this user.
When viewing a list of users of an organization, it is now possible to see approval related data.
When updating a user, it is now possible to provide approval related budget data.
The API specification for "CMS", "Search" and "Product & Catalog" have been separated from the Storefront API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management for each site.
Introduction of a new Cache API, see Guide - 7.10.19.0 New Cache API - Configuration and Metrics
New Single Sign-on (SSO) feature for SMC. This requires a DBMigrate. For details see:
A new optional query parameter extended has been added to the /products/{id} and /products/{id}/variations resources, which will provide more complete information about variation attributes and their values in the new field variationAttributeValuesExtended.
The category REST resource now supports a category reference as a category id. The category reference is included in CategoryRO as categoryRef.
The Localization API specification has been separated from the Storefront API specification and can be viewed via a drop down menu within the Swagger UI in Intershop System Management for each site.
The CMS REST API now allows to retrieve pages in hierarchical structure by calling /cms/pagetree. The depth can be limited for larger trees. Also a node from a lower level can be passed to retrieve only a specific sub-tree.
A new Configuration REST API for Commerce Management channel, application and service settings has been introduced. Fore more details see
A new REST API (part of the basket REST API) has been introduced to handle limited tender payment methods like gift cards, gift certificate, etc.
A new REST API to delete all items in basket has been introduced.
A new optional query parameter omitHasOnlineProducts has been added to the /categories resource. If set to true, the field hasOnlineProducts will not be resolved for:
All categories in the category list resource
Subcategories in the category item resource
The new field effectiveUrl has been added to attachments under the products resource.
For the latest REST API documentation refer to:
New Solr version 8.2.0 is used. The ICM assemblies do not contain Solr anymore. The Solr Search Service Adapter 2.0.3 for Solr server 8.2.0 is used by inspired-b2c and inspired-b2x. It is required to adapt your project assembly to choose a desired version. For more details see:
Image management enhancements require a DBMigrate for Oracle and MSSQL. For more details see:
Newsletter feature requires a DBMigrate for Oracle and MSSQL.
ReCaptcha v1 has been removed. A DB migrate is needed to remove obsolete service configurations.
New feature payment notifications has been introduced. Fore more details see:
Internal handling for state transition has been corrected: After a failed REDUCE the payment status is now set to AUTHORIZED instead of AUTHORIZATION_VOIDED.
The new requestable REST attribute numberOfRatings has been added to /products and /categories/<catID>/products that allows to render this information on product lists without calling /products/<productID> first.
The new API token login feature enables customers to log in to both the Progressive Web App and the inSPIRED storefront, see:
New URL rewrite rule for search, see Concept - URL Rewriting
New login type: Login can be done with either username or e-mail address, see Login Types
New B2C feature Cashback requires a DBMigrate for Oracle and MSSQL. For details see:
New requestable REST attribute retailSet was added to /products and /categories/<catID>/products. It shows if products from a list are retail sets or not. It allows to handle retail sets differently in lists (e.g. show a price range, instead of a price), without calling /products/<productID> first.
New REST resource for handling ViewContext objects
New ReCaptcha v3 has been introduced. For more details see:
Note
Version 7.10.14.0 has been revoked mainly due to the following critical problems:
The class patch mechanism with <server>/local/lib does not work anymore, see IS-28344 - Class patch mechanism with <server>locallib does not work anymore.
For dev systems with 'intershop.pipelines.checksource=true' all executed pipelines are reloaded at every request, see IS-28374 - With 'intershop.pipelines.checksource=true' all executed pipelines are reloaded at every request
The existing basket validation is extended and can now also be used via REST API. For more details see
New REST API for payment redirect (redirect after order creation) and order handling. For more details see REST API documentation.
A DBMigrate is needed
For details about the procedure of creating a basket, preparing the checkout and creating an order by using the IS7 REST API see Business Guide - WebShop REST API - Basket and Checkout REST API (v1).
For details about the order REST API please have a look at Concept - Order REST API (v1).
For details about the basket REST API please have a look at Concept - Basket REST API (v1) (Valid to 7.10).
Support for Prometheus Open Metrics added, see Guide - 7.10 API Changes.
Due to a fix regarding the passphrase of the SSH keys, the old passphrases are no longer valid. The key pair needs to be regenerated and the new public key needs to be sent to the consumer of the effected transfer. For more information see Guide - 7.10 API Changes.
Due to the introduction of swagger 2.x, the usage of swagger 1.x in custom cartridges will lead to dependency conflicts as they have the same identifier. In this case you have to use Gradle Tools >= 2.11.10. For more information and migration steps see Guide - 7.10.18.0 Security Update of Libraries
New REST API for payment redirect handling (redirect before order creation). For more details see REST API documentation.
Added SEO attributes for product and catalog REST-API. For more details see REST API documentation .
A manual migration is required to fix IS-26655 - OrderProductLineItemBOAppliedRebateExtension is dependent on existance of promotion data, see Guide - 7.10.12.2 Storing of Promotion Information at Orders for details
API Changes, see Guide - 7.10 API Changes for details:
Reworked text index creation for MS SQL
DBMigrate on MS SQL to update procedure sp_compile_invalid_objects
Option to disable CSS file compression
With patch release 7.10.5.3 Customer-Specific Assortments were introduced. With the 7.10.12.2 release one existing limitation was removed: The category page of the classic inSPIRED storefront now takes the assortments into account. If sub-categories are empty due to assortments, they are not listed on the category page.
Added IPv6 support, see Guide - IPv6 Support for Public Client Requests
A DBMigrate for MSSQL is needed to fix the following issues:
New extension of product REST API to show the default category
IS-25665 - Adapt REST API for Products to return defaultCategory - Adapt REST API for products to return default category
A DBMigrate is needed to fix the following issues:
With patch release 7.10.5.3 Customer Specific Assortments were introduced. With the 7.10.8.2 release one existing limitation is removed: The main menu of the classic inSPIRED storefront now takes the assortments into account. If categories are empty due to assortments, they are also removed from the main menu.
A new preference in the image management was added. It is now possible to select an image type for category images, instead of using the pre-defined type "M".
New requestable REST attribute packingUnit was added.
By using the /products and /categories/<catID>/products REST endpoints, product stubs for display on family pages and search result pages can be retrieved. The optional attrs parameter allows to receive certain product attributes in that call to construct product tiles on said pages.
packingUnit - can be used to display the packiging unit
Upgrade from JGroups 3.4.1 to 4.0.19
New naming schema for (JSON) attributes representing discounted and undiscounted total amounts - see Guide - 7.10 REST API Changes.
With this release we added an additional attribute packingUnit to the REST response for all /product calls. It contains the packing unit information for the respective product.
A DBMigrate is needed to fix the following issues:
IS-26284 - 'sp_genericPoAvDeleteByDomain' it not correct for MSSQL - 'sp_genericPoAvDeleteByDomain' it not correct for MSSQL
A DBMigrate is needed to fix the following issues:
IS-26004 - Index Using a Lot of Disk Space - Remove obsolete and duplicate indexes (MSSQL)
IS-26089 - (MSSQL) UUID generation is not random enough - UUID generation in database was not unique (MSSQL)
IS-26066 - [MSSQL] staging_ddl$add_constraint does not check for duplicates - Function does not handle constraint duplicates (MSSQL)
IS-26076 - Alternate Keys are created as NONUNIQUE Index - Alternate keys was not unqiue
With this release we added an additional attribute availableStock to the REST response for all /products and /product calls. It contains the quantity which is available for sale. The data comes from the Inventory Service.
New REST API for basket handling including payment. For more details see REST API documentation.
With the newly introduced Promotion Code Search, it is now possible to easily evaluate the validity, assignment and use of promotion codes in the back office. For more details refer the Intershop Commerce Management online help.
New REST API for basket handling including line Items, addresses and shipping. We are currently working on payment REST API. For more details please have a look at Cookbook - Basket REST API.
With Customer Specific Assortments it is now possible to create very individual assortments, much more fine-grained than with Catalog Views. They work with the search index and allow a more flexible configuration without performance loss.
For further details please refer to Concept - Customer-Specific Assortments.
The Swatch Image source can now be maintained via Image Management or via Product Custom Attributes. For further details please refer to Concept - Product Variations 7.10.
Order Export can now be initialized via DBInit, for further details refer to Cookbook - Order XML Export.
New requestable REST attributes minOrderQuantity and inStock were added.
By using the /products and /categories/<catID>/products REST endpoints, product stubs for display on family pages and search result pages can be retrieved. The optional attrs parameter allows to receive certain product attributes in that call to construct product tiles on said pages.
minOrderQuantity - can be used to add products to carts and quotes
inStock - can be used to effectively render the family page in the list view
New REST API for searching variation product by attributes. For further details refer to our API documentation (/products/{productsKey}/variations/search).
It is now possible to return the redirect status code 301 (moved permanently) instead of the default redirect code 302 (moved temporarily). For further details please refer to Cookbook - URL Rewriting.
It is now possible to exclude special characters for URL rewriting rules, see Cookbook - URL Rewriting.
Now attribute groups on channel level get an available via REST API flag. A new checkbox and a new custom attribute are added for every attribute group - AvailableViaREST with the values true/false. If an attribute group is available via REST API, then the group and all contained attributes will be included in the regular get product data call. A new parameter attributeGroup is introduced. It returns the requested attribute groups with all their attributes. For the import/export process an additional attribute <available-via-rest> was added to the impex XML file. For attribute groups on organization level the value is always false.
Starting with version 7.0.0 of the Responsive Starter Store which depends on ICM 7.10.5.0 or later, the current jQuery 3.3.1 is used instead of 1.11.3. All Javascript code of the Responsive Starter Store was migrated to this new jQuery version.
For more information see Guide - Responsive Starter Store 7.0.0 - jQuery 3 Migration.
With this migration all the used third party libraries were updated to their latest versions as well and adapted where necessary.
We introduced the usage of Captcha for the Contact Us pages. In the channel preferences you are able to configure the Captcha settings by enabling or disabling the feature.
The Inventory Connector now works with 7.10.3+, also see the new documents:
The performance of the variation master page (usually used in B2B scenarios) was improved. This requires a slightly different configuration of the search index. Instead of Master UUID and Is Variation, GroupMasterUUID should be indexed. The change is not mandatory - the previous configuration will still work. Also see
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.