Creating a new component

In the Components Manager main page, by pressing the Add Component button you will create a new component by selecting the type.

Note that, the type cannot be changed once the component has been created.
There are different types, each one with a different purpose and complexity.

You can select among:

• FILTER: the simplest type of component you can define, it is used to format a data value into widgets.
  A filter can be used inside widgets (built-in and custom).

• CONTROL: a page button or a field that can be used to make the page interactive.
  A control component can be used to execute thing commands, update thing parameters or change inputs of other page widget.

• WIDGET: a page element displaying data through tables, charts, schemes and other.
  A widget retrieve the data from the DPS backend, transform and display values in a meaningful way to DPS users.

• TEMPLATE: a set of ready to use templates that can be referenced inside the View pages.
  A template can be shared across multiple environments and also projects, improving the configuration time.

Other than the type, you have also to provide the following information:

• Name: the name of the component, it will be visible in the Console, for instance in the template editor.

• Component ID: the unique identifier of the component, used by the system to install and keep the component updated.
  While you are free to change the name, the ID once create cannot be changed.

• Description: few words describing the purpose of the component, will be displayed in the console along with the name.

Once confirmed you are redirected to the Component Definition page, here you can configure the main aspect of the component and write the source code (JS and CSS) implementing the component UI.