Passing a Parameter
- Navigate to the DataPage wizard, select a DataPage you want to modify, and proceed to Configure Fields screen. Submission Forms have one Configure Fields screen, but Report DataPages have three (search, results and details pages). In the Advanced tab, the section that pertains to parameters is External Associations and Defaults. Passing parameters from Results Page can be achieved using a query string.
- To pass a parameter to the next page, enable the On exit option by checking Pass field value as parameter and enter the parameter value. If a parameter is entered in this field, 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 field name. 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.
- Click Finish.
Note: In the details page of Report DataPage, 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 DataPage wizard, check On exit, pass AutoNumber ID field as parameter under the left panel to enable AutoNumber parameters. Because AutoNumbers cannot be included in the input fields, you must check this checkbox to pass an AutoNumber.
AutoNumbers passed from a Web Form have a slightly different syntax than other parameters. You must add “InsertRecord” as a prefix before the fieldname to receive this unique field type as shown above.
The parameter name will need to be formatted in a special way as shown in the example below:
Direct Your End User to the Next DataPage
On Destination and Emails 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.