Document Properties
KbidL29315
Last Modified23-Jul-2020
Added to KB21-Jan-2020
Public AccessEveryone
StatusOnline
Doc TypeGuidelines, Concepts & Cookbooks
ProductICM 7.9

Guide - 7.9 API Changes

1 Introduction

This document lists API changes for Intershop Commerce Management 7.9.x that can cause migration efforts.

For information on new APIs refer to the Public Release Note - Intershop Commerce Management B2C/B2X 7.9.

2 API Changes 7.9.6.1

DescriptionAPI ChangesHow to Migrate
JDBC Oracle driver updateThis release contains a reference to the new oracle jdbc driver 19.6.0.0.0.

The following steps are necessary so that the old driver can still be used:

  • Create and publish the new driver to your artifact repository (this is just needed during deployment to resolve dependencies).
  • Override the version at your customization assembly to the old version.

For more details see Support Article - Deployment Stops While Looking for Oracle 19 Drivers.

3 API Changes 7.9.4.20

DescriptionAPI ChangesHow to Migrate
Changed default-persistence for bot sessions.The default-value for the property intershop.session.persistBotSession is now false.Most likely, the bot-session should not be persisted. In that case, nothing is to be done.
If the bot-session should be persisted, the property has to be declared with the value true.
JDBC Oracle driver updateThe release contains a reference to the new oracle jdbc driver 19.3.0.0.

We do not recommend to use the new driver since the Oracle driver contains bugs/issues. The following steps are necessary so that the old driver can still be used:

  • Create and publish the new driver to your artifact repository (this is just needed during deployment to resolve dependencies).
  • Override the version at your customization assembly to the old version.

For more details see Support Article - Deployment Stops While Looking for Oracle 19 Drivers.

4 API Changes 7.9.4.18

DescriptionAPI ChangesHow to Migrate
Adapt default JGroups configuration XMLThis is not an API change but a configuration change:
  • Remove the multi cast flow control protocol (configuration uses uni cast only)
  • Limit the FLUSH timeout to five seconds (instead unlimited)
  • Remove the 'view_bundling' setting (is default 'true')
  • Adapt the 'min_threshold' value to prevent low credits for flow control handling

Merge these changes to your configuration file if you use a custom configuration file. No need to adapt configuration if you use the provided file.

Info

This change applies for 7.10.15.5 and  7.10.16.6 as well.

5 API Changes 7.9.4.11

DescriptionAPI ChangesHow to Migrate
Storing of Promotion Information at Orders

The order creation process has been adapted to store the relevant information of all used promotions directly at the order.

See Guide - 7.10.12.2 Storing of Promotion Information at Orders

6 API Changes 7.9.3.1

The fix of IS-23365 for the 7.9.3 ICM release includes the following API Changes compared to 7.9.2.5 ICM release:

DescriptionAPI changesHow to migrate

Java Code of Cartridge bc_customer

The package name of the following classes has been changed:

  • CustomerDeletionContextImpl
  • CustomerDeletionResultImpl
  • CustomerDeletionResultFactoryImpl

Old package name: com.intershop.component.customer.capi.handlerchain.impl
New package name: com.intershop.component.customer.internal.handlerchain

The following new CAPI classes were added:

  • com.intershop.component.customer.capi.handlerchain.impl.CustomerDataDeletionHandler
  • com.intershop.component.customer.capi.handlerchain.QueryExecutorHandler
  • com.intershop.component.customer.capi.handlerchain.QueryExecutorHandlerProvider

The following new methods were added to the class com.intershop.component.customer.capi.handlerchain.CustomerDeletionContext:

  • UserBO getUserBO()
  • Collection<UserBO> getUserBOs()


Use the new classes.

Java Code of Cartridge bc_gdpr

The following method have been changed:

  • com.intershop.component.gdpr.capi.PersonalDataRequestBODeleteAccountExtension.deletePersonalData()
    • Old method signature:
      boolean deletePersonalData()
    • Replacement:
      Result deletePersonalData()
  • com.intershop.component.gdpr.pipelet.DeleteCustomerAccount.Error
    • Added method:
      setError(String errorCode)
Use the Result.getResultType() and Result.isFailure() to check if deletion of personal data is successful.

Pipeline of Catridge bc_gdpr

ProcessPersonalDataRequest.pipeline

  • Use the new signature of DeleteCustomerAccount pipelet

Java Code of Cartridge bc_b2b_role_orm

The following new class was added:

  • com.intershop.component.b2b.role.orm.internal.user.UnassignUserRolesCustomerDeletionHandler

Disclaimer

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 Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Support Tickets