Chart On-screen Settings

Parameters of measures, dimensions, columns and analyzed objects can be defined as on-screen settings, bringing the settings easily available in the dashboard (above the chart). When the commonly used settings are defined as the on-screen settings, the settings dialog doesn't need to be opened at all.

Configuration

On-screen settings are defined as a JSON array, where each item has the following properties:

• type: Either measure, dimension, eventtypemeasure (for Event measures in flowchart), flowmeasure (for Flow measures in flowchart) or root. If slicing into dimensions is disabled, columns correspond to dimensions.
• index (integer): Index of the expression. Not used for the root.
• parameter (string): Name of the parameter.
• label (string): Custom label for the field.
• maxWidth (integer): Maximum width of the shown setting in pixels.
• newLine (boolean): Defines whether the setting is positioned to a new line for more spacing between settings.
• exclude (string array): List of values that are hidden from the dropdown list showing model objects.
• excludeCaseIdColumn (boolean): When showing case or event attribute, this setting will hide the case id column from the list. Use value true to hide the case id.
• includeChartFilters (boolean): With a dropdown list showing model data, this setting determines whether the list content is filtered with the chart filter rules. For example, the shown case attribute values may be filtered with the chart filters, or the chart filters can be ignored.
• includeOnly (string array): This setting filters the shown dropdown list values by explicitly specifying the shown values.
• allowedDatatypes (string array): This setting filters shown case and event attributes in the dropdown list by explicitly specifying the attribute datatypes which are shown. Allowed values: String, Integer, Float, DateTime, and Boolean.
• showStatistics (boolean): When the value is true, the dropdown list for model objects (such as case/event attributes, event types, variations, flows, etc.) shows also statistical data for the objects, such as counts and percentages. This setting is optional, and the default value is true, except for case and event attribute lists in Snowflake models, for which the default value is false.

Custom On-screen Settings

In addition to the measure/dimension/column parameters, it's also possible to define custom on-screen settings, i.e,. settings that are not based on any existing chart setting. For example, when using custom expressions, it's possible to define parameters for them as on-screen settings. To do that, there are additional properties to be set that define which kind of UI control is used. The following parameters can be used:

• control (string): UI control type which is one of the following: singleselectlist, dynamicsingleselectlist, multiselectlist, singlelinetext, multilinetext, numericfield, datefield, datetimefield, checkbox, colorpicker, bpmneditor.
• mandatory (boolean): Defined that the UI control is mandatory, i.e. the chart is not drawn until a value has been specified.
• updateImmediately (boolean): Specifies whether the chart is updated right away when the value is being changed. When disabled, the value updated only when cursor leaves the input box or the dropdown list is closed. Applicable only for the controls singlelinetext and multiselectlist.

For numericfield:

• minValue (number): Specifies the minimum allowed numerical value that can be inputed to the numerid field.
• minValue (number): Specifies the maximum allowed numerical value that can be inputed to the numerid field.
• decimals (integer): Specifies whether decimal numbers can be specified (or only integer numbers).
• unit (string): Specified unit is shown next to the numerical value.

For singleselectlist:

• options: List of options the dropdown list. Specified as an array of object with following properties:
  • label: User visible text in the dropdown list.
  • identifier: Actual stored value to the parameter.
• optionsData (string): Defines type of items shown by the dropdown list. One of the following: AggregateNumbers, AggregateDates, AggregateDurations, AggregateDurationsWithoutNulls, AggregateText, SqlAggregateNumbers, SqlAggregateDates, SqlAggregateText, TimeUnits, DurationUnits, Periods, CountOrPercentage, CountOrPercentageCases, CountOrPercentageEvents, NumericalComparison, EventIndex, FlowStartEndEvent, DataTypes.

For dynamicsingleselectlist and multiselectlist:

• dynamicType (string): Defines type of items shown by the dropdown list. One of the following: CaseAttributes, CaseAttributeValues, EventAttributeValues, EventAttributes, EventTypes, Variations, FlowsStartingFrom, StartEventTypes, EndEventTypes, CaseIds, DataTables, DataTableColumns, DataTableColumnsByDatatableName, AnalysisColumns, DataTablesOfProject, Models, ModelById, Projects, Scripts.

It's also possible to change UI controls for the standard expressions, by overriding UI control settings in the on-screen settings. All above mentioned parameters can be used, except the the UI control type cannot be changed (i.e. the control parameter cannot be used).

Examples

[
  {
    "type": "dimension",
    "index": 0,
    "parameter": "Attribute",
    "maxWidth": 500
  },
  {
    "type": "dimension",
    "index": 1,
    "parameter": "Period",
    "label": "Time"
  }
]

Creates a custom numeric field, where minimum value is 1 on decimals are allowed:

[
  {
    "type": "measure",
    "index": 0,
    "parameter": "var1",
    "maxWidth": 200,
    "control": "numericfield",
    "decimals": 2,
    "minValue": 1
  }
]

This example creates a custom dropdown list with predefined options:

[
  {
    "type": "measure",
    "index": 0,
    "parameter": "var1",
    "maxWidth": 200,
    "label": "Select option",
    "control": "singleselectlist",
    "options": [
     {
       "label": "Option 1",
       "identifier": "option1"
     },
     {
       "label": "Option 2",
       "identifier": "option2"
     },
     {
       "label": "Option 3",
       "identifier": "option3"
      }
    ]
  }
]