Skip to main content

Number Control

The Number control captures one numeric reading, such as a temperature, a pressure, a weight or a meter reading.

It consists of a label, a box for the reading, and optionally a unit shown beside the box and an expected range shown beneath it. Use it whenever the answer is a measurement or a count, so that CheckFlow can compare it with limits, branch on it and filter reports by it. For an answer that only looks like a number — a serial number, a phone number, a reference — use the Short Text control instead.

Add to the Template​

The Number control can be added from the controls toolbar in the Template. It is listed among the input controls, below Long Text.

Once you have added the control you must set the label text that will be displayed above the box. The label is required — it is also the name used to identify the control elsewhere in CheckFlow, such as in reports and dynamic values.

The settings sit in one row beneath the label. All of them are optional.

Unit​

What the reading is measured in — for example °C, kPa, kg or mm. The unit is shown beside the box in the checklist, and after the reading wherever the reading is written out as text, such as in reports and the activity feed.

The unit is only ever displayed. It is never compared, converted or checked.

Minimum and Maximum​

The expected range for the reading. Set either, both or neither.

Both limits are inclusive, so a reading equal to the Minimum or the Maximum is in range. A reading outside the limits is still saved — it is flagged as out of range, not refused. See Use in the Checklist.

You can type a limit with a point or a comma for the decimal mark. It is stored with a point. The template cannot be saved while a limit:

  • is not a number, or contains a thousands separator;
  • has more than 9 digits before the decimal point or 6 after it;
  • has more decimal places than the Decimal places setting allows;
  • makes the Minimum greater than the Maximum.

The reason is shown beneath the settings row, and repeated in the Cannot Save message when you save.

Decimal Places​

The Decimal places select sets how precise a reading is. Choose Any, or a number from 0 to 6. The default is Any.

  • With a number of places set, a reading with more places than that is refused, and a reading with fewer is padded with zeros once the user leaves the box — with 2 decimal places, 7 becomes 7.00.
  • With 0, only whole numbers are accepted.
  • With Any, a reading can have up to 6 decimal places and is not padded.

Required​

Tick the Required checkbox if the user must enter a reading before the parent task can be completed.

Populating from a Data Set​

The Number control cannot be linked to a Data Set. Only the Dropdown, Multi-Choice, Sub-Tasks and Table controls can be.

It can, however, be filled from a Number field of the record a user selects in a Dropdown control that is linked to a Data Set. That is a binding rather than a link — see Dynamic Values and Parameters.

Use in the Checklist​

The user sees the label with a box beneath it, and the unit beside the box if you set one. When the control has a Minimum or Maximum, the expected range is written beneath the box — for example Expected 0.00 to 5.00 °C, Expected at least 0 °C or Expected at most 5 °C.

The user types the reading. They can use a point or a comma for the decimal mark, so 7.5 and 7,5 are the same reading. Thousands separators are not accepted: an entry such as 1,234, which could mean either 1234 or 1.234, is refused with a message asking the user to enter it without a thousands separator or with a point for the decimal mark. An entry such as 0,125 or 12345,678 can only be a decimal, and is accepted.

The entry is checked as it is typed, and the reading is saved once the user leaves the box. An entry that cannot be taken is never saved — the reason is shown beneath the box instead (see Validation). The control records who last changed the reading and when.

Out-of-Range Readings​

A reading below the Minimum or above the Maximum is saved like any other, and flagged:

  • the box gets a red border, and Out of range is shown beneath it with a flag;
  • a red flag appears on the task's row in the task list, and beside the task's name above its controls, with the tooltip A reading in this task is out of range.

The task flags follow the readings as they are typed, and only count controls that are showing — a Number control hidden by a Conditional Logic rule does not flag its task. The flag is worked out from the reading and the limits each time, so correcting the reading removes it.

An out-of-range reading never prevents the task from being completed. To stop the process when a reading is out of range, use a rule — see Conditional Logic.

The control works the same way on a shared checklist and in the task panel of the Tasks grid.

Validation​

When a Number control is marked as required, validation is performed when the user completes the task. The task cannot be completed until a reading has been entered. A reading that is out of range is still a reading, so it satisfies Required.

Validation error messages are shown below the box.

If you try to complete a task outside of the checklist (e.g. from the Dashboard) and it fails validation we will notify you of the validation failure via a pop-up message.

Separately from Required, an entry that cannot be taken as a reading is refused as it is typed, whether or not the control is required. Nothing is saved, and one of these messages is shown beneath the box:

MessageShown when
Enter a number, such as 7.5The entry is not a number.
Enter a whole numberDecimal places is 0 and the entry has a decimal part.
Use at most 2 decimal placesThe entry has more decimal places than the control allows. The number matches the setting.
Use at most 9 digits before the point and 6 after itThe entry is too large, or too precise for any Number control.
Is that 1234 or 1.234? Enter it without a thousands separator, or with a point for the decimal markThe entry has a comma that could be a thousands separator or a decimal mark.

Conditional Logic​

The Number control can be the source of a Conditional Logic rule. It has the widest set of operators of any control, including two that read the control's own limits. The available operators are:

