...
...
...
This table specifically specifies the fields relevant to Form R, Part A only
As Page Content:
Table of Contents |
---|
As_Is Form
Semi-automated form (PDF) previously used by HEEOE:
Alistair Pringle (Unlicensed)/ James Harris:
...
...
...
...
User Journey
...
Assumptions
...
Prompts should be displayed to the Trainee advising them of how to update particular fields as needed
Appropriate field assistance should be displayed
Photograph from the original form is not needed
Form can be saved and come back later to complete and submit.
Form R Part A – Guidance Text
Displayed at the top of the form
All underlined / emboldened text should be displayed
Current Guidance Text
If If this form has been pre-populated by your Deanery/HEE local team, please check all details, cross out errors and write in amendments. By signing this document you are confirming that ALL ALL details (pre-populated or entered by you) are correct.
It It remains your own responsibility to keep your Designated Body, and the GMC, informed as soon as possible of any changes to your contact details. Your Deanery/HEE local team remains your Designated Body throughout your time in training. You can update your Designated Body on your GMC Online account under “My Revalidation”.
...
Updated Guidance (to be confirmed) Alistair Pringle (Unlicensed), James Harris, Sebastian Kwok (Unlicensed)
This This form has been pre-populated using the information available against your records within the Trainee Information System (TIS). Please check all details and either amend them within the relevant system (see guidance in the form), or speak to your local office to amend them on your behalf. By singing amend where necessary. Amendments made to your details on this form will not update other systems that you may have access to. By submitting this document you are confirming that ALL DETAILS (pre-populated or entered/amended by you) are correct.
It It remains your own responsibility to keep your Designated Body and the GMC informed as soon as possible of any changes to your contact details. Your HEE Local team remains your Designated Body throughout your time in training. You can update your Designated Body on your GMC Online account under “My Revalidation”"My Revalidation".
Fields
Red text to be discussed and agreed James Harris/ Alistair Pringle (Unlicensed):
...
Reference Table
...
- Pre-populate with Forename
- can be overwritten on the Form; no propagation to other parties on submission for MVP
...
- Cannot be left empty
...
Surname
...
James Harris Alistair Pringle (Unlicensed):
- Pre-populate with Surname
- can be overwritten on the Form; no propagation to other parties on submission for MVP
...
- Cannot be left empty
...
1234567
UNKNOWN
...
- Pre-populate
- can be overwritten on the Form; no propagation to other parties on submission for MVP
...
- No validation with GMC for MVP.
...
Person Owner
...
- Pre-populate with Person Owner
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- Overwritten with Local Office Reference table CURRENT values only
...
Alistair Pringle (Unlicensed) and Ashley Ransoo Shall we populate this field form PersonOwner table? - Yes but can be overwritten.
...
- Pre-populate
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
...
- DD/MM/YYYY format
...
Male
- Pre-populate
...
Field Validation
This table specifically specifies the fields relevant to Form R, Part A only
Synchronising data to Trainee UI:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
A. Order | B. Field name | C. TIS Field to pre-populate with | D. Trainee UI Field Mapping: DB name > Collection name > Field | E. Rules for Syncing to Trainee UI non-submitted forms/copy of TIS data | F. TIS Reference Table | G. Example value | H. Type (free text, drop down, check box) & Interaction (auto-populate etc) | I. Mandatory for Submission (Y/N) ? | J. Validation / Error Messaging | K. Notes | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Form R - Part A
| ||||||||||||||||||
Section 1: DOCTOR'S DETAILS | ||||||||||||||||||
1 | Forename | ContactDetails > Forename | trainee > TraineeProfile > forenames | Match on traineeTisId | N | Jayanta |
|
Y |
| ||||||
2 | GMC-Registered Surname | ContactDetails > Surname | trainee > TraineeProfile > Surname | Match on traineeTisId | N | Saha |
option of 'I prefer not to specify' is available, so made mandatory on form.
EEA Resident?
Permit to Work?
Settled?
- Pre-populate with???
EEA Resident?
Permit to Work?
Settled?
- Can be overwritten with???
In the form R it asks for the trainee's immigration status which can be 3 options listed. In TIS there is currently 3 fields that this information resides in which are all drop downs.
James Harris, Alistair Pringle (Unlicensed)
Permit to work list seems to be broken on TIS - not pulling the Reference 'Permit to work Current values' at the moment.
EOE form R a seems to have a combined selectable list with ability to enter freetext.
Should we make the 3 fields available separately rather than 1?
- Pre-populate with the most recent Person Qualification based on 'Date attained' where there are multiples.
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- Overwritten with Qualification Reference table CURRENT values only
- Overwritten with Qualification Reference table CURRENT values only
If there are multiple qualifications, which one to display? How to extract the Primary Qualification?
24/03:
Populate with the most recent one based on Date attained where there are multiples.
:
| Y |
| Should be GMC registered surname as per guidance at top of the form | |||||||
3 | GMC Number | GMCDetails > GMC Number | trainee > TraineeProfile > gmcNumber | Match on traineeTisId | N | 1234567 UNKNOWN |
| Y |
| There will be trainees with UNKNOWN / N/A pre-populated, but may have a GMC to enter at time of Form R. Should we wish to update TIS with the date in the future, the TIS Person ID can be linked back to. |
4 | Deanery / HEE Local Office | PersonOwner > Owner |
| Match on traineeTisId
| Y - Local Office | Health Education England Wessex |
|
- Valid date only
- In preferred best UX format for Trainee UI
| Y | Alistair Pringle (Unlicensed) and Ashley Ransoo Shall we populate this field form PersonOwner table? - Yes but can be overwritten. | |||||
5 | Date of birth | personaldetails > Date of Birth | trainee > TraineeProfile > dateOfBirth | Match on traineeTisId | N | 20/03/2020 |
|
- Overwritten with Medical School Reference table CURRENT values only
Address Line 1
Address Line 2
Address Line 3
Address Line 4
Post Code
- Pre-populate
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- Exclude Line 4 in the new Address to overwrite with
- Where new address is provided to overwrite with, allow only for 3 lines and post code
Y | Calendar date picker | ||||||
6 | Gender | personaldetails > Gender |
| Match on traineeTisId
| Y - Gender | Male |
|
- Similar validations to TIS Admin to be applied for the form form validations for telephone
- Pre-populate
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- Similar validations to TIS Admin to be applied for the form form validations for telephone
- Pre-populate
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- should we display the one we are eventually going to create their account with, whatever that will be?
This allows for multiple at the moment on TIS Admin, again a left over of the merged and migrated emails from Intrepid. Consideration on which one to display and what to allow in an edit scenario.
Alistair Pringle (Unlicensed) James Harris
Which email address do we display to the trainee where there are many concatenated? Or should we display the one we are eventually going to create their account with, whatever that will be?
Selection
Choose one between 15A - 15F
Selection
Choose one between 15A - 15F
Selection
Choose one between 15A - 15F
Selection
Choose one between 15A - 15F
Selection
Choose one between 15A - 15F
Curriculum specialty from Programme membership
James Harris/ Alistair Pringle (Unlicensed):
Pre-populate with the most recent Curriculum specialty attached to the Most recent Programme membership based on Future 'Programme start date' ?
| Y | Overwritten with Gender Reference table CURRENT values only | Alistair Pringle (Unlicensed), James Harris option of 'I prefer not to specify' is available, so made mandatory on form. | |||||||
7 | Immigration Status | N/A |
| N/A P.S: Observed that trainee UI has got an outdated list. The correct list should be the current values from TIS Rerefence > permitToWork list with the option of Other.
| Y |
| Y | |||
Immigration Status (Other) | N/A | N/A | N/A | N | ||||||
8 | Primary Qualification | Qualification > Qualification | trainee > TraineeProfile>qualification | Match on traineeTisId
|
Quality of Qualification reference data is poor, so freetext. |
| Y |
| If there are multiple qualifications, which one to display? How to extract the Primary Qualification? 24/03: Populate with the most recent one based on Date attained where there are multiples. | |
9 | Date Awarded | Qualification tab > Qualification> Date Attained | trainee > TraineeProfile > dateAttained | Match on traineeTisId
|
|
- Specialty list?
- Or Curriculum name from Curriculum table?
There is no Programme specialty field so we could either use 'Programme name' or the main 'Curriculum Specialty'
If there are multiple current programme membership, how do we decide which one to choose? Alistair Pringle (Unlicensed) and Ashley Ransoo
James Harris/ Alistair Pringle (Unlicensed):
- Pre-populate with the most recent Curriculum specialty attached to the Most recent Programme membership based on Future 'Programme start date' ?
Y |
| ||||||
10 | Medical School Awarding Primary Qualification (name and country) | Qualification tab > Qualification> Medical School | trainee > TraineeProfile > medicalSchool | Match on traineeTisId
| N |
|
- Specialty list?
- Or Curriculum name from Curriculum table?
James Harris/ Alistair Pringle (Unlicensed):
- Given the above field 'Progamme specialty' will be populated with most recent start date (possibly?) at time of filling form, should we be having additionally specialty 1 field also as a a duplicate field?
- Pre-populate if 15A is selected ?
- Pre-populate with the next most recent Curriculum specialty attached to the Most recent Programme membership based on Future 'Programme start date' ?
- Can be overwritten on the Form; no propagation to other parties on submission for MVP
- Overwritten with only CURRENT value from
- Specialty list?
- Or Curriculum name from Curriculum table?
- Cannot pre-populate as we do not maintain this field in TIS admins UI
- Editable dropdown populated with CURRENT values from College Reference table
Programme End Date from Programme membership
Programme end date for the Curriculum displayed in #16, i.e. attached to the Programme Membership. (see screenshot)?
James Harris/ Alistair Pringle (Unlicensed)
Pre-popuate with the Programme end date for the Curriculum displayed in #16, i.e. attached to the Programme Membership. (see screenshot)
| Y |
| ||||||||
11 | Home address | ContactDetails > address1 address2 address3 address4 postCode | trainee > TraineeProfile > address1, address2, address3, address4, postCode | Match on traineeTisId
|
| Y |
| Line 4 is a left over from Intrepid, if made editable, then the user should be allowed to update the whole address as an object and without a Line 4. | ||
12 | Contact Telephone | ContactDetails > telephoneNumber | trainee > TraineeProfile > telephoneNumber | Match on traineeTisId
|
|
- Date format with the best UX format.
- Valid dates only
Pre-populate
Read-only
Pre-populate
Read-only
Pre-populate
Read-only
Smart Search; FTSTA / LAT / MILITARY / SUBSTANTIVE (default) / VISITOR
Pre-populate
Read-only
Populate with Trainee name
- on submission
Hidden from trainee until post submission
NTN viewable once created
No view/editing for Trainee unless submitted (in Historical view)
Free Text for Admin
No editing for Trainee
No view/editing for Trainee unless submitted
Free text for Admin
| Y |
| ||||||||
13 | Contact Mobile | Mobile Number | trainee > TraineeProfile > mobileNumber | Match on traineeTisId
|
| Y |
| |||
14 | Email Address | N/A | N/A | N/A |
| Y | ||||
Section 2: DECLARATIONS | ||||||||||
15A | I confirm I have been appointed to a programme leading to award of CCT | N/A | N/A |
Pre-populate
- Today's Date
- On submission
Alistair Pringle (Unlicensed) and Ashley Ransoo Which date to be recorded? Do we need to override the submission date or go for new field called modified date?
23/03: Yes
N/A | N/A | Selection Choose one between 15A - 15F | N |
| ||||||
15C | I confirm that I will be seeking specialist registration by application for a CESR CP | N/A | N/A | N/A | N/A | Selection Choose one between 15A - 15F | N |
| ||
15D | I confirm that I will be seeking specialist registration by application for a CEGPR | N/A | N/A | N/A | N/A | Selection Choose one between 15A - 15F | N |
| ||
15E | I confirm that I will be seeking specialist registration by application for a CEGPR CP | N/A | N/A | N/A | N/A | Selection Choose one between 15A - 15F | N |
| ||
15F | I confirm that I am a core trainee, not yet eligible for CCT | N/A | N/A | N/A | N/A | Selection Choose one between 15A - 15F | N |
| ||
16 | Programme Specialty | Curriculum specialty from Programme membership | trainee > TraineeProfile > programmeMemberships > curricula > curriculumName | changes:
If a new programme membership is added to trainee, sync it to Trainee UI. If a new Curriculum membership is added to trainee, sync it to Trainee UI. If a field within an existing programme membership or curriculum membership for the trainee is updated, then re-sync all Prog/Curr mems.
| James Harris/ Alistair Pringle (Unlicensed):
Note: Curriculumid in ProgrammeMembership linked to Curriculum table to extract the curriculum sub type info
| Y | ||||
17 | Specialty 1 for Award of CCT | same as #16 | same as #16 | same as #16 |
| Conditionally mandatory | ||||
18 | Specialty 2 for Award of CCT | same as #16 | same as #16 | same as #16 |
| N | ||||
19 | Royal College / Faculty Assessing Training for the Award of CCT | N/A | reference > College |
| Y - College Reference table | Joint Royal College of Physicians Training Board |
| Y | ||
20 | Anticipated Completion Date of Current Programme (if known) | TIS_Interim > VwProgrammemembership >Programmecurriculumcompletiondate | trainee > TraineeProfile > programmeMemberships > programmeCompletionDate |
| TIS_Interim: TIS_NDW_ETL: | James Harris/ Alistair Pringle (Unlicensed)
| Y |
| ||
SECTION 3: PROGRAMME | ||||||||||
21 | Training grade | N/A | reference > Grade | Training grade reference in Trainee UI to be synch'ed from TIS when:
| Y |
| Y | |||
22 | Start date | Programme Start date | see #16 | see #16 | N |
| Y |
| ||
23 | Post type or appointment | Programme membership type | see #16 | see #16 for prepoluation Post type reference in Trainee UI to be synch'ed from TIS when:
| Y |
| Y | |||
24 | Full Time or % of Full Time Training | WTE | N/A | N/A | N |
| Y | |||
Section 4: SIGNATURE | ||||||||||
25 | Trainee Signature | N/A | N/A | N/A | N/A |
| ||||
26 | Date | N/A | N/A | N/A | N/A | Pre-populate
| Alistair Pringle (Unlicensed) and Ashley Ransoo Which date to be recorded? Do we need to override the submission date or go for new field called modified date? 23/03: Yes | |||
Section 5: HEE ONLY - 24/03: Not to Display on the Form on Trainee UI but available to Admins. | ||||||||||
27 | National Training Number / Deanery Reference Number | N/A | N/A | Hidden from trainee until post submission NTN viewable once created No view/editing for Trainee unless submitted (in Historical view) Free Text for Admin | ||||||
28 | GMC Programme Approval Number | N/A | N/A | No editing for Trainee No view/editing for Trainee unless submitted Free text for Admin |
Note (January 2024):
The validation rules for Form R Part A as implemented can be viewed most easily in the publicly accessible GitHub code repositories. These include the rules listed above, with further constraints to require reasonable string lengths and dates not in the far future/distant past, as well as any other slight adjustments that have been defined over time.
Back-end validation of final submitted Form R Part A: https://github.com/Health-Education-England/tis-trainee-forms/blob/main/src/main/java/uk/nhs/hee/tis/trainee/forms/dto/FormRPartADto.java
Front-end validation of Form R Part A (applied during the process of filling them out): https://github.com/Health-Education-England/tis-trainee-ui/blob/main/components/forms/form-builder/form-r/part-a/formAValidationSchema.ts