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
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.
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 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.
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=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:
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.