Managing Clinic Sessions - hmislk/hmis GitHub Wiki
Managing Clinic Sessions
This article explains how to create, edit, and manage clinic session instances — the individual scheduled occurrences of a clinic.
Navigation
Menu → Channelling → Clinic Sessions
Path: /clinic/sessions.xhtml
Requires the ClinicSession privilege.
Screen Layout
The Clinic Sessions screen closely mirrors the Channel Booking — By Dates layout:
- Date Range — From / To date pickers with quick buttons: Today, +1, +2, +7, +1 Month
- Search Filter — Type to filter sessions by clinic name or date
- Session Cards — Each session instance displayed as a card
Date Navigation
| Button | Action |
|---|---|
| Today | Set range to today |
| +1 | Add one day to the To date |
| +2 | Add two days |
| +7 | Add seven days |
| +1 Month | Add one month |
Session Instance Cards
Each clinic session card shows:
- Clinic/session name
- Date and start time
- Status (Scheduled / On Going / Completed / Cancelled)
- Patient counts (booked / seen)
- View button to open the session's appointment and queue management
Creating a Clinic Session
- Click Add or New Session on the sessions screen.
- Fill in:
| Field | Description |
|---|---|
| Clinic Name | Name of the clinic (e.g., Diabetic Clinic) |
| Session Date | Date of this occurrence |
| Start Time | Session start time |
| End Time | Approximate end time |
| Max Patients | Maximum number of appointments |
| Location / Room | Room or clinic area |
| Notes | Any special instructions |
- Click Save.
Editing a Clinic Session
- Click View on the session card, then use the Edit control.
- Modify the date, time, max patients, or other details.
- Save.
Cancelling a Clinic Session
- Open the session via the View button.
- Click Cancel Session.
- Confirm. Existing appointments must be managed (rescheduled or notified) manually.
Recurring Clinic Schedules
To set up a recurring clinic (e.g., every Wednesday), use the Clinic Schedule (/clinic/schedule.xhtml). Define the schedule once and generate instances for the required date range. See Clinic Schedule and Queue.