Creating a calculated dimension

You can create a calculated dimension from the Master items tab in the assets panel. The expression editor opens from the Create new dimensions dialog.

Do the following:

1. Click the Dimensions heading on the Master items tab to expand the category.

2. Click Create new.

   The Create new dimensions dialog opens.

3. Click 3 in the Field text box to open the Add expression dialog.

You will now be able to add expressions in different ways, depending on you preferences and of different levels of complexity.

Using a common function

1. Click the function you want to use.

2. Select a field from the drop-down list.

3. Click Insert to insert the function and the field into the expression editor.

   Tip noteYou can insert just a function or just a field by selecting only one of them.

4. Click Apply to close the Add expression dialog.

   For a measure, you continue by adding the descriptive data for the measure.

Adding an expression by typing

1. Type the expression directly in the expression editor.

   The field names you use in the expression are checked, and the syntax of the expression is validated.

   Tip noteAs you type in the expression editor, the expression is validated continuously. If there is an error, you see a hint about what is incorrect. Additional error information may be available by clicking the icon next to the hint.

   Each line in the expression editor is numbered and syntax highlighting is used.

2. Click Apply to close the Add expression dialog.

   For a measure, you continue by adding the descriptive data for the measure.

Adding an expression through the properties panel

You can add an expression to a visualization through the properties panel.

1. Open the sheet with the visualization that you want to edit.

2. Click @Edit to open the properties panel. (If it is hidden, click h in the lower right-hand corner to open it.)

3. Click the visualization that you want to edit.

4. Click Dimensions.

5. Click Add dimensions.

   A dimension text box is displayed.

6. Type your expression. The expression must begin with an equals sign (=), otherwise the string will be interpreted as text.

Detailed syntax help

You can open the online help with the full description of how to use the current function by double-clicking the function name in the expression editor and pressing Ctrl+H on the keyboard. This feature becomes available after having entered the first parenthesis of the expression after the function name.

Adding the descriptive data for the dimension

After having entered the expression, you need to add some descriptive information.

1. Type a name for the dimension.

2. Type a description for the dimension (optional).

3. Add tags (optional).

4. Click Add dimension.
5. Click Done to close the dialog.

The calculated dimension is now saved in the Dimensions category of the Master items, and you can use it in visualizations.