Create or edit a component and its datapoints in Boss’nX

The Boss’nX component form brings together the name, type, location (building, floor, zone), gateway and the list of datapoints, KNX or other protocols. It is used to create a component or edit an existing one, in a supervision opened directly or from the hypervision.

Intended for administrators and installers with Manage components. The steps below describe the form on a computer.

Before you start

• Your account has Manage components. Viewing or command-sending rights do not replace this editing right.
• Prepare the name, the location, the gateway and the parameters of the datapoints to configure.
• To start from an existing item, you can also duplicate a component and organize its datapoints.

Open the form

1. In the relevant supervision, open Components in your bar or through Menu → Components. On a tablet or phone, the bar and Menu are at the bottom of the screen.
2. Check the title Component Management.
3. To create one, click Add component, at the top. The title becomes Create component.
4. To edit one, find the right card with the Components filters, then click its Edit component pencil, at the top right. The pencil is also available in the detail sheet, to the right of the name. Wait for Loading component… to finish, then check the loaded values.

At creation, the suggested name and type do not describe your device: replace them with the appropriate values.

Fill in the general parameters

Field	What to do
Component name	Give a non-empty, recognizable name, for example Test ventilation, a fictional example.
Type	Choose the category that matches the component. It does not replace the choice of the protocol of its datapoints.
Building	Select the building part you want, or leave All buildings to choose among the available floors. This selection filters the floors.
Floor	Choose the actual floor rather than the first floor displayed. Unassigned is offered if you are preparing a component without assignment to a floor.
Zone	Choose a zone of this floor. Floor root corresponds to an assignment directly to the floor, without a zone. The list is greyed out if no zone is offered.
Gateway	Choose the gateway planned for the component. None lets you prepare the parameters without choosing a gateway; the Gateway memo to install (optional) field is then used as a note, without creating or attaching a gateway.
Favorite	Check to use this component among the favorites. See dashboard favorites.
Integrator comment	Add, if useful, a configuration note intended for the people who edit the component.

The building, floor and zone lists let you search and then select a result. After changing the building or the floor, check the floor and the zone again: incompatible choices may be replaced or cleared.

Before moving an existing component to another zone, check the rules of the original zone that use it: rules left without a reference in this zone may be removed during the move. Then check with the installer the expected uses in the old and the new zone.

If you change the component’s Gateway, also check the specific gateways of its KNX datapoints: see inheritance and choice per datapoint.

Add the datapoints

1. Click Add point, under the list of datapoints.
2. Fill in its Label, choose its protocol and configure the fields that match its use with the help of the table below.
3. Leave the last field you entered, then review the values before saving.

Need	Guide to follow
KNX datapoint	Configure the addresses and the DPT, then the formats and commands
BACnet datapoint: device and object	BACnet datapoints
Modbus datapoint: registers and no-signal check	Modbus datapoints
Trigger linked to an action or a scenario	Configure a Linknx datapoint
Several datapoints already available, through the Import menu	KNX, BACnet or Modbus from monitoring import
Alarm datapoint	Thresholds and lists, simple comparison and heartbeat, BACnet source and troubleshooting

The paths of the Import menu depend on the addresses and devices already configured.

Save the component

1. Click Create for a new component, or Save for an edit. This button is fixed at the bottom right; Saving… indicates the operation in progress.
2. After success, the interface returns to the original page, for example the component list or the detail sheet.

To abandon the pending changes, use Back, the arrow at the top left, before saving. This button does not undo a change that has already been saved: to correct it, reopen the form and save the corrected values.

Check the result

1. Find the component, reopen Edit component, then review its name, its location, its gateway and its datapoints.
2. Then check the expected display and operation in the supervision, following the installation’s procedure. Communication with the hardware is checked on the installation, not by saving the form alone.

Troubleshooting

Message or symptom	Action
Name is required.	Fill in Component name.
Label is required, Feedback address required, Command address required	These errors indicate the datapoint concerned. Correct the fields that match the functions enabled on this datapoint. Closing the error summary does not correct them.
Unable to fetch gateways.	Check the supervision and your connection, then reopen the form. Do not replace a known gateway with None just to work around this message.
Restricted access or missing pencil	Have the administrator check Manage components and the account’s scope.
Form still open after Create or Save, without a clear result	Do not consider the save as done. Note the visible messages and keep the useful parameters. Reopen the list to check whether the component exists and which parameters were saved, before starting again or creating a duplicate.

If the uncertainty persists, contact support@can-nx.com with the supervision, the component name, the attempted action and your checks, without a password, access key or confidential data.

French labels: Composants → Gestion des Composants → Ajouter un composant, Modifier le composant, Menu, Nom du composant, Type, Bâtiment, Étage, Zone, Passerelle, Aucune, Favori, Commentaire de l’intégrateur, Ajouter un point, Créer, Enregistrer, Sauvegarde…, Retour, Tous les bâtiments, Non assigné, Racine de l’étage.