› KCM ComposerUI for ASP.NET Developer's Guide › KCM ComposerUI APIs › The <response> element › Key selection

Key selection

The key selection XForms form contains two major parts:

  • The <response> structure, which holds a Base-64 encoded representation of the keys which can be selected on this screen.

  • For each key an <xforms:submit> element, which is labeled with the human-readable description of the record.

The client application should use the Keys parameter on the COM API instead of manually generating a response on a key selection form.

A client must return the <response> element unmodified to the COM API and pass the submission=attribute as the selected action to indicate the record that has been chosen. 

<xsd:schema targetNamespace="http://example.info/types">
<xsd:simpleType name="question0">
<xsd:restriction base="string">
<xsd:length value="11" />
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
<xforms:instance>
<response xmlns="">
<question0 />
<key0>QUxGS0kAAAAAAAA=</key0>
<key1>QU5BVFIAAAAAAAA=</key1>
<key2>QU5UT04AAAAAAAA=</key2>
<ITP-interact-step>1</ITP-interact-step>
<ITP-interact-count>2</ITP-interact-count>
<ITP-interact-ID>
a1ca34fceb0dec2e67f064d129633ce8
</ITP-interact-ID>
</response>
</xforms:instance>
<xforms:bind nodeset="question0" id="question0" type="type:question0" />
<xforms:submission id="keylist0" />
<xforms:submission id="keylist1" />
<xforms:submission id="keylist2" />
<xforms:submission id="next" />
<itp:question>
<xforms:input ref="question0">
<xforms:label>
Unique_five_character_code_bas
</xforms:label>
</xforms:input>
</itp:question>
<itp:question>
<itp:keylist-prompt>Select Customer</itp:keylist-prompt>
<xforms:submit submission="keylist0">
<xforms:label>Select</xforms:label>
<itp:screen-fields>
ALFKI Alfreds Futterkiste Maria Anders
</itp:screen-fields>
</xforms:submit>
<xforms:submit submission="keylist1">
<xforms:label>Select</xforms:label>
<itp:screen-fields>
ANATR Ana Trujillo Emparedados y helados Ana Trujillo
</itp:screen-fields>
</xforms:submit>
<xforms:submit submission="keylist2">
<xforms:label>Select</xforms:label>
<itp:screen-fields>
ANTON Antonio Moreno Taquería Antonio Moreno
</itp:screen-fields>
</xforms:submit>
</itp:question>