Student Training Information¶
Applies to: roles with Students.View (view), Students.Create / Students.Edit (capture and change). Last reviewed: 2026-11-18.
This page describes the training-related information DriveFlow holds on a student: branch, licence code, package and instructor; learner's licence and PDP details; driving assessments; and the licensing record. It also explains how the learner's licence affects lesson and test booking.
1. Summary of what is held¶
| Information | Captured where | Can be changed where | Shown where |
|---|---|---|---|
| Branch | Registration | Not on the web | Profile header, Overview, Student Directory |
| Licence code | Registration; Start New Course | By starting a new course | Overview, Student Directory |
| Training package | Registration; Start New Course | By starting a new course | Profile header chip, Overview |
| Assigned instructor | Registration (optional) | Not on the web | Not shown (see section 2) |
| Has learner's licence, number, expiry | Registration; set automatically by a learner's test result | Edit | Edit page only; "Learner's Licence" requirement in Course Details |
| Has PDP, number, expiry | Registration | Edit | Edit page only |
| Driving assessments | Record Assessment | Cannot be edited after saving | Assessments tab |
| Licensing record (date, notes) | License Student | Cannot be edited after saving | Not shown; the status becomes Licensed |
| Training completed date | Set automatically | - | Not shown; drives lesson booking rules |
2. Branch, licence code, package and instructor¶
These four are chosen in the Training Information panel when the student is registered; see Student registration.
- Branch. A student belongs to exactly one branch. Lessons, tests, invoices and number sequences use it. There is no screen to move a student to another branch. (The server supports a move and refuses it while the student has open lessons, with the message "This student has N scheduled lesson(s) at their current branch. Complete, cancel or move them before changing the student's branch." - but no web page sends a branch change.)
- Licence code and training package. The student record always points at their current package and licence code. Both are replaced when a new course is started; see Student enrolment. A licence code is optional only when the package is an Assessment package.
- Assigned instructor. Optional. Must be an active instructor at the student's branch. After registration it is not displayed on the profile and cannot be changed on the web. The Instructor row on the Overview tab shows the instructor of the student's next booked lesson instead. The assigned instructor does not restrict who can teach the student's lessons; the instructor is chosen per lesson (see Instructor assignment).
3. Learner's licence and PDP¶
3.1 The fields¶
| Field | Meaning |
|---|---|
| Has Learners Licence | The student holds a learner's licence. |
| Learners Licence Number | The licence number (optional). |
| Learners Licence Expiry | The expiry date (optional, but see below). |
| Has PDP | The student holds a Professional Driving Permit. |
| PDP Number | The permit number (optional). |
| PDP Expiry | The permit expiry date (optional). |
The number and expiry fields are greyed out until the matching tick box is ticked.
3.2 Capturing and changing¶
- At registration: in the Personal Information panel.
- Later: actions menu > Edit > Personal Information > Update Student (needs Students.Edit). These fields are saved by the edit page.
- Automatically: when a learner's test result is recorded for the student, Has Learners Licence is set to ticked if the result is Passed and unticked otherwise. The number and expiry are not filled in by the test result; add them through Edit. (Recording test results is covered in Test results.)
3.3 What the learner's licence controls¶
The learner's licence rule
A lesson can only be booked for a student who has a valid learner's licence on the lesson date, or who has a learner's test booked on or before the lesson date. The details follow.
Lesson booking. A lesson may only be booked when one of these is true:
- The student has a learner's licence that is valid on the lesson date. A licence with no expiry date recorded counts as valid; a licence whose expiry date is before the lesson date does not.
- The student has a learner's test booked, and the lesson is on or after the test date. This allows a student on a "learner's + lessons" package to book lessons that fall after their learner's test.
Otherwise the booking is refused with one of:
- "This student does not have a learner's licence yet. Book their learner's test first; lessons can then be scheduled from the test date."
- "Lessons can only be scheduled on or after the student's learner's test on (date)."
Test booking.
- A learner's test cannot be booked for a student who already has a learner's licence: "Student already has a learner's licence and cannot book another learner's test."
- A driving licence test needs a learner's licence: "Student must have a learner's licence to book a driving test."
Status. A valid learner's licence (ticked, with an expiry date of today or later) sets the status to Learners Passed at registration and whenever the student is edited. See Student status management.
Course requirements. The Course Details box shows "Learner's Licence: Completed / Pending" from the Has Learners Licence tick.
3.4 What the PDP fields control¶
Nothing. The PDP tick, number and expiry are stored for the school's records. No booking rule, status rule or reminder reads them. In particular, a licence code flagged in the system as requiring a PDP does not check the student's PDP.
3.5 Expiry dates¶
Note
There are no expiry reminders or alerts for a student's learner's licence or PDP. The expiry date is only compared with lesson dates (learner's licence) at the moment a lesson is booked.
4. Assessments¶
An assessment records an instructor's or assessor's view of a student's driving ability, usually before training starts. It is optional.
4.1 Who and where¶
- View: profile > Assessments tab (Students.View).
- Record: Record Assessment on that tab, or the student's actions menu > Record Assessment (Students.Edit).
Screenshot to be added
Screen: Student Profile, Assessments tab. Should show: the Assessment History table with one assessment and the "Record Assessment" button.
4.2 Recording an assessment¶
- Click Record Assessment. The box is headed Initial Driving Assessment with an Optional chip.
-
Complete the sections. No field is compulsory.
Previous Driving Experience
Field Options / meaning Starts on Driving Experience No previous experience, Beginner, Some experience, Experienced driver No previous experience Estimated Previous Driving Hours A whole number, 0 or more Empty Current Skill Level
Field Options Starts on Overall Skill Level Not yet assessed, Beginner, Basic, Intermediate, Advanced Not yet assessed Confidence Level Low, Medium, High Low Practical Assessment (tick boxes, all start unticked)
- Can start and stop the vehicle
- Can control steering
- Can use gears correctly
- Uses mirrors correctly
- Can move off safely
- Can stop safely
- Can change lanes
- Can reverse
Assessment Result
Field Options Starts on Assessment Result Not assessed, Requires training, Basic competency, Competent Not assessed Recommended Training Level Full training, Refresher training, Test preparation, Advanced training Full training Text and billing
Field Meaning Assessment Notes Observations, strengths, weaknesses and areas requiring improvement. Training Recommendation The recommended training approach. Additional Invoice Amount An amount in rand to bill the student for the assessment. Leave empty or 0 for no charge. Cannot be negative. -
Click Save Assessment. Skip closes the box without saving.
4.3 What happens when you save¶
- The assessment is saved with today's date and the type "Initial".
- If Additional Invoice Amount is more than 0, an invoice is created for that amount in the same step: one line described "Driving assessment (Initial) - (date)", due in 15 days, and it is emailed to the student. If the invoice cannot be created, the assessment is not saved either.
Messages:
| Message | Meaning |
|---|---|
| Assessment recorded successfully. | Saved, no invoice. |
| Assessment recorded. Invoice (number) created and emailed to the student. | Saved, invoice created and emailed. |
| Assessment recorded. Invoice (number) created; it could not be emailed. | Saved and invoiced, but the email failed. Send the invoice from the invoicing pages. |
| The additional invoice amount cannot be negative. | Enter 0 or more. |
| Unable to record assessment. | Refused without a specific reason. |
Recording an assessment does not change the student's status, package or lesson allowance. The "Recommended Training Level" is information only.
4.4 Assessment History¶
Columns: Date, Type, Skill Level, Confidence, Result (coloured chip), Recommended Training, Invoice (invoice number and amount, or "—"), and a PDF button.
Click the PDF icon (Download report) to download the assessment as a PDF named Assessment-yyyyMMdd.pdf. If it cannot be produced you see "Unable to generate the assessment report."
If there are none: "No assessments recorded for this student."
4.5 Assessment packages¶
A training package can have the type Assessment. Such a package is not tied to a licence code and can have 0 lessons, so a person can be registered just for an assessment. See Training packages. Registering on an Assessment package does not itself create an assessment record; use Record Assessment.
5. The licensing record¶
When a student is licensed (actions menu > License Student), DriveFlow stores a licensing record with the Graduation Date and Graduation Notes and sets the status to Licensed. The steps and rules are in Student status management.
The record itself (date and notes) is not displayed anywhere after saving. It does not store the driving licence number, issue date or expiry date: there are no fields for the student's actual driving licence. A scan can be kept under Student documents with the type Driving Licence.
6. Test information¶
Learner's tests and driving licence tests are separate records (date, time, centre, examiner, booking reference, result), listed on the profile's Driving Tests tab. They are documented in the driving tests documentation. On the student record itself, a test only leaves two traces: the student's status and, for a learner's test, the Has Learners Licence tick.
7. Limitations and notes¶
- Learner's licence and PDP details are not visible on the profile. Open Edit to see them.
- PDP fields have no effect on any rule.
- No expiry reminders for the learner's licence or PDP.
- Editing a student with a valid learner's licence resets the status to Learners Passed (see Student status management).
- A learner's licence with no expiry date counts as valid for booking lessons but does not give the Learners Passed status at registration. Enter the expiry date.
- A failed learner's test unticks Has Learners Licence, even if it was ticked by hand before.
- Assessments cannot be edited or deleted, and the assessment date, type and assessing instructor cannot be chosen on screen (the date is always "now", the type always "Initial", no instructor is recorded).
- Assigned instructor and branch cannot be changed on the web, and the assigned instructor is not displayed.
- No driving licence fields. The licence number and dates of the licence the student finally obtains are not stored.
- The licensing record is not displayed after it is saved, and "completed by" is not recorded.
Related articles¶
- Student registration - where training information is first captured.
- Student profiles - the profile tabs and the edit page.
- Student status management - how the learner's licence and tests change the status.
- Courses - the student's courses and course requirements.
- Package allocation - the lesson allowance.
- Test booking - booking learner's and driving licence tests.