You are viewing content for 5.0 | 4.9 | 4.8 | 4.7 | 4.6 | 4.5 | 4.4 | 4.3 | Previous Releases

Formula Functions

Overview of Formula Functions

Incorta provides the ability to create new formula columns in the business schema view or within an insight on a dashboard using a comprehensive library of formula functions.

Here is a list of supported functions when creating a new formula:

Group Description
Aggregation Functions Summarize the contents of a column of data
Boolean Functions Evaluate one or more expressions and return a boolean value
Conditional Statements Evaluate and return the results of an expression depending on the result of evaluating a boolean expression
Conversion Functions Converts values from one type to another
Filter Functions These functions are used to filter data to those items before or after a specified date. It is also possible to filter the data in groups
Miscellaneous Functions Various functions for finding values in table hierarchies, setting schema refresh interval and determining the row number in a query
Arithmetic Functions Perform math operations on values
Date Functions Adjust values of type date or timestamp
String Functions Convert, truncate and search within text strings

How to Read Formula Function Reference Entries

Formula Function reference entries contain sections:

• Example(s) : includes a verbal description of a problem followed by how the solution looks in Incorta
• Syntax : the function prototype
• Notes : description of operation, context, details to pay attention to, limitations

Typefaces

The reference entries use typefaces in the following way:

Format Meaning Example
italic variable var or \$var
bold constant true
fixed code phrase `FindMedia(op_count,location)`

Expressions

Formula functions take expressions as well as literals as arguments. For example, a column called x might contain strings which are actually numbers: “45.6”, “77.12”, “45.91”, … To find the average of the values in that column requires the strings be converted to numeric scalars. The formula function `double` does this. You could then write `average(double(x))`. In this case, an expression is passed to `average`.

Reference entries describe expressions using the `expr` keyword. For example, `double expr` means “expression evaluating to `double`”. More generally, `<type> expr` if more than one Incorta type can be passed as an argument. Square brackets `[]` indicate an Array of values such as `double[] expr`.

Incorta Types

Incorta types have the same characteristics as the Java types. They are:

• `string` — series of characters
• `date` — contains month, day and year
• `timestamp` — contains month, day, year and time
• `int` — 32 bit signed integer type
• `long` — 64 bit signed integer type
• `double` — 64 bit floating point type