Inpatient Room Occupancy and Vacancy - hmislk/hmis GitHub Wiki
Inpatient — Room Occupancy and Vacancy
Two related pages that give you the ward-clerk view of which beds are taken and which are free.
| Page | URL | Menu |
|---|---|---|
| Room Occupancy | /inward/inward_room_occupancy.xhtml |
Inpatient → Room → Room Occupancy |
| Room Vacancy | /inward/inward_room_vacant.xhtml |
Inpatient → Room → Room Vacancy |
Both are under privilege InwardRoomRoomOccupency (Room Occupancy specifically gates discharge from this page with InwardRoomDischarge).
Note — this is a paginated table view, not a real-time color-coded bed-map / floor plan. A live ward board with color-coded statuses and reservation overlap detection is not currently available. The closest real-time-style view is the Nursing Workbench tabs for Rooms / BHTs.
Room Occupancy
Shows every PatientRoom row — i.e., every room currently assigned to an admission. The table loads on demand; press Fill to load only your department's rooms, or Fill All to load every room in the institution.
Columns
| Column | What it shows |
|---|---|
| Room No | Room name. A green ✓ icon means the BHT in this row has been discharged from this room; a red ✕ means still occupied. Discharged rows are coloured discharged-color. |
| BHT No | Clickable link to the Inpatient Dashboard for that BHT. |
| Patient | Patient name. |
| Guardian | Guardian name + phone. |
| Credit Company | Insurer linked to the admission (if any). |
| Payment Method | Cash / Card / Credit Company / etc. |
| Action | Discharge from Room if not discharged; Cancel Discharge from Room if discharged in error. Only rendered to users with InwardRoomDischarge. |
Use case patterns
- Daily ward round — Fill, scan for ✕ rows, click the BHT to open the dashboard.
- Pre-cleaning a room — find the row by patient name, press Discharge from Room once the patient has actually left. This sets
PatientRoom.discharged = trueso the bed becomes available to other admissions. - Undo a wrong discharge — Cancel Discharge from Room flips
dischargedback to false, re-opening the room to this admission. Important when the room has not yet been reassigned. See #20183 for a historical issue wheredischarged=0left rooms looking occupied.
Room Vacancy
Shows every RoomFacilityCharge (i.e., every room that exists in the master data with at least one fee plan), not just occupied ones. Useful when you want to see what's available before admitting.
Columns
| Column | What it shows |
|---|---|
| Room | Room name. |
| Category | Room category (Private, Semi-private, General Ward, etc.). |
| Department | The department this room belongs to. |
| Room Charges for 24 | Room charge × 8 — a quick approximation of a 24-hour room rate (the underlying timed charge is per 3 hours; 8 × 3-hour blocks = 24 hours). |
The 24-hour figure here is room charge only — it does not include linen, MO, nursing, administration, or medical care charges that may also apply for the same 24 hours. See Admin — Room Categories, Rooms and Fees for the full fee structure.
Press Fill to load the table.
Releasing a room from elsewhere
In addition to Discharge from Room on this page, a room is automatically released when:
- The admission is discharged through Room Discharge.
- The admission is cancelled through Cancel Admission.
- A Room Change closes the old
PatientRoomand opens a new one. - A Patient Transfer is accepted by the receiving department.