Document Tree
Document Properties
Last Modified
Added to KB
Public Access
Doc Type
  • IOM 4.1
  • IOM 4.2
Guide - IOM 4.1 - 4.2 Migration


This guide lists all migrations required from Intershop Order Management 4.1 to 4.2. The document is aimed to project developers.

Stronger Check on Unpersisted Enum Values During Startup

The deployment now modifies only possible differences in persisted enumerations but throws an exception if the value is not yet persisted and stops the deployment.
It is hence necessary to write an SQL migration script to add these new values in the database additionally to the Java definition. Checkout the iom-blueprint-project/001_ExpandedEnumerations.sql in relation to the affected Expanded*.java file, for example.

The modification cannot affect already deployed projects, but missing enum definitions in existing configuration scripts may prevent new deployments, e.g., creating a new test environment.

Simplified Handling of Expanded Enumerations

The handling of expanded enumerations has been refactored to require less code and make the process less error-prone. In order to benefit from this, follow these steps:

  1. Replace the existing class level annotation bakery.persistence.annotation.PersistedEnumerationTable by bakery.persistence.annotation.ExpandedEnum on your expanded enums.

  2. Furthermore, add the same annotations to expanded enums that have not had the annotation PersistedEnumerationTable yet — for example, ExpandedProcessTaskDefDO. Please note that you are supposed only to add this annotation to classes that are supposed to be extended in the IOM platform.

  3. Delete the class

  4. Replace the entire code of class using:

    package com.intershop.oms.enums.expand;
    import javax.annotation.PostConstruct;
    import javax.ejb.EJB;
    import javax.ejb.Singleton;
    import javax.ejb.Startup;
    import bakery.persistence.dataobject.EnumUtil;
    import bakery.persistence.expand.EnumInitializer;
    public class InitializeExpandedEnumerations extends EnumInitializer
        // packages to scan for enumerations
        private static final Object[] PACKAGES = { "com.intershop.oms.enums.expand" };
        @EJB(lookup = EnumUtil.JNDI_NAME)
        private EnumUtil util;
        public void init()

In addition to that there was a breaking change in TransmissionTypeDefDOEnumInterface - the new methods “getTransmissionTypeGroups” and “getDescription” have to be implemented in ExpandedTransmissionTypeDefDO. They are supposed to return a human-readable name and a collection of transmission classes (e.g. OrderTransmissionDO.class) that are mapped to the according TransmissionTypes in the enumeration. The decision to introduce this as a breaking change (instead of a default method) has been made in order to make sure the custom transmission types are correctly mapped and displayed in the new Transmissions REST API.

Require IOM Helm Charts 2.2.0, WildFly 26.1.2.Final, and Adoptium OpenJDK





Deprecated obsolete ImportConfigurationDO.priceComparisonProviderDefRef (database)


With regard to 77073, mailResourcesBaseUrl cannot be longer used in the mail-templates. According to the environment variable OMS_MAIL_RESOURCES_BASE_URL was removed from Dockerfile. Also refer to




Removed obsolete cluster property is.oms.mail.resources.base.url


Removed obsolete ImportPriceComparisonDO, PriceComparisonDO, update_price_comparison (database)

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.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.