NAHLN Interface

The NAHLN Interface checks for accessions that have finalized that include the tests that are reported automatically to the National Animal Herd Laboratory Network. This is an HL7 message that is sent automatically, either using a username and password or as of version 2.1.7, a token to the web service.

Job Settings

This job uses the standard Job API settings for VetView.

Field	Description
Active Flag	Indicates that this job is active and available to start.
Server to Run On	Displays a drop down of all servers currently connected to your VetView database. We strongly recommend having a dedicated API server, separate from the user facing production servers, to avoid lag.
Auto Start	Indicates that this job will start after a server reboot, and will run at the specified time. If this flag is not turned on, the job will need a manual start after a server reboot.
Error to Email Address	If there is an issue running the job, a message will be sent to the specified email address.
Job Runs Every	The timer for this job. For most API jobs, this timer can be set as often as once a minute. If you are on a slower or older server, this may be better to run less frequently, to give each job time to finish.
Start/Stop Job	If auto start is not on, this button will kick off the job. If the job is running, this button changes to Stop Job and will disable the job temporarily, but leave it active and available to start again.

NAHLN Interface Tab

Message Log

The Message Log allows you to view the status of the messages sent via the system.

Successful messages with have a status of S. Queued messages will have a status of Q. Failed messages will have a status of Failed.

Message Details

Clock on a row to view the XML code that was sent to the NAHLN database, and the response if one was recieved. If there is a Failed status, the error message may provide clues as to what the issue is.

Message Setup

These are the specific settings for each test in your lab system.

Add New

Click on the Add New button to create a new interface. A blank Message Details window will load.

Message Setup Details

Enter in the configuration details for the message.

Most Common NAHLN settings

Field	Description
Message Profile	The name of the profile. For clarity, we strongly recommend including the name of the disease being reported, or the test for the disease.
Active Flag	This profile is active, and whenever an associated test is finalized, a message will be sent in the specified Post Type containing the results.
Failure Email	If this message cannot be sent for known or unknown reasons, an error email will go to this email address.
Post Type	Choice between NAHLN EMS (HL7 Post with Auth Token), NAHLN standard (HL7 PUT with username and password), USAHerds (SOAP Post), BSE (XML Post), and SHIC (Post.) The exact format for each message may be different for each state and even each individual test. Contact NAHLN for specific information needed.
Destination URL	The web server to send the message to, usually a URL for the USDA website.
Username and Password or Auth Token	The username and password assigned to your institute to be permitted to post messages to the USDA website. For NAHLN EMS, this will be an auth token instead.
Message Type	The exact HL7 or XML message type that will be sent based on Post Type.
Schema Definition	An XSD file. This can be uploaded, or removed.
Sending Application	The name of the application sending the message. For the purposes of this interface it will always be VetView.
Universal ID	The root OID of the laboratory sending the message for this test.
Sending Facility	The Premise ID of the organization sending this message.
Receiving Application	Application or Program Name. For the purposes of this interface, it will always be NAHLN unless otherwise specified.
Universal ID	The Root OID of NAHLN as designated to your organization.
Receiving Facility	The Premise ID of NAHLN as designated to your organization.
Date/Time of Message:	An auto timestamp of the date and time the message is sent in HL7 standard.
Message Type	The message type. For Hl7 this will always be OPU-R25
Message Control ID	Auto generated using the current timestamp in miliseconds
Processing ID	Indicates whether messages should actually be sent or not. Choices between Debugging (verifying internal settings), Production (live data is sent), or Training (no live data is sent.)
Processing Mode	Choices between Current, Archive, Restore from Archive, or Initial Load
Version ID	NAHLN is version 2.6
Message Profile Identifier	Choices between the Result Base for various tests. Select the appropriate one for the test being reported.
Originating Laboratory	Specify if all tests and results from your lab will come from a single lab. Disable if multiple labs have the option of reporting test results to NAHLN.
PV1	Settings for patients - classes, whether a case coordinator is included, and whether to use the accession number or a reference number or disable the option entirely.
OBX	Observations. Include Lot or Group, Include Source or Flow, include Reference Number, and Choose Question for each.
ROL	Role Instance IDs include the specific role, the person, the address, and the location, as well as other option. If the whole location and not an individual is acting in the Role, choose Source Premises. Multiple roles can be turned on.
NK1	Other client names and relationshops.
PID	Patient Identifiers used. Choices of Animal ID, Case Numbers, or other questions. Patient demographics can be included in the HL7 message as well.
SPN	Specimen placer information. The Specimen Label, Specimen ID, or animal IDs can be used. Additional specimen information can be included in the HL7 message as well.

Mappings

The final tab on this screen is where you can link your VetView system's installation to the codes used by NAHLN for species, breed, and sex.

Example Species:

Example Breed:

Example Sex:

VetView Wiki

Most recent releases of VetView: Version 4.2.5 Hotfix (Released 10/31/2024)

Contents