Admin Doctor Speciality Mapping - hmislk/hmis GitHub Wiki

Doctor-Speciality Mapping

Overview

While each doctor record can have a single primary speciality, the Doctor-Speciality Mapping system allows a consultant to be associated with multiple specialities. This is particularly important for channelling — a doctor may see patients under "Cardiology" on some days and "General Medicine" on others, and the mapping makes both available when scheduling sessions or applying fees.

When to Use

  • A consultant works across more than one speciality
  • You need to configure which specialities a doctor appears under in channelling schedules
  • Exporting a list of all doctor-speciality associations for reporting

Navigating to Doctor-Speciality Mapping

  1. Click Administration → Manage Staff
  2. In the left index, click Doctor Specialities (under the Metadata section)
  3. The Manage Doctor Speciality screen opens

Required privilege: AdminStaff

The Doctor-Speciality List

The list on the left shows all existing doctor-speciality mappings by name. Use the filter to search. Click a mapping to select it and see/edit it on the right.

Creating a Doctor-Speciality Mapping

  1. Click Add (green button)
  2. Enter the Speciality Name (this is the name of the mapping record, typically the speciality name)
  3. Enter an Income Name (optional — used for income categorisation reports)
  4. Click Save

Note: The current interface shows a name/description form for the mapping record itself. The association to a specific doctor is made through the doctor's own record or through the channelling session setup. The mapping here defines the available speciality label for a doctor.

Exporting

Click Excel to export the mapping list as a spreadsheet.

Deleting a Mapping

  1. Select the mapping in the list
  2. Click Delete (confirmation required)

Technical Notes (Admin/Developer)

Doctor-speciality mappings are stored as DoctorSpeciality entities managed by doctorSpecialityController. These differ from the Speciality entity (which is the master list) — a DoctorSpeciality is a specific named role that a doctor fulfils (combining identity + discipline for scheduling purposes). The downloadAsExcel() method generates the export via doctorSpecialityController.

Related Features