OPD Token Management Admin - hmislk/hmis GitHub Wiki
OPD Token Management (Admin)
The Token Management admin screen allows authorised users to manage the OPD token system configuration — including queue reset, token sequence control, and session setup.
Navigation
Menu → OPD → Token Management
Action method: #{tokenController.navigateToTokenIndex()}
Requires the PharmacyTokenManagement privilege.
Also accessible from some configurations via:
Menu → OPD → Billing section → Token Management
Functions
Queue Reset
At the end of each day or session, reset the token queue so numbering restarts for the next period:
- Open Token Management.
- Select the doctor / department whose queue is to be reset.
- Click Reset Queue or Reset Tokens.
- Confirm the reset.
All tokens for that queue are cleared from the active view. Past tokens are retained in the database for records.
Token Sequence Configuration
Configure how tokens are numbered:
| Setting | Description |
|---|---|
| Starting Number | Token number to begin from (default: 1) |
| Reset Frequency | Daily (resets at midnight) or Session-based (resets when a new session is started) |
| Prefix | Optional letter prefix (e.g., "A001", "B001" for different queues) |
Managing Multiple Queues
If the OPD has multiple doctors or departments running simultaneously (each with their own queue), each queue is managed independently. Create and configure a separate token stream for each:
- Select the doctor / department.
- Set the token numbering parameters.
- Save.
Viewing All Tokens
The Token Management index shows a summary of all active queues:
| Column | Content |
|---|---|
| Doctor / Department | Queue owner |
| Current Token | Last token issued |
| Waiting | Count of tokens in waiting state |
| Called | Count of currently called tokens |
| Completed | Count of completed consultations |
Manual Token Adjustment
If a token was issued incorrectly (wrong doctor, duplicate, etc.), administrators can void or delete individual token records from this screen.