Zum Inhalt springen
Elausys

HyperVisu / Integrationen

ETS-Projektimport

Importieren Sie eine .knxproj-Datei, um die Visualisierung automatisch aufzubauen – Ersetzen oder Zusammenführen, mit Prüfschritt.

elausys · 22 Juli 2026
Auf dieser Seite

ETS-Projektimport (.knxproj)

Sie können jederzeit ein vollständiges ETS-Projekt importieren, nicht nur im Einrichtungsassistenten – zum Beispiel, nachdem das ETS-Projekt um ein neues Geschoss erweitert wurde.

Was Sie brauchen: die aus ETS 5 oder 6 exportierte .knxproj-Datei (und ihr Passwort, falls das Projekt geschützt ist) sowie eine aktuelle Sicherung des Servers (siehe „Backup & Restore“).

  1. Öffnen Sie auf der KNX-Seite den Reiter Bridge und klicken Sie in der Kopfzeile auf Import KNX Project. Die Schaltfläche wird nur auf diesem Reiter angezeigt und öffnet direkt die Dateiauswahl.

  2. Wählen Sie die .knxproj-Datei. Geben Sie bei einem geschützten Projekt das Password des ETS-Projekts ein und klicken Sie auf Unlock.

  3. Prüfen Sie die Zusammenfassung der Vorschau: Building, Floors / Rooms, Widgets to create, Group addresses, Skipped functions.

  4. Wählen Sie unter What to import die gewünschten Bereiche: Building structure, Group addresses, Functions (widgets). Deaktivieren Sie einen Bereich, um diesen Teil Ihrer Konfiguration unverändert zu lassen – wird nur Group addresses importiert, wird die Bibliothek aktualisiert, ohne Räume oder Widgets zu verändern.

  5. Klicken Sie optional auf Review & edit, um den Vorschlag zu korrigieren, bevor etwas angelegt wird: Geräte umbenennen, Widget-Typen ändern, Geräte zwischen Räumen verschieben, Geräte ganz ausschließen (siehe den Prüfschritt des Assistenten, „First-Run Setup Wizard“, für die vollständige Anleitung zu diesem Bereich). Die Schaltfläche wird angezeigt, solange Functions (widgets) aktiviert ist.

  6. Enthält der Server bereits Räume und Geräte, erklärt eine Warnung die beiden Möglichkeiten. Wählen Sie:

    • Merge (add new) – fügt Neues hinzu und behält Ihre lokalen Änderungen. Es wird nichts gelöscht: Ein Raum oder Gerät, das aus dem ETS-Projekt entfernt wurde, bleibt auf dem Server. Ein Raum oder Gerät, das Sie seit dem letzten Import auf dem Server geändert haben, bleibt unberührt; eines, das Sie nicht geändert haben, wird aus dem Projekt aktualisiert.
    • Replace all – baut die aktivierten Bereiche aus dem Projekt neu auf. Bei aktivierter Option Functions (widgets) werden alle KNX-Geräte gelöscht, auch die von Hand angelegten, und aus dem Projekt neu erstellt. Bei aktivierter Option Building structure werden auch die Geschosse und Räume gelöscht und neu angelegt. Geräte anderer Protokolle bleiben erhalten.

    Auf einem Server ohne Räume und ohne Geräte ersetzt eine einzelne Schaltfläche Import die beiden.

  7. Lesen Sie die Meldung, die am Ende des Imports erscheint. Nach einem Merge aller drei Bereiche lautet sie „Merged: X added, Y updated, Z kept (local edits)“; nach einem Teilimport listet sie die verarbeiteten Räume, Widgets und Gruppenadressen auf. Die Meldung ist kurz, notieren Sie sich die Zahlen also, falls Sie sie brauchen. Die neue Konfiguration wird angewendet und die Seite lädt sich von selbst neu: Danach ist nichts mehr anzuwenden.

⚠️ Warning: Replace all entfernt jedes KNX-Gerät und seine Bindungen in den aktivierten Bereichen – einschließlich Umbenennungen, Raumzuordnungen und von Hand angelegter Geräte – und, bei aktivierter Option Building structure, jeden Raum, den das Projekt nicht enthält. Favoriten, die auf einen ersetzten Raum oder ein ersetztes Gerät zeigten, werden gelöscht. Szenarien und Automatisierungen werden nicht neu aufgebaut; prüfen Sie daher diejenigen, die ein ersetztes Gerät verwendet haben. Wählen Sie im Zweifel Merge (add new).

📘 Note: Merge (add new) erkennt nur, was ein früherer Projektimport angelegt hat. Ein von Hand angelegter Raum oder ein von Hand angelegtes Gerät wird nicht zugeordnet, sodass der Import die Projektversion daneben hinzufügt.

📘 Note: Deklariert das ETS-Projekt keine Funktionen, leitet HyperVisu Geräte aus Aktorkanälen und verknüpften Gruppenadressen ab. Die Vorschau weist ausdrücklich darauf hin – prüfen Sie die abgeleiteten Geräte vor dem Import.

Häufig gestellte Fragen

Kann ich nach der Ersteinrichtung ein ETS-Projekt importieren?

Ja. Öffnen Sie die KNX-Seite und klicken Sie auf dem Reiter Bridge auf Import KNX Project. Laden Sie eine .knxproj-Datei aus ETS 5 oder 6 hoch und geben Sie ihr Passwort an, falls sie geschützt ist.

Kann ich nur Gruppenadressen importieren?

Ja. Wählen Sie unter What to import die Option Group addresses und lassen Sie Building structure und Functions deaktiviert.

Sollte ich Merge oder Replace all wählen?

Merge fügt neuen Inhalt hinzu, behält lokale Änderungen und löscht nichts. Replace all baut die aktivierten Bereiche neu auf: Es löscht dort jedes KNX-Gerät, auch von Hand angelegte, und erstellt sie aus dem Projekt neu; Geräte anderer Protokolle bleiben erhalten.

Was ist, wenn mein ETS-Projekt keine Funktionen hat?

HyperVisu leitet Geräte aus Aktorkanälen und verknüpften Gruppenadressen ab. Prüfen Sie den abgeleiteten Vorschlag vor dem Import.

Weiter erkunden

Finden Sie die weiteren Anleitungen zu diesem Produkt in der Dokumentation.

Zurück zu Integrationen