# 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 - [Medical Specialities](Admin-Medical-Specialities) - [Creating and Managing Doctors and Consultants](Admin-Doctors-and-Consultants) - [Fees by Speciality and Staff Member](Admin-Fees-by-Speciality-and-Staff)