Converting delimited data to business objects

This section provides the following information on how the Delimited data handler converts Delimited data to business objects:

Delimited string requirements

When converting a string or stream, the Delimited data handler makes the following assumptions:

If you have more than one business object in the data, make sure you do not introduce any new characters (such as a space, a tab, a new line, or a carriage return) between them.

When the Delimited data handler reads a file in Delimited format, it takes the following special processing steps to assign to a business object attribute the CxIgnore or CxBlank attribute value:

Note:
Make sure the escape string and the delimiter have different values as configured by the Escape and Delimiter meta-object attributes in the Delimiter data handler child meta-object.

The following line shows an example of a string in Delimited format. The syntax is:

Bus_Obj_Name<delimiter>Verb<delimiter>Attr1<delimiter>Attr2<delimiter>
Number_of_child_object_instances<delimiter>Child_Object_Name<delimiter>
Verb<delimiter>Attr1<delimiter>Attr2<EndBO:Bus_Obj_Name>

The following sample uses a tilde (~) delimiter:

Customer~Create~p1~p2~p3~1~CustomerAddress~Create~q1~q2~q3~q4~q5~q6~q7~q8~q9~q10~3~
PhoneInfo~Create~r1~r2~r3~r4~r5~r6~r7~PhoneInfo~Create~r1~r2~r3~r4~r5~r6~r7~
PhoneInfo~Create~r1~r2~r3~r4~r5~r6~r7

Serialized-data processing

The Delimited data handler processes delimited data into a business object as follows:

  1. The data handler gets the business object name from the first token in the data and creates a business object to contain the data.
  2. The data handler sets the verb in the business object. The data handler assumes that the verb for the top-level business object is in the second token in the delimited data. Note that child business objects may not have verbs set.
  3. The data handler determines if there are any child meta-objects (those whose names are listed in the cw_mo_ tag of the business object application-specific information). The data handler does not perform the processing to populate these attributes of the business object. For more information about the cw_mo_ tag, see Implementing conversion from a business object.
  4. The data handler looks for meta-object attribute named OmitObjectEventId. If this is set to true, the data handler does not perform the processing to populate the ObjectEventId attribute.
  5. The data handler parses the data and populates the values of the remaining simple attributes in the business object with the token values from the data. The data handler processes container attributes as follows:

Copyright IBM Corp. 1997, 2003