Trainee UI - Field Validation | Form R (Part B)

Page content:

As Is Form


User Journey

 

Assumptions

  • Specified fields should also be editable, should the Trainee need to make changes to what is held in the system - these are currently captured on the 

  • Appropriate field assistance should be displayed

  • Trainee photograph from the original form is not needed - there is no photo

  • All help text should be displayed as is contained within the form

  • This is only displayed to medical trainees



Guidance Text

Guidance for applicants on how to complete:

https://heeoe.hee.nhs.uk/sites/default/files/form_r_guidance_-_april_2017_version_4.pdf

Field validation

This table specifically specifies the fields relevant to Form R, Part B only

Synchronising data to Trainee UI:

https://hee-tis.atlassian.net/browse/TISNEW-5154

https://hee-tis.atlassian.net/browse/TISNEW-5238

https://hee-tis.atlassian.net/browse/TISNEW-4307

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

G. Reference Table

H. Example value

I. Type (free text, drop down, check box) & Interaction (autopopulate etc)

J. Mandatory for submission (Y/N)

K. Validation / Error Messaging

L. Notes

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

G. Reference Table

H. Example value

I. Type (free text, drop down, check box) & Interaction (autopopulate etc)

J. Mandatory for submission (Y/N)

K. Validation / Error Messaging

L. Notes

Form R - Part B https://hee-tis.atlassian.net/browse/TISNEW-3947

https://hee-tis.atlassian.net/browse/TISNEW-4283
Section 1 - DOCTORS DETAILS

This form has been pre-populated using the information available against your records within the Trainee Information System (TIS). Please check all details and 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 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.”

Failure to appropriately complete a Form R Part B when requested may result in an Outcome 5 at ARCP (Please refer to latest edition of the Gold Guide).

1

Forename

Forename

Refer to Form R A

Refer to Form R A

N

Sebastian

  • Pre-populate

  • can be overwritten on the Form; no propagation to other parties on submission for MVP

Y

  • Cannot be left empty

Same as Form R Part A

2

GMC-Registered Surname

Surname

Refer to Form R A

Refer to Form R A

N

Potato

  • Pre-populate with Surname

  • can be overwritten on the Form; no propagation to other parties on submission for MVP

Y

  • Cannot be left empty

Same as Form R Part A

3

GMC Number

GMC Number

Refer to Form R A

Refer to Form R A

N

1234567

  • Pre-populate

  • can be overwritten on the Form; no propagation to other parties on submission for MVP

Y

  • No validation with GMC for MVP.

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

Primary Contact Email Address

 

N/A

N/A

 

PotatoSeb@nhs.net

  • Leave blank, do not pre-populate

  • Populate with valid email address. 

  • Can be overwritten on the Form; no propagation to other parties on submission for MVP

  • Valid email address format

Y



Strongly advised to give 'NHS.net' address

Full text on Form R:
”For reasons of security and due to frequent system failures with internet email accounts, you are strongly advised to provide an ‘NHS.net’ email address.”

5

Deanery / HEE Local Team


 

Person Owner


 

Refer to Form R A

Refer to Form R A

Y - Local Office

Health Education England North West London

  • Pre-populate with Programme Owner

  • If no Active/Current Programme membership then leave blank

  • Can be overwritten on the Form; no propagation to other parties on submission for MVP

  • Overwritten with Local Office Reference table CURRENT values only

    • Note: Exclude 'London LETBs' in the list

Y



Same as Form R Part A

6

Previous Designated Body for Revalidation

Designated body of their previous revalidation episode. (since they were last revalidated)

@James Harris @Alistair Pringle (Unlicensed)

 

Match on traineeTisId

  • Match on traineeTisId

    • If changed/added/removed on Reval against trainee, needs to be re-synced to Trainee UI trainee record

    • If a value in the Local Office Reference table in TIS is changed/Inactivated/added, then needs to be re synced to trainee UI Reference

    • If existing value has changed its name or status from CURRENT to INACTIVE on TIS Reference,  then re-sync to Trainee UI > Reference, remove Inactives from dropdown for new form submission

    • If new value with Status = CURRENT is added in TIS Local Office Reference, then sync to trainee UI> Reference

Y- Local Office

