1. Home
  2. On-premises 5.2
  3. Guides
  4. Tours
  5. Concepts
    1. Aggregate filter
    2. Alias
    3. Apache Avro™
    4. Apache Kafka™
    5. Applied filter
    6. Base table
    7. Bookmark
    8. Business schema
    9. Business schema view
    10. Business schema view column
    11. Business schema view formula column
    12. Column
    13. Connector
    14. Dashboard filter
    15. Dashboard folder
    16. Dashboard runtime filter
    17. Data agent
    18. Data alert
    19. Data destination
    20. Date system variable
    21. Distinct filter
    22. Expression
    23. External data source
    24. External session variable
    25. Filter expression
    26. Filter expression session variable
    27. Filter option
    28. Formula column
    29. Formula expression
    30. Full load
    31. Global Variable
    32. Incorta Analyzer Table
    33. Incorta Analyzer Table column
    34. Incorta Analyzer Table formula column
    35. Incorta Analyzer View
    36. Incorta Analyzer View formula column
    37. Incorta SQL Table
    38. Incorta SQL View
    39. Individual filter
    40. Insight filter
    41. Internal query expression
    42. Internal session variable
    43. Join
    44. Join condition
    45. Join condition column
    46. Join filter
    47. Join filter column
    48. Level based measure
    49. Load filter
    50. Local data file
    51. Local data folder
    52. Materialized View
    53. Materialized View Column
    54. Materialized View Formula Column
    55. Measure filter
    56. Miscellaneous system variable
    57. Multi-Source table
    58. Physical schema
    59. Physical schema table
    60. Physical schema table column
    61. Physical schema table formula column
    62. Physical schema table runtime security filter
    63. Presentation variable
    64. Prompt
    65. Query system variable
    66. Runtime business view
    67. Runtime business view formula column
    68. Runtime security filter
    69. Session variable
    70. Shared Storage
    71. SQL Interface
    72. Upgrade Readiness
    73. Variable
    74. Visualization
  6. Tools
  7. References
  8. Integrations
  9. Data applications
  10. Releases

Concepts → Business Schema View Formula Column

About a business schema view formula column

For a Business Schema View, you can create an expression for a formula column using the Formula Builder. A formula expression has certain capabilities and limitations in a business schema view.

Using the Business Schema Designer, you can create a business schema view formula column by dragging and dropping New Formula from the Data panel into the canvas of the business schema view. These actions add a new business schema view formula column to the business schema view. From here, you can edit the properties of the business schema view formula column.

Properties of a business schema view formula column

Here are the properties of a formula column in a business schema view:

PropertyControlDescriptionConfiguration
Nametext boxEnter the formula column’s name; used in the fully qualified name of the columnValid characters: A-Z, a-z, 0-9, $, _
Name must begin with a letter character
Labeltext boxEnter a user friendly nameutf-8 md valid characters, including emoji 😀
Descriptionread onlyAdditional information for column, observable in the column details of the Analyzerutf-8 md valid characters, including emoji 😀
Functiondrop down listSelect the Incorta Function of the columnDimension or Measure
Set/Change FormulaFormula BuilderCreate or edit a formula expression.See Formula Builder
Note

A formula column that functions as a dimension will not appear in the list of runtime dashboard filters.

Business schema view formula column expressions

A formula expression returns a scalar value or array of values. These values are of a specific type. A formula expression can consist of:

  • referenced columns
  • built-in functions
  • variable

Referenceable columns in a business schema view formula column expression

A referenced column has a fully qualified name. Here are the possible types of referenceable columns in a business schema view formula column expression:

Reference SourceReference TypeReferenceableNote
Physical_Schema.Table.ColumnData-backedYes
Physical_Schema.Incorta_Analyzer_Table.ColumnData-backedYes
Physical_Schema.Incorta_Analyzer_Table.Formula_ColumnData-backed formulaYes
Business_Schema.View.ColumnData-backedYes
Business_Schema.View.Formula_ColumnRuntime formulaYes
Business_Schema.Incorta_View.ColumnData-backedNoValidation possible in the Formula Builder.
Runtime error in the Analyzer (Explore Data)
Business_Schema.Incorta_View.Formula_ColumnRuntime formulaNoValidation possible in the Formula Builder.
Runtime error in the Analyzer (Explore Data)
Note

Data-backed references data that persists to Shared Storage.

Supported built-in functions

A formula column in a business schema view can use the following built-in functions in a formula expression:

Function TypeDescriptionExamples
AggregationFunctions that accumulate data to a summary valueaverage, count, distinct, max, median, min, or sum
BooleanFunctions that evaluate to True or Falseand, between, contains, endsWith, in, inList, isNan, isNull, like, not, or, startsWith
Conditional StatementStatements that return a value based on the evaluation of a parametercase, decode, and if
ConversionFunctions that convert the Incorta Data Type of a parameter. In addition, functions that manipulate Timestamp and Date values for different return values.day, double, monthName, parseDouble, string, toChar, and year
FilterFunctions that specify a subset of data itemsfirstVersion or lastVersion
MiscellaneousFunctions with assorted usesdescendantOf, lookup, rowNumber, and schemaRefreshTime
ArithmeticFunctions that take one or more values and return a single valueabs, ceil, exp, floor, max, min, mod, rnd, round, sqrt, and trunc
DateFunctions that manipulate Timestamp and Date valuesaddDays, date, month, removeTime, weekday, and year
StringFunctions that return string values or return values based on string parametersbin, concat, find, ifNull, repeat, rTrim, and upper
AnalyticFunctions that compute values over a group of rows and returns a single result for each rowdenseRank, index, or rank

Variable references in formula expressions

In the Formula Builder, in the Functions and Variables panel, certain variables are referenceable in the formula expression. Some types of variables all users have access to and other kinds of variables are subject to Discretionary Access Control (DAC).

Here are the various categories of variables:

  • System Variables: Predefined variables within Incorta that return a value as a defined type.
  • External Session Variables: Variables that query an external data source when invoked. Values returned as string.
  • Internal Session Variables: Variables that query data within a schema. Values returned as string.
  • Global Variables: A static variable available to all tenant users that return a value as a defined type.

Formula expressions in a business schema view formula column can reference the following variables:

Variable TypeReferenceableNote
System VariableYes
External Session VariableYes
Internal Session VariableYes
Global VariableNoNot supported in 4.9 or earlier releases

Additional Considerations

There are additional considerations for a business schema view formula column in:

  • the Analyzer
  • an Insight

Business schema view formula columns in the Analyzer

When using the Analyzer, you can select and inspect business view columns in the Data panel. For a given column, select the Information icon in the right gutter. The Information dialog shows the:

  • Column Name
  • Source Column/Formula
  • Data Type
  • Function
  • Description
  • Sample Data
Note

The Information dialog shows the formula expression.

Business schema view formula columns in an Insight

A business schema view formula column in an Insight will enforce a defined aggregation in the formula expression. This means that a user cannot override the aggregation for the business schema view formula column in the Analyzer.

You can use a business schema view formula column as an applicable filter for an insight, including Individual, Distinct, and Aggregated filters.