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.

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

  4. Select record options for the portal.

  5. To


    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.

  6. 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.

  7. Click OK.

  8. 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.

To add a blank row to a portal for new records:

You can create a record in a portal's related table by entering data in the blank row at the end of the portal. To display this blank row in a portal, you must allow the relationship to create related records.

  1. In Layout mode, in the portal object, note the name of the portal's related table.

  2. Choose File > Manage > Database, then click the Relationships tab.

  3. In the relationships graph, locate the table occurrence that the portal's layout is based on and the table occurrence the portal is related to (as noted in step 1).

  4. Double-click the indicator line between the related table occurrences.

  5. In the Edit Relationship dialog, under the related table, select Allow creation of records in this table via this relationship.

    When this option is selected, entering data in a related field that has no corresponding related record creates a related record based on the match field in the current table. See Creating and changing relationships.