Processing multiple IDocs with a wrapper business object

Note:
This section is applicable only to service-call request processing.

When processing multiple IDocs, the ALE Module requires a wrapper business object as the top-level business object. The multiple IDoc wrapper business object contains an attribute that represents an array of IDoc parent wrapper business objects.

For each parent wrapper business object, SAPODA generates the Create, Retrieve, Update, and Delete verbs. For each of these verbs, it generates the following AppSpecificInfo values:

sap.sapalemodule.VSapALEBOHandler,MsgType=;MsgCode=;MsgFunction=

Figure 54 illustrates the relationship between a top-level wrapper object and it's child IDoc business objects.

Figure 54. Wrapper business object containing child business objects

Multiple IDoc wrapper object example

The following is a sample definition of a multiple IDoc wrapper business object:

[BusinessObjectDefinition]
Name = sap_alereq01_wrapper
Version = 1.0.0
AppSpecificInfo = 

[Attribute]
Name = Dummy_key
Type = String
Cardinality = 1
MaxLength = 1
IsKey = true
IsForeignKey = false
IsRequired = true
AppSpecificInfo = DummyKey
DefaultValue =
[End]

[Attribute]
Name = TransactionId
Type = String
Cardinality = 1
MaxLength = 1
IsKey = false
IsForeignKey = false
IsRequired = false
AppSpecificInfo = CrossWorlds TID
DefaultValue =
[End]

[Attribute]
Name = sap_alereq01
Type = sap_alereq01
ContainedObjectVersion = 1.0.0
Relationship = Containment
Cardinality = n
MaxLength = 255
IsKey = false
IsForeignKey = false
IsRequired = false
AppSpecificInfo = 
DefaultValue = 
[End]

[Verb]
Name = Create
AppSpecificInfo = sap.sapalemodule.VSapALEBOHandler,MsgType=;MsgCode=;MsgFunction=
[End]

[Verb]
Name = Retrieve
AppSpecificInfo = sap.sapalemodule.VSapALEBOHandler,MsgType=;MsgCode=;MsgFunction=
[End]

[Verb]
Name = Update
AppSpecificInfo = sap.sapalemodule.VSapALEBOHandler,MsgType=;MsgCode=;MsgFunction=
[End]

[Verb]
Name = Delete
AppSpecificInfo = sap.sapalemodule.VSapALEBOHandler,MsgType=;MsgCode=;MsgFunction=
[End]

Multiple IDoc wrapper: Attribute that represents the child business object

Table 28 lists and describes the properties of the attribute that represents the child business object in the multiple IDoc wrapper business object.

Table 28. Multiple IDoc wrapper: attribute that represents child business object
Property name Description
Name Set the value to the name of the parent business object generated by SAPODA.
Type Set the value to the name of the parent business object generated by SAPODA.
ContainedObjectVersion Set the value to 1.0.0.
Relationship A child business object is contained by a parent business object; therefore, the value is containment.
IsKey Set the value to false.
IsForeignKey Set the value to false.
IsRequired Set the value to false.
AppSpecificInfo This property is not used for the attribute that represents child business objects in the ALE Module.
Cardinality Set the value of the attribute in the top-level wrapper business object that represents the IDoc parent business object to cardinality n.

Copyright IBM Corporation 1997, 2004. All Rights Reserved.