Adobe acrobat forms javascript object specification User Manual

Page of 64
Acrobat Forms - JavaScript Object Specification
30
The optional aFields parameter is the array of field names to submit or a string containing a
single field name. If this parameter is present then only the fields indicated are submitted,
except those excluded by parameter bEmpty. If this parameter is omitted or is null then all
fields in the Form are submitted (again subject to the restrictions of bEmpty).
You can include non-terminal fields in the array or the string passed as a parameter: this is a
simple shortcut for having a whole subtree submitted.
Example:
/* Submit the form to the server */
this.submitForm("http://myserver/cgi-bin/myscript.cgi#FDF");
/* Or */
this.submitForm("http://myserver/cgi-bin/myscript.cgi#FDF",
true, "name");
The example above illustrates a shortcut to submitting a whole subtree. Passing “name” as part
of the field parameter, submits “name.title”, “name.first”, “name.middle” and “name.last”.
Addition
The optional bGet parameter indicates, if true, that the submission uses the GET HTTP method
and if false (the default) a POST. GET is only allowed if using Acrobat Web Capture to submit
(the browser interface only supports POST) and only if the data is sent as HTML (i.e. bFDF
should be false).
Note:
You need to be running inside a web browser or have the Acrobat Web
Capture plug-in installed, in order to call the submitForm method (unless
the URL uses the “mailto” scheme, in which case it will be honored even if
not running inside a web browser, as long as the SendMail plug-in is
present).
Note:
Usage of the https protocol is supported for secure connections.
4.0