Skip to content

Survey runner making changes to EPE surveys

Jump to bottom
Joshua Chapman edited this page Feb 23, 2023 · 3 revisions

# Making changes to EPE Survey

eQ ID: epe_0003 (GB) and epe_0004(NI)

  • Navigate to  https://author.eqbs.gcp.onsdigital.uk/convert/<QUESTIONNAIRE_ID_FROM_AUTHOR>

  • Copy and paste the questionnaire JSON into the relevant JSON file in Runner (Either epe_0003 or epe_0004; use eQ ID to know which to change)

  • Ensure eq_id, form_type, data_version and survey_id are unchanged from the previous epe (compare with the JSON you just replaced to know what these values are)

  • update the Theme to "epe" for 0003 and "northernirleland" for 0004

  • Within the preview_content block of the JSON (near the top of the page, around line 32) add a description property into the content property to create a hyperlink, it's value is unchanged from the previous wave (compare with the JSON you just replaced to know what this value is) - you may need to add a whole content array containing the question - see previous surveys

  • Ensure the trad_as metadata validator (found at the end of the JSON document) is optional_string (it will default to string in the JSON you grab from Author)

  • remove the extra metadata field for "employment_date" at end of questionnaire.

  • When you are done making changes, or further updates, run yarn format and push the code to GitHub.

If you need to updated the contact details

Then you need to make a new theme in runner or update if it already exists:

1. Runner/app/themes

Clone the relevant themes folder that is closest to your needs eg: covid

Rename that clone folder to your survey theme name Eg: epe

Runner/app/themes/yourThemName/templates Update introduction.html as required with new contact details etc. Important! Some prettifiers will turn single quotes into doubles when you clone!

you must use single quotes and not double for the refs reps, targets and aria codes!

 Update info.json as required

You may not need the thank-you.html unless that has changes

2. Runner/app/assets/styles/themes

Clone the relevant theme folder

Note - use docker logs on local to debug any issues like 500 errors etc

Clone this wiki locally