buildFormData

buildFormData() updating;

The buildFormData method of the Schema class examines the form build data for every form in the receiver and all of its subschemas. If the data is not up-to-date, it is constructed. This method enters transaction state if the process is not already in that state. Similarly, a commitTransaction instruction is called at the end of the method if the process was not initially in transaction state.

An exception is raised if the schema is currently versioned.

The following code fragment runs the buildFormData method for the current schema and its subschemas.

currentSchema.buildFormData;

Form build data is normally constructed when a form is saved in the Jade Painter. If that data is not up-to-date at run time, the form build construction occurs the first time a form is created from logic. In some situations, form build data can become invalid; for example, after upgrading to a new Jade version when new features have been added and following a schema and forms definition file load that involved a reorganization.

Run the buildFormData method before the ReadOnlySchema parameter in the appropriate [JadeClient] or [JadeServer] section of the Jade initialization file is set to true; otherwise any form where the form build data is not up‑to‑date must perform this step every time a form is created because the data cannot be stored persistently. This would be more expensive than creating the form from its build data and it also results in more network traffic being generated in thin client mode.