Respondent Flow

A typical respondent flow through a survey tree is as follows:

1. Authentication (if using the Pera apps)
2. Profile answers
3. Assessment answers
4. Feedback on the Pera experience
5. Results viewing (if enabled)
6. Visiting account page (e.g. to see results from past surveys or to complete ongoing surveys)

For each survey a Response is created. Note: this includes the head survey response which may be empty.

Each response contains a list of Answers corresponding to the survey questions.

Both responses and answers have a status field - ResponseStatus - to indicate if the answer/response is in-progress (started) or completed (finished).

To complete a response all required questions in the survey must have answers.

To complete a survey tree all reponses in the tree must be complete.

The details of a Survey and it's questions/profile can be retrieved with the survey query.

Reponses and answers

Create a Response to a Survey via the responseCreate mutation.

Create Answers in a Response via the surveyAnswerCreate mutation.

Profile Response

The head survey may contain a SurveyProfile. The SurveyProfile defines common profile questions (name, email, university etc.) via SurveyProfileTypes.

The profile may also contains filter questions (single or multiple choice), for example "How did you hear about us?" or "In which city do you like to work?" These profile answers can be used to filter the responseList as returned by hrResponseList.

After a response to the head survey has been created, and assuming the head Survey has a Profile, a ResponseProfile object must be created via the responseProfileCreate mutation.