Sort Records
Purpose
Sorts the records in the current found set according to specified criteria.
See also
Format
Sort Records [Restore; With dialog: On/Off]
Options
•With dialog specifies whether to display a dialog box when the script step is performed, allowing users to enter different sort instructions.
•Specify sort order allows you to create a sort order and store it with the script step. When Specify sort order is not selected, FileMaker Pro uses the most recently executed sort instructions.
•Keep records in sorted order places a new or changed record that’s in sorted order into the adjusted order after the record is committed. When this option is not selected, new or changed records stay in the same position in the sort order until a find request is performed or the records are sorted by different criteria.
Compatibility
Where the script step runs | Supported |
FileMaker Pro | Yes |
FileMaker Server | Partial |
FileMaker Go | Yes |
Custom Web Publishing | Partial |
FileMaker WebDirect | Yes |
Runtime solution | Yes |
Originated in
FileMaker Pro 6.0 or earlier
Description
Find the records you want to sort (using
Perform Find script step or
Show All Records script step) before using this script step. If you sort a
repeating field, FileMaker Pro sorts on only the first entry in that field. You don't need to use the
Enter Browse Mode script step or
Go to Record/Request/Page script step after using Sort Records.
Each Sort Records script step can store a unique sort order; the sorting instructions are stored with the step, not the script. You can use this step several times within the same script and store a different sort order for each occurrence.
Notes
•Items in the sort order that aren’t valid when the script step is performed are ignored. When you specify a sort order in a database containing multiple
tables, FileMaker Pro stores the table name for each sort field in the sort order. For example, a sort order using the Last Name field of the Contacts table is stored in the sort order as Contacts::Last Name. If the Sort Records script step is performed when a table other than Contacts is the active table, Contacts::Last Name cannot be evaluated, and is ignored in the sort order.
•Server-side scripts and Custom Web Publishing run this script step as if the With dialog option is set to Off, so you must use the Specify sort order option to save the sort order in this script step.
Example 1
Goes to the Invoices layout, performs a find, sorts the records, then goes to the first record in the
found set.
Go to Layout ["Invoices"]
Perform Find [Restore]
Sort Records [Restore; With dialog: Off]
Go to Record/Request/Page [First]
Related topics