ETS-Dateien

KNX Clarity speichert jede exportierte .knxproj-Datei als versionierten Anhang am zugehörigen Projekt. Jede Version wird einmal geparst, und die extrahierten Räume, Geräte und Gruppenadressen werden in das Projekt geschrieben, damit Sie sie in der Weboberfläche durchblättern können, ohne die ETS zu öffnen.

Wo Sie es finden

Der ETS-Upload und die Versionshistorie liegen innerhalb eines Projekts im Tab Pläne. Der Tab vereint Architekten-Pläne (PDF / Bild) und ETS-Exporte — der frühere eigenständige Tab „ETS-Dateien“ wurde in diese gemeinsame Oberfläche eingegliedert, sodass es nur eine Anlaufstelle für die Quelldateien gibt.

Datei hochladen

Öffnen Sie das Projektdetail, wechseln Sie zum Tab Pläne und klicken Sie auf Datei hochladen. Es erscheint ein Dateiauswahl- Dialog; wählen Sie eine .knxproj (Format ETS 5 oder ETS 6, bis 200 MB), fügen Sie optional einen Kommentar hinzu und bestätigen Sie.

Desktop

Mobile

Während des Hochladens sehen Sie eine Fortschrittsanzeige. Ist der Upload abgeschlossen:

1. Die Datei wird im verschlüsselten Projektspeicher abgelegt.
2. Das Zip wird im Hintergrund geparst, und die Räume, Geräte und Gruppenadressen des Projekts werden aus dem extrahierten XML aktualisiert.
3. Die Versionszeile wechselt von wird geparst zu bereit.

Das Parsen dauert für ein typisches Einfamilienhaus meist unter 10 Sekunden. Größere Gewerbeprojekte können bis zu einer Minute brauchen; aktualisieren Sie den Tab, falls es stehen bleibt.

Versionierung

Jeder Upload erzeugt eine neue Version, überschreibt nie die vorherige. Versionsnummern sind dicht (v1, v2, v3, …) und werden serverseitig vergeben, sodass zwei Techniker gleichzeitig hochladen können, ohne dass es zur Kollision kommt.

Desktop

Mobile

Jede Zeile zeigt:

• Versionsnummer
• Originaldateiname
• Dateigröße
• Name des Hochladenden
• Upload-Zeitstempel
• Kommentar (falls vorhanden)
• Parse-Status

Herunterladen

Klicken Sie in einer Versionszeile auf Herunterladen, um die originale .knxproj zu beziehen. Die Downloads werden über eine kurz gültige Signed-URL ausgeliefert (15 Minuten gültig) — ist der Link abgelaufen, klicken Sie erneut auf Herunterladen.

Beta-Einschränkung

Organisationsübergreifende Downloads (wenn Sie ein Projekt prüfen, das aus einer anderen Org an Sie übertragen wurde) sind für das nächste Beta-Release vorgesehen und derzeit auf die Identität des Hochladenden begrenzt. Brauchen Sie dringend Zugriff auf eine Datei eines Kollegen, laden Sie sie aus einem eigenen ETS-Backup neu hoch oder lassen sie sich auf dem üblichen Out-of-Band-Kanal zuschicken.

Was der Parser extrahiert

Entität	Sichtbar unter
Räume	Räume & Geräte → Baum
Geräte	Räume & Geräte → Geräteliste
Gruppenadressen	Tab Gruppenadressen
Hersteller	Katalog-Match, verlinkt aus den Gerätezeilen

Was die ETS kennt, KNX Clarity aber noch nicht im UI darstellt (Buskoppler, Parameter, Kommunikationsobjekte, Szenen), geht nicht verloren — es bleibt in den geparsten Metadaten und wird verfügbar, sobald wir eine entsprechende Oberfläche ausliefern.

Beschädigte Uploads ersetzen

Landet eine Version im Status error (Parser-Fehler, abgeschnittener Upload, falsches Dateiformat), zeigt die Zeile ein rotes Status-Abzeichen mit der Kurz-Fehlermeldung. Klicken Sie auf ⋮ → Version löschen, um sie zu entfernen, und laden Sie erneut hoch. Das Löschen einer error-Version lässt den zuvor geparsten Stand unberührt.

Kommentar-Konvention

Wir empfehlen, bei jedem Upload einen einzeiligen Kommentar zu schreiben, der erklärt, was sich gegenüber der vorherigen Version geändert hat. Das wird zur Audit-Spur des Projekts und ist das Erste, was ein Service-Techniker Monate später öffnet. Gute Beispiele:

• 3× Dimmer in Küche hinzugefügt, GA 1/2/15 auf Insel umgemappt
• Tippfehler bei EG-WC-Schalter-Namen korrigiert
• Initialer Inbetriebnahme-Export