Testing
  • 14 Jun 2020
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Testing

  • Dark
    Light
  • PDF

Article summary

Several tools are provided to assist troubleshooting any connection issues you may experience.

Service Log

Once your Relay Server is up and running, it will generate useful insights into the Dr. Know Windows Application Log regarding its ability to connect to your other vendor’s product as well performance, productivity, and error information.


Verbosity Level

You can change the level of detail that is generated to the service log by changing the 'App.Verbose.Level' setting within the 'DK.EHR.Relay.exe.config' configuration file.

Supported Verbosity Levels
  • 0 = No output
  • 1 = Basic output (default; service startup and tear-down; errors)
  • 2 = Extended output (performance information, etc)
  • 3 = Exhaustive output (everything, raw packets, extended debug information)

Debug Mode

You can place your connection into Debug Mode by adding a '-' prefix to the IP address of your Connection’s message configuration and restarting the Relay Server software. Doing so will instruct the Relay Server to continue to listen at the same IP address. However, the messages that it receives from the other vendor will not be generated to the normal 'messages\outbound' sub-folder of the main folder where your Relay Server is installed. Rather, these messages (in ALL their various formats) will be generated into a special 'messages\dev' sub-folder. This provides you with the ability to inspect these files and make sure they are coming across as expected.

Supported debug mode output formats
  • XML - Native format used by the Relay Server for processing
  • HL7 - Native protocol format, without packet wrapping (i.e. MLP protocol tokens)
  • Raw - Native HL7 protocol format, including packet wrappings (i.e. MLP protocol tokens)
  • Binary - Direct serialization of raw packet bits to disk

Manual Processing

You can manually copy and paste these captured files (XML format only) into the normal 'messages\outbound' folder for re-processing. Additionally, you can use these real-time messages as new samples that you can use to make changes to your connection’s configuration. When ready, remove the '-' prefix from the IP address, restart the Relay Server, and you are back in production mode.


What's Next