Xlate Debugger

The Xlate Debugger, integrated into the Translation Configurator, is for users who require detailed information when developing and troubleshooting translations. You can observe the run-time behavior of the translation process and locate logic errors and addresses.

Note: When using the Xlate Debugger, the IDE does not open/close any panes. All panes remain in the same state (open/closed) when the debugger is opened/closed.

The hcixlttest testing command provides debugging on every action during the translation.

hcixlttest tests a translation configuration against an actual data message. For every input message, the Translation Configurator parses the input message according to the translation’s input record specification. It then produces an output message according to the output record specification. After this, it runs the transformation actions defined in the .xlt file, and shows the results according to the chosen detail level.

Translation files are stored in $HCISITEDIR/Xlate (UNIX) or %HCISITEDIR%\Xlate (Windows).

Example

A user is developing an interface for a new downstream system. The downstream is not receiving the data in a specific field of an HL7 v2 message.

The translation has several IF and ITERATE conditions.

To debug, the user sets breakpoints in key areas in the translation to step through their logic and correct the issue.

Debug mode

Debug mode is designed for debugging the xlt files. It includes an editing area and debug panel.

After the debugger is launched, Translation Configurator changes to debug mode. This automatically closes the Launch Bar and Site Manager to free the space for the debug panel.