Code Block Response

Top  Previous  Next

Once one of the button-stype webitem buttons is pressed, the equivalent of a web form is submitted to the UnForm server, to run the same rule set that contains the detect and button commands (-f and –r are used, along with any args options and a hard-coded "-p pdf").  The following values are available in the cgi$ template:

 

cgi.action$

The name of the webaction button that was pressed to load or autorun the web form.

cgi.button$

The name of the button webitem that was pressed.

cgi.panel$

Returns the name of the active panel when the button was pressed, or "*" if no panels are defined.

cgi.field_name$

One field for each webfield and webitem in the form.  Checkboxes can have multiple items in the value, each separated by chr(1) ($01$).  Any spaces in the name of the associated webfield or webitem is replaces with underscores (a web field named "Doc ID" becomes cgi.field_doc_id$).

 

 

Use the prejob code block to interpret these items, and generate a cgiresponse$ string value.  This value is returned to the web extension for processing, based on the content:

 

http: or https: prefix displays a URL in a new tab
error: message text (use \n or <br> for line breaks) displays a message box titled "error", capitalized the same was as the prefix.
message: message text displays a message box titled "message".
other text renders in local browser window, and assumes HTML content

 

The webapi object can be used to generate http responses.  Note these http values can also be used in <a href=> tags in a pure html response.

 

If no cgireponse$ is available, the print job result is returned instead, allowing artificial print jobs to execute (by generating text pages in a prejob code block, and allowing normal rule set processing to handle the job).  The print job will be in PDF format.