Questionary Step

Display a questionary form to the participant with questions of two type:

• Text input answer - displays text box for input,
• Choose answer - list of answers, each with checkbox.

Answers to question may be constrained, e.g., with regular expression for text input or maximum number of selected choices.

If the questionary contains any question marked as required, the participant may complete the questionary step only if all required questions are correctly answered.

Each questionary and its questions may be identified with id. This is used for storing and retrieving answers during the session recording.

Definition

• actionType : "Questionary" (required)
• id : string - identifiaction of the questionary.
• questions : QuestionActionSettings[] - array of questions contained in this questionary:
  • actionType : string - answer type, see below.
  • id : string - identification of the question, used to identify the answer in the result and SessionRecording settings.
  • question : string - text of the question.
  • helpText : string - help text displayed when the participant fails to answer the question.
  • isRequired : boolean - specifies whether the question must be answered in order to continue in the sessions.
  • Other settings specific to each answer type. Currently, these are supported:
    • Text input answer
      • actionType : "WriteQuestionAnswer"
      • validAnswerRegexPattern : string - if not empty and isRequired is set to true, the regex pattern is used to check for correctness of the answer.
    • Choose answer
      • actionType : "ChooseQuestionAnswer"
      • answers : string[] - array of available answers for the question.
      • limit : int - maximum number of answers which the participant may choose.

Instructions step can be styled with these additional settings, see Content Step styling for more details.

• foreground : Color (optional) - text foreground color.
  • default value: "white"
• background : Color (optional) - background color.
  • default value: "black"
• fontSize : number
  • default value: 24

Result

• resultType : "Successful" - if the questionary was completed.
• answers : QuestionAnswer[] - array of answers to each question in the questionary:
  • questionId : string
  • answer : string
    • For WriteQuestionAnswer, the participant's answer.
    • For ChooseQuestionAnswer, concatenated indices of selected answers, separated with comma ,.