itp:question element
<itp:question
( id= )?
>
	( <itp:order-response/> )?
	( <itp:keylist-prompt/> )?
	( <itp:paragraph-set/>
	  <itp:textblockserver>
		<itp:server/>
		<itp:port/>
		<itp:environment/>
	  </itp:textblockserver> ) ?
	<xforms:.../>
	( <itp:helptext/> )?
	( <itp:feedback/> )?
	( <itp:layout-hint/> )?
</itp:question>

Description

The <itp:question> element defines a single question on the form. This element contains the XForms representation of the question and some optional components which affect how the question is displayed.

Attributes

id

(optional) This attribute specifies the ID(…) keyword used to identify this question for use with the SHOW/SHOWNOT keywords.

Content

<itp:order-response>

(optional) This element is used in textblock selection and multiselect questions to indicate that the form should allow the user to order the responses.

<itp:keylist-prompt>

(optional) This element is used in keyselection forms to provide a description for the selection list. It can only occur if the root element

<itp:interact>

has an itp:type="keyselection" attribute.

<itp:paragraph-set>

(optional) This element is used in a textblock selection and specifies the textblock view from which the textblocks can be selected by the user.

<itp:textblockserver>

(optional) This element is used in a textblock selection and specifies the textblock server and environment from which the textblocks can be selected by the user.

<itp:helptext>

(optional) This element specifies a helptext for the question. It is only generated if the question has an HELPTEXT element.

<itp:feedback>

(optional) This element specifies feedback messages for the question. It is only generated if the form was previously rejected because of an invalid response or if one or more ERRORCONDITION statement in the form were triggered.

<itp:layout-hint>

(optional) This element specifies a layout hint for the question. It is only generated if the question has an LAYOUT element.

The following XForms elements can currently occur within an <itp:question> element:

Element

Used for:

<xforms:select>

Any multiselect question with a picklist.

<xforms:select1>

BOOL question, any question with a picklist.

<xforms:input>

NUMBER and TEXT questions.

<xforms:upload>

Text question with a FILE modifier.

( <xforms:submit> )*

Keys in a keyselection form (one <xforms:submit> element for each key displayed).

This list can be expanded in future versions of ITP.

Example

<itp:question>
<xforms:input/ >
<itp:helptext>Provide the age of the customer.</itp:helptext>
<itp:feedback>The age should be between 18 and 35.</itp:feedback>
</itp:question>