Elements of a Page

This topic describes the various elements that you can add to a page and the settings that you can configure.

Elements

You can add UI elements of the following categories to a page:
  • Inputs: Contains UI elements that receive input from application users, such as a button, check box, drop-down list box, slider, toggle, and other elements.
  • Display: Contains UI elements that display information in the application, such as plain text, image, graph, map, table, and other elements.
  • Layouts: Contains UI elements that are used to create a layout in the page, such as a container, separator, new line, and repeater.
  • Tools: Contains UI elements that allow application users to upload an Excel worksheet to load data into an entity, upload a list of devices in a CSV format, or manage events.
  • Custom: Contains custom UI plug-in elements that have been uploaded by an application developer.

Settings

The following table describes the settings that you can configure for a UI element. This list is not comprehensive.
SettingDescription
ActionsThe action that should be triggered when the element is selected.
Allow ExportIndicates whether data that appears in the element can be exported. By default, this check box is cleared.
ConditionsThe condition based on which the element appears in the application. For example, you can create a condition that a control button or a warning image be displayed if the temperature recorded by the sensor exceeds 40 degrees Celsius.
DisabledIndicates whether you want the element to appear as disabled in the application.
False LabelThe label of the element that should appear when a toggle or an indicator is set to OFF.
First OptionThe first option that appears in an element of the type drop-down list box (for example, select an asset).
Global DataIndicates whether the value of the element is available globally for use by other elements or query inputs. This check box is enabled only after you specify an ID for the element.
HiddenIndicates whether the element should appear in the application. By default, this check box is cleared. You can configure hidden elements to appear when an action is performed.
IdThe name of the global variable that will be available if the Global Data check box is selected.
LabelThe label that will appear for elements such as check boxes and drop-down list boxes.
MaximumThe maximum value for an element that contains a range (such as a slider or a gauge).
MinimumThe minimum value for an element that contains a range (such as a slider or a gauge).
OptionsIndicates whether the values in the element are hard-coded or displayed dynamically from a query.
Range LimitThe range of values that application users can enter in the element.
RequiredIndicates whether it is always required to enter a value in the element that is used as an input to a query. By default, this check box is cleared.
Show <number> rows at a timeThe number of rows that can appear at a time in an element of the type grid.
Show onThe devices in which the element should appear. By default, the options Mobile, Tablet, and Desktop are selected.
SourceThe source from which data should be retrieved to initialize the element. If you are configuring the settings of an input element, you can select one of the following options:
  • Data: Fetches data that from a global variable or the output value of a query.
  • Manual: Allows you to enter a value manually.
  • Formula: Allows you to create a formula using global variables and the output values of a query.
If you are configuring the settings of a display element, you can select one of the following options:
  • Data: Displays data from a global variable or the output value of a query.
  • Manual: Allows you to enter a value manually.
  • Formula: Allows you to create a formula using global variables and output values of a query.
  • URL: Displays an image from a URL.
  • File: Allows you to upload an image for the element.
StackedIndicates whether the bars displayed in an element of the type graph should be stacked. By default, this check box is cleared.
StepThe step value used for a slider element.
StyleThe style of a meter-type gauge element.
Target DataThe query input that is the target for the value of the element.
TooltipsIndicates whether data in a table cell should contain tooltips displaying the content. By default, this check box is cleared.
True LabelThe label of the element that should appear when a toggle or an indicator is set to ON.
TypeThe data type of an input element. If you are configuring the settings of an element of the type graph or gauge, this field contains a list of graph or gauge types.
ValidationThe validations to be applied on the value entered in an input element. You can select the following options:
  • Capital: Select this check box if you want application users to enter a value only in uppercase.
  • Minimum character: Select this check box if you want to set a minimum character limit to values entered in the element, and then enter the number of minimum characters that application users must enter in the element.
  • Range Limit: Select this check box if you want to set the maximum and minimum values that can be entered in a numeric, date, or time input element.
WidthThe width of the element of the type toggle.
X-axis LabelThe label of the horizontal axis of an element of the type graph.
Y-axis LabelThe label of the vertical axis of an element of the type graph.