--- title: Importer un fichier de projet KNX dans Boss’nX description: "Importer un fichier de projet KNX dans Boss’nX. Boss’nX : ouvrir Mise en service depuis Réglages KNX dans la supervision avec Gérer la topologie, contrôler la passerelle maître…" canonical: https://wiki.can-nx.com/guides/boss-knx-project/ language: fr product: Boss’nX audience: - administrateur - installateur context: Supervision autonome ou ouverte depuis hypervision ; Réglages KNX sur ordinateur ; FR/EN --- # Importer un fichier de projet KNX dans Boss’nX Contexte : Supervision autonome ou ouverte depuis hypervision ; Réglages KNX sur ordinateur ; FR/EN Pour un administrateur ou un installateur disposant de **Gérer la topologie**, dans la supervision concernée, sur ordinateur. Ce guide prépare les adresses et la structure d’un projet à partir d’un fichier **.knxproj**. L’ajout de points à un composant existant se fait dans [Import → KNX du composant](https://wiki.can-nx.com/guides/boss-import-knx/). ## Ouvrir l’import 1. Ouvrez la supervision du bâtiment à configurer. Depuis l’hypervision, entrez d’abord dans cette supervision. 2. Dans l’en-tête, ouvrez **Réglages → KNX**. Si **Réglages** n’est pas visible directement, cherchez dans **Plus**. La page **Mise en service** s’ouvre à l’étape **Import**. 3. Vérifiez **Passerelle maître (optionnel)**. Une passerelle peut déjà être sélectionnée : contrôlez son nom et son identifiant, sans supposer qu’elle convient au projet. Ce choix prépare l’association aux composants créés ensuite. **Aucune — attribution manuelle par composant** permet de prévoir cette attribution dans chaque composant. 4. L’indication **Connexion en mode Tunneling** décrit le mode présenté ici ; ce n’est pas un bouton pour changer de protocole. Pour gérer les passerelles elles-mêmes, consultez [Passerelles KNX](https://wiki.can-nx.com/guides/boss-knx-gateways/). Si **KNX** manque, vérifiez la supervision et faites confirmer **Gérer la topologie** par l’administrateur. Un accès de consultation ne suffit pas. Si le parcours reste absent, contactez **support@can-nx.com** en indiquant l’interface et le rôle utilisés. ## Choisir et analyser le fichier 1. Préparez le fichier **.knxproj** correspondant à cette installation. Exemple fictif de nom : `Bureau-exemple.knxproj`. 2. Déposez ce fichier dans **Glissez-déposez votre fichier .knxproj**, ou utilisez **Choisir un fichier**. Contrôlez le nom affiché et **Fichier prêt à être analysé**. 3. Si le projet est protégé, cochez **Projet protégé par mot de passe**, puis saisissez son **Mot de passe** dans le champ de l’interface. Ne le transmettez pas au chatbot ni dans un e-mail de support. 4. Cliquez sur **Analyser**. Le bouton peut afficher **Traitement...** pendant l’opération. Attendez la fin de l’envoi et de l’analyse ; une progression d’envoi terminée ne suffit pas à confirmer l’analyse. 5. À la fin, contrôlez les messages, puis passez à **Dictionnaire**, avec **Étape suivante** ou l’étape correspondante en haut. Dans **Adresses de groupe**, vérifiez que des adresses et noms du projet attendu sont présents. **Import KNX terminé — construisez le dictionnaire** invite à préparer la reconnaissance des adresses. Suivez [Configurer le dictionnaire KNX](https://wiki.can-nx.com/guides/boss-knx-dictionary/). Le dictionnaire permet ensuite d’obtenir une structure classée et de passer à **Structure**. ## Ce qui est terminé, et ce qui reste à faire L’import du fichier, la reconnaissance des adresses et la création des composants sont des étapes distinctes. **Import terminé**, **Analyse terminée. La comparaison est prête.** ou **Projet chargé. Prêt pour sélection.** ne suffisent pas à établir que des composants ont été créés dans la supervision. - **Dictionnaire** sert à préparer les règles et à vérifier les adresses reconnues. - **Structure** sert à [revoir et créer les composants détectés](https://wiki.can-nx.com/guides/boss-knx-structure/). **Afficher la structure détectée**, lorsqu’il est proposé dans **Import**, ouvre cette revue ; il ne crée rien à lui seul. - [**Organisation**](https://wiki.can-nx.com/guides/boss-organization/) sert aux parties de bâtiment, étages et zones. Cette étape est également accessible sans importer de fichier KNX, pour préparer une organisation manuelle. La présence d’une adresse importée ou reconnue ne certifie pas une communication avec le matériel. Pour retrouver les composants réellement enregistrés, consultez [la liste des composants](https://wiki.can-nx.com/guides/boss-components-find/). ## Reprendre un import ou une erreur **Fermer** dans le panneau de progression masque ce panneau. Il ne constitue pas une annulation du traitement. N’enchaînez pas plusieurs imports parce que le panneau a été fermé. Si un échec apparaît, relevez le message. **Réessayer** remet l’import en préparation ; vérifiez de nouveau le fichier sélectionné et, si nécessaire, le champ de mot de passe avant de cliquer sur **Analyser**. Voir [les vérifications selon le message](https://wiki.can-nx.com/guides/boss-knx-project-help/). Pour importer une nouvelle version du projet, reprenez **Import**, sélectionnez le fichier voulu, puis contrôlez l’inventaire, le dictionnaire et la structure obtenus avant de créer ou modifier des composants. Ne déduisez pas du nouvel import que les composants existants ont été remplacés ou mis à jour. Suivez [la reprise d’import et la résolution des conflits](https://wiki.can-nx.com/guides/boss-knx-reimport/). Pour une reprise dont les conséquences sur l’existant restent incertaines, contactez **support@can-nx.com** avant cette création ou modification. En anglais : **Settings → KNX**, **Import**, **Master Gateway (optional)**, **None — manual assignment per component**, **Dictionary**, **Structure**, **Building**, **Next step**.