This service facilitates the review and editing of Blaise questionnaire data, supporting multiple user roles with distinct permissions and functionalities. It utilises two Blaise questionnaires: the original interview questionnaire and a derived "edit" questionnaire. A cloud function manages data synchronisation between these questionnaires.
- SVT Supervisor: Assigns cases to editors, tracks editing progress, and can directly edit cases.
- SVT Editor: Reviews and edits completed cases, flagged by specific outcome codes.
- Researcher: Accesses and edits any case, regardless of status or organization.
- Survey Support: Works with the original questionnaire, enabling case recoding.
Prerequisites
Clone the repository:
git clone https://github.com/ONSdigital/blaise-editing-serviceCreate an .env file in the root of the project and add the following environment variables:
| Variable | Description | Example |
|---|---|---|
| PORT | Port for the express server | 5000 |
| BLAISE_API_URL | URL that the Blaise Rest API is running on (including protocol) | http://localhost:90 |
| SERVER_PARK | Name of the Blaise server park | gusty |
| VM_EXTERNAL_WEB_URL | External URL used for CATI (not including protocol) | cati.example.com |
Example .env file:
PORT='5000'
BLAISE_API_URL='http://localhost:90'
SERVER_PARK='gusty'
VM_EXTERNAL_WEB_URL='cati.example.com'Open a tunnel to our Blaise RESTful API in your GCP project:
gcloud compute start-iap-tunnel restapi-1 80 --local-host-port=localhost:90 --zone europe-west2-a