TABLE 4.

Contextual information for hook ‘copd‐careplan’.

Field	Optionality	Description
encounterId	REQUIRED	FHIR encounter.id of the current CDS process
patientId	REQUIRED	FHIR patient.id of the current patient
birthDate	REQUIRED	Date of birth of the current patient. Supports decision on suggesting administering pneumococcal immunization to patients over 64 years of age
smokingStatus	REQUIRED	FHIR observation instance representing, via a SNOMED CT term, the patient as either a regular smoker or not.
co‐morbidities	OPTIONAL	FHIR bundle of condition instances representing, via SNOMED CT terms, active diagnoses in the record of the current patient.
immunizationStatus	REQUIRED	FHIR bundle of immunization instances denoting, via SNOMED CT terms, whether the patient has completed the annual influenza vaccine, or the pneumococcal vaccine.
copdAssessment	REQUIRED	FHIR bundle of observation instance and Medication bundle. The former represents, in SNOMED CT, the user‐selected COPD group. The latter represents, using internal Ids, the user‐selected COPD drug types requested for CDS.
cdsSuggestedTreatments	OPTIONAL	FHIR bundle of medication instances suggested by the COPD‐CDS system as a response to hook ‘copd‐assess’ for the current patient. The bundle is aggregated to the conflict resolution input document to provide alternatives to user‐selected COPD drug types when resolving potential conflicts among recommendations.

Note: This CDS service collects patient data from the EHR to propose one or more personalized COPD treatment management care plans.