Skip to content

Scheduling a test: changing, moving and cancelling

Applies to: Owner, Administrator, Manager, Receptionist, Instructor. Last reviewed: 2026-11-18.

Once a test is booked you can change its details, move it to another time, or cancel it. This page covers all three, and how tests relate to the lesson diary.

Test statuses

Status Meaning Set by
Booked The test is booked and has not happened yet. Booking
Completed A result (Passed or Failed) has been recorded. Recording the result
Cancelled The test was cancelled. Cancelling
Passed Defined in the system but never set. The pass or fail is stored as the test's Result, with status Completed. -
Failed Defined in the system but never set. -

Allowed changes:

stateDiagram-v2
    [*] --> Booked: Book test
    Booked --> Completed: Record result (Result - Passed or Failed)
    Booked --> Cancelled: Cancel

Note

A Completed or Cancelled test cannot be changed, moved or reopened.

Who can do what

Action Menu item shown to Server needs Default roles that can do it on the web
View DrivingTests.View DrivingTests.View All staff roles
Edit DrivingTests.Edit DrivingTests.Edit Owner, Administrator, Manager, Receptionist, Instructor
Move on the calendar DrivingTests.Edit DrivingTests.Edit same
Record Result DrivingTests.Edit DrivingTests.Edit same
Cancel DrivingTests.Delete DrivingTests.Edit Owner, Administrator

Important

Cancel is only shown to users with DrivingTests.Delete, which by default only the Owner and Administrator hold. Managers and Receptionists do not see it.

All actions are in the row menu (three dots) on the Driving Tests page and on the student's Driving Tests tab.

Changing a test's details

Available while the test is Booked.

  1. Open the row menu and click Edit. The Edit Driving Test dialog opens.
  2. Change any of the fields below.
  3. Save. Message: "Driving test updated successfully."
Field Can be changed Notes
Student No Shown for information.
Test Type No "The test type can't be changed once booked."
Test Date Yes Required. "Please select a test date."
Test Time Yes Required. "Please select a test time."
Testing Centre Yes Required.
Instructor Yes Driving licence test only. Required.
Vehicle Yes Driving licence test only. Required.
Examiner Yes Up to 200 characters.
Booking Reference Yes Up to 100 characters.
Notes Yes Up to 1000 characters.

Rules and messages

Rule Message
Only a Booked test can be edited "Only scheduled driving tests can be updated."
Driving licence test needs an instructor "Instructor is required for a driving licence test."
Driving licence test needs a vehicle "Vehicle is required for a driving licence test."
A newly chosen instructor must be active "Instructor is not active."
A newly chosen instructor must work at the test's branch "This instructor works at a different branch from the test."
Vehicle must be active "Vehicle is not active."
A newly chosen vehicle must be usable at the test's branch "This vehicle is not available at the test's branch."
Test not found "Driving test not found."

A test keeps the instructor and vehicle it already has even if they have since become inactive or moved branch; the checks apply only when you pick a different one. For a learner's test, any instructor or vehicle is removed on save.

Warning

Editing does not check for clashes with lessons or other tests, and does not check that the new date is in the future.

Moving a test on the calendar

  1. Open Calendar in Week or Day view.
  2. Drag the green driving test tile to the new time and drop it.
  3. A Reschedule Driving Test confirmation appears, warning that the new slot will be checked before the test is moved. Click Reschedule Test, or Cancel.
  4. On success: "Driving test rescheduled successfully."

Screenshot to be added

Screen: Calendar page. Should show: a driving test tile being moved and the Reschedule Driving Test confirmation.

Needs DrivingTests.Edit. Only the date and time change; the instructor, vehicle and testing centre stay the same. Dropping the test in another instructor's column in Day view does not change the instructor.

What is checked

The test is treated as lasting one hour from its start time.

Rule Message
Only a Booked test can be moved "Only booked driving tests can be rescheduled."
Not into the past "A driving test cannot be rescheduled to a time in the past."
The instructor has no lesson (other than a cancelled one) overlapping that hour "The instructor is already booked during this time."
The instructor has no other Booked test overlapping that hour "The instructor already has another driving test during this time."
The vehicle has no lesson (other than a cancelled one) overlapping that hour "The vehicle is already booked during this time."
The vehicle has no other Booked test overlapping that hour "The vehicle already has another driving test during this time."
Test not found "Driving test could not be found."

Branch working hours, slot boundaries and the booking window do not apply to tests; a test can be at any time of day. A learner's test has no instructor or vehicle, so only the first two rules apply to it.

If the student had already been reminded of the test, they are reminded again for the new time.

Cancelling a test

Available while the test is Booked, to users with DrivingTests.Delete.

  1. Open the row menu and click Cancel (in red).
  2. Confirm in the Cancel Driving Test dialog by clicking Cancel Driving Test.
  3. Message: "Driving test cancelled."

What happens:

  • The status becomes Cancelled. The test stays in the list and on the calendar.
  • If the student's status is Test Booked, it goes back to Ready For Test. Otherwise the student's status is left as it is.
  • The student can now be booked for another test.
Rule Message
A test with a result cannot be cancelled "Completed driving tests cannot be cancelled."
Already cancelled "Driving test is already cancelled."

Cancelling a test does not cancel any lessons and sends no notification.

Tests and the lesson diary

Tests and lessons are kept separately, and they only partly know about each other.

Situation Is a clash detected?
Booking a lesson for an instructor or vehicle that has a test at that time No
Booking a test for an instructor or vehicle that has a lesson at that time No
Editing a test's date, time, instructor or vehicle in the Edit dialog No
Dragging a test on the calendar onto a lesson or another test Yes
Booking a lesson for a student at the time of their own test No

Use the calendar to check

Before booking a driving licence test, look at the instructor's and vehicle's day in the Calendar (Day view) and move any lessons that overlap. See Lesson rescheduling.

Where tests appear

  • Driving Tests page - the full list.
  • Student profile, Driving Tests tab.
  • Calendar - green tiles titled Driving Test {number}, one hour long, with the testing centre. Use the Driving Tests option in the event list to show only tests.
  • Vehicle Calendar - tests using that vehicle.
  • Student portal and mobile apps - the student's upcoming test.

An instructor who only manages their own lessons sees, on the Calendar, only the tests where they are the instructor.

Limitations and notes

  • Cancel shows an internal identifier. The confirmation reads "Cancel driving test {id}?" where the id is a long system code rather than the test number.
  • No reason can be entered when cancelling from the web application, although the system can store one in the test's notes.
  • The Cancel menu item and the server use different permissions (DrivingTests.Delete to see it, DrivingTests.Edit to perform it). A Manager cannot cancel a test on the web with the default roles.
  • Cancelling rarely changes the student's status. Booking a driving licence test sets the student to Ready For Test, not Test Booked, so the "back to Ready For Test" step usually has nothing to do. A student moved to Learners Pending by a learner's test booking stays Learners Pending after the test is cancelled.
  • Month view on the calendar moves a test to midnight. Dropping a test on a day in Month view sets its time to 00:00. Use Week or Day view.
  • Lesson and test diaries are not cross-checked except when dragging a test, as described above.
  • No notification is sent when a test is edited, moved or cancelled, apart from the repeated reminder after a move.
  • Tests have no duration. One hour is assumed for the calendar and for clash checks.