--- title: "KNX-Wörterbuch: Gruppenadressen in Boss’nX erkennen" description: Legen Sie in Boss’nX die CMD- und FB-Schlüsselwörter fest, die Gruppenadressen eines importierten ETS-Projekts erkennen, und prüfen Sie die Klassifizierung. canonical: https://wiki.can-nx.com/de/guides/boss-knx-dictionary/ language: de product: Boss’nX audience: - administrateur - installateur context: "Boss’nX am Computer: Schritt Dictionary unter KNX commissioning, nach dem Import der .knxproj-Datei" --- # KNX-Wörterbuch: Gruppenadressen in Boss’nX erkennen Kontext: Boss’nX am Computer: Schritt Dictionary unter KNX commissioning, nach dem Import der .knxproj-Datei Das KNX-Wörterbuch von Boss’nX erkennt die aus ETS importierten Gruppenadressen anhand von Schlüsselwörtern für Befehle (**CMD**) und Statusrückmeldungen (**FB**), geordnet nach Komponentenkategorien. Es bereitet die erkannten Komponenten vor, die Sie anschließend unter **Structure** (Struktur) anlegen: Sein Speichern allein legt die Komponenten der Supervision nicht an. Das gespeicherte Wörterbuch dient außerdem dazu, die Gruppenadressen späterer Importe zu klassifizieren. Für Administratoren und Installateure, die ein Gebäude in Betrieb nehmen, direkt nach dem [Import der .knxproj-Datei](https://wiki.can-nx.com/de/guides/boss-knx-project/). ## Bevor Sie beginnen - Ihre Rolle verfügt über **Manage topology** (Topologie verwalten). - Sie arbeiten am Computer in der betreffenden Supervision. Öffnen Sie aus der Hypervision zuerst diese Supervision. - Die .knxproj-Datei ist importiert; andernfalls bleibt der Schritt gesperrt. ## Das Wörterbuch öffnen 1. Öffnen Sie **Menu → KNX commissioning** (Menü → KNX-Inbetriebnahme) und dann den Schritt **Dictionary** (Wörterbuch). 2. Warten Sie, bis **Loading saved dictionary...** (Gespeichertes Wörterbuch wird geladen...) abgeschlossen ist. Schlägt das Laden fehl, lesen Sie die [Fehlerbehebung](https://wiki.can-nx.com/de/guides/boss-knx-project-help/), bevor Sie vorhandene Regeln ersetzen. Der Bereich **Component template configuration** (Konfiguration der Komponentenvorlage) enthält die Regeln. **Group addresses** (Gruppenadressen) zeigt die importierten Adressen und ihre Erkennung. ## Kategorien vorbereiten 1. Wählen Sie in der Spalte **Template** (Vorlage) eine vorhandene Kategorie. 2. Um eine neue anzulegen, klicken Sie auf **+ Category** (+ Kategorie), prüfen Sie dann **Component type** (Komponententyp) in ihrem Bereich und wählen Sie den gewünschten Typ in der Liste. Eine bereits vorhandene Kategorie kann nicht ein zweites Mal unter demselben Namen angelegt werden. 3. Um vom vorgeschlagenen Modell auszugehen, verwenden Sie **Load default template** (Standardvorlage laden). Enthält die Vorlage bereits Kategorien, kündigt eine Bestätigung ihre Ersetzung an: Diese Schaltfläche ersetzt die aktuelle Vorlage, statt sie zu ergänzen. Brechen Sie ab, wenn Sie diese Regeln behalten müssen. ## Einen Datenpunkt und seine Schlüsselwörter hinzufügen 1. Klicken Sie in der Kategorie auf **+ Add datapoint** (+ Datenpunkt hinzufügen). Es erscheint eine Gruppe mit einem Feld **Datapoint name...** (Name des Datenpunkts...) und zwei Zeilen: **CMD** für den Befehl, **FB** für die Statusrückmeldung. 2. Geben Sie dem Datenpunkt einen Namen und verlassen Sie dann dieses Feld. 3. Klicken Sie in jeder benötigten Zeile auf **+ Keyword** (+ Schlüsselwort), geben Sie ein zu den Adressnamen des Projekts passendes Schlüsselwort ein und bestätigen Sie mit der Eingabetaste oder verlassen Sie das Feld. Fügen Sie bei Bedarf weitere Schlüsselwörter hinzu. 4. Für einen reinen Rückmelde-Datenpunkt füllen Sie **FB** aus und lassen **CMD** ohne Schlüsselwort. Eine Zeile ohne Schlüsselwort wird beim Speichern nicht übernommen: Eine Gruppe, deren beide Zeilen leer sind, wird daher nicht als Erkennungsdatenpunkt gespeichert. Name und Schlüsselwörter eines Datenpunkts haben unterschiedliche Funktionen: Das Umbenennen des Datenpunkts ersetzt nicht die Festlegung der Schlüsselwörter. Fiktives Beispiel: Ein Datenpunkt namens `Temperatur Wohnzimmer` kann nur Rückmelde-Schlüsselwörter enthalten, die nach dem Lesen der Adressnamen dieses Projekts gewählt wurden. So korrigieren Sie einen Datenpunkt: - Das kleine Kreuz auf einem Chip entfernt dieses Schlüsselwort. - Das Kreuz der Zeile, **Delete this row** (Diese Zeile löschen), entfernt die ganze Zeile, mit Bestätigung, wenn sie Schlüsselwörter enthält. - **Create feedback** (Rückmeldung erstellen) oder **Create command** (Befehl erstellen) stellt das fehlende Gegenstück wieder her. - Der Papierkorb **Delete pair** (Paar löschen) entfernt nach Bestätigung beide Zeilen. ## Den Erstellungsmodus wählen Der **Creation mode** (Erstellungsmodus) gilt für die ausgewählte Kategorie: - **Type-based** (nach Typ) fasst Elemente desselben Typs im selben Gebäudebereich zusammen, um eine Komponente dieses Typs vorzubereiten. - **Name-based** (nach Name) behält die nach Namen erkannten Gruppierungen bei. **Apply to all** (Auf alle anwenden) überträgt den gewählten Modus auf alle Kategorien; verwenden Sie dies nur, wenn diese Organisation zum gesamten Projekt passt. Mit dem Griff **Reorder** (Neu anordnen) links neben einer Datenpunktgruppe ändern Sie deren Reihenfolge in der Kategorie. Prüfen Sie die resultierende Gruppierung unter **Structure**, bevor Sie die Komponenten anlegen. ## Die Suche auf einen Teil der Adressen eingrenzen Ein Suchbereich beschränkt die Suche nach den Schlüsselwörtern eines Datenpunkts auf einen Teil der Baumstruktur der Gruppenadressen. 1. Klicken Sie in der Datenpunktgruppe auf **Search scope** (Suchbereich), um denselben Suchbereich für **CMD** und **FB** vorzubereiten. Für eine einzelne Zeile verwenden Sie ihre Zielscheiben-Schaltfläche **Set the search scope** (Suchbereich festlegen). 2. In **Group addresses** kennzeichnet das Banner **Search scope — …** den Datenpunkt und bei einer einzelnen Zeile **CMD** oder **FB**. Prüfen Sie dieses Ziel, bevor Sie etwas anhaken. 3. Haken Sie die gewünschten Zweige oder Adressen an; mit den Chevrons klappen Sie die Gruppen auf. Ein Zweig kann mehrere Adressen abdecken: Prüfen Sie den Zähler **address(es) covered** (abgedeckte Adressen). Fiktives Beispiel: Der Zweig `1/2` beschränkt den Suchbereich auf die Adressen dieses Zweigs. 4. Klicken Sie auf **Confirm** (Bestätigen), um die Auswahl anzuwenden. **Cancel** (Abbrechen) verwirft nur den gerade vorbereiteten Suchbereich. 5. Warten Sie das Speichern ab und prüfen Sie dann die Suchbereich-Chips auf den betreffenden Zeilen und die Anzahl der erkannten Adressen. **Das Bestätigen einer vollständig leeren Auswahl hebt die Einschränkung des Suchbereichs auf.** Es ist kein Weg, „keine Adresse zu erkennen“: Um eine Erkennungsrolle zu entfernen, löschen Sie sie oder entfernen Sie ihre Schlüsselwörter. Während der Auswahl ist die Textsuche ausgeblendet und das Speichern deaktiviert. Bereiten Sie immer nur eine Auswahl vor und schließen Sie sie mit **Confirm** oder **Cancel** ab, bevor Sie zu einer anderen Aufgabe wechseln. ## Die erkannten Adressen prüfen In **Group addresses** beschreiben **Recognized** (Erkannt) und **Not yet recognized** (Noch nicht erkannt) das Ergebnis der letzten verfügbaren Klassifizierung, nicht einen Zustand der KNX-Kommunikation. - Mit **Search an address or a name…** (Adresse oder Namen suchen…) finden Sie eine importierte Adresse. Leeren Sie die Suche, um wieder alles zu sehen. - Nach der Klassifizierung filtert das Badge **N address(es)** (N Adressen) einer Zeile das Inventar auf deren Treffer. Klicken Sie erneut auf dieses Badge oder im Banner **Filtered: …** (Gefiltert: …) auf **Clear** (Löschen), um diesen Filter aufzuheben. Auch die Eingabe einer Suche ersetzt diesen Filter. - Während eines Speichervorgangs oder nach dessen Fehlschlag können die Zähler noch die vorherige Klassifizierung widerspiegeln. Warten Sie das Ende der Verarbeitung ab und lesen Sie die Meldungen, bevor Sie Schlüsse ziehen. ## Das Wörterbuch speichern Änderungen an Schlüsselwörtern, Modi und Suchbereichen werden automatisch gespeichert, mit einer neuen Klassifizierung. Verlassen Sie nach der Eingabe eines Namens das Feld, um diese Änderung zu speichern. 1. Warten Sie unten im Bereich, bis **Saving…** (Wird gespeichert…) abgeschlossen ist. 2. Das Bedienelement zum Speichern, **Save now** (Jetzt speichern), kann **Saved** (Gespeichert) oder **Failed — Retry** (Fehlgeschlagen — Erneut versuchen) anzeigen. Klicken Sie darauf, um das Speichern und die Aktualisierung der Klassifizierung ausdrücklich anzufordern, insbesondere nach einem Zurücksetzen oder um zu prüfen, ob Ihre Regeln angewendet wurden. 3. Warten Sie das Ende ab, ohne die Seite zu schließen. 4. Prüfen Sie die Treffer und klicken Sie dann auf **Next step** (Nächster Schritt), um [die Komponenten unter Structure zu überprüfen](https://wiki.can-nx.com/de/guides/boss-knx-structure/). ## Bezeichnungen ausschließen Ausschlüsse listen die Bezeichnungen auf, die beim Import ignoriert werden sollen, zum Beispiel um Diagnose-, Test- oder Wartungsadressen des KNX-Projekts auszusortieren. 1. Geben Sie unter **Template → Exclusions** (Vorlage → Ausschlüsse) im Feld **Add an ignored label** (Zu ignorierende Bezeichnung hinzufügen) eine Bezeichnung ein und klicken Sie dann auf **Add** (Hinzufügen). 2. Prüfen Sie die resultierende Klassifizierung. Ein Ausschluss löscht eine bereits angelegte Komponente nicht von selbst. Das Kreuz auf einem Chip entfernt diesen Ausschluss. **Show advanced filters → + Add rule** (Erweiterte Filter anzeigen → + Regel hinzufügen) bietet ein Feld **Pattern** (Muster) und **Case insensitive** (Groß-/Kleinschreibung ignorieren) für eine Regex-Regel. Verwenden Sie nur eine für Ihr Projekt validierte Regel. Um eine Regel bestätigen oder einen unsicheren Treffer erklären zu lassen, wenden Sie sich an den Support, statt immer mehr Filter hinzuzufügen. ## Eine Kategorie löschen oder die Vorlage zurücksetzen - **Delete category** (Kategorie löschen) fragt nach einer Bestätigung, bevor ihre Einträge gelöscht werden. - **Reset** (Zurücksetzen) unten im Bereich fragt nach einer Bestätigung, bevor alle Kategorien und Schlüsselwörter gelöscht werden. Klicken Sie nach dem Bestätigen auf **Save now**, um dieses Zurücksetzen anzuwenden, und prüfen Sie dann das Ergebnis. **Reset** ist von **Reset topology** (Topologie zurücksetzen) zu unterscheiden, das die Organisation des Gebäudes betrifft. Diese Aktionen bieten keine automatische Wiederherstellung einer früheren Vorlage: Bei einer unsicheren Wiederherstellung wenden Sie sich an den Support. ## Ergebnis prüfen 1. Warten Sie, bis **Saved** nach Ihrer letzten Änderung erscheint. Derselbe Text vor Ihren Änderungen oder eine bereits zugängliche Struktur zeigt nicht an, dass die letzte Änderung angewendet wurde. 2. Prüfen Sie unter **Group addresses** die Anzahl der erkannten Adressen und die Treffer der geänderten Zeilen. 3. Prüfen Sie unter **Structure** die Gruppierungen, bevor Sie die Komponenten anlegen. ## Fehlerbehebung - Gesperrter Schritt: [Importieren Sie zuerst die .knxproj-Datei](https://wiki.can-nx.com/de/guides/boss-knx-project/). - Fehlgeschlagenes Laden, **Failed — Retry** oder eine andere Fehlermeldung: Folgen Sie der [Fehlerbehebung für das Wörterbuch](https://wiki.can-nx.com/de/guides/boss-knx-project-help/). Besteht das Problem weiter, wenden Sie sich an support@can-nx.com. Französische Bezeichnungen: **Dictionnaire**, **Configuration du template de composant**, **Template**, **+ Catégorie**, **Type de composant**, **+ Ajouter un datapoint**, **+ Mot-clé**, **Périmètre de recherche**, **Définir le périmètre de recherche**, **Valider**, **Annuler**, **Par type**, **Par nom**, **Appliquer à tout**, **Adresses de groupe**, **Enregistrer maintenant**, **Enregistré**, **Échec — Réessayer**, **Charger le template par défaut**, **Réinitialiser**.