› KCM ComposerUI for ASP.NET Developer's Guide › KCM ComposerUI APIs › Top-level elements › itp:interact element

itp:interact element

<itp:interact
	itp:type=
	itp:lang=
	itp:gui_lang=
	itp:version=
	itp:feature-level=
      itp:has-errors=
>
	<itp:header/>
	( <itp:question/> | <itp:group/> | <itp:table/> )+
	( <itp:button/> )+
</itp:interact>

Description

The <itp:interact> element is the root element of the interact.xml file. It contains all questions and associated definitions for the form.

Attributes

Attribute Description
itp:type This attribute indicates the type of form that is presented. Currently defined values are:
  • keyselection: The form is a key-selection screen.
  • query: The form is based on a FORM statement.
  • content-wizard: The form is based on a WIZARD statement.
itp:lang The language currently used by KCM to generate dates, numbers and other language-dependent output.
itp:gui_lang The language currently used by KCM to interact with the user. Both itp:lang and itp:gui_lang are presented in the format "ll‑CC", where:

  • "ll" is the ISO-639 language code.

  • "CC" is the ISO-3166 country code.

For example, the KCM language "ENG", English localized for the UK, maps to "en-GB". "NLB", Dutch localized for Belgium, maps to "nl-BE".
itp:version The version of KCM that generates the interact.xml file.
itp:feature-level Indicates the FORM features that actually occur in the form. Currently defined levels are:

0 - All features introduced before KCM ComposerUI Server

1 - MULTISELECT, ORDER, BEGINGROUP/ ENDGROUP

2 - VIEW

3 - EXPANDABLE, EDITBOX, RADIOBUTTONS, READONLY, TOGGLE

4 - BEGINTABLE/ ENDTABLE, TIME, RECORSET, SHOW/ SHOWNOT

5 - EDITABLE_TEXTBLOCK questions

6 - Support for Text Block preview by date

7 - CONTAINS, IN, >, >=, <, <= allowed as toggle operator

8 - Toggling allowed on more than one condition

9 - Editable Rich Text Blocks

Each level includes the features of the previous levels.

itp:has-errors This attribute has the value "true" to indicate that the form is a re-send of a previously generated and submitted form, including feedback to the user about the errors in the input. In all other cases, the value is "false".

Content

The <itp:interact> element contains an <itp:header> element which defines the title of the form and the header attributes for the XForms definition.

In addition to this header, it contains one <itp:question> element for the QUESTION / TEXTBLOCK and one <itp:button> element for each button on the FORM. Note that a form always contains at least one question and one button.

Example 

<itp:interact itp:type="query" itp:lang="nl-NL" itp:gui-lang="en-GB" itp:version="3.2.2" itp:feature-level="0" xmlns:itp="http://www.aia-itp.com/3.1/interact" xmlns:xforms="http://www.w3.org/2002/xforms" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:type="http://example.info/types">
<itp:header/>
<itp:question/>
<itp:question/>
<itp:button/>
</itp:interact>