Patient Flags - NHS England - Implementation Guide STU1
0.4.0 - ci-build

Patient Flags - NHS England - Implementation Guide STU1 - Local Development build (v0.4.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Retrieve Reasonable Adjustment Record

Overview

For high level requirements, see Key purposes of the Reasonable Adjustment Flag

Usecase

A Reasonable Adjustment Record may be retrieved if it exists. It will be possible to determine that a adjustment flags exist by searching for a Patient Flag with the code NRAF, or Programme Flags with a category of NRAF.

Patient FlagPatient or ProxyPractitionerResearchRetrieve Reasonable Adjustment recordPatientPatient AdvocateConsultinclude

System Interaction

PractitionerPractitionerFHIR APIFHIR APIPatient FlagPatient FlagAdjustment FlagAdjustment FlagConditionConditionQuery for recordsQuery for recordsQuery for recordsQuery for recordsAssemble returnsSearchSet Bundle

Queries

Using FHIR search capabilities, it is possible to retrieve the reasonable adjustment records in several ways.

This section describes how to query from the Patient endpoint using FHIR search

This will return all associated flag resources for Reasonable Adjustments.

GET /Patient?identifier=9912003888&_has:Flag:patient:code=NRAF&_has:Flag:patient:category=NRAF&_revinclude=Flag:patient&_has:Condition:patient:category=NRAF&_revinclude=Condition:patient 

This limits the search to patients thant have the identifier 9912003888

identifier=9912003888

This limits the search to patients that have Flag resources linked via patient and have the code NRAF, and also includes the resource in the returned searchset Bundle.

&_has:Flag:patient:code=NRAF&_revinclude=Flag:patient

This limits the search to patients that have Flag resources linked via patient and have the category NRAF, and also includes the resource in the returned searchset Bundle.

&_has:Flag:patient:category=NRAF&_revinclude=Flag:patient

This limits the search to patients that have Condition resources linked via patient and have the category NRAF, and also includes the resource in the returned searchset Bundle.

&_has:Condition:patient:category=NRAF&_revinclude=Condition:patient

The following queries will return all or some of the resources constituing a Reasonable Adjustments record, i.e.

This query relies on the FlagCategory and FlagCode SearchParameters.

This section describes how to query from the Flag endpoint using FHIR search

NOTE: For every additional record/resource added, the flag-detail element in the Patient Flag resource will need updated. See TODO – link to add interaction diagram.

If the flag-detail extension is used, then references to all Reasonable Adjustment resources can be included the Patient Flag resource.

This will return all associated flag resources for Reasonable Adjustments.

http://localhost:8080/fhir/Flag?patient.identifier=9912003888&_include=Flag:detail&_include=Flag:patient

This limits the search to patients thant have the identifier 9912003888

patient.identifier=9912003888=9912003888

This includes all references in the flag detail extension that have been defined in the FlagDetail SearchParameter.

&_include=Flag:detail

This includes the associated patient resource.

&_include=Flag:patient

This query relies on the FlagCategory, FlagCode and FlagDetail SearchParameters.