Manual

Manual

Search

LabCorp HL7

HL7 is the name of the file format that Royal dental Software uses to receive data from Laboratory Corporation of America (LabCorp).

Royal dental Software uses HL7 messages to receive lab results and embedded PDFs from LabCorp. We connect to a SFTP (Secure File Transfer Protocol) site maintained by LabCorp and retrieve the files (HL7 messaging text). A service (program without a user interface) called RoyalDentalHL7 needs to be installed on the server. It will handle the interaction between the HL7 messages and Royal dental Software database.

Updating Royal dental Software Versions

We recommend contacting Royal dental Software Support for assistance with an update.

Setup Steps

  1. Make sure the client Royal dental Software program is installed on the server the same as it would be on any other workstation.
  2. Enable and set up the LabCorp HL7 Definition.
  3. Connect to the Database: The information for connecting to the database is in the FreeDentalConfig.xml file in the application folder. This is the same file that the main Royal dental Software program uses to connect to the database. The information in the file must be accurate before starting the RoyalDentalHL7 service. One way to ensure the accuracy is to start the Royal dental Software client program:
    1. On the Choose Database window, set the database connection information. Only simple direct database connections are supported. Uncheck Do not show this window on startup so this window will show the next time a users launches Royal dental Software from the workstation, then close the window. If Royal dental Software is run as an administrator (right-click, Run as Administrator when launching Royal dental Software), connection information will auto-save to the FreeDentalConfig.xml file.
    2. Verify that the information saved correctly by re-launching Royal dental Software. If the information is correct, users can be sure that RoyalDentalHL7 will connect to the correct database when the service is started.
  4. Create a service (RoyalDentalHL7 service) to receive HL7 messages in the Royal dental Software Service Manager. If there are multiple database for multiple customers hosted on one server, then multiple HL7 services, each with unique names, must be setup. Then, each database must be set up to match with a differently named HL7 service. If already using HL7, users may only need to restart the RoyalDentalHL7 service.

    Errors: If the service does not start as expected:

    • Verify that LabCorp message definition settings are correct.
    • The service will not start if the version is not exactly the same as the version of the main Royal dental Software program.
    • If it still won't start, use the Computer Management tool: In the Start Menu navigate to Computer, right-click, Manage. Expand System Tools, Event Viewer, Windows Logs. Click on Application. The error and information entries will help determine the reason why the RoyalDentalHL7 will not start.

Troubleshooting

Simple Troubleshooting: If the messages are not being passed to OD and processed as expected, follow the steps below.

  1. Stop the RoyalDentalHL7 service.
  2. Edit the FreeDentalConfig.xml file by adding a line for <HL7verbose>True</HL7verbose>. Example:
  3. Start the service, then monitor the error log.
  4. After troubleshooting, remove the <HL7verbose>True</HL7verbose> line from the xml file. The line will usually be removed automatically when a user clicks OK from the Choose Database window.