Configuring the International Patient Summary in the Reference Application.
- abdillahi ali
Table of contents
Getting Started with the International Patient Summary
The International Patient Summary (IPS) module provides functionality for fetching, storing, and retrieving FHIR International Patient Summaries within the OpenMRS ecosystem. This module is designed to operate in a headless manner, meaning it does not include any user interface components.
How to Configure the Backend for the International Patient Summary on the Reference Application
Navigate to the OpenMRS GitHub repository.
Clone the repository
In this illustration the repository is cloned on Gitpod. Therefore, click on configure your own repository to start the Gitpod machine
The repository is searched under Gitpod and user clicks on the continue button. The workspace will start successfully.
The following repository https://github.com/I-TECH-UW/o3-distro/tree/IPS-MPI/distro has the required International Summary Patient artefacts that should be added to the Reference application currently running on the Gitpod instance. See illustration below
click on the committed changes for the artefacts.
Click on the Files changed.
The first artefact is the IPS version OMOD found under the distro/distro.properties copy the OMOD artefact.
Click on the and paste under the same path of the cloned instance .
The second artefact is the IPS Snapshot version found under distro/pom.xml copy the artefact.
Paste the artefact under properties in distro/pom.xml of the cloned instance.
Copy the repository.
Paste the repository under the cloned instance.
Copy the IPS ESM App.
Paste the esm-ips-app under frontend/spa-assemble-config.json in the cloned instance.
Click on the docker-compose.yml file and copy the command to start-up the back end.
Open a new terminal. change directory to the front end module and build the module.
copy the command to start-up the back end and run under the front -end terminal.
Open a new terminal and execute the command docker compose up
Click on the ports tab and expose the port for the backend link to be publicly accessible.
Click on the link to access the backend.
Remove the path to access the back-end.
Enter login credentials and click on login button.
Property | Description |
|---|---|
| The URL of the FHIR server endpoint that returns the IPS. |
| Example: |
| The concept mapping or UUID of the complex concept used to store the IPS. |
| The UUID of the identifier type used to query the server for the IPS. |
To configure the above properties, we shall create an IPS concept so that we get the UUID that will store the IPS. To create the concept, the Dictionary menu item then click on Add New Concept.
Fill in the Concept Name, Class , Datatype and click on the Save Concept button.
Upon successful creation of the concept, copy the UUID.
Click on the administrator menu.
Click on Settings under Maintenance
Click on Ips, paste the Complex complex UUID that was copied. The Identifiertype Uuid and Url remain the same. Click on the Save button. The global properties saved successfully.
How to Configure the Frontend of the Reference Application to display the International Patient Summary for a patient
Click on the Url under the ports tab.
Enter the Username and click on the Continue button.
Enter the Password and click on the Login button
Select location.
Search patient
Click on Actions.
Click on Edit Patient Details.
Click configure
Select checkbox and configure
Update patient
To access the IPS click on the Hamburger menu at the top left.
Click on Patient History
Click on Refresh. The IPS will be displayed under the Patient History.