FileMaker Value List Calculation Simulator

A tool for developers to test and understand how to use a value list in a calculation.

GetValue() Function Simulator

Value List Items

Item Number	Value

What is a FileMaker Use Value List in Calculation?

In FileMaker Pro, a “value list” is a pre-defined set of values used to speed up data entry and ensure consistency. While they are most often attached to fields as dropdown menus or radio buttons, their contents can also be used directly within calculation formulas. To use a value list in a calculation means to programmatically access, parse, or retrieve a specific item from that list of values. This is a core concept for creating dynamic and intelligent database solutions.

The primary function for this purpose is GetValue(listOfValues; valueNumber). This function takes a list of text values separated by carriage returns and retrieves the specific item designated by the item number. Our calculator above provides a direct simulation of how this function operates, allowing you to see results in real-time. This is fundamental for anyone working with a FileMaker calculation field.

The GetValue Formula and Explanation

The core formula for extracting a value from a list is surprisingly simple:

GetValue ( yourValueList ; itemNumber )

This formula is the heart of what developers do when they need to programmatically use a value list in a calculation. It treats a block of text with line breaks as an ordered list and lets you pick out any single piece of it.

Variables Table

Variable	Meaning	Unit (Data Type)	Typical Range
yourValueList	A text string where each value is separated by a carriage return (¶). This can be a hardcoded list, a field reference, or the result of the ValueListItems() function.	Text	Any text, from a few items to hundreds.
itemNumber	The position of the value to extract from the list. The first item is 1, the second is 2, and so on.	Number (Integer)	1 to N, where N is the total number of items in the list.

Practical Examples

Example 1: Retrieving a Status

Imagine a value list named “Status” containing “Pending”, “Active”, “Completed”, and “Cancelled”. You want to get the second status.

• Inputs:
  • Value List: “Pending¶Active¶Completed¶Cancelled”
  • Item Number: 2
• Formula: GetValue ( "Pending¶Active¶Completed¶Cancelled" ; 2 )
• Result: “Active”

Example 2: Dynamic Category Assignment

A product’s SKU is “FR-003”. The first part (“FR”) indicates the category. You have a value list of category codes (“EL”, “FR”, “BK”) and a corresponding value list of full category names (“Electronics”, “Fruit”, “Books”). You can find the position of “FR” in the first list to retrieve the correct name from the second list.

• Inputs:
  • Value List: “Electronics¶Fruit¶Books”
  • Item Number: 2 (Determined by finding the position of “FR” in another list)
• Formula: GetValue ( "Electronics¶Fruit¶Books" ; 2 )
• Result: “Fruit”

This demonstrates a key aspect of advanced FileMaker scripting, where data from one source informs a calculation on another.

How to Use This FileMaker Value List Calculator

This tool simplifies understanding the GetValue function without needing to open FileMaker.

1. Enter Your Value List: In the “Value List” text area, type or paste the items you want in your list. Each item must be on a new line.
2. Set the Item Number: In the “Item Number to Retrieve” field, enter the position of the value you wish to extract. For example, to get the first item, use 1.
3. View the Results: The calculator updates in real-time. The “Primary Result” box shows the direct output of the simulated GetValue function. The details below provide context, such as the total item count and status.
4. Analyze the Table: The table below the calculator automatically numbers your list items, making it easy to see the relationship between item number and value.

Key Factors That Affect Value List Calculations

• Carriage Returns: The function is entirely dependent on carriage returns (the ‘Enter’ key) as delimiters. A list pasted with commas or other separators will be treated as a single item.
• 1-Based Indexing: Unlike many programming languages that use 0-based arrays, FileMaker’s GetValue starts counting from 1. Requesting item 0 will result in an empty string.
• Out-of-Range Numbers: If you request an item number greater than the total number of items, the function returns an empty string. Our calculator displays an “Out of Range” error to make this clear.
• Data Source: The performance can be affected by where the value list comes from. A custom, hard-coded list is fastest. A list based on field values across a large, un-indexed table can be slower. Check your database performance if you notice a lag.
• Conditional Value Lists: The contents of a value list can change based on other data. This makes calculations that use them incredibly powerful, but also means you must account for the list’s content at the exact moment the calculation fires.
• Empty Lines: An empty line in your list is a valid value! GetValue will return an empty string if you request the number of a blank line, which can be a source of bugs if not anticipated.

Frequently Asked Questions (FAQ)

1. What’s the difference between GetValue() and ValueListItems()?

ValueListItems("fileName"; "valueListName") retrieves the entire list of items from a named value list in your database file. GetValue() works on any return-delimited text, including the output of ValueListItems(), to get just one specific item.

2. How can I get the total number of items in a list?

Use the ValueCount(listOfValues) function. It returns an integer representing the total number of carriage-return separated values.

3. Can I use this for a list with commas instead of line breaks?

Not directly with GetValue(). You would first need to use the Substitute(yourText; ","; "¶") function to replace the commas with carriage returns.

4. Why am I getting an empty result?

There are three common reasons: 1) The item number you requested is higher than the number of items in the list. 2) The line corresponding to your item number is genuinely blank. 3) The text you are using as a list does not contain any carriage returns. For more, see the common pitfalls.

5. Is there a way to find a value and get its number?

There isn’t a direct native function for this (a “ValuePosition” function). It requires a custom function or a looping script that checks each value with GetValue() until a match is found.

6. How does this relate to the FileMaker use value list in calculation?

This is the primary method. The phrase ‘use value list in calculation’ almost always implies using functions like GetValue(), ValueCount(), and FilterValues() to manipulate list data programmatically.

7. Can the value list source itself be a calculation?

Yes, but it’s complex. You can create relationships and calculation fields that generate a return-delimited list, and then base a value list on that field. This is an advanced technique for highly dynamic scenarios.

8. What happens if my text has extra spaces?

GetValue() retrieves the value exactly as it is, including any leading or trailing spaces on that line. You may need to wrap the result in the Trim() function to remove them.