This page is part of the Retrieval of Real World Data for Clinical Research (v1.0.0-ballot: STU1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions
One of the ways that patient health data can be retrieved is by requesting a patient summary document from the source system. This IG expands the use of the International Patient Summary (IPS) for this purpose. All of the IPS sections are used but the profiles that are returned are the Real World Data versions of the profiles which have been added on to for RWD purposes.
A patient summary document is a FHIR Bundle with type = ‘document’ and includes, as the first resource, a Composition resource. This Composition resource provides “meta” information about the information contained in the document, i.e. author, date, subject, etc. It also breaks the data down into different sections with each section having a code that indicates the section type as well as the specific type of data, represented as FHIR resource instances, that can be found in each section.
For source systems that support the extended IPS request, they SHALL support the Retrieve Extended IPS FHIR operation on the Patient endpoint for a specific Patient id.
[base]/Patient/[id]/$retrieveExtendedIPS(?historyPeriod=[# of months])
There is an optional parameter to the operation which is the number of months to consider history. This history period is found in most of the sections below.
The medication summary section contains a description of the patient’s medications. The content will contain all of the currently active medications plus any medications that have been administered in the given history period.
The entries in this section SHALL be one of:
The entries will be MedicationStatement instances where the MedicationStatement points to the optional source resource that generated the statement (i.e. a MedicationRequest representing the prescription details that were used to infer that a patient is on a given medication).
The problem list section describes clinical problems, conditions, or diagnoses that are currently being monitored for the patient.
The history of procedures section contains a description of all procedures for the patient performed in the given history period.
The diagnostic results section lists relevant observation results collected on the patient or produced on in-vitro biologic specimens collected from the patient in the given history period. Some of these results may be laboratory results, others may be anatomic pathology results and others, radiology results.
These sections from the IPS have no change and are recommended to be included if there is data:
These sections from the IPS have no change and are optional to be included if there is data:
There will be source systems that do not support the requesting of a patient summary document. In those instances, requesting systems will need to make individual queries to retrieve the data needed. This section details the needed queries.
To receive medication summary information, a requesting system will have to query the four different Medication workflow resources to find all information about a patient’s medications.
Resource Type | Query |
---|---|
MedicationRequest | [base]/MedicationRequest?patient=Patient/[patient id]&authoredon=ge[history date] |
MedicationDispense | [base]/MedicationDispense?patient=Patient/[patient id]&whenhandedover=ge[history date] |
MedicationAdministration | [base]/MedicationAdministration?patient=Patient/[patient id]&effective-time=ge[history date] |
MedicationStatement | [base]/MedicationStatement/patient=Patient/[patient id]&effective=ge[history date] |
To receive the problem list, the following query for conditions should be made:
[base]/Condition?patient=Patient/[patient id]&recorded-date=ge[history date]
To receive procedures for a patient, the following query for procedures should be made:
[base]/Procedure?patient=Patient/[patient id]&date=ge[history date]
To receive observation results for a patient, the following query for observations should be made:
[base]/Observation?patient=Patient/[patient id]&date=ge[history date]
The profiles that have been defined for this implementation guide are listed here. Here is the list of required sections and the profiles that have been defined for that section:
For all other sections, the IPS profiles were deemed sufficient.
EHRs will be gathering Patient consent and they will share what data they can.