zimpl:FHIR Profiling Toolkit for HealthShare

2024-03-27 • Brandon Thomas

Contents

• Scope
• Installation
  • Classes and Dependencies
  • Configure Production
  • Navigate to the Startpage
  • Disclaimer
• Known Issues
• Roadmap
• License

Scope

This package provides a number of tools which were developed to aid in the implementation of the German MII FHIR profiles in InterSystems HealthShare. These tools are not intended for production use.

Many thanks to our sponsor for this project, the University Hospital of Hamburg-Eppendorf, Germany 🎉

The following screenshots narrate the basic functionality ...

---

Retrieve and compare SDA Containers with FHIR Bundles by MRN/AA or MPIID

---

Network diagram which displays the hierarchy of all resources within a FHIR bundle

---

Timeline diagram of specific FHIR resources within a bundle

---

Extensible DTL Viewer with search, filter and export capabilities

---

Integrated Management Portal

Installation

Import Classes

• Import and compile the classes from GitHub in the HSCUSTOM namespace.

Configure Production

A foundation-type production is required in HealthShare for retrieving SDA and FHIR. An installer method will configure this for you.

• From the terminal, use the installer script to setup the new namespace ZIMPLFHIRPRO and configure the production:

HSCUSTOM> do ##class(HS.Local.zimpl.fhirpro.API.Installer).Install()

Now in the Management Portal:

• Configure the Business Operation GATEWAY

  • The ServiceName setting needs to use an AccessGateway known in the Service Registry, for example: dembp18bthomas.local:HSACCESS

• Configure the Business Operation HS.FHIRServer.Interop.HTTPOperation

  • The ServiceName setting needs an HTTP Endpoint for FHIR (ODS), for example: FHIR.Service.R4
    Note: you may need to configure the HTTPCredentialsConfig and SSL Configuration settings in the Service Registry entry.

• 💡 Optionally add the Business Operation HS.Util.Trace.Operations

• Start the production

Web Dependencies

The following external libraries are contained in the included zip file:

• jQuery
• DataTables css and js
• simple tree table
• vis-network
• vis-timeline

---

• Unzip and save the contents of

zimplfhirpro_Dependencies-*.zip

to the following directory:

{HealthShare Installation}/csp/healthshare/zimplfhirpro/

Navigate to the Startpage

http://localhost:52774/csp/healthshare/zimplfhirpro/HS.Local.zimpl.fhirpro.UI.Index.cls

Disclaimer

⚠️ This application is not supported by InterSystems Corporation. Please be notified that you use it at your own risk.

Known Issues & Caveats

2024-01-12

• custom DTLViewer classes should now extend HS.Local.zimpl.fhirpro.UI.DTLViewer

Roadmap

• Add REST API in ODS to handle ReloadPatient(), etc from this tool
• Add tools for managing ^ISCSOAP,^FSLOG; verify custom DTL package; Extension Mapping; FHIR validation

License

This and all external libraries included with this package are available as open source under the terms of the MIT License.