Creating and managing layouts and reports > Working with portals on layouts > Creating portals to display related records
 

Creating portals to display related records

To create a portal that displays data from related fields in rows, first define a relationship between the table occurrence that the current layout is based on and another table occurrence. Use the Manage Database dialog box. See Defining database tables and Creating and changing relationships.

For example, in an invoice layout, you can add a list of line items by creating a portal that shows related records from the Line Items table.

Invoice layout for products illustrating the example above

To create a portal that displays related records:

1. In Layout mode, click the Portal tool Portal tool in the status toolbar.

2. Position the crosshair pointer on the layout where you want the portal to begin, then drag the pointer diagonally until the portal is the size you want.

3. In the Portal Setup dialog box, for Show records from:

choose the related table from which to display related records

choose Apps and Add-ons if the current table has a primary key, such as the default PrimaryKey field; see Adding Add-on Tables to custom apps

To create a new table or relationship, choose Manage Database.

4. Select record options for the portal.

 

To

Select

Sort the records in the portal

Sort portal records (or click Specify). In the Sort dialog box, choose the fields by which to sort the portal records, and click OK.

Filter the records in the portal

Filter portal records (or click Specify). In the Specify Calculation dialog box, define a formula for a calculation to filter the portal records, and click OK.

Allow related records to be deleted from the related table (in Browse mode)

Allow deletion of portal records.

This option does not need to be selected when you use the Delete Portal Row script step.

Display a vertical scroll bar at the right side of the portal, with which users can see (and enter) more records than are visible in the portal at one time

Allow vertical scrolling. Then, for Show scroll bar, choose Always (the default) to have the scroll bar display all the time, or When scrolling to have it display only while scrolling occurs.

To have the scroll bar display the portal's first record when you exit the current record, select Reset scroll bar when exiting record (or, clear this option so the scroll bar does not reset).

Note  You can't change the style of scroll bars.

5. Select format options for the portal.

You can specify the initial related record to display in the portal, the number of rows in the portal, and the background color for portal rows. See Formatting portals.

6. Click OK.

7. In the Add Fields to Portal dialog box, choose the fields that you want to appear in the portal.

Tip  You can drag objects, such as a related field, onto the first row of an existing portal to add it to the portal.

Notes 

You can also create a portal that shows records from a new Add-on Table. See Adding Add-on Tables to custom apps.

Related topics 

Deciding where to place related fields

Working with related data in portals

Adding a vertical scroll bar to a field