The Number Box is a filtering element on the dashboard that is utilized to specify either a numeric value or a range of values. It serves to filter data for analysis elements within the viewer. This element can be positioned anywhere on the dashboard. Its width is capable of adjusting, either expanding or contracting, depending on the dimensions of the dashboard in the viewer.
 

 

 

This chapter will cover the following questions:

Number Box editor;

Switching Values;

List of properties.

 
The Number Box element can function only as the primary filter element among other filter elements, and it cannot rely on the values of other filter elements. The Number Box element can operate in the following selection modes:

Single. In this mode, a single numeric value is defined, and the filter is applied to the dashboard elements based on the value of the Condition parameter.

Range. In this mode, both the minimum and maximum numeric values are determined.
 
The configuration of the Number Box element takes place within its editor. To access the editor in the report designer, follow these steps:

Double-click on the Number Box element.

Select the Number Box element, then choose the Design command from the context menu.

 
 

The Number Box editor

In the Number Box editor, you can add elements with data, configure the value selection mode, and designate the primary filtering element.
 

 

The Value field designates the data element whose values will be utilized for data filtration.

The Field displays the expression of the selected data field for the element.

The Selection Mode parameter determines the operating mode of the filtering element. The following values are available for selection:

Single. In this scenario, an initial value is specified, and the filtering of these elements in the indicator panel will be conducted based on the Condition parameter.

Range. In this scenario, it will be possible to establish both the minimum and maximum values, which will constitute the range of values for filtering these dashboard elements.

 

The Condition parameter is accessible only when the Single mode is chosen. The value of this parameter represents a logical operation that determines the extension of the value range from the current one. For instance, if "Greater than…" is selected, the element's default range will encompass all values greater than the current value of the element.

The Initial Value parameter is utilized to designate a starting value for the Number Box element. In single mode, only one value can be specified, whereas in range mode, both minimum and maximum values can be provided. If the parameter value is left unspecified, the initial value will default to the minimum value from the data element.

The Minimum/Maximum value parameter is used to restrict the range of valid values that can be entered into the Number Box element. By default, the Auto mode is utilized, meaning the range of valid input values is automatically calculated based on the specified data. In the Custom mode, you have the option to manually define the minimum and maximum values permissible for input in the Number Box element.

 

 

Switching Values

When viewing the dashboard, you can input values into this element, paste them from the clipboard, or use controls to switch them. When using controls to switch values, an essential consideration for data filtering is the switching step. By default, the toggle step is an integer that increments or decrements by one. Nonetheless, if you wish to make fractional adjustments, you need to modify the value of the Decimal Digits property.

 

The value of this property indicates the quantity of decimal places. By default, the property value is 0, signifying a whole number. The switching step is defined by the smallest digit. Put differently, for example, if the Decimal Digits property is set to 1, the switching step will involve decimal values. If the Decimal Digits property is set to 2, the step will involve hundredths, and so forth.

 

 

List of properties
The list below contains the name and description of the properties of the Number Box element, which you may find on the properties panel of the report designer.