Channel Doctor Leave Management - hmislk/hmis GitHub Wiki

Doctor Leave Management

Doctor Leave Management allows administrators to record when a consultant is unavailable — blocking new bookings for the affected sessions and alerting staff at the booking screen.

Navigation

The Doctor Leave menu has two options:

Menu → Channelling → Doctor Leave → By Date Menu → Channelling → Doctor Leave → By Service Session

Requires the ChannellingDoctorLeave privilege. Individual sub-options require ChannellingDoctorLeaveByDate and ChannellingDoctorLeaveByServiceSession respectively.

By Date

Use this to record leave for a specific calendar date across all sessions on that day.

  1. Select the consultant from the Consultant / Doctor field.
  2. Enter the leave date (or date range).
  3. Optionally add a reason or note.
  4. Click Save.

All session instances for this consultant on the specified date(s) are flagged as leave. The Channel Booking screen shows a Holiday tag on those instances, warning booking staff that the doctor is unavailable.

Existing bookings in those sessions are not automatically cancelled. Staff must contact affected patients and reschedule or cancel their bookings manually.

By Service Session

Use this to record leave for a specific recurring session (e.g., only the Tuesday afternoon sessions, not all sessions on those Tuesdays).

  1. Select the consultant.
  2. Select the specific service session (e.g., "Dr. Perera Tuesday Afternoon").
  3. Enter the date or date range for which leave applies to this session.
  4. Save.

This is more precise than By Date when a consultant has multiple sessions on the same day and is only absent from one of them.

Doctor Holiday Mark (from Channel Booking View)

A faster way to mark leave for individual session instances without navigating to the Doctor Leave pages:

  1. From Channel Booking View, select the consultant.
  2. Click the Doctor Holiday button in the header (requires ChannelSessionHolidayMark privilege and the configuration option Enable mark doctor holiday from channel view).
  3. A dialog shows all session instances for this consultant.
  4. Select the instances to mark and click Mark.
  5. To remove the holiday flag, select the instances and click Unmark.

This marks instances with a yellow "Holiday" label but does not cancel them.

Effect on Bookings

Action Effect
Leave marked "Holiday" tag shown on session; new bookings should be avoided
Existing bookings Not automatically cancelled — must be handled manually
Queue / Display Session still appears but is flagged

To prevent any bookings from being made, cancel the session instance instead. See Channel Session Instances.

Removing Leave

To remove a leave record:

  • By Date / By Service Session pages: Find the leave record and delete it.
  • Doctor Holiday button: Select the marked instances and click Unmark.

Related Articles