Running sample message CSV_5

This sample illustrates how if CSV records contain unique identifiers which can be used as tags, then a tagged delimited model can be used to parse them. The tagged CSV model is simpler and more flexible than the delimited only models used in the previous samples. Having a tagged model allows the records to be optional, and as illustrated in sample 6 allows a choice of different types of records in any order in the main part of the CSV message. In the input message there is a single header record followed by a single repeating comma separated record followed by a single trailer record. This is parsed using the sample message set and written as an XML message.

This topic includes instructions for running the sample. It also includes an example of an input test message and a corresponding expected output message, so that you can confirm that the sample has worked.

For a more detailed explanation of the message model used in this sample, refer to  Exploring the Comma Separated Value (CSV) sample.

Input test message

The test message used in running this sample is based on the following format:

HEADER,2005-04-01,X123456IB7,customer details<CRLF>
CUST,Bob,Dyson,1 Desolation Row,Orlando,FL,32802,HYT-457-AX<CRLF>
CUST,Jimmy,Pace,1002 Misty Mountain Drive,New York,NY,10001,ADU-239-BX<CRLF>
CUST,Ralf,McCartney,67 Penny Lane,Las Vegas,NV,89125,JUI-854-CF<CRLF>
CUST,Elvis,John,3 Yellow Brick Road,Chicago,IL,60699,GGY-118-AS<CRLF>
CUST,Rick,Clayton,461 Ocean Boulevard,Miami,FL,33101,LOP-212-TY<CRLF>
TRAILER,5

<CRLF> represents the characters with ASCII hex code points x'0D' and x'0A'.

Running the sample

This sample uses the message flow CSV2XML. It contains many input nodes but for this sample it uses the node with the queue called CSV2XML.IN5. The message flow passes the message through a compute node that changes the format to XML and writes the message out. This causes the CSV message to be parsed into a logical tree and then written in XML format. The output XML message shows the logical structure of the message that was parsed.

To run the sample:

  1. Switch to the Broker Application Development perspective in the Message Broker Toolkit.
  2. In the Broker Development view, expand the message flow project CSVMessageFlow and open CSV2XML.mbtest.
  3. Click the Invoke icon in the top-right of the editor.
  4. Set Input Node to CSV2XML.IN5.
  5. Ensure Viewer is set to Source.
  6. Click Import Source and select CSV_msg5.dat from project CSVMessageFlow.
  7. Click Send Message. A message is sent to the CSV2XML.IN5 queue.

    The message flow parses the CSV message and writes out the same logical message in XML. The output message is put on the CSV2XML.OUT queue.

  8. You might have to select Source from the Viewer menu to see the message.
  9. Compare this with the expected output message.

    Now try transforming from XML to CSV.

  10. In message flow project CSVMessageFlow, open XML2CSV.mbtest.
  11. Click the Invoke icon in the top-right of the editor.
  12. Set Input Node to XML2CSV.IN.
  13. Ensure Viewer is set to Source (from dropdown).
  14. Click Import Source and select XML_msg5.xml from project CSVMessageFlow.
  15. Click Send Message. A message is sent to the XML2CSV.IN queue.

    The message flow parses the XML message and writes out the same logical message in CSV. The output message is put on the XML2CSV.OUT queue.

  16. The output message should appear in the editor.
  17. Compare this with the original CSV message.

If all the steps have worked then the sample is complete.

Now take a look at the message set project and the explanation of this message definition in Exploring the Comma Separated Value (CSV) sample.

Expected output message

The expected output XML message is:

<?xml version="1.0"?>
<CSV_5>
<header>
<requestDate>2005-04-01</requestDate>
<requestID>X123456IB7</requestID>
<requestType>customer details</requestType>
</header>
<customer>
<firstname>Bob</firstname>
<lastname>Dyson</lastname>
<streetaddress>1 Desolation Row</streetaddress>
<cityname>Orlando</cityname>
<statecode>FL</statecode>
<postcode>32802</postcode>
<referencecode>HYT-457-AX</referencecode>
</customer>
<customer>
<firstname>Jimmy</firstname>
<lastname>Pace</lastname>
<streetaddress>1002 Misty Mountain Drive</streetaddress>
<cityname>New York</cityname>
<statecode>NY</statecode>
<postcode>10001</postcode>
<referencecode>ADU-239-BX</referencecode>
</customer>
<customer>
<firstname>Ralf</firstname>
<lastname>McCartney</lastname>
<streetaddress>67 Penny Lane</streetaddress>
<cityname>Las Vegas</cityname>
<statecode>NV</statecode>
<postcode>89125</postcode>
<referencecode>JUI-854-CF</referencecode>
</customer>
<customer>
<firstname>Elvis</firstname>
<lastname>John</lastname>
<streetaddress>3 Yellow Brick Road</streetaddress>
<cityname>Chicago</cityname>
<statecode>IL</statecode>
<postcode>60699</postcode>
<referencecode>GGY-118-AS</referencecode>
</customer>
<customer>
<firstname>Rick</firstname>
<lastname>Clayton</lastname>
<streetaddress>461 Ocean Boulevard</streetaddress>
<cityname>Miami</cityname>
<statecode>FL</statecode>
<postcode>33101</postcode>
<referencecode>LOP-212-TY</referencecode>
</customer>
<trailer>
<totalRecords>5</totalRecords>
</trailer>
</CSV_5>

Back to sample home