Advanced Questionnaires

What are advanced questionnaires? 

Advanced questionnaires are PKB questionnaires that have additional features; including scoring, branching logic, coded data and embedded images. Organisations can currently send 'advanced questionnaires' to patients via the advanced questionnaire API endpoints.  Patients will receive an email notification when they are sent an advanced questionnaire and can answer the questions without first logging in, even if they are not registered. 

Advanced questionnaire features

Scoring 

Advanced questionnaires can be built to automatically calculate a score, based on answers that the patient has provided. Whether the patient can see the score as they are answering the questions is configurable. Scores will appear on the QuestionnaireResponse resource, with an associated clinical code if appropriate. 

Branching 

Branching logic can be used in a questionnaire, so that the patient is only asked questions that are relevant to them. An example of this would be displaying pregnancy-related questions after the patient had answered ‘Yes’ to a question asking if they are pregnant.

Mandatory questions 

Questionnaires can not be built with mandatory questions. If a patient attempts to submit a questionnaire without answering all mandatory questions, they will be shown an error message.

Coded data

Questions can now be assigned clinical codes, so that their answers can be written back to clinical systems from the QuestionnaireResponse resource. For example, if a patient completed a GAD7 questionnaire, their answers and overall score would be linked to the relevant LOINC codes on the QuestionnireResponse (see this example in the dev wiki).

How do I create an advanced questionnaire?

Advanced questionnaires have to be built by PKB. Please contact your Success team PM to discuss this. 

Can I send an advanced questionnaire to a patient via the user interface?

Currently, teams can only send advanced questionnaires via the advanced questionnaire APIs. We will soon be adding support for professionals and coordinators to send advanced questionnaires via the user interface.  For more information, see our development plan. 

Can patients start advanced questionnaires via the user interface? 

Currently, teams can only send advanced questionnaires via the advanced questionnaire APIs. We will soon be adding support for patients to initiate some questionnaires from their record by clicking 'Start consultation'.  For more information, see our development plan. 

Can I control which questionnaires patients can start via the user interface?

Patients will soon be able to start some advanced questionnaires from their PKB record by clicking 'Start consultation'. Your team will be able to choose which questionnaires that your patients can initiate and which questionnaires can only be sent by the team.