Tutorial: Set up FHIR service for Da Vinci Drug Formulary requirements

In this tutorial, you set up the FHIR® service in Azure Health Data Services (FHIR service) to pass the Touchstone tests for the Da Vinci Payer Data Exchange US Drug Formulary Implementation Guide.

Touchstone capability statement

The first test focuses on testing the FHIR service against the Da Vinci Drug Formulary capability statement. If you run this test without any updates, the test fails due to missing search parameters and missing profiles.

Define search parameters

As part of the Da Vinci Drug Formulary IG, you need to define three new search parameters for the FormularyDrug resource. The capability statement tests all three of these search parameters.

• DrugTier
• DrugPlan
• DrugName

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 FHIR service without updates.

Store profiles

Besides defining search parameters, the only other update you need to make to pass this test is to load the required profiles. The Da Vinci Drug Formulary IG uses two profiles.

• Formulary Drug
• Formulary Coverage Plan

Sample REST file

To help you create these search parameters and profiles, the Da Vinci Formulary sample HTTP file on the open-source site includes all the steps previously outlined in a single file. After you upload all the necessary profiles and search parameters, you can run the capability statement test in Touchstone. You should get a successful run:

Touchstone query test

The second test is the query capabilities. This test validates that you can search for specific Coverage Plan and Drug resources by using various parameters. The best path is to test against resources that you already have in your database, but the Da VinciFormulary_Sample_Resources HTTP file is also available with sample resources pulled from the examples in the IG, which you can use to create the resources and test against.

Next steps

In this tutorial, you learned 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.