Health Education England South London

  • Pre-populate with designated body from previous revalidation episode

  • Editable with Local Office reference value

 

N



Not mandatory - some trainees may not have been previously revalidated

Note: This will have to be done on the current Reval Live app, when the new Reval App goes live we will need to refactor this.

7

Current Revalidation Date

Submission date (from Revalidation module)

Revalidation > submissiondate

trainee > TraineeProfile > currRevalDate

  • If changed/added/removed on Reval Module against trainee, needs to be re-synced to Trainee UI trainee record

 

09/04/2025

  • Pre-populate

  • Editable

N



Not mandatory as F1s (first year Foundation trainees) will not have one, and some PH (Public Health trainees) will not have a reval date either

what happens if not connected to DB

8

Date of Previous Revalidation

Submission date (from Revalidation module)

 

trainee > TraineeProfile > prevRevalDate

  • If changed/added/removed on Reval Module against trainee, needs to be re-synced to Trainee UI trainee record




09/04/2020

  • Pre-populate

  • Editable

Note: We may not be able to pre-populate this as we may not be keeping historical revalidation episodes. Check with reval guys: @Adewale Adekoya

N



Can Form R Part B pull previous submission date (if applicable)? Must ignore deferrals. Only consider successful revalidations

 

9

Programme / Training Specialty

Curriculum Specialty from Programme Membership

Refer to Form R A

Refer to Form R A

 

Cardiology

  • Pre-populate with the current Curriculum specialty of curriculumSubType = MEDICAL_CURRICULUM and Status = CURRENT and attached to the Most recent Programme membership based on furthermost 'Programme start date' 

Note: Curriculumid in ProgrammeMembership linked to Curriculum table to extract the curriculum sub type info

  • Where there are multiple, pick the topmost in alphabetical order

  • Can be overwritten on the Form; no propagation to other parties on submission for MVP

  • Overwritten with only CURRENT value from

    • Curriculum.name of curriculumSubType = MEDICAL_CURRICULUM and Status = CURRENT from Curriculum table  

Y



Same as Form R Part A

Some curricula may contain a year e.g. “Cardiology - 2007” - potentially confusing to the trainee

@James Harris @Alistair Pringle (Unlicensed) - Do curriculum names still have year?

Alphabetical order issue:
General (Internal) Medicine
Renal
BSMS HEI

10

Dual Specialty

N/A

Refer to Form R A (Reference mapping already covered)

Refer to Form R A

SpecialtyName

General (Internal) Medicine

Same as above, but reverse alphabetical order(?)

  • Leave unpopulated

  • Overwritten with only CURRENT value from

    • Curriculum.name of curriculumSubType = MEDICAL_CURRICULUM and Status = CURRENT from Curriculum table  

N



@Alistair Pringle (Unlicensed) @James Harris :

Triple accreditation - please add another row as a blank field to give trainees the option to add a third specialty

 

https://hee-tis.atlassian.net/browse/TISNEW-4293

Section 2 - WHOLE SCOPE OF PRACTICE (assistance information required) Read these instructions carefully! Please list all placements in your capacity as a registered medical practitioner since last ARCP (or since initial registration to programme if more recent). This includes: (1) each of your training posts if you are or were in a training programme; (2) any time out of programme, e.g. OOP, mat leave, career break, etc.; (3) any voluntary or advisory work, work in non-NHS bodies, or self-employment; (4) any work as a locum. For locum work, please group shifts with one employer within an unbroken period as one employer-entry. Include the dates and number of shifts worked in each locum employer-entry. Please add more rows if required.

Multiple of rows of the below can be added.



11

Type of Work

see column H

Note:

trainee > TraineeProfile > placements

  • site

  • siteLocation

  • placementType

  • grade

  • specialty

Note: None of the above are stored as Reference on trainee UI.

  • Match on traineeTisId and placementTisId

  • If a Site known As/site name/address/postcode changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record

 

N/A

(Placement Type in reference will not suffice)


ST5 Cardiology

In Post

OOPC/E/P/R/T

Parental Leave

Locum

Volunteering

  • Can add multiple rows

  • Pre-populate with all placements since last ARCP if possible

  • <Placement Type> <Placement Grade> <Placement Specialty> format taken from their placements on TIS

  • Can be overwritten with freetext

Y



 

