Go to Related Record script step

Contents > Script steps reference (alphabetical list) > Navigation script steps > Go to Related Record script step

Go to Related Record script step

Format

Go to Related Record [From table: "<table name>"; Using layout "<layout name>"]

Options

Get related record from lets you select the source relationship from a list of tables in the current database. If the table is not in the list or if you need to add or change a relationship, Manage Database displays the Manage Database dialog box, where you can create or edit relationships.

Show record using layout lets you choose a layout in the current file that will be used to display the related record(s).

Use external table's layouts opens the file containing the external table you specify and lets you choose a layout from that file in which to display the related record(s). This option is only available if the source relationship you selected references a table in another file.

Show in new window allows you to show the related records in a new window and lets you specify the settings for the new window. For more information, see New Window script step.

Specify lets you edit the settings you have previously chosen for the new window.

Show only related records creates a new found set in the related table with the options either to match the current record or to match the entire found set.

Match current record only creates a new found set in the related table containing a set of records that match the current record. For example, if there are three records in the related invoice table that match the customer record in the customer table you are currently viewing, and you want to see all three invoices, use Match current record only to display the three invoices.

Match all records in the current found set creates a new found set in the related table that matches all records in the current found set. For example, if you have a found set of ten customers and there are forty invoices in the invoice table that match any of these ten customers, use Match all records in the current found set to display the forty matching invoices.

Web compatibility

This script step is web-compatible.

Description

Goes to the current related record(s) in a related table, except when this script step is used from an active portal row.

If this script step is used from an active portal row, and the portal's table is the related table, then the related record in that table is made current. If the portal's table is not the related table, the first related record in the found set is made current.

You have the option to view the related records in a new window. This script step requires a relationship to be in effect.

For example, suppose you have an Invoices table that's related to a Customers table and you're currently looking at a particular invoice. In the Invoices table, you have a button that's set to Go to Related Record [Customers] . Clicking this button determines which customer record your current invoice is related to and immediately goes to that record in the Customers table. If the record in question is not currently in the Customers table's found set, the script can perform a find to make the record current.

This script step also works with portal rows. If the currently active portal row is row #3 and you execute a Go to Related Record script step using the same relationship as the portal, then FileMaker Pro goes to that particular related record in the related table.

When used with a table in an external file, this script step will open the file containing the external table and, if selected, go to the external layout you specify.

Note To bring the new window with the related record(s) to the front automatically, add the Select Window script step.

Examples

The following goes to a related record in the table "MyRelatedTable".


Go to Related Record [From table: "MyRelatedTable";
Using layout: "MyLayout"]

The following goes to a related record in the table "MyRelatedTable" and shows a found set of related records only.


Go to Related Record [Show only related records;
From table: "MyRelatedTable"; Using layout: "MyLayout"]

Script step categories

Contents > Script steps reference (alphabetical list) > Navigation script steps > Go to Related Record script step