| title | description | services | ms.service | ms.subservice | ms.topic | ms.author | author | ms.date |
|---|---|---|---|---|---|---|---|---|
Da Vinci Drug Formulary Tutorial for Azure API for FHIR |
This tutorial walks through setting up Azure API for FHIR to pass the Touchstone tests against the DaVinci Drug Formulary implementation guide. |
healthcare-apis |
healthcare-apis |
fhir |
tutorial |
kesheth |
expekesheth |
09/27/2023 |
[!INCLUDE retirement banner]
In this tutorial, we'll walk through setting up Azure API for FHIR to pass the Touchstone tests for the Da Vinci Payer Data Exchange US Drug Formulary Implementation Guide.
The first test that we'll focus on is testing Azure API for FHIR against the Da Vinci Drug Formulary capability statement. If you run this test without any updates, the test will fail due to missing search parameters and missing profiles.
As part of the Da Vinci Drug Formulary IG, you'll need to define three new search parameters for the FormularyDrug resource. All three of these are tested in the capability statement.
The rest of the search parameters needed for the Da Vinci Drug Formulary IG are defined by the base specification and are already available in Azure API for FHIR without any more updates.
Outside of defining search parameters, the only other update you need to make to pass this test is to load the required profiles. There are two profiles used as part of the Da Vinci Drug Formulary IG.
To assist with creation of these search parameters and profiles, we have the Da Vinci Formulary sample HTTP file on the open-source site that includes all the steps outlined above in a single file. Once you've uploaded all the necessary profiles and search parameters, you can run the capability statement test in Touchstone. You should get a successful run:
:::image type="content" source="media/cms-tutorials/davinci-test-script-execution.png" alt-text="Da Vinci test script execution.":::
The second test is the query capabilities. This test validates that you can search for specific Coverage Plan and Drug resources using various parameters. The best path would be to test against resources that you already have in your database, but we also have the Da VinciFormulary_Sample_Resources HTTP file available with sample resources pulled from the examples in the IG that you can use to create the resources and test against.
:::image type="content" source="media/cms-tutorials/davinci-test-execution-results.png" alt-text="Da Vinci test execution results.":::
In this tutorial, we walked through how to pass the Da Vinci Payer Data Exchange US Drug Formulary in Touchstone. Next, you can learn how to test the Da Vinci PDex Implementation Guide in Touchstone.
[!div class="nextstepaction"] Da Vinci PDex
FHIR® is a registered trademark of HL7 and is used with the permission of HL7.