6.13.1International 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.2Overview
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.3Generation 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 DefaultJpaIpsGenerationStrategy 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 Narrative Templates implementations, so it can be considered the central part of your IPS configuration.
- JavaDoc: IIpsGenerationStrategy
- Source Code: IIpsGenerationStrategy.java
The default generation strategy 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.
- JavaDoc: DefaultJpaIpsGenerationStrategy
- Source Code: DefaultJpaIpsGenerationStrategy.java
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 definition within the generation strategy) as the .profile qualifier. For example:
ips-allergyintolerance.resourceType=Bundle
ips-allergyintolerance.profile=https://hl7.org/fhir/uv/ips/StructureDefinition-Composition-uv-ips-definitions.html#Composition.section:sectionAllergies
ips-allergyintolerance.narrative=classpath:ca/uhn/fhir/jpa/ips/narrative/allergyintolerance.html
Built-in Narrative Templates:
- Source Code: ca.uhn.fhir.jpa.ips.narrative. Note the following:
- Default properties file: ips-narratives.properties
- Example template for Allergies section: allergyintolerance.html
- Fragments file containing common fragments used in multiple templates: utility-fragments.html
6.13.5Credits
This module is based on the excellent work of Rio Bennin of Crossroads Labs, and Panayiotis Savva and Constantinos Yiasemi of the University of Cyprus.