Mapping of dummy keys allows you to map a key field from an IDoc
control or data record business object to the dummyKey property of the top-level
business object. The dummyKey property is used for flow control and business
process logic.
The adapter supports
dummy key mapping in the following manner:
- You must configure the property-level application-specific information
of the dummyKey property as the xpath of the property from which the value
should be set. In other words, the property level application-specific information
is set to the xpath within the business object hierarchy of the attribute
that is being mapped to the top-level object.
- If multiple cardinality objects are found in this path, the adapter uses
the cardinality defined in the xpath. This is true for all multiple cardinality
objects wherever they occur in the hierarchy. The following line of code is
an example of the xpath: <sapasi:ForeignBOKeyRef>Orders05/Orders05DataRecord/
Orders05E2edk14[1]/OrgID />
- If the application-specific information is incorrect or if the mapped
property value is empty, the adapter fails the event. This is also the case
when the application-specific information is configured to set an object type
value as the dummyKey. Note that dummyKey can only contain a simple type.