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”.
4.0
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.
Acrobat Forms - JavaScript Object Specification
30