Dashboard Widget

The title of the widget is shown in the application runtime on the Landing Page and in the Dashboard Configuration area as follows:

• ❌  not set: the title is not shown on the Landing Page. The Dashboard Configuration area suggests the widget by its technical name, for instance, dashboard-widget1:
  
• Other options: the title can be a Static value, Localizable, or retrieved from the Model.

Optional short description of the widget that is shown to the users in the dashboard configuration area:

Description can be a Static value, Localizable, or retrieved from the Model.

help icon and tooltip for information displaying as:

• ❌  not set: help icon is not shown;
• Static value: manually entered text displayed in a pop-up window. The text of the prompted message  is edited in a standard text editor and can include plain text, headings, links, and lists;
• Localizable:  plain text specified per each available in the system locale. Shows appropriate localized help message according to the currently selected by the user language profile settings;
• Model: displayed data is retrieved from a specified data model field.

An icon of the widget is shown in the Dashboard Configuration area as follows:

• ❌  not set: widget has a default icon;
• Other options: choose an icon from the suggested Library, Model source, or Image URL.

If applicable, defines the elements' layout direction in the widget that contains more than 1 control descriptor:

• Vertical: elements are placed vertically
  
• Horizontal: elements are placed horizontally
  

Elements' horizontal alignment options:

• Default
• Start
• Center
• End
• Justify
• Spaced

Elements' vertical alignment options:

• Default
• Start
• Center
• End
• Stretch

Defines whether a widget will be available for the user.

Possible options:

• True: user has access to the widget
• False: widget is disabled 
• Model: allows dynamically define the widget availability conditions
• Not set: user has access to the widget

All available user widgets are shown in the dashboard configuration panel:

Availability does not define whether the widget is actually displayed or not on the Landing Page, but only provides access to the specified widget. Whether the available widget is shown is defined by the Initial Visibility property or user's personalized configuration.

Availability option can also hide the widget from the users who have configured personalization for this widget.

Defines the initial visibility state of the widget, until a user does a personalization.

• Selected: when the user opens a Landing Page for the first time the Dashboard Widget will be shown on the Landing Page.
• Disabled: the widget is not displayed on the Landing Page, but can still be accessed if the widget Availability is enabled. The user can run configuration option  to personalize the shown widgets.

For proper Initial Visibility configuration make sure the Availability property is configured as well.

In this case, a personalization is a configuration of the widgets that are displayed on the Landing Page. Personalized widgets example is as follows:

Personalized widgets example has the following options:

•  plus icon shows the widget on the Landing Page;
•  close icon hides the widget from the Landing Page. It is still available to the user but is not displayed;
• Reset to default: shows all widgets according to their Initial Visibility configuration;
• Revert to custom: is available only for the Landing Page with personalized widget configuration. Run this action to see personalized widgets on the Landing Page.

If the Landing page has the above-mentioned personalization, the Initial Visibility property value is ignored and the user sees only the widgets from the personalized configuration.

Available options:

• Selected: the widget area is not outlined with any background color and is displayed as a part of the layout
  
• Disabled: the widget area is outlined with the background color depending on the system Theme
  

This property allows improving user experience by managing device visibility options. For instance, the widget can be hidden from the layout when it is too large and contains a lot of data that cannot fit the small screen of a mobile device.

The application checks the user device's screen resolution and shows or hides the graphic element based on the selected check-box options settings:

• disabled: the widget is not displayed;
• selected (default): the widget is shown on the page.