Software Venture Consulting

FileMaker Pro downloads & Resources
FileMaker Custom Functions
FileMaker Web Viewer Examples
FileMaker Pro & Lasso Consulting
FileMaker Books
FileMaker Articles
FileMaker Error Reference

Free Web Tools
Free FileMaker Tools

Personal Pages

Shopping Cart
Shopping Cart


Free Newsletter


Privacy Policy

FileMaker is a registered trademark of FileMaker, Inc. in the U.S. and other countries.


 FileMaker Pro Custom Functions

List  |  Show Random  |  Upload  |  Add This to Your Site

PortalSortKey ( parameter ; PortalFieldNames )

Rate this function:  

  Average rating: 3.8  (38 votes)
  Discuss this Custom Function

Ugo DI LUCA, DLSystems

Using this calculation for your portal sorting key should render things easy. One script of 2 lines should be enough to sort any column either asc. or desc.

Sample Input:
PortalSortKey ( PortalRelationship::gParameter ; "portalFields" )
Sample Output:
A text value of 0.005 is converted as
"0 999999999999.005" when in ascending process and

"1 000000000000.005" when in descending process

 Then copy & paste into FileMaker Advanced's Edit Custom Function window.

Click here to copy To Clip Manager if you have myFMbutler's Clip Manager installed


The key built through this function can be used for any sorting case, not only portals by the way.

This function relies on a value list, memorizing the fieldnames in the order they appear in the colums.
To allow for an effective sort on Text fields containing Number, Date or Time values, each field of this kind should be appended a prefix,
respectively "N__" if it contains a Number, "D__" for Date, "T__" for Time and "H__" for TimeStamp

Example of Value List :
where 'D__dateOfBirth' et 'T__visitTime' are text fields containing respectively Date and Time values

This Function use another simple one, allowing to reverse the alphabet for the descending order sort
**CustomFunction by Ugo Di Luca - DLSystems - may 2004**
Substitute( Upper(Texte); [ "A"; "z" ]; [ "B"; "y" ]; [ "C"; "x" ]; [ "D"; "w" ]; [ "E"; "v" ]; [ "F"; "u" ] ; [ "G"; "t" ]; [ "H"; "s" ]; [ "I"; "r" ]; [ "J"; "q" ]; [ "K"; "p" ]; [ "L"; "o" ]; [ "M"; "n" ]; [ "N"; "m" ]; [ "O"; "l" ]; [ "P"; "k" ]; [ "Q"; "j" ]; [ "R"; "i" ]; [ "S"; "h" ]; [ "T"; "g" ]; [ "U"; "f" ]; [ "V"; "e" ]; [ "W"; "d" ]; [ "X"; "c" ]; [ "Y"; "b" ]; [ "Z"; "a" ] )

When implementing this function, the calculation using this function would be used as the portal sort key. The parameter would be a global field and scripting a portal sort should be as simple as a 2 lines script.
Let ( [
P = Get ( ScriptParameter ) ;
S = Sort::gParameter ] ;
If ( Abs ( S ) = P ; -S ; P )) ]
Refresh Window [flush cache]

and the parameter associated to the button in each column would simply be the column number, either positive or negative second the sort order desired.

It would be advised that the global resides within the related Table so refreshing would occur within a self join relationship without even the need of a Refresh Window step.
Of course, involving an unstored calculation as the sort key could be problematical for long list of related records...

Note: these functions are not guaranteed or supported by Please contact the individual developer with any questions or problems.

This is my Custom Function and I want to edit it


There are no comments yet. Be the first to post a comment about this Custom Function! Please try to keep it brief & to the point. Anyone can post:

Your Name:
characters left. If you paste in more than 1500 characters, it will be truncated. Discuss the function - advertisements and other useless posts will be deleted.
Answer 4 + 2 =
Search for Custom Functions:

Custom Functions Widget
Download the Custom Function Dashboard Widget for OS X
Keep all the latest Custom Functions right at your fingertips!

Newest Custom Functions:

1. PreviousMonthEndDate ( myDate )
  (Wed, Mar 07, 3:35am)
2. PreviousMonthName (myDate)
  (Wed, Mar 07, 3:33am)
3. FmTableFields ( tableName ; fieldsInclude ; fieldsExclude ; classExclude ; typeExclude ; prefixExclude )
  (Fri, Mar 02, 6:32am)
4. sql.getTable ( fullyQualifiedFieldObject )
  (Thu, Feb 22, 8:36am)
5. sql.getField ( fullyQualifiedFieldObject )
  (Thu, Feb 22, 8:34am)
6. FilterOut ( ListA ; ListB )
  (Wed, Feb 21, 6:11pm)
7. Char0 ( )
  (Sun, Feb 18, 2:35am)
8. CreateVCardFile ( FirstName ; LastName ; CompanyName ; Phone ; Email ; WEB ; hAddress1 ; hAddress2 ; hZip ; hCity ; hCountry ; wAddress1 ; wAddress2 ; wZip ; wCity%2
  (Sun, Feb 18, 1:50am)

RSS Feed of Custom Functions