NAHLN/USA Herds Setup Guides
Step 1: How do I set up the API?
Enable the NAHLN Interface section
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_16-44-29.png?version=1&modificationDate=1674510269700&cacheVersion=1&api=v2)
This enables the interface and opens the NAHLN Tab.
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_16-46-9.png?version=1&modificationDate=1674510368821&cacheVersion=1&api=v2)
You will need to create a Certificate Folder. The Certificate folder is any folder on the server where the API will save any Certificates or other setup files needed in the message definition.
Create a Message Definition
Individual profiles are created under the Message Setup tab.
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_16-48-18.png?version=1&modificationDate=1674510498736&cacheVersion=1&api=v2)
The information required for each Post Type will be different. This information should be provided to you from NAHLN for the specific message types.
Step 2: How do I set up the Test Definitions?
Test Setup Screen - Add New Message Profile
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_16-51-53.png?version=1&modificationDate=1674510713212&cacheVersion=1&api=v2&effects=drop-shadow)
- Choose the Message Profile that was setup in the API
- Select when the message should be added to the Queue for processing:
- Accession finalizes
- Test Finalizes
- Manually sent
How do I monitor the Sending and Logging of Messages?
Result Entry Area - For tests that have message defined will automatically have a section added the result area where you can see the status of the out going messages.
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_16-59-14.png?version=1&modificationDate=1674511154831&cacheVersion=1&api=v2)
API - Message Log
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-23_17-2-54.png?version=1&modificationDate=1674511374129&cacheVersion=1&api=v2)
How do I set up Mappings between my system and NAHLN?
To ensure your system is accurately sending data that NAHLN can read, you can link the Species and Breed used in your local version of VetView to the NALHN codes for species and breed.
This can be especially useful if you use the species name as a generic for for a clade or family that contains many species.
![](https://vetview.atlassian.net/wiki/download/attachments/71434247/image2023-1-24_9-3-40.png?version=1&modificationDate=1674569018344&cacheVersion=1&api=v2)