HL7 Message Modifier

The HL7 Message Modifier filter provides a fast and simple means of defining the most commonly-used modifications to HL7 messages passing through Rhapsody. The filter provides a graphical user interface with pre-defined functions for commonly used message modifications, and instant feedback on the results of those changes using test sample messages.

The Mapper filter is used to map from an entire message definition to another. Though versatile, the Mapper filter is not optimized for cases when a user wants to make a small number of straightforward changes to an HL7 message, for example, altering a date format or merging fields to conform to the requirements of a destination system. The HL7 Message Modifier filter provides an intuitive way to define frequently used HL7 message changes for users who want to speed up their workflow or who are not familiar with programming concepts required for the Mapper and JavaScript filters.

For a comparison between the HL7 Message Modifier and Mapper filters, refer to Mapping Exercise.

System Requirements

• In order to use and configure the HL7 Message Modifier filter, ensure that Internet Explorer® is installed on the same machine that is running Rhapsody IDE.
• The filter uses the same port as the Management Console to operate (as configured in the rhapsody.properties file). Ensure that port is available for the filter to use.
• An TLS/SSL certificate is required to configure the filter. Refer to Security for details.

Supported Functionality

You can configure changes through the HL7 Message Modifier filter to trigger unconditionally, or conditionally on the basis of the value of a field, message property or Rhapsody variable.

The filter incorporates the following modification functions:

• Setting a field to a value, message property or Rhapsody variable.
• Clearing a field.
• Converting a field value to uppercase or lowercase.
• Removing certain characters from a field value.
• Copying from fields.
• Setting a field to concatenated values.
• Trimming values in a field.
• Setting a field using lookup tables
• Inserting date-time into a message.
• Setting message properties to a field value.
• Deleting segments (repeating segments are all deleted).

Limitations

Certain functionality is not supported by the HL7 Message Modifier filter, for example:

• Adding segments.
• Deleting segments (deleting individual instances of repeating segments).
• Complex looping structures, for example merging or splitting NTE segments.
• Applying more than one change to the same field.
• Applying changes sequentially.
• Handling field repeats.
• Handling non-HL7 formats.

In these cases, you can use the Mapper filter.