OperatorMeaning
isThe reading equals the value. 5, 5.0 and 5.00 are the same value.
is notThe reading is not the value, or there is no reading.
has no valueNo reading has been entered.
has any valueA reading has been entered, in range or not.
is greater thanThe reading is above the value.
is greater than or equal toThe reading is the value or above it.
is less thanThe reading is below the value.
is less than or equal toThe reading is the value or below it.
is out of rangeThe reading is below the control's Minimum or above its Maximum. Takes no value.
is in rangeThere is a reading, and it is within the control's limits. Takes no value.

When you build the rule, type the value with a point or a comma for the decimal mark — it is stored with a point. A value that is not a number is refused with Enter a number, such as 7.5. Readings are compared as numbers, never as text.

Points to know:

  • is out of range and is in range use the control's own Minimum and Maximum, so changing a limit changes what the rule means. A control with no limits is never out of range, so is in range is met by any reading.
  • With no reading, only has no value and is not can be met. A control with no reading is neither out of range nor in range.

A common pattern is a required Number control with an expected range, and a rule that shows a corrective-action task — or a halt task that stops the checklist — when the reading is out of range.

A Number control can also be the target of a rule, so it can be shown or hidden by a condition driven by another control.

Dynamic Values and Parameters​

The reading captured in a Number control can be reused elsewhere in the checklist as a Dynamic Value:

  • As text — in a Text or Mail-To placeholder, the Default Checklist Name of a Linked Checklist, or a Short Text or Long Text control bound to it — the reading is written padded to the control's decimal places, followed by a space and the unit: 7.50 °C. Until a reading is entered, a placeholder shows its token.
  • As a number — another Number control bound to it takes the reading itself.

The control can also receive a dynamic value, through a Dynamic Value Binding set from the control's Content Settings cog. A Number control can be bound to:

  • another Number control in the same checklist;
  • a Number field of the record selected in a Dropdown control that is linked to a Data Set;
  • the global values Current Month and Current Year, which are resolved when the checklist is created.

Other controls, such as a Short Text control, cannot fill a Number control. The control does not accept inline {{placeholder}} tokens.

The control can also be bound to a Template Parameter of type Number or String, so it is pre-filled when the checklist is created. A String parameter's value must be written with a point for the decimal mark and no thousands separators — for example 7.5 or -18.

Whatever fills the control — another control, a Data Set field, a global value, a parameter or a linked checklist — the same rules apply:

  • A value with more decimal places than the control allows is rounded to them, half away from zero: 12.345 into a control with 2 decimal places becomes 12.35, and -12.345 becomes -12.35. A control set to Any takes up to 6 decimal places.
  • A value that is not a number, or is too large for a Number control, is left out, and the control keeps the reading it had.

Only a reading the user types is refused for having too many decimal places. A value copied in from elsewhere is rounded, because there is nobody to tell.

Linked Checklists​

A Number control can be either side of a Linked Checklist control mapping, so a reading captured in a parent checklist can be carried into the child checklist it creates.

  • Number to Number — the reading is copied, rounded to the child control's decimal places.
  • Number to a text control — a Short Text, Long Text or Text child receives the reading as text with its unit, such as 7.50 °C.
  • A text control to Number — the child is filled only when the parent's answer is a number written with a point for the decimal mark and no thousands separators.
  • Default Value — for a Number child, the mapping's Default Value must be a number written with a point, such as 7.5 or -18. The Template Designer says so beneath the box and will not save the template until it is.

Reporting​

Number answers are available in Reports and can be added as a column. Each cell shows the reading padded to the control's decimal places, with its unit. A reading that is out of range is shown in red with a flag.

A Number column is filtered with the Number filter — Is Greater Than, Is Less Than and the rest — and the filter value can have decimals.

Control columns are only available in a report when a single template is selected. Add the column from the Columns dropdown, under Tasks & Fields. See Report Columns.

Limits​

LimitValue
Digits before the decimal point9
Digits after the decimal point6
Decimal places settingAny (up to 6), or 0 to 6
Unit50 characters
Minimum and MaximumThe same 9 and 6 digit limits, no more decimal places than the control allows, and the Minimum no greater than the Maximum
Number formatA point or a comma for the decimal mark. No thousands separators, no exponents.

Notes and Limitations​

  • Out of range is a flag, not a rule. It never refuses a reading and never blocks completion. If an out-of-range reading must stop the process, build that with Conditional Logic.
  • Every change to the reading is recorded in the activity feed with its unit, and an out-of-range reading says so — for example updated number 'Fridge Temperature' value to '7.50 °C', outside 0.00 to 5.00 °C.
  • The print view shows the reading with its unit, the expected range, and Out of range when it applies.
  • Conditional Logic — showing a corrective-action or halt task when a reading is out of range.
  • Dynamic Values — reusing a reading elsewhere, and filling this control from another Number or a global value.
  • Template Parameters — setting a reading when the checklist is created, with a Number parameter.
  • Report Filters — finding checklists by reading with the Number filter.
  • Control Types — the capability matrix for every control.