---
title: Créer ou modifier un composant dans Boss’nX
description: "Créer ou modifier un composant dans Boss’nX. Boss’nX : ouvrir Ajouter un composant depuis Composants ou Modifier le composant depuis la carte ou le détail, distinguer droit Gérer les…"
canonical: https://wiki.can-nx.com/guides/boss-component-edit/
language: fr
product: Boss’nX
audience:
  - administrateur
  - installateur
context: Supervision autonome ou ouverte depuis hypervision ; configuration sur ordinateur ; FR/EN avec champs français persistants
---

# Créer ou modifier un composant dans Boss’nX

Contexte : Supervision autonome ou ouverte depuis hypervision ; configuration sur ordinateur ; FR/EN avec champs français persistants

Pour un administrateur ou un installateur ayant **Gérer les composants**, dans une supervision ouverte directement ou depuis l’hypervision. Préparez le nom, la localisation, la passerelle et les paramètres des points à configurer. Les étapes ci-dessous décrivent le formulaire sur ordinateur.

## Ouvrir le formulaire

1. Dans la supervision concernée, ouvrez **Composants**, éventuellement dans **Plus**. Sur un écran étroit, cette entrée se trouve dans le menu de navigation.
2. Vérifiez le titre **Gestion des Composants**.
3. Pour une création, cliquez sur **Ajouter un composant**, en haut. Le titre devient **Créer un composant**.
4. Pour une modification, retrouvez la bonne carte avec [les filtres de Composants](https://wiki.can-nx.com/guides/boss-components-find/), puis utilisez son crayon **Modifier le composant**, en haut à droite. Le crayon est aussi disponible dans la fiche détaillée, à droite du nom. Attendez la fin de **Chargement du composant...**, puis vérifiez les valeurs chargées.

Le nom et le type proposés à la création ne décrivent pas automatiquement votre appareil. Remplacez-les par les valeurs appropriées.

## Renseigner les paramètres généraux

| Champ | Ce qu’il faut faire |
| --- | --- |
| **Nom du composant** | Donnez un nom non vide et reconnaissable, par exemple **Ventilation test**, exemple fictif. |
| **Type** | Choisissez la catégorie correspondant au composant. Elle ne remplace pas le choix du protocole de ses points. |
| **Bâtiment** | Sélectionnez la partie de bâtiment voulue, ou laissez **Tous les bâtiments** pour choisir parmi les étages disponibles. Cette sélection filtre les étages. |
| **Étage** | Choisissez l’étage réel. **Non assigné** est proposé si vous préparez un composant sans affectation à un étage. Ne conservez pas automatiquement le premier étage affiché. |
| **Zone** | Choisissez une zone de cet étage. **Racine de l'étage** correspond à une affectation directement à l’étage, sans zone. La liste est grisée si aucune zone n’est proposée. |
| **Passerelle** | Choisissez la passerelle prévue pour le composant. **Aucune** permet de préparer les paramètres sans choix de passerelle ; le champ **Mémo passerelle à installer (optionnel)** sert alors de note, sans créer ni rattacher une passerelle. |
| **Favori** | Cochez pour utiliser ce composant parmi les favoris. Voir [les favoris du tableau](https://wiki.can-nx.com/guides/boss-dashboard-favorites/). |
| **Commentaire de l'intégrateur** | Ajoutez, si utile, une note de configuration destinée aux personnes qui éditent le composant. |

Les listes de bâtiment, d’étage et de zone permettent de rechercher puis de sélectionner un résultat. Après un changement de bâtiment ou d’étage, **revérifiez l’étage et la zone** : les choix incompatibles peuvent être remplacés ou effacés.

Avant de déplacer un composant existant dans une autre zone, vérifiez les règles de la zone d’origine qui l’utilisent. Des règles devenues sans référence dans cette zone peuvent être retirées lors du déplacement. Contrôlez ensuite les usages attendus dans l’ancienne et la nouvelle zone avec l’installateur.

Changer la **Passerelle** du composant demande aussi de vérifier les passerelles particulières de ses points KNX : [héritage et choix par point](https://wiki.can-nx.com/guides/boss-point-knx/).

## Ajouter les points et enregistrer

1. Cliquez sur **Ajouter un point**, sous la liste des points.
2. Renseignez son **Label**, choisissez son protocole et configurez les champs correspondant à son usage. Pour KNX, suivez [configurer les adresses et le DPT](https://wiki.can-nx.com/guides/boss-point-knx/), puis [les formats et commandes](https://wiki.can-nx.com/guides/boss-point-display/).
3. Quittez le dernier champ saisi, puis relisez les valeurs avant sauvegarde. Le menu **Import** propose d’autres parcours d’ajout ; leur disponibilité dépend des adresses et équipements déjà configurés.
4. Cliquez sur **Créer** pour un nouveau composant, ou **Enregistrer** pour une modification. Ce bouton est fixé en bas à droite ; **Sauvegarde...** indique l’opération en cours.
5. Après succès, l’interface revient à la page d’origine, par exemple la liste des composants ou la fiche détaillée. Retrouvez le composant, rouvrez **Modifier le composant**, puis relisez son nom, sa localisation, sa passerelle et ses points.
6. Vérifiez ensuite l’affichage et le fonctionnement attendus dans la supervision selon la procédure de l’installation. La sauvegarde d’un formulaire ne certifie pas à elle seule la communication avec le matériel.

Pour abandonner les modifications en attente du composant, utilisez **Retour**, la flèche en haut à gauche, avant la sauvegarde. Ce bouton n’annule pas une modification déjà enregistrée. Une correction après sauvegarde demande de rouvrir le formulaire et d’enregistrer les valeurs corrigées.

## Si la validation ou la sauvegarde bloque

**Le nom est requis.** : renseignez **Nom du composant**. Les autres erreurs indiquent le point concerné, par exemple **Le label est requis**, **Adresse de retour requise** ou **Adresse de commande requise**. Corrigez les champs qui correspondent aux fonctions activées sur ce point. Fermer le résumé des erreurs ne les corrige pas.

**Impossible de récupérer les passerelles.** : vérifiez la supervision et votre connexion, puis rouvrez le formulaire. Ne remplacez pas une passerelle connue par **Aucune** uniquement pour contourner ce message.

**Accès restreint** ou crayon absent : faites vérifier **Gérer les composants** et le périmètre du compte par l’administrateur. Les droits de consultation ou d’envoi de commandes ne remplacent pas ce droit d’édition.

**Le formulaire reste ouvert après Créer ou Enregistrer, sans résultat clair** : ne considérez pas la sauvegarde comme acquise. Relevez les messages visibles et conservez les paramètres utiles. Rouvrez la liste pour vérifier si le composant existe et quels paramètres ont été enregistrés avant de recommencer ou de créer un doublon. Si l’incertitude persiste, contactez **support@can-nx.com** avec la supervision, le nom du composant, l’action tentée et vos vérifications, sans mot de passe, clé d’accès ni données confidentielles.

En anglais : **Components → Component Management → Add component**, ou **Edit component** sur la carte ; **More** peut contenir **Components**. Le formulaire utilise **Component name**, **Type**, **Building**, **Floor**, **Zone**, **Gateway**, **None**, **Favorite**, **Integrator comment**, **Add point**, **Create**, **Save**, **Saving...**, **Back**. Les options de localisation sont **All buildings**, **Unassigned** et **Floor root**.

Pour repartir d’un élément existant : [dupliquer un composant et organiser ses points](https://wiki.can-nx.com/guides/boss-component-copy-points/).

Pour configurer un appareil et son objet dans un composant, consultez [les points BACnet](https://wiki.can-nx.com/guides/boss-point-bacnet/).

Pour ajouter un déclencheur lié à une action ou un scénario, consultez [configurer un point Linknx](https://wiki.can-nx.com/guides/boss-point-linknx/).

Pour configurer des registres et une absence de signal, consultez [les points Modbus](https://wiki.can-nx.com/guides/boss-point-modbus/).

Pour reprendre plusieurs points déjà disponibles, suivez l’import [KNX](https://wiki.can-nx.com/guides/boss-import-knx/), [BACnet](https://wiki.can-nx.com/guides/boss-import-bacnet/) ou [Modbus depuis le monitoring](https://wiki.can-nx.com/guides/boss-import-modbus/).

Pour configurer un point d’alarme, suivez [les seuils et listes](https://wiki.can-nx.com/guides/boss-point-alarm/), [la comparaison simple](https://wiki.can-nx.com/guides/boss-point-alarm-comparison/) et [heartbeat, source BACnet et dépannage](https://wiki.can-nx.com/guides/boss-point-alarm-help/).