@Alistair Pringle (Unlicensed) @James Harris

This should consist of 

  • placement data

  • leave data

  • Could be anything outside of TIS e.g Locum, Volunteering

 

  • Must include current placement and any previous placement(s) subsequent to previous ARCP

  • pop up/message to ensure that any voluntary/locum work is documented

12

Start Date

placement > dateFrom

trainee > TraineeProfile > placements > startDate

  • Match on traineeTisId and placementTisId

  • If a dateFrom changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record

N/A

02/10/2019

  • Pre-populate with Placement start date

  • Can be overwritten with date format

Y



  • Must include current placement and any previous placement(s) subsequent to previous ARCP

13

End Date

Placement > dateTo

trainee > TraineeProfile > placements > endDate

  • Match on traineeTisId anf placementTisId

  • If a dateTo changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record

N/A

06/10/2020

  • Pre-populate with Placement start date

  • Can be overwritten with date format

 

Y





14

Training Post?

Derived from Placement > placementType

see column H

trainee > TraineeProfile > placements > placementType

Note: Not a reference on trainee UI

  • Match on traineeTisId and placementTisId

  • If placement type is changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record

 

N/A

Placement Type in reference?

Y

  • Pre-populate Y for a placement type of “In Post” , ‘In Post - Extension’ and ‘In Post - Acting Up’

https://hee-tis.atlassian.net/browse/TIS21-1341

  • Leave blank for all others and enable trainee to select “Y” or “N” accordingly

Y



@Alistair Pringle (Unlicensed) @James Harris

15

Site Name

derived from Placement > SiteId

see column H

trainee > TraineeProfile > placements > site

  • Match on traineeTisId and placementTisId

  • If site name (SiteKnownAs) is changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record




Hammersmith Hospital

  • Pre-populate with siteknownas from Placement site if Type of work = Placement

  • Else freetext that can be overwritten (trainee may not be necessarily at an ODS list site)

Y



@Alistair Pringle (Unlicensed) @James Harris

  • Pre-population unlikely to capture overseas sites and sites where the trainee volunteered at

16

Site Location

derived from Placement > SiteId

see column H

trainee > TraineeProfile > placements > siteLocation

  • site address/postcode is changed/added/removed on TIS against trainee, needs to be re-synced to Trainee UI trainee record

 



  • Pre-populate with the address field of the Site from #15 if Type of work = Placement

  • Else freetext that can be overwritten (trainee may not be necessarily at an ODS list site)

Y



Guidance text needed (see Form)

Full address not necessary. Trust / Lead employers / Placement Site will suffice

Time Out of Training - guidance text see document



17

Short and Long-term sickness absence

N/A

N/A

N/A

N/A

3

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

 

 

Y



@Alistair Pringle (Unlicensed) @James Harris

  • Can pull from ESR Absence data?

  • Must be from date after the previous ARCP

  • Pre-populate all TOOTs with 0 and let trainee edit. Integers only.

  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

18

Parental leave (incl Maternity / Paternity leave)

N/A

N/A

N/A

N/A

0

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

Y



  • Can pull duration from placements subsequent to previous ARCP marked as “Parental Leave”?

  • Must calculate TOOT from day after ARCP and not the actual parental leave start date

  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

19

Career breaks within a Programme (OOPC) and non-training placements for experience (OOPE)

N/A

N/A

N/A

N/A

0

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

Y



  • Can pull duration from placements subsequent to previous ARCP with Type marked as “OOPC” or “OOPE”?

  • OOPP?

  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

20

Paid / unpaid leave (e.g. compassionate, jury service)

N/A

N/A

N/A

N/A

0

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

Y



@Alistair Pringle (Unlicensed) @James Harris - can this come from absence data?

Unpaid leave appears in both #20 and #21.

  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

21

Unpaid/unauthorised leave including industrial action

N/A

N/A

N/A

N/A

0

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

Y



  • Can pull from ESR data?

  • Unpaid leave appears in both #20 and #21.

  • leave unpaid leave there

  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

22

Other (see guidance)

N/A

N/A

N/A

N/A

0

  • Pre-populate with 0

  • Editable - Can only populate with integer numbers. Referring to the guidance half days to be rounded up.

Y



  • No restrictions, but if needed can put 999 days as limit

  • Limit set to 9999 to allow for long term leave.

