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 Alan: “Here is a list of functions available for creating new formulae [formulas]”
|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|
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
The reference entries use typefaces in the following way:
|italic||variable||var or $var|
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
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.
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
Below is an example reference entry. The fictional function being documented is called
FindMedia returns a book or movie recommendation given one or more themes.
FindMedia to get a recommendation for a movie title incorporating “neo noir” and “science fiction” themes.
FindMedia("film", "neo noir", "science fiction")
In this example,
FindMedia returns “Blade Runner”.
FindMedia(str media, string theme1, . . ., string themeN)
FindMedia takes a media type, media and one or more theme strings, theme1 …, and returns a title of type
string whose themes match those requested.
The media value can be “film” or “book”. Currently interactive media is not supported. The themeN values are restricted to a maximum of 7: theme0 … theme6.
FindMedia does not support negation of the media or themeN strings.
Note that when more than three theme strings are passed, performance will begin to degrade. Be patient if you need to pass more than three themes.