Place datapoints and component cards in a Boss’nX schema

In the Boss’nX schema editor, the Datapoints palette lists the data of the supervision’s components, for example an On/Off state or a temperature. Dragged into the drawing, a data item becomes an element already bound to this datapoint; dragged by its handle, a component becomes a Component card.

Intended for administrators and installers who build the schemas of a supervision. To then choose the data of an Icon button manually, see Linked data.

Before you start

• Your role grants View schemas and Edit schemas; see the role capabilities.
• You are working on a computer, in a supervision opened directly or from the hypervision.
• The component and its data are already available in the supervision.
• To work on a copy of the schema, see schema management.

Open the Datapoints palette

1. In the relevant supervision, open Schemas in the header bar, or Menu → Schemas.
2. Hover over the schema row in the left panel, open the three dots Actions, then Edit schema. Wait for the name and the drawing to load.
3. Explicitly choose the layer in which to place the new element.
4. Scroll the left panel down to Datapoints, below the element tiles. Its subtitle is Drag onto the canvas. Click its title if it is collapsed.
5. If names are truncated, drag the right edge of the panel to the right; its tooltip is Resize panel. Also scroll the inner list to see the lower rows.

The Search elements… field, near the tiles, searches for the types of objects to draw. To find a data item from your installation, use the field located in Datapoints.

Browse or search for a data item

1. Expand the levels with their chevrons: building part, floor, zone, then component. A component can also appear without an associated zone.
2. Expand all opens the containers; then click the desired component to see its datapoints. Collapse all closes the containers.
3. To search for a zone or a component, enter its name in Search (zone, component, address…), for example Hall (fictitious example). The matching branches are displayed with their data.
4. To search only in the datapoints, check Match datapoints only; the field becomes Search (datapoint: name, DPT, address…). Then enter a datapoint name, a DPT or a known address. With this option, a zone search such as Hall may no longer return a result.
5. To return to manual navigation, clear the text in the field. During a search, Expand all and Collapse all are unavailable: the results are expanded according to the search.

A datapoint row shows its name and, when they are filled in, its DPT, its unit, its R status feedback address and its W action address. Check the parent component: several components can have a datapoint named On/Off. The address shown is a configuration reference; communication with the device is checked separately, as described below.

Drag a data item into the drawing

1. In Datapoints, locate the row of the desired data item.
2. Hold the mouse button down on this row, drag it to a free area of the drawing space, then release. A simple click does not place the data item.
3. A new element appears, selected, and Configuration lets you review its settings. The proposed type depends on the data item and its read or write capabilities.
4. Check the type, the data item and the component shown. For example, a readable and writable On/Off data item can create an Icon button; a writable numeric data item, a Numeric control; a read-only numeric measurement, a Text that displays this data item.
5. Adjust the necessary settings.

These examples do not cover all datapoint types. If the result does not match the intended use, first identify the chosen data item and its use. To manually choose the binding of an Icon button, see Linked data.

Place a component card

1. On the component row, locate the small stacked-layers icon, to the right of the number of points.
2. Drag this icon to a free area of the drawing. A Component card appears with this component selected.
3. Check its name and its data.

Clicking the component name opens or closes its list of datapoints without placing anything. To place the card, start from the small icon on the right; to place a single data item, start from its datapoint row.

Find data that is already placed

A data item already found in the drawing remains available in the palette. Its dimmed appearance and the Placed badge do not prevent it from being dragged again: a new drop creates an additional element without moving the previous one.

Placed ×2 indicates two occurrences found for this data item, possibly in different layers. The 2 placed marker on a component counts distinct datapoints found: it is not the same counter. These indications help with locating, without forming a complete inventory of the schema’s bindings; to review the elements grouped by data item, use Used datapoints.

To find an occurrence:

1. Hover over the Placed badge of a datapoint. A small list shows its occurrences, their layer and their element type.
2. On the desired row, click the target icon, tooltip Locate on canvas. The small list closes and the relevant layer is displayed.
3. If the layer changes but Configuration does not open, wait for it to load. Hover over the same badge again to reopen the list, then use the target of this occurrence again.

To hide these rows in the palette, check Hide placed points. Components remain visible, even when all their points are hidden; the text Placed points hidden may then replace their list. Uncheck the option to see the rows again. This option does not delete any element from the drawing.

Check the result

1. Click Save and confirm, then read the summary. Saving is detailed in the schema saving guide.
2. Reopen the same schema and the same layer, then check the saved element: its type, data item and component, or the name and data of the card.
3. Placement binds the element to a data item. To check that the value comes in or that a command works, open the schema in view mode and watch the device.

Troubleshooting

• No result for this search: shorten or clear the search; uncheck Match datapoints only if you are looking for a zone or a component.
• Component visible but data item missing: expand this component and uncheck Hide placed points.
• No component available: check the chosen supervision and wait for it to load before concluding that a device has disappeared.
• Locate on canvas does not open Configuration, even after a second attempt: note the schema, the layer and the data item you are looking for, for support.
• Placement markers different from the expected data item: review the binding in Configuration. Do not delete or recreate an element based solely on a counter.

Other cases are covered in the Datapoints palette FAQ. If these checks fail, contact support@can-nx.com specifying the product, the schema, the layer, the component, the data item, the message displayed and the attempts already made. A screenshot without sensitive data can help.

French labels: Menu, Schémas, Modifier le schéma, Datapoints, Glissez vers le canvas, Filtrer uniquement les datapoints, Tout déplier, Tout replier, Masquer les points placés, Placé, Points placés masqués, Localiser sur le canvas, Redimensionner le panneau, Sauvegarder.