Generic HL7 Message Structure
Generic HL7 message structure can be customized to meet the bridging requirements of other software.
In the Main Menu, click Setup, Advanced Setup, HL7.
There are several internal definitions. Some information can be edited in an internal definition, but messages and segments cannot.
Custom definitions allow editing of all information, including messages and segments. To create a custom definition you have two options:
Double click on the message definition.
Enabled: Enable the definition and activate editable fields.
Mode Tx: Select a transfer mode (Mode Tx) of File, TCP/IP, or Sftp.
Delimiters: Select the separator characters.
Show Appts Module: Give access to the Appointments module.
Show Account Module: Give access to the Account module.
Send Quad as Tooth Num: Usually quadrant information shows as surface information in a claim. However, some insurance carriers require that quadrant information show as tooth number and may reject claims if it doesn't. Check this box to send quadrant information as tooth number.
Warn if Procs not attached to Appt: Show a message prior to sending procedures via HL7 if they are not attached to an appointment.
HL7 Communication Options: Set up the inbound and outbound folder paths or ports. The options vary based on the ModeTx. See TCP/IP mode below for steps.
OpenDental HL7 server and service name: See HL7 Service Manager for information about installing and naming the OpenDentalHL7 service.
Show Demographics: Typically patient demographic information is not entered in Open Dental because it may be overwritten every time an inbound HL7 message for the patient is processed. If you want to be able to change and add demographic information in Open Dental, select Change and Add Pts. You will be prompted to enter a password which is hl7.
Messages/Segments: Can only be edited in custom definitions. See Editing Messages/Segments below.
For custom definitions, the incoming and outgoing message structure can be modified. To add a new message, click Add. To modify an existing message, double click the message or one of its segments.
Message Type: For a description of all message types, see HL7 Inbound and Outbound Message Types.
Event Type: Incoming/Outgoing:
Item Order: Determines the order the message will show in the Message / Segment grid.
Segments: Double click on a segment to modify, or click Add to create a new segment.
Segment Name: Can be selected from a list of available segment names supported by Open Dental.
Item Order: For outgoing messages, affects the message structure. For incoming messages, only determines the order the segment shows in the Message Edit window.
Fields: Double click a field to modify or click Add to create a new field.
Data Type: Linked to fields internally defined by Open Dental, so you will only have the option to select a data type for fixed text fields.
Table ID: For informational purposes only and is not used by Open Dental or inserted into outgoing messages.
Fixed Text: Fixed text fields are ignored for incoming messages, and simply inserted in the proper item order for outgoing messages.
Field Name: Lists only fields that Open Dental will process for incoming messages or fill in with data from the database when constructing outgoing messages.
To view a log history of HL7 messages, click History on the HL7 Defs window.