sethiddenwebformitem
sethiddenwebformitem
PAGE
,
FIELD
,
VALUE

The sethiddenwebformitem statement adds a hidden field to a form on a web page.

Parameters

This statement has three parameters:

page – field or variable containing an HTML page. The page must contain a `</form>` tag.

field – name of the hidden web form field.

value – value of the hidden web form field.

Description

This statement adds a hidden field to a form on a web page. In addition to normal visible data values (text editing cells, checkboxes, radio buttons, etc.) web browsers also support hidden values within a web form, and this statement lets you add a hidden value after the form has been rendered (hidden values can also be included in the rendering process, see Setting Hidden Form Values).

This example adds a hidden field named PreviousCustomer to the form, and sets the value to yes.

    cgiHTML = renderwebform("Invoice","")
    sethiddenwebformitem cgiHTML,"PreviousCustomer","YES"

When the form is filled out and submitted back to the server, the PreviousCustomer value will be included, and can be accessed with the webformitemvalue( statement, just like any other item in the web form.

You can also use a variable or expression for the hidden field value, like this:

    let discountPercentage = 15
    ...
    cgiHTML = renderwebform("Invoice","")
    sethiddenwebformitem cgiHTML,"Discount",discountPercentage

Hidden field values are always text, but if a numeric value is supplied (as in the example above) it will automatically be converted to text for you.

See Also

- deletewebtemplate -- deletes the web template (a dictionary) associated with a form (if any).
- getwebtemplate -- retrieves the web template (a dictionary) associated with a form (if any).
- getwebtemplate( -- retrieves the web template (a dictionary) associated with a form (if any).
- getwebtemplatetext -- retrieves the text of the web template (a dictionary) associated with a form (if any).
- getwebtemplatetext( -- retrieves the text of the web template (a dictionary) associated with a form (if any).
- grabwebformitems -- grabs multiple web form items and stuffs the values into fields and/or variables.
- listwebtemplates -- retrieves a list of web templates in the specified database, if any.
- listwebtemplates( -- retrieves a list of web templates in the specified database, if any.
- makeformwebtemplate -- converts a Panorama form into the equivalent HTML/CSS.
- renderwebform -- renders a Panorama web form into HTML, merging data into the template as necessary.
- renderwebform( -- renders a Panorama web form into HTML, merging data into the template as necessary.
- retrywebform -- retries a web form that has missing or invalid data.
- savewebtemplate -- saves a web template (a dictionary) associated with a form.
- webdatabasetoform -- fills in an HTML form with database field values.
- webfontsubstitutes -- generates an array of standard font substitutions for web browsers.
- webformallitems( -- returns a list of POST parameters passed from a form to the web server as a carriage return separated list.
- webformerrors( -- returns a list of errors that have been collected with the WebFormItemCheck statement.
- webformhiddenitems( -- returns a list of the hidden items in the web form submitted to this web procedure.
- webformitembang -- sets the text generated by the webformitembang( function.
- webformitemnames -- returns a list of POST parameters passed from a form to the web server as a carriage return separated list.
- webformitemnames( -- returns a list of POST parameters passed from a form to the web server as a carriage return separated list.
- webformitems( -- returns a list of POST parameters passed from a form to the web server, including both visible and invisible items (but excluding the special items Panorama generates for its own internal use).
- webformmerge -- fills in an HTML form with database values (fields and variables).
- webformrecordid -- adds a RECORD_ID hidden field to the HTML of a web form.
- webformselection -- selects data based on input from a web form. The web form must have fields that match the database fields.
- webformtodatabase -- updates the current database with information from the web form that was just submitted.
- webformvisibleitems( -- returns a list of the visible items in the web form submitted to this web procedure.
- webmerge -- merges an external HTML template file with fields and variables from the current record.
- webthisrecordkey -- makes a key for use with the WebURLSelect statement to specify the current record.

History

Version | Status | Notes
10.2 | No Change | Carried over from Panorama 6.0.