6.13International Patient Summary (IPS) Generator

 

The International Patient Summary (IPS) is an international collaborative effort to develop a specification for a health record summary extract. It is specified in the standards EN 17269 and ISO 27269, and supported in FHIR through the International Patient Summary Implementation Guide.

In FHIR, an IPS is expressed as a FHIR Document. The HAPI FHIR JPA server supports the automated generation of IPS documents through an extensible and customizable engine which implements the $summary operation.

6.13.1Overview

 

IPS Overview

The IPS Generator uses FHIR resources stored in your repository as its input. The algorithm for determining which resources to include and how to construct the mandatory narrative is customizable and extensible, with a default algorithm included.

6.13.2Generation Strategy

 

A user supplied strategy class is used to determine various properties of the IPS. This class must implement the IIpsGenerationStrategy interface. A default implementation called DefaultIpsGenerationStrategy is included. You may use this default implementation, use a subclassed version of it that adds additional logic, or use en entirely new implementation.

The generation strategy also supplies the Section Registry and Narrative Templates implementations, so it can be considered the central part of your IPS configuration.

6.13.3Section Registry

 

The IPS SectionRegistry class defines the sections that will be included in your IPS. Out of the box, the standard IPS sections are all included. See the IG homepage for a list of the standard sections.

6.13.4Narrative Templates

 

The IPS Document includes a Composition resource, and this composition must include a populated narrative for each section containing the relevant clinical details for the section.

The IPS generator uses HAPI FHIR Narrative Generation to achieve this.

Narrative templates for individual sections will be supplied a Bundle resource containing only the matched resources for the individual section as entries (ie. the Composition itself will not be present and no other resources will be present). So, for example, when generating the Allergies / Intolerances IPS section narrative, the input to the narrative generator will be a Bundle resource containing only AllergyIntolerance resources.

The narrative properties file should contain definitions using the profile URL of the individual section (as defined in the section registry) as the .profile qualifier. For example:

ips-allergyintolerance.resourceType=Bundle
ips-allergyintolerance.profile=http://hl7.org/fhir/uv/ips/StructureDefinition/AllergiesAndIntolerances-uv-ips
ips-allergyintolerance.narrative=classpath:ca/uhn/fhir/jpa/ips/narrative/allergyintolerance.html

Built-in Narrative Templates:

6.13.5Credits

 

This module is based on the excellent work of Rio Bennin and Panayiotis Savva of the University of Cyprus.