When you are working with an app, you can create master measures so that they can be reused. You can easily create a measure using one of the most common aggregation functions by selecting the function and the field from drop-down lists.
When naming an entity, avoid assigning the same name to more than one field, variable, or measure. There is a strict order of precedence for resolving conflicts between entities with identical names. This order is reflected in any objects or contexts in which these entities are used. This order of precedence is as follows:
Inside an aggregation, a field has precedence over a variable. Measure labels are not relevant in aggregations and are not prioritized.
Outside an aggregation, a measure label has precedence over a variable, which in turn has precedence over a field name.
Additionally, outside an aggregation, a measure can be re-used by referencing its label, unless the label is in fact a calculated one. In that situation, the measure drops in significance in order to reduce risk of self-reference, and in this case the name will always be interpreted first as a measure label, second as a field name, and third as a variable name.
Do the following:
-
Click
Edit sheet in the toolbar. The assets panel opens on the left-hand side.
-
Click
Master items in the assets panel. -
After Measures, click Create new.
-
Click
in the Expression field to open the Add expression dialog.You find drop-down lists for selecting a field and a common function on the right-hand side.
- If you want to show fields from a particular table, select this table in the top drop-down list (optional).
- Select a field from the Field drop-down list.
-
Select a function from the bottom drop-down list.
Tip noteYou can insert just a field by not selecting a function. -
Click Insert to insert the field and the function into the expression editor.
Tip noteYou 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, and only when using a computer with a keyboard. -
Click Apply to close the Add expression dialog.
Now you need to add some descriptive data for the measure.
-
Type a name for the measure.
-
Type a description for the measure (optional).
If you do not add a description and then link a glossary term to your master item as a definition, the term definition will be used in the description.
-
If you want to specify a color, click
in the color drop down and select a color through one of the following methods:- Click one of the colors in the palette.
- Type a 6 character color code in the Hex input field.
- Click
at the bottom of the dialog, select a color in the color wheel, and optionally adjust the saturation slider.
-
Add tags (optional).
-
Optionally, if you have access to a glossary, link the measure to a glossary term.
-
Under Number formatting, you can choose:
- Auto
- Number
- Money
- Date
- Duration
- Custom
- Measure expression
- Click Create.
The measure is now saved in the Measures category in the master items, and you can use it in visualizations.
Considerations
A master measure is a type of master item. When working with master items, consider the following:
-
Master items can only be viewed, edited, created, and deleted when editing a private sheet. You cannot perform actions on master items from a public or community sheet.
-
Depending on your permissions, your access to master items might be limited. For example, you might be able to view the master items in an app but not create, edit, or delete them. For more information about how permissions affect actions on master items, see Permissions for working with master items.
-
You cannot create, edit, or delete the master items of a published app. Instead, perform these actions in the source app and then re-publish the app to the managed space.
Permissions
For more information about the required permissions for creating master measures, see Permissions for working with master items.