Using Author Questions <q>

Use the QUESTION ( <q>) element to capture information from the author of the report. When using the QUESTION element, be aware of the following:

• All question elements must begin with <q name=" "> and end with </q>.
• The application uses the name element as a variable to hold the value of the answer provided by the author of the report.
• When using the DISPLAY node, be aware of the following:
  • The system uses the DISPLAY node containing the text to display as the question to the author.
  • All DISPLAY elements must with <display> and end with </display>.

• When using the OPTIONS node, be aware of the following:

  • The application uses the OPTIONS node to:

    Present pre-defined multiple answers to the author. All OPTIONS elements must start with <options> and end with </options>.

    Represent a single pre-defined answer.

  • The total character limit is 1,000 characters across all options.
  • All OPTION elements must start with <option> and end with </option>.
  • All OPTION values display in drop-down lists. The application truncates the option value after 160 characters.
  • If no OPTIONS are used, with the <q> operand, the application will present a free text field to the author to enter any value. The character limit for free text entries is 10,000.
• You cannot use variables as a part of DISPLAY or OPTION.
• All declared variables are case-sensitive.

Consider the following usage example:

<q name="q1"> <display>What is your favorite color?</display> <options> <option>Some Value 1</option> <option>Some Value 2</option> </options>