Skip to content

Latest commit

 

History

History

ips-subscriptions-no-zen

README.MD

Implementation of IPS FHIR IG on Aidbox FHIR platform

This repository contains pre-configured Aidbox instance and implementation of $summary operation defined by IPS:

Prerequisites

STEP 1: Environment and Aidbox license

Copy .env.tpl file into .env file:

cp .env.tpl .env

Obtain the self-hosted license as described in the documentation.

Add the license (AIDBOX_LICENSE) int the .env file.

STEP 2: Run aidbox and node-app in Docker

docker compose up --build

On start, the node-app will create App resource, upload a sample FHIR Bundle with patient data.

Step 3: Open and log in into Aidbox instance

Open in browser http://localhost:8888

And log in witn username: admin and password: password

Step 4: Request $summary using REST Console

In the Aidbox admin window, navigate to the APIs section and choose REST Console.

The $summary operation requires either the logical ID (Patient.id) or a business identifier (Patient.identifier) of the patient. To request the IPS "document" Bundle for a specific patient using the REST Console, you can use the following request:

GET /fhir/Patient/[id]/$summary

e.g.

GET /fhir/Patient/2b90dd2b-2dab-4c75-9bb9-a355e07401e8/$summary

Or you can use request with identifier search parameter:

GET /fhir/Patient/$summary?identifier=<patient-identifier>

Step 5: Check if Aidbox Topic-Based Subscriptions works

The SubscriptionTopic in Aidbox is set up to send QuestionnaireResponse events in the completed and amended status to https://aidbox.requestcatcher.com/. We will use Aidbox Forms to send QuestionnaireResponse.

To try it out:

  1. Open https://aidbox.requestcatcher.com/ to view webhook requests.
  2. Open Aidbox Forms at http://localhost:8888/ui/sdc#/.
  3. Click "Share" on the form, then "Attach", copy the link.
  4. Open the link and fill the form.

Read more about Aidbox Topic-Based Subscriptions: https://docs.aidbox.app/modules/topic-based-subscriptions/wip-dynamic-subscriptiontopic-with-destinations