--- title: Créer des composants depuis la structure KNX dans Boss’nX description: "Créer des composants depuis la structure KNX dans Boss’nX. Boss’nX : ouvrir Structure après classement dans la supervision avec droits de topologie et composants, distinguer ligne…" canonical: https://wiki.can-nx.com/guides/boss-knx-structure/ language: fr product: Boss’nX audience: - administrateur - installateur context: Supervision autonome ou ouverte depuis hypervision ; Réglages KNX Structure sur ordinateur ; FR/EN --- # Créer des composants depuis la structure KNX dans Boss’nX Contexte : Supervision autonome ou ouverte depuis hypervision ; Réglages KNX Structure sur ordinateur ; FR/EN Pour un administrateur ou un installateur ayant **Gérer la topologie** et **Gérer les composants**, dans la supervision du bâtiment, sur ordinateur. Le fichier KNX doit être importé et son dictionnaire enregistré avec un classement disponible : voir [l’import du projet](https://wiki.can-nx.com/guides/boss-knx-project/) et [le dictionnaire](https://wiki.can-nx.com/guides/boss-knx-dictionary/). ## Ouvrir et lire la structure 1. Ouvrez **Réglages → KNX**, éventuellement depuis **Plus**, puis **Structure**. Depuis l’hypervision, entrez d’abord dans la supervision concernée. 2. Dans **Structure KNX et adresses groupées**, chaque ligne prépare un composant avec son **Type**, sa **Localisation** et ses **Points**. Une ligne détectée n’est pas encore la preuve d’un composant enregistré. 3. Cliquez sur la ligne ou sur son chevron à droite, **Déplier les datapoints de …**. Vérifiez les noms, adresses et DPT sous **Commande** et **Retour**. L’ouverture d’une autre ligne replie la précédente. 4. La pastille **Points** distingue les groupes, commandes et retours ; son infobulle en donne le détail. Contrôlez les adresses elles-mêmes avant de créer, notamment les associations commande/retour. 5. Si des badges **Déjà importé**, **À fusionner**, **Conflit** ou **Ambigu** apparaissent, consultez [reprendre un import sur des composants existants](https://wiki.can-nx.com/guides/boss-knx-reimport/) avant de lancer l’opération. **Afficher les éléments non importables (N)** révèle les éléments **Inconnu** ou **Exclus**, masqués par défaut. Leurs cases sont désactivées. Les afficher ne les rend pas importables ; corrigez d’abord les règles utiles dans **Dictionnaire**, puis vérifiez le nouveau classement. Ne créez pas un composant dont les adresses ou le DPT restent incertains. ## Retrouver et sélectionner les lignes **Rechercher un composant…** recherche dans les noms de composants, les chemins détectés et les catégories. Pour chercher une adresse KNX elle-même, utilisez plutôt **Adresses de groupe** dans **Dictionnaire**. Les onglets **Localisation** et **Type** changent le regroupement de la liste. Le bouton **Localisation** muni d’un chevron ouvre un filtre d’espaces ; il ne change pas la destination d’un composant. Cochez un espace pour afficher son contenu et ses descendants. **Inclus via le parent** indique qu’un enfant est déjà couvert par le parent coché ; retirez ce parent pour choisir seulement certains enfants. **Réinitialiser**, à côté de ce filtre, retire le filtre d’espaces. **Filtrer** ouvre les puces de types. Cliquez sur les types souhaités ; **Réinitialiser les tags** retire ces filtres. Ces puces filtrent la liste sans sélectionner les composants. 1. Cochez **Inclure**, à gauche de chaque ligne à créer. Le clic sur le reste de la ligne ouvre les détails. 2. **Tout cocher** ajoute les lignes importables correspondant aux filtres et à la recherche en cours. La case d’un en-tête sélectionne les lignes importables de ce groupe dans la vue filtrée. 3. **Tout décocher** efface la sélection complète, y compris les lignes masquées. Vous pouvez ensuite reconstruire une sélection précise. 4. Avant de continuer, effacez la recherche et les filtres utiles pour relire toutes vos sélections. **Masquer une ligne ne la décoche pas.** Le nombre du bouton **Créer N composants** compte aussi les sélections actuellement masquées. ## Ajuster le nom et la destination Pour le nom du futur composant, survolez son nom et utilisez le crayon **Renommer le composant**. Renseignez **Nom du composant**, puis la coche **Valider le nom**, Entrée ou quittez le champ. La croix **Annuler la modification** abandonne cette saisie. Dans les détails d’un groupe de points, le champ **Libellé** permet de préparer son libellé ; validez avec Entrée ou quittez ce champ. Pour la destination, utilisez la cellule de la colonne **Localisation**, sur la ligne concernée : 1. Ouvrez cette cellule, qui peut afficher **Auto**, un chemin, **Localiser…** ou **Non localisé**. 2. Dans **Choisir une localisation**, choisissez un **Étage** ou une **Zone**. **Chercher un espace…** permet de préciser la recherche ; contrôlez aussi le chemin parent pour distinguer les noms semblables. Le badge **existant** désigne un espace déjà enregistré. Les autres propositions proviennent des espaces détectés. 3. **Auto (détecté)** rétablit la destination déduite du projet importé. **Non localisé** prépare ce seul composant sans étage ni zone. Effacez la recherche du menu pour retrouver ces deux choix. 4. Relisez le chemin dans la cellule. Le filtre et le regroupement **Localisation** de la barre d’outils suivent les espaces détectés ; ils ne déplacent pas la ligne selon votre nouvelle destination. Les composants s’affectent ici à un étage ou une zone ; le menu ne propose pas une partie de bâtiment seule comme destination. Si un espace manque dans une longue liste, précisez la recherche. Pour une destination absente ou incertaine, consultez [le dépannage](https://wiki.can-nx.com/guides/boss-knx-structure-help/). ## Créer et contrôler le résultat 1. Contrôlez la **Passerelle maître (optionnel)** à l’étape **Import** avant de préparer votre sélection finale. Revenir d’une étape à l’autre peut vous obliger à refaire les ajustements de la revue. 2. Dans **Structure**, terminez la saisie du dernier champ, puis relisez sélection, noms, destinations, adresses et DPT. 3. Cliquez sur **Créer N composants**. Ce bouton lance l’opération ; n’attendez pas systématiquement une confirmation supplémentaire. Les espaces nécessaires aux nouveaux composants peuvent être créés avec eux. Des composants déjà rapprochés peuvent être mis à jour selon [le parcours de réimport](https://wiki.can-nx.com/guides/boss-knx-reimport/). 4. Attendez la fin de **Création en cours…** et lisez tous les messages. Une réussite accompagnée d’erreurs est un résultat partiel. 5. Dans [Composants](https://wiki.can-nx.com/guides/boss-components-find/), retrouvez puis ouvrez les composants enregistrés. Vérifiez leur nom, passerelle, étage, zone et points. Pour compléter une configuration, utilisez [le formulaire du composant](https://wiki.can-nx.com/guides/boss-component-edit/) et [les points KNX](https://wiki.can-nx.com/guides/boss-point-knx/). **Importer sans assignation**, sous le bouton principal, importe la sélection sans créer d’espaces et sans affecter les composants à un étage ou une zone. Réservez ce choix à de nouveaux composants que vous placerez ensuite dans leur formulaire. Pour mettre à jour des composants existants, suivez le parcours de réimport avec le bouton principal ; ce lien n’est pas un équivalent de la fusion. La préparation de la revue ne sauvegarde pas les composants. Une fois la création ou une mise à jour lancée, quitter l’étape ou **Annuler** une autre fenêtre ne revient pas sur les opérations déjà réussies. Si le résultat est partiel ou inconnu, [contrôlez ce qui a été enregistré avant de reprendre](https://wiki.can-nx.com/guides/boss-knx-structure-help/). Une présence dans la liste ne prouve pas une communication avec le matériel. En anglais : **Settings → KNX → Structure**, **KNX structure and grouped addresses**, **Include**, **Select all**, **Clear selection**, **Filter**, **Reset tags**, **Location**, **Choose a location**, **Auto (detected)**, **Unassigned**, **Create N components**.