Page Parameters

Page Parameters are holding areas (placeholders) that are used to pass values from one page to another.

For example, you want to build a page in which the user's name is a placeholder. When this page is called from another 'user list page', which has a list of users, the 'user list page' can pass the real name of the user whose name was clicked.

The receiving page then uses the parameter name inside formulas. Any widget that uses a formula will then show the user's name.

Page Parameters are similar to cell references in a spreadsheet program. Just as you can refer to the value in cell D3 you can refer to the value of a page parameter.

Here are two common examples:

Passing part of a title as a page parameter.

First we will define a new page parameter, called pageName and then we will use it within the page.

Defining a page parameter:

1. From the 'Widgets on page' select the 'Page' widget.

2. The parameters block will appear in the 'Widget Settings' on the right (Expand the right panel if it is not open).

3. Click the (+) button to add a new parameter.

4. Enter a name (no spaces), and select the type (number or text). for Data Object ids, use 'Text'.

5. Enter a text or number value. This will be used when the page is being edited on its own - so you can use the parameter's default value in formulas.

Using a Page Parameter on the page

Next, we will use the page parameter within this page. For this we will use the Content Text formula (See Conditional formulas) to set the title of the page.

1. Select a title or other text element.

2. Select the 'Text & Typography' panel from the right editor.

3. In the 'Content Text' formula editor, enter "Welcome "&pageName

The content of the chosen element should change to reflect the page parameter's default value, concatenated (or appended) to the text "Welcome ". You can also press the Play button in the Formula Editor to see the entire text .

Passing the identifier (ID) of a Data Object.

Another common use of page parameters is to pass the unique identifier associated with a Data Object. This is useful when you need to populate form fields in a Data Object Container with a particular data object that's been selected in another page.

This example uses the special Filter Formula Editor. For details of how the filter formula editor works, see 'Data Filter Formula Editor'

As an example, consider a the following form for a hotel guest feedback:

1. Select the Data Container and ensure it has the correct Data Object selected (in this case 'GuestFeedback').

2. In the widget settings's Filter, enter the filter IF id is equal to feedbackId. In this case feedbackId is a page parameter defined on this page, like this:

   

   The Default value has been chosen from the Data Viewer in the Data Object - so when this page is being edited, it uses the given value. In actual use, another page - perhaps a Data List page , will use a Navigation widget to open this page - at which point the parameter passed in from the navigation will be used instead.

3. Use the 'Play' button in the formula editor to see what data object the filter will show.