Load RxNorm into Aidbox
Setting up Aidbox with RxNorm terminology loaded via FTR
Last updated
Was this helpful?
Setting up Aidbox with RxNorm terminology loaded via FTR
Last updated
Was this helpful?
Since the 2405 release, using Aidbox in FHIRSchema mode is recommended, which is incompatible with zen or Entity/Attribute options.
provides normalized names for clinical drugs and links its names to many of the drug vocabularies commonly used in pharmacy management and drug interaction software, including those of First Databank, Micromedex, Multum, and Gold Standard Drug Database. By providing links between these vocabularies, RxNorm can mediate messages between systems not using the same software and vocabulary. The license is free if you intend to use only the RxNorm codes.
We offer out-of-the-box integration with the most recent version of RxNorm, accessible at any given time, via the and .
To correctly set up Aidbox, we'll utilize the Aidbox configuration projects.
There's an for this process. Adhere to this guide, but note a variation when you reach the Configure the Aidbox
step: instead of using the recommended configuration projects (R4,R4B,R5,etc.) β clone this specific project:
This project is tailored with specific configurations essential for terminology loading.
If you already have a configuration project, you can replicate these steps to enable RxNorm terminology in your Aidbox instance.
By adding this dependency, we instruct Aidbox to load the zen.fhir
ValueSet definition, which is meant to include all codes from RxNorm. This ValueSet definition contains a specific directive detailing the FTR manifest. Aidbox'll use this manifest to input the actual RxNorm concepts into the database.
Zen requires importing a namespace into the entrypoint to load the ValueSet definition into the definitions store.
By default, Aidbox does not load terminologies into the database as that can take a lot of disk space. This means that full terminology functionality wonβt be available until you enable it manually. When you set it to true
, Aidbox will load terminologies into the database on the next startup and start functioning as a fully-featured terminology server.
To achieve that we set ftr.pull.enable
to true in features
map.
When ftr.pull.enable
is set to true
, Aidbox loads concepts asynchronously by default. This means that immediately after starting, there might be no concepts available because they are still loading. To address this behavior, set ftr.pull.sync
to true
.
async
pulls)Access the Aidbox UI and navigate to Database
> . Look for a query that includes "_import"
; this query is responsible for loading concepts into your database. Once this query disappears from the list, you can check the concepts in the database. Proceed to Database
> DB Console
and enter the following query: