$Web_Form_Parm

From m204wiki
Revision as of 22:17, 18 October 2012 by JALWiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

<section begin="desc" />Value of form field<section end="desc" />

$Web_Form_Parm retrieves the value of a field on a form.

$Web_Form_Parm takes four arguments, and it returns a string (or null for any error condition).

Syntax

<section begin="syntax" /> %string = $Web_Form_Parm( fieldname, occurrence, start, len ) <section end="syntax" />

Syntax terms

fieldname The name of the form field, returned by $Web_Form_Name. A required argument if occurrence is not specified, otherwise it is optional.
occurrence The occurrence number of a form field, or the occurrence number of the form field matching fieldname, if fieldname is specified. An optional argument if fieldname is specified, otherwise it is required.
start Starting position within the field. This is an optional argument which defaults to 1.
len Length to return. This is an optional argument, provided in case a form field exceeds 255 bytes. The length of a form field can be determined with $Web_Form_Len. The default is the length of the form field.

Examples

This example places the value of each parameter on a form into a User Language %variable of the same name.

* Stash the form values in matching fields. %CUSTOMER_NAME = $Web_Form_Parm( 'CUSTOMER_NAME' ) %CUSTOMER_NUM = $Web_Form_Parm( 'CUSTOMER_NUM' ) %ORDER_NUM = $Web_Form_Parm( 'ORDER_NUM' ) %ORDER_DATE = $Web_Form_Parm( 'ORDER_DATE' ) %ORDER_ITEM = $Web_Form_Parm( 'ORDER_ITEM') %ORDER_ITEM2 = $Web_Form_Parm( 'ORDER_ITEM', 2)

See also