Link to a Page
You can add a link to a construct page within the same or different WebApp using the Link to Page Name property in the column input types mentioned below, enabling users to access the required page with a click. By default, when linking from one page to another, Construct Preview links the pages using the key fields.
Currently, the following column input types supports the Link to Page feature:
List
Number
Text
Button
When using the Link to Page setting with column input types other than button, the display text in the field displays with an underline.
Use an existing column in a view, or a count, or a NULL and assign an alias so a Button column type can be added to the page in the Construct Preview. Buttons can display text or a counter to indicate the number of records on the linked page. You can also execute an event using Buttons. Refer to Construct Events for more information.
Note
It is recommended to implement the page links in column properties prior to building additional page properties. Testing additional properties on pages that have not been linked within the WebApp cannot be performed during implementation, leaving possible errors undiscovered until later.
A NULL column with an alias must be added to the underlying view to add a button to a column that does not contain data. The view must be modified before a link from a button can be added.
To link to a page on the above mentioned column input types, complete the following steps:
On the Construct Preview’s home page, edit the required WebApp. The WebApp configuration page is displayed.
Access the Grid’s or Form’s node of your required construct page.
In the Fields node of the Grid or Form, access the required the column input type mentioned above.
From the Link to Page Name list, enter the name of the required construct page.
In the Display Text field, enter the required display text if this field links to another page.
To open the link in a new browser tab, turn on the Open in New Tab toggle.
To add a link to page binding criteria, refer to the Add Link to Page Bindings section below.
To pass additional data to the linked page’s container events, refer to Add Link to Page Shared Fields section below.
Click Save.
Add Link to Page Bindings
Link to Page only links the pages using key fields. However, if the key fields are different between linked pages, identity the key fields on the required views and use the Link to Page Bindings property to link between the pages.
Note
Page bindings pass data values from the source page to the target page, allowing for filtered views when navigating between pages.
For instance, a user clicks a button on a Country page listing country records to access a Region page listing the selected country's regions. If the Country field (the key field) does not have the same name on both pages, the field on the linked from page (the Country page) must be included as part of the page binding criteria. Otherwise, the Region page displays regions for all countries.
Use the table below as a reference to add the required link to page bindings. Either the Source Data Record Field Value or Fixed Value field must be specified.
Field Name | Description | Supported Values/Notes |
|---|---|---|
Name | Specify a unique binding name for the page link | Enter a name for binding. maxLength: 256 |
Target Column | Specify the target column in the linked page | Enter target column name from the dataset. maxLength: 128 |
Target Page Container Name | Specifies the container name in the linked page | Select the name of the grid or form container from the page you’ve selected. |
Source Data Record Field Value | Specifies the source column in the current page | Select source column name from your dataset. |
Fixed Value | Specifies the source value in the current page | Specify the value or the actual record of the source column. maxLength: 255 |
Click Add to create multiple page binding criteria.
Add Link to Page Shared Fields
Link to Page Shared Fields allows you to pass additional data between grids/forms for the events configured in the linked (target) container. Unlike Page Bindings, Page Shared Fields do not filter records on the target container.
Note
Ensure that the event task configured in the target container includes a variable to store data from the shared source column or value.
Use the table below as a reference to add the required link to page shared fields. Either the Source Column or Fixed Value field must be specified.
Field Name | Description | Supported Values/Notes |
|---|---|---|
Name | Specify a unique name for the link to page shared field | maxLength: 256 |
Target Column | Specify the target column in the linked page | Enter target column name from the dataset. maxLength: 128 |
Target Page Container Name | Specifies the container name in the linked page | Select the name of the grid or form container from the page you’ve selected. |
Source Column | Specifies the source column from the parent container to pass the value from | Select source column name from this container’s dataset. |
Fixed Value | Specifies a fixed value for the target column | Enter a value. maxLength: 255 |
Click Add to include multiple shared fields.