Creating a new component

Prev Next

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 widgets.

  • WIDGET: a page element displaying data through tables, charts, schemes, and other forms.
    A widget retrieves the data from the DPS backend, transforms it, and displays 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 projects, improving the configuration time.

Other than the type, you also have 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 created cannot be changed.

  • Description: A 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, where you can configure the main aspect of the component and write the source code (JS and CSS), implementing the component UI.