WebPageSubmit Function

Action

Queries the currently active page for the specified HTML form. If the form is found, the function submits the form to the Web server by means of the HTTP POST method and reads the response page. If the retrieved document is of content type HTML, it is parsed and embedded documents are requested. This function also supports multi-part file upload (RFC1867-compliant file upload).

The form value pairs of the parsed HTML base are used to provide data for the subsequent submission. This way hidden fields, for example, session ids, are automatically taken from the HTML form and submitted to the server. These default values may be overwritten by using a form identifier declared in the dclform section. The submission method, GET or POST, is defined by the HTML form. If it is missing, the GET method will be used.

WebPageSubmit() recognizes automatically form and form entry.

"filename" := "<name of the input tag>;<file name>;<content type>";

Form identification rules are listed herein, ordered by priority:

• HTML forms to be queried are identified by a name:

  <form name="form1" action="data2html.asp">
    <input type=hidden name="cantfind" value="#b21334a45">
    <input type=text name=ShoeSize value=44>
  </form>

• The “value” attribute of the submit button:

  <form name="form1" action="data2html.asp">
    <input type="submit" value=Insert>
  </form>

• The image used for submission may provide an “alt” attribute:

  <form name="form1" action="data2html.asp">
    <input type="image" src=box5.gif alt="PostBox">
  </form>

In the case of a changing HTML form name, you can refer to the HTML form by number. All forms are numbered sequentially throughout the Web page.

Include file

WebAPI.bdh

Syntax

WebPageSubmit( in sHtmlForm   : string allownull,
               in formSubmit  : form,
               in sTimer      : string optional,
               in nHtmlFormNo : number optional,
               in sFrame      : string optional,
               in hContext    : number optional): boolean;

Return value

• true if the form is found and submitted successfully

• false otherwise