Skip to main content

Creating and Applying Units of Measurement

Many numeric attributes store values that only make sense with a unit — volume, pressure, mass, area, and so on.

Many numeric attributes store values that only make sense with a unit — volume, pressure, mass, area, and so on. A number without a unit is ambiguous and open to misinterpretation. The platform supports defining units of measurement centrally and applying them to numeric attributes, so that screens, processes, and reports all display values with appropriate unit labels.

Units are organised by Measurement Dimension — a grouping of related units. For example, a Volume dimension might contain litres, cubic metres, and gallons. You must create a dimension before you can add units to it.

A single attribute can only have one unit of measurement applied to it — all records in that attribute share the same unit. The platform does not perform automatic unit conversion. If conversion is needed between units, it must be handled explicitly in the Process Logic workbook.


Create a Measurement Dimension

  1. Open the Configuration application and navigate to the Units module.

  2. Open the Measurement Dimension screen.

  3. Click New.

  4. Enter a Name and Description.

  5. Enter an Audit Comment and click Save.

The dimension is now available for units to be added to it.


Create a Unit of Measure

  1. Select the relevant Measurement Dimension.

  2. In the Units panel, click Edit, then Add.

  3. Enter the Unit Name and Symbol.

  4. Enter an Audit Comment and click Save.

The unit is now available for assignment to numeric attributes.


Apply a Unit to an Attribute

When creating or editing an attribute, set the Type to Number (or Integer), then select the required Unit of Measure from the list. Once applied, the unit symbol appears in the object screen column header so users can see what unit the values are expressed in.


Units in Process Inputs

When configuring a Process Input, you can specify a Heading Location — a named range where the platform writes a two-row header into the workbook: one row for attribute business names and one row for unit symbols. This makes it easier to validate incoming data and handle unit conversion explicitly in workbook logic. See Process Inputs for how to configure this.


Design guidance

Assign a unit to every numeric attribute that represents a measurable quantity. Do not mix units across records in the same attribute — if your data contains values in different units, convert them to a single standard unit before storing them. Handle any conversion logic in a Process Logic workbook, not in the platform configuration. Reuse existing dimensions rather than creating duplicates.

Did this answer your question?