Lösung der Artikel aus dem Herstellerkatalog

Dieser Artikel behandelt folgende Themen:

• Import
• Wie ein Bezeichner aufgelöst wird
• So öffnen Sie die Katalogartikelauflösung
• So fügen Sie einen Service-Endpunkt hinzu
• So fügen Sie eine Auflösungsregel hinzu
• So importieren Sie Regeln aus einer CSV-Datei
• So überprüfen Sie eine Kennung

Import

„Herstellerkatalog-Artikelauflösung“ ist eine MyKNX-Funktion für KNX-Hersteller. Hier wird festgelegt, wie die Seriennummern (SN) und GTINs Ihrer Geräte den Katalogartikeln zugeordnet werden, beispielsweise wenn ein Gerät in ETS gescannt wird. Für jeden Bereich von Identifikatoren wählen Sie eine von zwei Optionen:

• Von KNX verwaltete Zuordnung: KNX speichert die Zuordnung und gibt den von Ihnen ausgewählten Katalogartikel zurück.
• Weiterleitung an Ihren Service: Die Abfrage wird an einen von Ihnen betriebenen HTTPS-Endpunkt weitergeleitet, der den Katalogeintrag zurückgibt.

Wie ein Bezeichner aufgelöst wird

Bei der Abfrage einer Seriennummer oder einer GTIN werden die Regeln in folgender Reihenfolge ausgewertet:

1. Die SN oder GTIN wird abgefragt, beispielsweise wenn ein Gerät in ETS gescannt wird.
2. Zunächst werden Ihre Servivevorschriften überprüft. Stimmt die Kennung mit dem Bereich einer Serviceregel überein, wird die Anfrage an Ihren Endpunkt weitergeleitet.
3. Von KNX gehostete Zuordnungen dienen als Ausweichlösung. Wenn keine Serviceregel übereinstimmt und eine von KNX verwaltete Zuordnung übereinstimmt, gibt KNX Ihren Katalogartikel zurück.
4. Noch nicht geklärt. Wenn keine Regel zutrifft, wird kein Katalogartikel zurückgegeben.

Sie können diese Erläuterung auch in MyKNX einsehen, indem Sie auf „Wie eine Kennung aufgelöst wird“ klicken.

So öffnen Sie die Katalogartikelauflösung

1. Melden Sie sich bei MyKNX an und wählen Sie Ihr Unternehmen in der Organisationsauswahl aus.
2. Gehen Sie zu „Konto“ und klicken Sie in der Spalte „Mitglied“ auf „Auflösung der Artikel aus dem Herstellerkatalog“.

Auf dieser Seite werden Ihre bestehenden Regeln aufgelistet. Sie können diese nach Regeltyp („Alle Regeln“, „Ihr Service“, „KNX-gehostet“) und nach Kennung („SN und GTIN“, „SN“, „GTIN“) filtern oder nach Bereich, Katalogartikel oder Endpunkt suchen.

So fügen Sie einen Service-Endpunkt hinzu

Ein Endpunkt ist nur erforderlich, wenn Sie Lookups an Ihren eigenen Service weiterleiten möchten. Definieren Sie einen Endpunkt einmalig und verwenden Sie ihn in mehreren Serviceregeln wieder.

1. Klicken Sie im Feld „Ihre Service-Endpunkte“ auf „Endpunkt hinzufügen“.
2. Geben Sie einen Namen für Ihr Team ein, z. B. „Produktionsservice“ oder „Staging“.
3. Geben Sie den Endpunkt ein: eine HTTPS-URL, die dieselbe Abfrage wie der öffentliche Endpunkt (?sn= oder ?gtin=) empfängt und dieselbe Antwort zurückgibt.
4. Klicken Sie auf „Speichern“.

So fügen Sie eine Auflösungsregel hinzu

1. Klicken Sie auf „Regel hinzufügen“.
2. Unter 1 · Wählen Sie als Kennung entweder „Seriennummer (SN)“ oder „GTIN“ aus.
3. Wählen Sie den Bereich aus:
   • Min/Max: Geben Sie die untere und die obere Grenze (einschließlich) ein. Bei SN besteht das Format aus dem Herstellercode, gefolgt von 8 Hexadezimalziffern (MMMM:HHHHHHHH). Geben Sie für die GTIN bis zu 14 Ziffern ein; kürzere GTINs werden automatisch normalisiert.
   • Platzhalter: Geben Sie ein Muster ein, bei dem Fragezeichen (?) für ein beliebiges Zeichen stehen, z. B. 00FA:0000????.
   • Alle meine Seriennummern: Umfasst alle Seriennummern Ihres Herstellercodes (nur SN).
4. Unter 2 · Wie diese gelöst werden, wählen Sie bitte aus:
   • „KNX-Hosted Mapping“ und wählen Sie den Katalogartikel aus (beginnen Sie mit der Eingabe, um nach Produktnamen oder Katalogartikel-ID zu suchen), oder
   • Leiten Sie die Nachricht an Ihren Service weiter und wählen Sie den Endpunkt aus.
5. Klicken Sie auf „Speichern“.

So importieren Sie Regeln aus einer CSV-Datei

Um mehrere Regeln in einem Schritt zu erstellen, klicken Sie auf „CSV importieren“. Jede Zeile ordnet Seriennummern oder GTINs einem Katalogartikel zu oder leitet die Abfrage an einen Ihrer Service-Endpunkte weiter. Die Datei muss im UTF-8-Format vorliegen, durch Kommas getrennt sein und eine Kopfzeile enthalten. Sie können eine Vorlage von der Importseite herunterladen („CSV-Vorlage herunterladen“).

So überprüfen Sie eine Kennung

Verwenden Sie das Kontrollkästchen „Identifikator prüfen“, um zu sehen, welche Regel gilt, bevor ein Gerät den Feldbereich erreicht. Geben Sie eine Seriennummer (z. B. 00FA:00000007) oder eine GTIN ein und klicken Sie auf „Prüfen“. Das Ergebnis zeigt die zutreffende Regel an oder „Nicht zugeordnet“, falls der Bezeichner keiner Regel entspricht.