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 21 illustrates the relationship between a top-level wrapper object and it's child IDoc business objects.

Figure 21. 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 30 lists and describes the properties of the attribute that represents the child business object in the multiple IDoc wrapper business object.

Table 30. 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 Corp. 1997, 2004