Message Schemas

The following link is designed to give users a generic url (without the schema version) that users can include as the schema in their xml. This would allow you to be sure that you are always validating against this latest posted schema without having to download a new copy and update your xml each time a new version is created. If you prefer to have a local copy of the current schema, you can follow the instructions below for downloading a copy. Previous versions are also available below.

Current Base Schema (V2.1): https://vtsl.vetmed.vt.edu/nahln/Documents/NAHLNMessageSchemas/NAHLNResultBase.xsd
(To Save a copy locally: In IE or Netscape, right-click and select Save Target As.. In Foxfire, right-click and select Save Link As...)

Please note that for messaging, file name must include the version number, but without the file extension. See sample text below.

<MSH.21>
   <EI.1>NAHLNResultBaseV2.0</EI.1>
   <EI.3>2.16.840.1.113883.3.5.9</EI.3>
   <EI.4>ISO</EI.4>
</MSH.21>

Previous Schemas:
(To Save a copy locally: In IE or Netscape, right-click and select Save Target As.. In Foxfire, right-click and select Save Link As...)

Base Schema Version 2.0
Base Schema Version 1.9.5
Base Schema Version 1.9.4

Message Transformation

An xsl transformation file is provided here to give users an easy way to render your xml result messages into a human-readable format. Copy/paste the following into your XML message on Line 2, immediately following the "". Download and put the .xsl file in the same folder with your XML document. You should then be able to point your web browser or favorite XML program at the XML file and view it in a more human-readable format. Please post any comments or suggestions regarding the Transformation on the NAHLN documents forum.

<?xml-stylesheet type='text/xsl' href='NAHLNResultHTML.xsl'?>

To download a copy of the transform and save it locally, right click on the following link and save the file to your disk.

https://vtsl.vetmed.vt.edu/nahln/Documents/NAHLNMessageTransforms/NAHLNResultHTML.xsl

Documents

The document links in this section lead to the NAHLN Documents Forum. Each link should lead you to the Current Documents thread that contains only the most recent copy of each document. The link should also take you directly to the post for that document within the thread, however, if you don't see it, scroll up or down and be sure to check all pages within the thread in case the document moved. If you don't find the document in the current documents thread, you can click on the NAHLN Documents Forum link at the top of that page and search for the specific thread on the document you were looking for (we keep all old copies in individual document threads). Please let us know if you have trouble finding a document and we will investigate and be sure that you get the document you need.


VS SSL Certificate (March 2023) zip file
VS SSL Certificate (March 2023) 7-zip file
Once downloaded: Extract files, Choose appropriate type, Remove ".rename"

The NAHLN Electronic Messaging Guide, NVSL-WI-1781, contains requirements and guidance for electronically messaging test results. It is a controlled document and available through your lab's quality management system.



Quick User Guide to HL7 Messaging (uploaded Sept 2016)

NAHLN Result Messaging Implementation Guide (V.5 updated May 2020)

NAHLN Order & Response Messaging Implementation Guide (V.5 updated May 2020)

Hitchhiker's Guide to NAHLN Messaging (updated May 2021)

NAHLN Message Map Template (updated October 2018)

USALIMS NAHLN Messaging Guide (Updated February 2022)

NAHLN IS Lab Registry Job Aid

NAHLN IS OID User Guide


Helpful Links

LOINC®
AAVLD OID Registration & Search
Integrated Taxonomic Information System (ITIS)
Animal Diversity Web
World Bird Guide