---
title: ETS-Projekt (.knxproj-Datei) in Boss’nX importieren
description: Importieren Sie die .knxproj-Datei eines ETS-Projekts in Boss’nX, prüfen Sie das Master-Gateway und bereiten Sie Wörterbuch und Struktur der Komponenten vor.
canonical: https://wiki.can-nx.com/de/guides/boss-knx-project/
language: de
product: Boss’nX
audience:
  - administrateur
  - installateur
context: "Boss’nX am Computer: Schritt Import unter Menu → KNX commissioning in der Supervision des Gebäudes"
---

# ETS-Projekt (.knxproj-Datei) in Boss’nX importieren

Kontext: Boss’nX am Computer: Schritt Import unter Menu → KNX commissioning in der Supervision des Gebäudes

Der Schritt **Import** der Inbetriebnahme in Boss’nX analysiert die **.knxproj**-Datei Ihres ETS-Projekts und übernimmt deren Gruppenadressen. Er eröffnet den weiteren Ablauf: Das Wörterbuch erkennt diese Adressen, anschließend legt der Schritt **Structure** (Struktur) die Komponenten der Supervision an.

Für Administratoren und Installateure, die die Adressen und die Struktur eines Gebäudes vorbereiten. Um Datenpunkte zu einer vorhandenen Komponente hinzuzufügen, verwenden Sie stattdessen [Import → KNX der Komponente](https://wiki.can-nx.com/de/guides/boss-import-knx/).

## Bevor Sie beginnen

- Ihre Rolle verfügt über **Manage topology** (Topologie verwalten): Ein reiner Lesezugriff reicht nicht aus.
- Sie arbeiten am Computer in der Supervision des zu konfigurierenden Gebäudes. Aus der Hypervision wechseln Sie zuerst in diese Supervision.
- Ihnen liegt die zu dieser Installation passende **.knxproj**-Datei vor, zum Beispiel `Buero-Beispiel.knxproj` (fiktiver Name), und bei einem geschützten Projekt dessen Passwort.

## Import öffnen und Master-Gateway prüfen

1. Öffnen Sie **Menu → KNX commissioning** (Menü → KNX-Inbetriebnahme) in der Familie **Integration**. Die Seite **KNX commissioning** öffnet sich beim Schritt **Import**.
2. Prüfen Sie **Master Gateway (optional)**. Möglicherweise ist bereits ein Gateway ausgewählt: Prüfen Sie seinen Namen und seine Kennung, bevor Sie es beibehalten, ohne anzunehmen, dass es zum Projekt passt. Diese Wahl bereitet seine Zuordnung zu den anschließend angelegten Komponenten vor.
3. Um stattdessen in jeder Komponente ein Gateway zuzuordnen, wählen Sie **None — manual assignment per component** (Keines — manuelle Zuordnung pro Komponente).

**Tunneling Mode** (Tunneling-Modus) unter **KNX Connection Mode** (KNX-Verbindungsmodus) ist eine Angabe, keine Schaltfläche zum Wechseln des Protokolls: Boss’nX kommuniziert mit der KNX-Installation im Tunneling-Modus über ein IP/KNX-Gateway. Um den Status der Gateways selbst einzusehen, siehe [KNX-Gateways](https://wiki.can-nx.com/de/guides/boss-knx-gateways/).

## Die .knxproj-Datei analysieren

1. Legen Sie die Datei unter **Drag and drop your .knxproj file** (Ziehen Sie Ihre .knxproj-Datei hierher) ab oder verwenden Sie **Choose a file** (Datei auswählen). Prüfen Sie den angezeigten Namen und **File ready to be analyzed** (Datei bereit zur Analyse).
2. Ist das Projekt geschützt, haken Sie **Password protected project** (Passwortgeschütztes Projekt) an und geben Sie dann sein **Password** (Passwort) im Feld der Oberfläche ein. Geben Sie es niemals per E-Mail, an den Support oder an einen Online-Assistenten weiter.
3. Klicken Sie auf **Analyze** (Analysieren). Die Schaltfläche kann während des Vorgangs **Processing...** (Wird verarbeitet...) anzeigen. Warten Sie das Ende des Uploads und danach das Ende der Analyse ab: Der Upload-Fortschritt endet vor der Analyse.
4. Lesen Sie die abschließenden Meldungen. **KNX import complete — build the dictionary** (KNX-Import abgeschlossen — erstellen Sie das Wörterbuch) fordert Sie auf, die Erkennung der Adressen vorzubereiten.
5. Wechseln Sie mit **Next step** (Nächster Schritt) oder über den entsprechenden Schritt oben auf der Seite zu **Dictionary** (Wörterbuch). Prüfen Sie unter **Group addresses** (Gruppenadressen), ob Adressen und Namen des erwarteten Projekts vorhanden sind.

Fahren Sie mit der [Konfiguration des KNX-Wörterbuchs](https://wiki.can-nx.com/de/guides/boss-knx-dictionary/) fort.

## Von der importierten Datei zu den Komponenten

Der Import der Datei, die Erkennung der Adressen und das Anlegen der Komponenten sind getrennte Schritte der Seite **KNX commissioning**:

| Schritt | Zweck |
| --- | --- |
| **Import** | Analysiert die Datei und übernimmt die Gruppenadressen. **View detected structure** (Erkannte Struktur anzeigen) öffnet, sofern angeboten, die Überprüfung der Struktur, ohne etwas anzulegen. |
| **Dictionary** | Bereitet die Erkennungsregeln vor, zeigt die erkannten Adressen und erzeugt die von **Structure** verwendete Klassifizierung. |
| **Structure** | Dient dazu, [die erkannten Komponenten zu überprüfen und anzulegen](https://wiki.can-nx.com/de/guides/boss-knx-structure/). |
| [**Building**](https://wiki.can-nx.com/de/guides/boss-organization/) (Gebäude) | Dient für Gebäudeteile, Etagen und Zonen. Auch ohne KNX-Datei zugänglich, um eine manuelle Organisation vorzubereiten. Auch einzeln über **Menu → Building organisation** (Menü → Gebäudeorganisation) erreichbar. |

## Ergebnis prüfen

- **Import complete** (Import abgeschlossen), **Analysis complete. Comparison is ready.** (Analyse abgeschlossen. Vergleich ist bereit.) und **Project loaded. Ready for selection.** (Projekt geladen. Bereit zur Auswahl.) bestätigen die Analyse der Datei, nicht das Anlegen der Komponenten der Supervision, das unter **Structure** erfolgt.
- Um die tatsächlich gespeicherten Komponenten zu finden, siehe [die Komponentenliste](https://wiki.can-nx.com/de/guides/boss-components-find/).
- Eine importierte oder erkannte Adresse stammt aus der Datei: Sie belegt keine Kommunikation mit der Hardware.

## Eine neue Version des Projekts importieren

1. Kehren Sie zu **Import** zurück und wählen Sie die gewünschte Datei aus.
2. Prüfen Sie das resultierende Inventar, das Wörterbuch und die Struktur, bevor Sie Komponenten anlegen oder ändern. Schließen Sie aus dem neuen Import nicht, dass die vorhandenen Komponenten ersetzt oder aktualisiert wurden.
3. Folgen Sie der [Wiederholung eines Imports und der Lösung von Konflikten](https://wiki.can-nx.com/de/guides/boss-knx-reimport/).

Bleiben die Folgen für den Bestand unklar, wenden Sie sich an den Support, bevor Sie Komponenten anlegen oder ändern.

## Fehlerbehebung

- **KNX commissioning** fehlt im **Menu**: Prüfen Sie die geöffnete Supervision und lassen Sie **Manage topology** vom Administrator bestätigen.
- Fortschrittsbereich geschlossen: **Close** (Schließen) blendet nur diesen Bereich aus, ohne die Verarbeitung abzubrechen. Starten Sie deshalb nicht mehrere Importe nacheinander.
- Fehlschlag angezeigt: Notieren Sie die Meldung. **Retry** (Erneut versuchen) versetzt den Import zurück in die Vorbereitung; prüfen Sie erneut die ausgewählte Datei und gegebenenfalls das Passwortfeld, bevor Sie auf **Analyze** klicken.

Für jede Fehlermeldung folgen Sie den [Prüfungen je nach Meldung](https://wiki.can-nx.com/de/guides/boss-knx-project-help/). Fehlt **KNX commissioning** weiterhin oder besteht das Problem weiter, wenden Sie sich an support@can-nx.com und nennen Sie die verwendete Oberfläche und Rolle sowie die angezeigte Meldung.

Französische Bezeichnungen: **Menu → Mise en service KNX**, **Import**, **Passerelle maître (optionnel)**, **Aucune — attribution manuelle par composant**, **Analyser**, **Dictionnaire**, **Structure**, **Organisation**, **Étape suivante**.