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.
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:
and the variable CompanyName has been given the value "Alpha Holdings" on page 1, then the title of page 2 is realised as:
If, however, CompanyName was not answered on page 1 then the title of page 2 is realised as:
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 "...".
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:
“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:”