xforms:rebuildAdded by IBM on August 8, 2013 | Version 1 (Original)
|Causes the form viewing application to rebuild any internal data structures that are used to track computational dependencies within a particular model.
In general, the XForms processor automatically runs this action when required. As such, this action is included mostly for completeness.
Table 1. rebuild parameters
<xforms:rebuild event model="model"/>
|event||string||The XForms event that triggers the action.|
|model||string||The ID of the model to rebuild. If the model attribute is omitted, then the default model is used.|
Example The following button rebuilds model X when clicked:
<xforms:rebuild ev:event="DOMActivate" model="X"/>
- This feature is most likely to be used on scaled-down XForms processors, in which the implicit rebuild-recalculate-revalidate-refresh sequence is not implemented because of limited resources. In this case, explicit requests for these actions may force an exchange with a server.
- If an action sequence includes a setvalue action that affects a node which is used in an XPath predicate in the nodeset of an XForms bind, then you can call rebuild to cause the XForms bind to be re-evaluated.