23

Total

N/A

N/A

N/A

N/A

3

Autopopulated

= Total of above fields 16-22

Y



  • Limit set to 9999 to allow for long term leave.

https://hee-tis.atlassian.net/browse/TISNEW-4315

Section 3 - DECLARATIONS RELATING TO GOOD MEDICAL PRACTICE (assistance information required)

These declarations are compulsory and relate to the Good Medical Practice guidance issued by the GMC. Honesty & Integrity are at the heart of medical professionalism. This means being honest and trustworthy and acting with integrity in all areas of your practice, and is covered in Good Medical Practice. A statement of health is a declaration that you accept the professional obligations placed on you in Good Medical Practice about your personal health. Doctors must not allow their own health to endanger patients. Health is covered in Good Medical Practice.



23

1) I declare that I accept the professional obligations paced on me in Good Medical Practice in relation to honesty and integrity.

N/A

N/A

N/A

N/A



Selection box

Y / N

Y



Guidance information required here 

24

2) I declare that I accept the professional obligations placed on me in Good Medical Practice about my personal health

N/A

N/A

N/A

N/A



Selection box

Y / N

Y





25

3a) Do you have any GMC conditions, warnings or undertakings placed on you by the GMC, employing Trust or other organisation?

N/A

N/A

N/A

N/A



Selection box

Yes - present Q3b

No - present Q4

Y





26

3b) If yes, are you complying with these conditions / undertakings?

N/A

N/A

N/A

N/A



Yes - present Q4

No - TBC

Y - if 3a = yes



what happens if no? @Alistair Pringle (Unlicensed)

reval users to investigate?

27

4) Health Statement 

N/A

N/A

N/A

N/A



Free text

 

N



Guidance text needed here

no character limit

https://hee-tis.atlassian.net/browse/TISNEW-4317

SECTION 4 - UPDATE TO PREVIOUS FORM R PART B - see guidance text doc

If you have previously declared any Significant Events, Complaints or Other Investigations on your last Form R Part B, please provide updates to these declarations below. Please do not use this space for new declarations. These should be added in Section 5 (New declarations since your previous Form R Part B).

Can add multiple rows of the below



28

1) If you did not declare significant events, complaints, or other investigations on your previous Form R Part B, check this box

N/A

N/A

N/A

N/A



Check box

Go to Section 5

N - but if N then must answer 2





29

2) If any previously declared significant events, complaints, or other investigations have been resolved since your last ARCP/RITA/Appraisal, you are required to have written a reflection on these in your Portfolio

N/A

N/A

N/A

N/A



Selection: Y/N

Add multiple

Y




pull from previous form R?
allow access to previous form r for reference?

30

2a) Declaration Type

N/A

N/A

N/A

N/A



Smart-search / drop down

  • Significant event

  • Complaint

  • Other investigation



Y - If (2) is yes




Guidance text/definitions

31

2b) Date of entry into Portfolio

N/A

N/A

N/A

N/A



Calendar picker

Y - If (2) is yes





32

2c) Title / Topic of Reflection/Event

N/A

N/A

N/A

N/A



Free text

Y - If (2) is yes





33

2d) Location of entry in Portfolio

N/A

N/A

N/A

N/A



Free text

Y - If (2) is yes





34

3) If any previously declared Significant Events, Complaints or Other Investigations remain unresolved,
please provide a brief summary below, including where you were working, the date of the event, and
your reflection where appropriate. If known, please identify what investigations are pending relating to
the event and which organisation is undertaking this investigation.

N/A

N/A

N/A

N/A



Free text

N



Guidance text required:

https://hee-tis.atlassian.net/browse/TISNEW-4323

Section 5: NEW DECLARATION SINCE YOUR PREVIOUS FORM R PART B  - see guidance text doc

Significant Event: The GMC state that a significant event (also known as an untoward or critical incident) is any unintended or unexpected event, which could or did lead to harm of one or more patients. This includes incidents which did not cause harm but could have done, or where the event should have been prevented. All doctors as part of revalidation are required to record and reflect on Significant events in their work with the focus on what you have learnt as a result of the event/s. Use non-identifiable patient data only.

