Passing Parameters through Caspio Bridge

You can use parameters to pass data from one DataPage to another.  There are two methods to accomplish this transfer.  You can either pass parameters using the internal Caspio Bridge session, or use a query string.  This article shows how you can pass parameters internally through Caspio Bridge.  This method has the advantage that the parameter data is not visible in the address bar of your end-user’s browser.  Receiving parameters is discussed here.

Enable advanced options and parameters

On the first page of the DataPage wizard you must click Enable Parameters.  You cannot pass or receive parameters if you haven’t checked this checkbox.

Passing a parameter

Proceed to a Configure Fields screen of the DataPage wizard.  Web Forms have one Configure Fields screen, but Search and Report DataPages have three (search, results and details pages).  Once advanced options and parameters have been enabled, search and details Configure Fields screen will display an extra tab along the top labeled “Advanced”.  The section of the Advanced tab that pertains to parameters is called External Associations and Defaults. Passing parameters from results page can be achieved using query string.

To pass a parameter to the next DataPage, locate the section marked “On exit”.  Check the “Pass field value to the next page” checkbox.  By enabling this option the DataPage will place the field’s value in the current Caspio Bridge session for future DataPages to use. The wizard will generate a default parameter name that matches the fieldname.  You can change this name if you need to, but it must maintain the correct syntax [@xxxxx].  Your data will be accessible under this parameter name until it is replaced, or the session expires.  Save this parameter name for later reference when you want to receive this parameter.

Note that in the details page of Search and Report Forms you can only pass parameters from fields that are editable or hidden and not display only.

Passing an AutoNumber field

In Web Forms, AutoNumber parameters must be passed in a special way.  In the Select Fields screen of the DataPage wizard there is a checkbox located under the left panel.  Because AutoNumbers cannot be included in the input fields, you must check this checkbox to pass an AutoNumber.  The parameter name will also be formatted in a special way as shown below:

Example: [@InsertRecordApplication_ID]

Direct your end-user to the next DataPage

On the Destination and Triggers screen you can direct the end-user to the DataPage, or host web page, that will receive your parameters.

Remember that passing a parameter makes the data available for all future DataPages until the data is overwritten or the session expires.  The receiving DataPages must have parameters enabled and must be correctly configured to receive the parameters.