Managing the OPD Queue - hmislk/hmis GitHub Wiki

Managing the OPD Queue

The OPD Queue screen shows the live token queue for each doctor or department, allowing clinic staff to call patients, track progress, and manage the flow of walk-in patients.

Navigation

Menu → OPD → OPD Queue

Action method: #{opdTokenController.navigateToOpdQueue()}

The OPD Queue page (/opd/token/opd_queue.xhtml) runs in a template without the standard navigation menu — it is designed to be kept open on a dedicated screen at the clinic or nurse's station.

Screen Layout

The queue screen shows the logged-in user's name and "OPD Token Management" in the header. The main area displays all tokens for the current session, grouped by status.

Token Status Views

The system provides separate views for each queue stage:

Page Path Shows
Waiting opd/token/opd_tokens_waiting.xhtml Tokens not yet called
Called opd/token/opd_tokens_called.xhtml Currently called tokens
Completed opd/token/opd_tokens_completed.xhtml Finished consultations
Manage All opd/token/maage_opd_tokens.xhtml All tokens with management controls

Queue Actions

Calling a Patient

  1. On the Waiting list, locate the next token.
  2. Click Call next to the token.
  3. The token status changes to Called.
  4. The display board (if connected) announces the number.

Marking as Completed

After the consultation:

  1. Click Complete next to the token on the Called list.
  2. The token moves to the Completed list.

Skipping / Marking Absent

If a patient does not respond:

  1. Click Skip or Mark Absent on the Called token.
  2. The patient is flagged as absent. Their token remains for reference but they are no longer in the active queue.

Recalling a Patient

A patient who was called but not yet seen can be called again — the system re-announces or re-displays their number.

Display Board

If a waiting room display board is configured, it shows the current Called token number automatically when the Call button is pressed. See Channel Display Board for the general display board concept (OPD display uses the same approach).

Queue Reset

At the end of the day or session, the queue can be reset. This clears the day's tokens from the active view and prepares for the next session. Reset is performed in OPD Token Management Admin.

Related Articles