Passer au contenu
Elausys

HyperVisu / Intégrations

Import de projet ETS

Importez un fichier .knxproj pour construire la visualisation automatiquement : remplacement ou fusion, avec une étape de vérification.

elausys · 22 juillet 2026
Sur cette page

Import d'un projet ETS (.knxproj)

Vous pouvez importer un projet ETS complet à tout moment, et pas seulement dans l'assistant de configuration : par exemple lorsque le projet ETS a été étendu avec un nouvel étage.

Ce qu'il faut : le fichier .knxproj exporté depuis ETS 5 ou 6 (et son mot de passe si le projet est protégé), ainsi qu'une sauvegarde récente du serveur (voir « Backup & Restore »).

  1. Sur la page KNX, ouvrez l'onglet Bridge et cliquez sur Import KNX Project dans l'en-tête. Le bouton n'apparaît que sur cet onglet et ouvre directement le sélecteur de fichier.

  2. Choisissez le fichier .knxproj. Pour un projet protégé, saisissez le Password du projet ETS et cliquez sur Unlock.

  3. Examinez le résumé de l'aperçu : Building, Floors / Rooms, Widgets to create, Group addresses, Skipped functions.

  4. Sous What to import, cochez les sections souhaitées : Building structure, Group addresses, Functions (widgets). Décochez une section pour laisser cette partie de votre configuration exactement en l'état : importer uniquement les adresses de groupe actualise la bibliothèque sans toucher aux pièces ni aux widgets.

  5. Cliquez éventuellement sur Review & edit pour corriger la proposition avant toute création : renommer des appareils, changer des types de widget, déplacer des appareils entre pièces, exclure des appareils (voir l'étape de vérification de l'assistant, « First-Run Setup Wizard », pour le détail complet de ce volet). Le bouton s'affiche tant que Functions (widgets) est coché.

  6. Si le serveur contient déjà des pièces et des appareils, un avertissement explique les deux possibilités. Choisissez :

    • Merge (add new) – ajoute ce qui est nouveau et conserve vos modifications locales. Rien n'est supprimé : une pièce ou un appareil retiré du projet ETS reste sur le serveur. Une pièce ou un appareil que vous avez modifié sur le serveur depuis l'import précédent est laissé intact ; celui que vous n'avez pas modifié est mis à jour depuis le projet.
    • Replace all – reconstruit les sections cochées à partir du projet. Avec Functions (widgets) coché, il supprime tous les appareils KNX, y compris ceux créés à la main, puis les recrée depuis le projet. Avec Building structure coché, les étages et les pièces sont eux aussi supprimés puis recréés. Les appareils des autres protocoles sont conservés.

    Sur un serveur sans pièce ni appareil, un seul bouton Import remplace les deux.

  7. Lisez le message affiché à la fin de l'import. Après une fusion des trois sections, il indique « Merged: X added, Y updated, Z kept (local edits) » ; après un import partiel, il liste les pièces, widgets et adresses de groupe traités. Le message est bref : notez les chiffres si vous en avez besoin. La nouvelle configuration est appliquée et la page se recharge d'elle-même : il n'y a rien à appliquer ensuite.

⚠️ Warning: Replace all supprime tous les appareils KNX et leurs liaisons dans les sections cochées (renommages, affectations de pièces et appareils créés à la main compris) et, avec Building structure coché, toutes les pièces que le projet ne contient pas. Les favoris qui pointaient vers une pièce ou un appareil remplacé sont effacés. Les scénarios et automatisations ne sont pas reconstruits : vérifiez ceux qui utilisaient un appareil remplacé. En cas de doute, choisissez Merge (add new).

📘 Note: Merge (add new) ne reconnaît que ce qu'un import de projet antérieur a créé. Une pièce ou un appareil créé à la main n'est pas apparié : l'import ajoute donc la version du projet à côté.

📘 Note: Si le projet ETS ne déclare aucune fonction, HyperVisu déduit les appareils à partir des canaux d'actionneur et des adresses de groupe liées. L'aperçu l'indique explicitement : vérifiez les appareils déduits avant d'importer.

Questions fréquentes

Puis-je importer un projet ETS après la configuration initiale ?

Oui. Ouvrez la page KNX puis, dans l'onglet Bridge, cliquez sur Import KNX Project. Chargez un fichier .knxproj d'ETS 5 ou 6 et indiquez son mot de passe s'il est protégé.

Puis-je importer uniquement les adresses de groupe ?

Oui. Sous What to import, sélectionnez Group addresses et laissez Building structure et Functions décochés.

Dois-je choisir Merge ou Replace all ?

Merge ajoute du nouveau contenu en préservant les modifications locales, et ne supprime rien. Replace all reconstruit les sections cochées : il supprime tous les appareils KNX qui s'y trouvent, y compris ceux créés à la main, et les recrée depuis le projet ; les appareils des autres protocoles sont conservés.

Que se passe-t-il si mon projet ETS ne contient aucune fonction ?

HyperVisu déduit les appareils à partir des canaux d'actionneur et des adresses de groupe liées. Vérifiez la proposition déduite avant d'importer.

Continuer l'exploration

Retrouvez les autres guides de ce produit dans la documentation.

Retour à Intégrations