Inpatient Room Change and Guardian Room Change - hmislk/hmis GitHub Wiki

Inpatient — Room Change and Guardian Room Change

Room Change moves a currently admitted patient from one room to another. Guardian Room Change does the same for a guardian/attendant accompanying the patient. Both actions close the existing room record and open a new one with accurate timestamps so that time-based charges (room rent, oxygen, etc.) are calculated correctly for each room.

Room Change

Page: Inpatient → Room → Room Change
XHTML: /inward/inward_room_change.xhtml
Controller: RoomChangeController.recreate()
Privilege: InwardRoomRoomChange

Deprecated. The page itself now shows a banner directing staff to Patient Room Details (from the Interim Bill or Admission Profile page) for room management going forward. This page is kept only as a fallback and will be removed later.

Steps

  1. Search for the patient by name, BHT number, PHN, or MRN. Filter by institution if needed. Scanning a barcode that exactly matches one PHN/BHT/MRN auto-selects that admission and advances immediately — no click needed. If the scan matches more than one admission (e.g. a patient with several active admissions), the normal dropdown appears for manual selection.
  2. If manual selection is needed, pick the patient from the auto-complete results.
  3. The current room details are shown.
  4. Select the new room from the available vacancy list.
  5. The change date/time defaults to now but can be adjusted.
  6. Click Save.

What Happens

  • The existing PatientRoom record's end time is set to the change timestamp.
  • A new PatientRoom record is created for the new room, starting at the change timestamp.
  • Timed service charges (room rent, etc.) are split at the change timestamp so each room is charged for the correct duration.
  • The Room Occupancy board updates immediately.

Guardian Room Change

Page: Inpatient → Room → Guardian Room Change
XHTML: /inward/inward_room_change_guardian.xhtml
Controller: RoomChangeController.recreate()
Privilege: InwardRoomGurdianRoomChange

Deprecated. Same banner and fallback status as Room Change above.

Follows the same process as a patient room change — including the same barcode-friendly PHN/BHT/MRN search with auto-select — but applies to the guardian's room assignment rather than the patient's. Guardian room charges are tracked separately.

A query matching more than one admission (e.g. a patient with several active admissions sharing one PHN) shows the normal dropdown for manual selection instead of auto-advancing:

Multiple matches listed for manual selection

Picking a row (or auto-advancing on an exact single match) leads to the same Patient Details / Room Details screen used to make the change:

Guardian Room Change screen after a patient is selected

Room Change from the Admission Profile

Both room change and guardian room change can also be launched directly from the Admission Profile Dashboard → Room Management panel. This pre-populates the patient so the search step is skipped.

Audit Trail

Both changes are recorded with the user's identity and the change timestamp.

Related Articles