Complaints: A complaint is a formal expression of dissatisfaction or grievance. It can be about an individual doctor, the team or about the care of patients where a doctor could be expected to have had influence or responsibility. As a matter of honesty & integrity you are obliged to include all complaints, even when you are the only person aware of them. All doctors should reflect on how complaints influence their practice. Use non-identifiable patient data only.

Other investigations: Any on-going investigations, such as honesty, integrity, conduct, or any other matters that you feel the ARCP panel or Responsible Officer should be made aware of. Use non-identifiable patient data only.

**REMINDER: DO NOT INCLUDE ANY PATIENT-IDENTIFIABLE INFORMATION ON THIS FORM

Can add multiple rows of the below.



35A

I do not have anything new to declare since my last ARCP/RITA/Appraisal

N/A

N/A

N/A

N/A



selection box

Y - must select either 35A or 35B



@Alistair Pringle (Unlicensed) @James Harris

keep RITA, reval users will contact COPMeD

35B

I have been involved in significant events/complaints/other investigations since my last ARCP/RITA/Appraisal

N/A

N/A

N/A

N/A



selection box

Y - must select either 35A or 35B



@Alistair Pringle (Unlicensed) @James Harris

 

36A

If you know of any resolved significant events/complaints/other investigations since your last ARCP/RITA/Appraisal, you are required to have written a reflection on these in your Portfolio. Please identify where in your Portfolio the reflection(s) can be found

N/A

N/A

N/A

N/A





Read only text field 





36B

Issue Type

N/A

N/A

N/A

N/A



Drop down:

  • Significant event

  • complaint

  • other investigation

Add multiple

Y - if 35B is selected





36C

Date of Entry in Portfolio

N/A

N/A

N/A

N/A



Calendar picker

add multiple

Y - if 35B is selected





36D

Title / Topic of Entry

N/A

N/A

N/A

N/A



Free text

Add multiple

Y - if 35B is selected





36E

Location of Entry in Portfolio

N/A

N/A

N/A

N/A



Free text

Add multiple

Y - if 35B is selected





37

If you know of any unresolved significant events/complaints/other investigations since your last ARCP/RITA/Appraisal, please provide below a brief summary, including where you were working, the date of the event and your reflection where appropriate. If known, please identify what investigations are pending relating to the event and which organisation is undertaking the investigation.

N/A

N/A

N/A

N/A



FREE TEXT

 

Y - if 35B selected





https://hee-tis.atlassian.net/browse/TISNEW-4324

SECTION 6: COMPLIMENTS - see guidance text doc

Compliments are another important piece of feedback. You may wish to detail here any compliments that you have received which are not already recorded in your portfolio, to help give a better picture of your practice as a whole. This section is not compulsory.

38

Free text

N/A

N/A

N/A

N/A



Free text

 

N





https://hee-tis.atlassian.net/browse/TISNEW-4326

SECTION 7: DECLARATION - see guidance text doc

I confirm this form is a true and accurate declaration at this point in time and will immediately notify the Deanery/HEE local team and my employer if I am aware of any changes to the information provided in this form. I give permission for my past and present ARCP/RITA portfolios and / or appraisal documentation to be viewed by my Responsible Officer and any appropriate person nominated by the Responsible Officer. Additionally if my Responsible Officer or Designated Body changes during my training period, I give permission for my current Responsible Officer to share this information with my new Responsible Officer for the purposes of Revalidation.

39

Trainee Signature

N/A

N/A

N/A

N/A



  • Populate with Forename<space>Surname entered earlier on the form

  • Read-only: If needs amending then correct on the form above.

  • on submission

Y



As with Form R Part A

40

Date

N/A

N/A

N/A

N/A



Pre-populate

  • Read-only

  • Today's Date

  • On submission

  • On re-submission, overwritten new date

Y



As with Form R Part A

Note (January 2024):

The validation rules for Form R Part B 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, such as for the Covid declarations section.
Back-end validation of final submitted Form R Part B: https://github.com/Health-Education-England/tis-trainee-forms/blob/main/src/main/java/uk/nhs/hee/tis/trainee/forms/dto/FormRPartBDto.java
Front-end validation of Form R Part B (applied during the process of filling them out): https://github.com/Health-Education-England/tis-trainee-ui/blob/main/components/forms/formr-part-b/ValidationSchema.ts