Data Binding

Keys that begin with param are serialized alphabetically in the data mappings file. These keys signify that the component in the value can be traced back to a specific property in a form parameter.

For example:

  param_customer$firstName = control.fname

This signifies that the control fname is bound to the firstName attribute of the parameter customer. If the parameter type contains nested classes, the key consists of multiple property names, separated by $.

For example:

  param_customer$address$zipCode = control.zip

Here, the key refers to the zipCode property of the Address object, which is contained by the Customer object.

In some situations, more than one component may reflect the value in the property of a form parameter. For instance, consider a master-detail pane where a property can show up as both a column in the master grid pane, and also as an editable field in the detail pane. In such cases, all components that can be traced back to the same data key are shown as a comma-separated list on the corresponding value.

For example:

  param_customer$firstName=control.fname__master,control.fname

Bindings are also provided for panes:

  param_customer=pane.customer

Here, the value of the customer parameter itself is bound to the customer pane.