For example, you can use ISFIRSTOCCURRENCE to prevent duplicates when creating lists from data.
ISFIRSTOCCURRENCE(Values to compare, List dimension to search)
|Values to compare||Number, Boolean, date, time period, list, or text||The values to search for the first occurrences of.|
|List dimension to search||List|
The list to search along for the first occurrences of the Value to find argument.
Must be a dimension of the target line item.
The ISFIRSTOCCURRENCE function returns a Boolean result.
Use ISFIRSTOCCURRENCE with the Users list
You can reference the Users list with the ISFIRSTOCCURRENCE function. However, you cannot reference specific users within the Users list as this is production data, which can change and make your formula invalid.
The ISFIRSTOCCURRENCE function references the order of the leaf list as seen in General Lists, not the parent list. This means that the first occurrence of an item may not be the first that displays in a list within a module. You can change the order of lists with the Order List action.
An artificial limit is imposed to prevent the searching of large data sets that would slow down the server. This limit is set at 50 million cells. If more than 50 million cells are used with the ISFIRSTOCCURRENCE function, the model rolls back and a notification displays.
The 50 million cell limit does not account for summarized values or the Time and Versions lists. This means you can use the ISFIRSTOCCURRENCE function with a line item with a Cell Count of greater than 50 million cells if there are less than 50 million nonsummarized cells.
As the number of cells you use with the ISFIRSTOCCURRENCE function increases, so does the duration of the calculation.
Calculation engine functionality differences
In Polaris, you can use the ISFIRSTOCCURRENCE function with the Time list. In the Classic Engine, you cannot.
Additionally, in Polaris, the ISFIRSTOCCURRENCE function does not have a 50 million cell limit as it does in the Classic Engine.
Related Anaplan functions
In this example, a Contracts list displays on rows, and line items on columns. The line items contain information about each contract, and the Is first occurrence? line item uses the ISFIRSTOCCURRENCE function to identify the first contract for each product.
Is first occurrence?
Example with expression for Values to compare argument
The Values to compare argument can be any valid expression. In this example, a Transactions list displays on rows, and line items on columns.
Each transaction has a fee subtracted from it. The ISFIRSTOCCURRENCE function is used to identify the first occurrence of each value after subtraction.
|Transaction value||Transaction fee|
First occurrence of transaction value