IRIS Interop DevTools: A Jumpstart into IRIS Transformations for CCDA and FHIR

IRIS supports CCDA and FHIR transformations out-of-the-box, yet the ability to access and view those features requires considerable setup time and product knowledge. The IRIS Interop DevTools application was designed to bridge that gap, allowing implementers to immediately jump in and view the built-in transformation capabilities of the product. 

In addition to the IRIS XML, XPath, and CCDA Transformation environment, the Interop DevTools package now provides:

• FHIR-SDA Transformation setup
• SDA-FHIR Transformation setup
• Bubbling up of FHIR validation errors
• Loading of required context for FHIR transforms

The look and feel of the dashboard has been updated to be more intuitive and user-friendly. Execution occurs within IRIS in order to leverage the environment, while the UI allows visibility, repeatability, and the ability to isolate modifications and modules for testing.

There are five utilities:

1. XPath Evaluator: Evaluates an XPath against an input CCD and returns result

2. CCDA to SDA Transform: Runs an input CCD through the selected base XSL transform and displays SDA result. 

3. XSL Template Tester: Applies a single XSL template against an input CCD and displays the resulting CCD. 

4. FHIR to SDA Transform: Runs the standard FHIR to SDA transform on an input FHIR resource or bundle and displays SDA result or FHIR validation error response. 

5. SDA to FHIR Transform: Runs the standard SDA to FHIR transform on an input SDA message and displays FHIR Bundle result.

 Getting Started:

1. IRIS Interop DevTools is available for download on the Open Exchange. 

2. Once installed, the UI runs in a Docker container. Follow the instructions in the README to build and start docker. (Additional instructions are included in the README for MacOS users). 

3. Open the UI at: http://localhost:4000  

For local installation

The application is built to run on Docker on an IRIS for Health community image, however the solution only requires a Foundation namespace and is compatible with HealthConnect, IRIS for Health, or HealthShare UCR.

1. The backend IRIS web application and REST APIs is available for installation via IPM.

From IRIS terminal:

zpm "install iris-ccd-devtools"

2. The front-end application can be installed locally by changing directories to the  "frontend/CCD-Tools-Frontend" folder and then running the following commands:

• npm install
• npm rundev

3. Open the UI at: http://localhost:4000  

Sample Data

There is anonymized sample data loaded in the testing folder. There are also two Postman collections for testing the backend APIs. The interop-devtools-ccd-fhir.postman_collection.json contains the updated FHIR-SDA APIs. 

Running The Toolset

Upload or paste the contents from the appropriate sample file in order to test each tool. 

Example for the FHIR to SDA transform tester:

Let us know what you think. Is a toolset like this useful for what you do? What features would be useful in the future? We look forward to continuing to enhance the toolset in our Innovations group.