File Toolbar

File/Application Toolbar

Table of Contents

File Operations

Open - Open a file containing HL7 Messages 

  • Click the Open button to display the standard Windows Open File Dialog. This dialog allows you to multi-select files to be opened.
  • Click just under the Open button to access a list of recently opened files.
  • You can also open files by dragging and dropping them into HL7Spy, or by using the "Open Folder" tool.

New - Create a new, empty, HL7 file

  • You can create a new file and copy and paste messages into the Editor

Open Folder - Open multiple files

  • Directory - The location of the folder you wish to search for matching files.
  • File Search - A semicolon-delimited list of file extensions to search for.
  • Recurse Subdirectories - Whether to search nested subfolders.
  • Content Search - Look at the contents of the file to see if there is a match, useful for searching specific patient IDs.
  • Use Regex - Specify a more complex search using a Regular Expression.
  • Match Case -  Consider the case of the text in the match.
  • Merge files into a single file before loading - Merge many small files into one before loading them in HL7Spy.


Open Hex - Open a file and display its contents in the Hex Editor

  • Click the Open button to display the standard Windows Open File Dialog.
  • Click to the right of the Open button to display a list of recently opened files for quick access.

Save As - Save the contents of the current tab to a file

  • Files in HL7Spy are always read-only. Modifying a message in the editor does NOT edit the underlying file, by design.
  • To save changes, you must save the file to another file.
  • Click the “Save File” toolbar button to display a dialog providing control over the location and format of the files being saved.


  • When the “Save” button is clicked, each message in the message collection will be written to the file specified in the “File Path” textbox, using the specified character encoding. The Frame Start/Frame End specifies how messages are delimited. By default, Standard HL7 Message Framing is used, with each message preceded by byte 0x0B and followed by 0x1C0X1D, resulting in the following format: 0BMSH...1C0D0BMSH...1C0D...

Export XML - Export the contents of the Editor to XML

  • Version - Specify the XML version to be generated.
  • Message Range - Select a subset of messages to export.
  • Generated File Name - Determine what is used to generate the file name of the XML document.
  • Directory - Where the XML files should be written.
  • Sample Message - Displays the current message in the editor converted to XML.

HL7 Communications

Receive HL7 - Receive HL7 Messages over TCP/IP using the MLLP Protocol

  • Welcome Port - The Windows Network Port that HL7Spy will listen on for incoming connections.
  • Network Interface (to the right of the Welcome Port) - Network interfaces available on the local machine. By default, all interfaces are listened on.
  • Inactivity Timeout - Time in minutes before the connection will be closed due to inactivity.
  • Max Message Size - The maximum size in KB that HL7Spy will receive. A setting of 0 means there is no size limit.
  • Support BHS/FHS Messages - Turn on/off the HL7 batch message protocol option.
  • Acknowledgment - Set the HL7 ACK return code and message sent back to the sending party.
  • Debug Logging - Enable/disable logging of the HL7 protocol, useful for troubleshooting connectivity issues.
  • File Path - The location to store incoming messages.
  • Delete File on Close - When selected, the file containing the messages will automatically be deleted when the tab is closed.
  • Exclusive Access - Turn on/off sharing of the file.

Options

Application Options - Set options that affect the visual and operational characteristics of the application

  • Order Tabs by MSH-7 - When enabled, tabs are sorted in order of the date-time value (MSH-7) found in the first message of each tab.
  • Hide Application Tooltips - Disable tooltips that describe the functionality of buttons when hovering over them.
  • Hide Button Group Title - The text below groups of buttons (for example "File Operations" under the "Open Hex" button) can be hidden to free up vertical display area.
  • Show Partial Load Dialog - When loading a very large file, you might want to turn this feature on to only load a portion of the file instead of the entire contents
  • Explorer - Start New HL7Spy Instance - When enabled, a new instance of HL7Spy will be launched when opening a file from Windows Explorer, otherwise an existing instance will be used.
  • Use Strict Message Detection - HL7Spy by default uses heuristics to determine the start and end of HL7 messages in a file. Turning on strict mode forces HL7Spy to use a less forgiving algorithm for this.
  • Troubleshooting - Increase Logging - When you encounter a problem with HL7Spy our support team may ask you to turn this feature on to increase the amount of logging the application generates. Log files are located in Documents\HL7Spy\logs.
  • Use Windows Aero Glass - Change the visual appearance of the application by turning on/off Windows Aero Glass.
  • Shadow Main Window - urn on/off a shadow along the border of the main HL7Spy application window.
  • Look And Feel - Change the application's coloring and how elements such as windows, buttons, and menus look and feel.
  • Reset Layout - Set the application back to its default layout.
  • Reset Permissions - Enabled when HL7Spy is run as a user with Administrator rights, it resets the permissions on folder and registry entries used by HL7Spy.

Editor Options - Change operational characteristics of the editor

  • Mask PHI Settings - Controls which fields are masked when Masking is turned on in the editor. See Mask PHI Settings...
  • HL7 Keyboard Tips - Turn on/off the tooltip that is displayed when a field is selected in the editor. Tip: These tooltips are also displayed when you hold the shift key down while hovering the mouse over a field.
  • Word Wrap - Turn on/off word wrapping when lines in the editor are longer than the display area
  • Whitespace - Show/hide the whitespace within the message
  • Line Numbers - Show/hide the line numbers that are displayed in the editor
  • Dock Navigation Bar to top - This option allows you to control the location of the message navigation control. By default, the message slider, search box, and navigation controls are docked just below the editor. Some users prefer to have these controls docked on top of the editor.
  • Font - Change the font family and size used by the editor.

Registration and Help

Register HL7Spy - Register your license to activate HL7Spy

About HL7Spy - Shows information about your copy of HL7Spy

  • Hardware ID - An identifier for your instance of HL7Spy.
  • Licensee - The email address, or owner of this copy of HL7Spy.

Bug Report - Takes you to this document

  • Clicking this button will open a new window that will allow you to access the HL7Spy User Manual