Inpatient EHR Clinical Discharge - hmislk/hmis GitHub Wiki
Inpatient EHR — Clinical Discharge
Clinical discharge is the doctor's formal decision that the patient is medically fit to leave. It is a separate step from room discharge (which is performed by nursing/ward staff) and must be recorded before the room discharge can proceed.
Page: Admission Profile → Clinical Data → Clinical Discharge
XHTML: /inward/inward_clinical_discharge.xhtml
Controller: InpatientClinicalDataController.navigateToClinicalDischargeFromAdmission()
Privilege: InpatientClinicalDischarge
Fields on PatientEncounter: clinicallyDischarged (boolean), clinicalDischargedBy (Person), clinicalDischargeDateTime (Date)
Access Control
The Clinical Discharge page is only accessible to users holding the InpatientClinicalDischarge privilege. If this privilege is absent, the page shows an access-denied message instead of the form.
On the Admission Profile Dashboard, the Clinical Discharge button colour indicates status:
- Amber — not yet clinically discharged
- Green — clinical discharge recorded
Status Banner
If the patient has already been clinically discharged, a green success banner is shown at the top of the page:
Clinically discharged by [Doctor Name] on [Date/Time]
All form fields are disabled — the record cannot be changed once saved.
Clinical Discharge Form
| Field | Notes |
|---|---|
| Discharge Condition | Auto-complete from configured discharge conditions (see Admin — Inpatient EHR Discharge Conditions). Examples: Improved, Cured, LAMA (Left Against Medical Advice), Referred, Expired |
| Discharge Date/Time | Defaults to the current date/time; can be adjusted |
| Discharge Diagnoses | Structured diagnoses (auto-complete from the diagnosis master). Multiple diagnoses can be added. |
| Clinical Notes / Comments | Free-text discharge narrative |
Discharge Diagnoses cannot be added until the record has been saved once (the Add button is disabled before first save).
Saving Clinical Discharge
Click Save Clinical Discharge (or equivalent). On success:
patientEncounter.clinicallyDischarged = truepatientEncounter.clinicalDischargedBy = current userpatientEncounter.clinicalDischargeDateTime = selected date/time
The Admission Profile Dashboard button turns green.
Discharge Medications Link
From the Clinical Discharge page, the Discharge Medications button navigates to the discharge medications page so that take-home prescriptions can be added in the same workflow. This button is disabled until the clinical discharge record has been saved.
Related Articles
- Inpatient EHR — Discharge Medications — take-home prescriptions
- Inpatient — Room Discharge — room discharge follows clinical discharge
- Admin — Inpatient EHR Discharge Conditions — configure discharge condition values
- Admin — Inpatient Privileges and Access —
InpatientClinicalDischargeprivilege - Inpatient Admission Profile (Dashboard) — status indicator button