Javadoc
This method is invoked when the form is ready for submission. Typically
this method would be called from one of your submission buttons
automatically but it is possible to invoke it programmatically.
Before validation, the general errors are cleared.
If the validation phase is passed the the submission handler will be
invoked. Before the handler is invoked, the page loading dialog will be
shown so that async requests can complete in the background.
The
SubmissionHandler must hide the loading dialog by calling
hideFormProcessingDialog() on the form or by calling Mobile.hideLoadingDialog()