Home > Products > Symphonia > Message Mapper

Message Mapper

Maps from one format to virtually any other format
Allows incompatible systems to communicate

Using the Symphonia Message Mapper is easy...

1. Symphonia's Message Designer analyses and displays each message in its hierarchical form. These messages are then imported into Symphonia's message mapper.
2. The Symphonia Message Mapper application displays two panes, each with a format ready to be mapped to the other. The user simply drags a component from one pane to its equivalent in the other.
3. When all the components have been connected this way, a map file is generated which is capable of mapping a message from one format to the other. This map file is stored in the message project file.

Example of Mapping from HL7 2.3 to XML - The user-friendly Symphonia Mapper Application makes it easy.

One message format is in the left pane, the other format is in the right. Users simply drag and drop from one to the other - code creating the map is automatically generated in the lower pane.

	Workspace Shows mapping structures being created (These structures can also be reused / repeated for use when creating other maps.)
	When beginning a mapping project, Symphonia creates two definition panes of content. In this example the HL7 is on the left and XML is on the right.
	Mapping technique: Drag and drop the matching components in each of the definition panes from one to the other. The code is automatically generated for this assignment.
	It is possible to drag a message component (or field) down into the code pane. This will place the full path to the items in the code pane below. This saves typing out the full path repeatedly. This is useful when setting hard coded values and when that item is a parameter to another map. Also, one of the message components may not need to be mapped, but only need its content altered.
	Displays external functions. These can be held in DLL's and called from the mapping code, for example, date formality, string manipulation and data type conversion.
	Mapping code is created here. (Shown as definition)
	Call over collections. The [*] symbol in the In.PID.HomePhoneNumber[*] indicates that the MapXTNTophon submap is to be called for each instance in the In.PID.HomePhoneNumber repeating item.
	Code Helper Toolbar Inserts code for commonly used logic, for example, a 'for loop', 'select' or 'ifstatement'.

With the Message Mapper you can quickly map a path between any two hierarchical objects, e.g. between two EDI HL7 messages, as used in the Health Care Industry; or between an XML document and an EDI HL7 message, or even between an XML document.The Mapping tool helps you to easily define mapping between a left and right object. e.g. creating a map between an HL7 laboratory application and an X.12 Whiteboard application.

Example of Creating Maps: HL7 to XML	Example of Using Maps: HL7 to XML

Using the Symphonia Message Mapper is easy...

1. Message Definition
   Define the message structure in Symphonia's EDI or XML Designers.
2. Importing
   Import the left and right message definitions into the Mapper with the easy to use wizard. Messaging definitions can include: an XML Schema, DTD, Symphonia EDI Designer files and Designer for XML files.
3. Mapping Definition
   Define how fields in one object are mapped to fields in the other object by simply dragging and dropping from one pane to the other. Depending on the definitions being mapped, it is also possible to have the Mapper "Auto-Map" the majority of data from one structure to the other.
4. Testing / Debugging
   The Mapper includes a fully integrated debugger, allowing the setting of breakpoints and allowing the user to step through each line of mapping code. The values of variables and fields can be viewed and checked at the same time. The testing can be performed on any supplied arbitrary file..
5. Compiled Mapping Definition
   The Symphonia Message Mapper creates a compiled mapping file to be used with the mapping COM component and Java Mapper Classes.
6. Using the Mapper in an Application
   The Symphonia Message Mapper can be incorporated into an application using the Symphonia Mapper COM object, Symphonia Java C++ libraries or the Symphonia Mapper Java Classes. The Mapper engine can be run on Unix systems using the java Engine, or the C++ libraries can be ported on request.

Transport Engine

The Symphonia Message Mapper tools includes the Symphonia EDI/XML Tools.

Video Tutorial

Download the Message Mapper video tutorial here.