How is active text displayed on the questionnaire?

The display of active text on the questionnaire depends upon the relationship between where it occurs (warning message, variable guidance, etc.) and what variables are mentioned in the embedded expressions.
In general, these can be classified as:
  • Off-Page
    : the active text occurrence and the variable are on different questionnaire pages
  • On-Page
    : the active text occurrence and the variable are on the same questionnaire page
Indeed, the relationship may be a combination of both if more than one variable is mentioned in the embedded expressions.
Note that the active text for the Template Name is always considered off-page since this is calculated when the documents are generated. Note also that the active text for a warning may vary between off-page and on-page as the questionnaire pages containing the variables are navigated over.
In the examples that follow these active components are annotated with underline.
Off-Page Active Text
If there are sufficient off-page variables that enable the embedded expression to be fully evaluated, then the expression's value is substituted in the active text.
For example, suppose the title of page 2 is:
“{CompanyName} Details”
and the variable CompanyName has been given the value "Alpha Holdings" on page 1, then the title of page 2 is realised as:
“Alpha Holdings Details”
If, however, CompanyName was not answered on page 1 then the title of page 2 is realised as:
“CompanyName Details”
If the expression embedded within the active text involves any function, including case functions, which cannot be fully evaluated, then it is substituted with the text "...".
On-Page Active Text
Where the active text occurrence and the variable are on the same questionnaire page, changes happen in real-time as and when variables are answered or re-answered.
For example, consider a questionnaire page that contains variables ApplicantName and ApplicantAddress with respective questions:
“Who is the applicant?”
“Enter {ApplicantName}'s address:”
When the page is first rendered it will contain the question:
“Enter ApplicantName's address:”
If the user enters the text Jane Doe in the edit box for ApplicantName then the question will automatically change to:
“Enter Jane Doe's address:”

Related content