Configure record transformation in message handler

About record transformation in message handler

Use the Activator message handler to configure transformations of the records that you exchange in messages:

• For any protocol.
• On any type of flow: inbound, outbound, and for exchanges with both back-end or trading partner endpoints.

For records transformations that you configure in message handler, Activator reads the original file containing the records on the hard drive, writes the transformed copy to the hard drive.

Limitation: You can perform only one record transformation on a message. If more than one record transformation is available, only the first transformation of the list of available record transformation is executed.

This topic describes only the records transformations that you can configure in message handler. For a complete list of message handler actions, see Define message actions.

Configuration

1. Click Processing configuration on the menu bar to open the Processing configuration page.
2. In the processing graphic at the top of the page, click the Message handler icon, to open the Message handler page.
3. From the task list at the bottom of the page, click Add a new message processing action to open the wizard.
4. Select an attribute as a condition for applying the message attributes template, and click Next.
5. In the Select a message processing action page, select the option Perform record format transformation.
6. Complete the fields. Enter values for the expected input format (original format) and the desired output format (target format) resulting from the transformation:
7. Original format – These parameters specify the format of the source record, before transformation. Any parameter that is not set in these fields is taken from the local file format metadata attributes.
   • File format – From the drop-down list, select a file format option:
     • Use protocol value
     • Binary, fixed record length
     • Binary, variable record length
     • Text, fixed record length
     • Text, variable record length
   • Record length – Enter a required record length, or leave this field blank to use the protocol value
   • Record padding character – Enter the character used for line padding (if any).
   • Character set – Enter the character set used in the original file (Example: ASCII, EBCDIC,...).
8. Target format – These parameters specify the format of the transformed record.
   • File format – From the drop-down list select a file format option:
     • Use protocol value
     • Binary, fixed record length
     • Binary, variable record length
     • Text, fixed record length
     • Text, variable record length
   • Record length – Enter a required record length, or leave this field blank to use the protocol value
   • Record padding character – Enter the character to be used for line padding.
   • Character set – Enter the character set to use (Example: ASCII, EBDC, ...)
7. Click Finish.

Disabling record transformation

To disable record transformations, do one of the following:

• In message handler, to turn off file transformation, clear the Perform record format transformation option.
• Set the local or virtual FileFormat attribute to to OCTET_STREAM.
• Set the local and virtual file record attributes to exactly match.

Related topics

• Message handler
• Set up message-processing actions
• Define message attributes
• Define message actions