goToQuestionnaire()

By calling goToQuestionnaire() the participant is directly redirected to another questionnaire in the same survey project. In doing so, an additional data record is created, which carries the number (CASE) of the original data record as reference (REF).

void goToQuestionnaire(string QuestionnaireID, [string TextID], [string page])

void goToQuestionnaire(string QuestionnaireID, [boolean restart], [string page])

• QuestionnaireID
  The ID of the questionnaire to which the participant should jump to.
• TextID
  The ID of a text to be displayed if the participant has already completed the questionnaire.
• Restart
  If the second parameter has the value true, no text is displayed if the subordinate questionnaire has already been filled out, but the questionnaire jumps to the page specified in the third parameter and can be filled out/changed again from there.
• Page
  If this parameter is set and contains a valid pageID, the subordinate questionnaire does not start on the first page or does not continue an interview that has already started on the last active page, but jumps directly to the specified page.

Important: Unlike multiLevelDown(), the participant is not returned to the original questionnaire after completing the questionnaire (reaching the last page). If this is desired, the command goToParent() must be used in the questionnaire (e.g. on the penultimate page).

The function goToQuestionnaire() allows a participant to fill in an otherwise locked questionnaire (access mode “internal/locked”). This is especially useful if the participant has previously authenticated himself by serial mail, serial number or login.

• If the participant has been assigned a personal identification (SERIAL), this will also be noted in the questionnaire to which goToQuestionnaire() refers.
• If no person ID is known in the current interview, a new character string (e.g. CASE000123) is generated. In both cases, the case number (CASE) of the original data record is noted as a reference (REF) in the new data record.

If the questionnaire is called up again by the same participant, it is treated as if a link personalized by serial mail or serial number was called up again. This means: If nothing to the contrary has been set in the questionnaire settings for the questionnaire (compile questionnaire → Tab Settings), any existing data record of the participant is continued. If the interview has already been completed, the text specified with TextID is displayed. If no ID has been specified, no content will be shown – by default SoSci Survey jumps to the next page.