IBM Support

Unreleased IDoc segments cause exceptions when running external service wizard and at run time

Troubleshooting


Problem

Unreleased segments in IDocs may cause the following issues: 1. During object discovery using the external service wizard, you might get the exception "The segment could not be read for the release ". 2. At run time you may encounter an error message: "Caused by: commonj.connector.runtime.DataBindingException: Failed in population return object" error. This happens even if all the business object definitions were generated successfully for the IDoc when you ran the external service wizard.

Symptom


1. Exception thrown when using external service wizard "The segment could not be read for the release <release number>"
2. Exception thrown at run time
CNTR0020E: EJB threw an unexpected (non-declared) exception during invocation of method "onNotification" on bean "BeanId(RAS_SAP_ALE_InboundApp#RAS_SAP_ALE_InboundEJB.jar#export.SAPInboundInterfaceEIS, null)". Exception data: commonj.connector.runtime.DataBindingException: Failed in population return object

Cause

For a given IDoc segment there may be multiple segment definitions at different release levels. Some of the segments may not have been released. If an IDoc type definition uses unreleased segment definitions, the external service wizard may fail or choose the latest released segment version instead. This is a problem for the adapter at run time because it will not be able to find the business object definitions for the unreleased children segments. For example, if the IDoc MATMAS05 has unreleased segment E2MARAM005, the external wizard will create an E2MRAM004 (released segment) child business object definition for MATMAS05 business object instead of E2MARAM005.

Resolving The Problem

When using the external service wizard to discover IDocs, you can specify the release version for the IDoc in the wizard. The default value is the version of the SAP system you are running the wizard against. If the IDoc you selected has unreleased segments, you should set the field "IDoc release version" on "Configure Properties for <IDoc name>" page of the wizard to empty (zero length string).

[{"Product":{"code":"SSMKUK","label":"WebSphere Adapters Family"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Adapter for SAP","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
15 June 2018

UID

swg21297820