XML Property Binding

Use XML property binding with the following:

  • ICONLIST control,

  • MENU control,

  • ROWTABSUBPAGES control, or

  • for any simple property.

XML property binding uses XML files to access property values. Use the prefix "XML:" to indicate XML property binding.

<itr visibleprop="XML:isHomeAddressVisible">
   ...
</itr>

You see that the visibility of the row container is controlled by the XML property isHomeAddressVisible. An XML property is bound to a property tag (name-value pair).

<property name="isHomeAddressVisible" value="true">
</property>

The overall page layout is bound to an XML data file that contains all the property tags.

<xmlproperties>
   <property name="isHomeAddressVisible" value="true">
   </property>
   <property name="isBusinessAddressVisible" value="false">
   </property>
</xmlproperties>

The XML data file contains two property tags. With the first property, isHomeAddressVisible is set to "true"; with the second property, isBusinessAddressVisible is set to "false". At runtime, you can switch between XML data files by changing the "XML data mode". Just use the following method in order to use the correct XML data file method:

Adapter.setXMLDataMode

The files are kept within directory <webapp>/<project>/xmldata. Each XML data mode is represented by a subdirectory. By default, the Application Designer server accesses the XML files within the directory default.

cis
    project
        xmldata
            default
                PersonInfoAdapter.xml
            fullinfo
                 PersonInfoAdapter.xml