Overslaan en naar hoofdcontent gaan

Zoeken

KNX-apparaatontwikkeling

Informatie over de ontwikkeling van KNX-apparaten

      Oplossing van catalogusitems van fabrikanten

      Vassilios Lourdas
      • Bijgewerkt

      De functie ‘Catalogusitems van de fabrikant’ koppelt serienummers en GTIN’s aan catalogusitems via door KNX gehoste koppelingen of HTTPS-service-endpoints. Via MyKNX kunnen fabrikanten endpoints aanmaken, regels toevoegen of importeren, de volgorde van resolutie begrijpen en identificatiecodes controleren.

      ✨Deze inhoud is met behulp van AI opgesteld.

      Dit artikel behandelt de volgende onderwerpen:

      Inleiding

      De functie Resolutie van catalogusitems van fabrikanten’ is een MyKNX-functie voor KNX-fabrikanten. Hiermee wordt bepaald hoe de serienummers (SN) en GTIN's van uw apparaten aan catalogusitems worden gekoppeld, bijvoorbeeld wanneer een apparaat in ETS wordt gescand. Voor elk bereik van identificatiecodes kiest u een van twee opties:

      • Door KNX gehoste mapping: KNX slaat de mapping op en retourneert het catalogusitem dat u hebt geselecteerd.
      • Doorsturen naar uw service: De opzoekaanvraag wordt doorgestuurd naar een HTTPS-endpoint dat door u wordt beheerd en dat het catalogusitem retourneert.

      Zonder resolutieregels kunnen uw serienummers en GTIN's niet aan catalogusitems worden gekoppeld.

      Hoe een identificatiecode wordt opgelost

      Wanneer een serienummer of GTIN wordt opgezocht, worden de regels in deze volgorde geëvalueerd:

      1. SN of GTIN opzoeken. Bijvoorbeeld wanneer een apparaat in ETS wordt gescand.
      2. Eerst worden uw serviceregels gecontroleerd. Als de identificatiecode binnen het bereik van een serviceregel valt, wordt de aanvraag doorgestuurd naar uw endpoint.
      3. Door KNX gehoste mappings dienen als terugvaloptie. Als er geen serviceregel overeenkomt en een door KNX gehoste mapping wel overeenkomt, geeft KNX uw catalogusitem weer.
      4. Niet opgelost. Als geen enkele regel overeenkomt, wordt er geen catalogusitem weergegeven.

      U kunt deze uitleg ook in MyKNX bekijken door op 'Hoe een identificatiecode wordt opgelost' te klikken.

      Hoe u de oplossing van catalogusitems opent

      1. Meld u aan bij MyKNX en selecteer uw bedrijf via de organisatiekiezer.
      2. Ga naar 'Account' en klik in de kolom 'Lid' op 'Oplossing van catalogusitems van fabrikanten'.

      Op deze pagina vindt u een overzicht van uw bestaande regels. U kunt deze filteren op regeltype ('Alle regels', 'Uw service', 'Door KNX gehost') en op identificatiecode ('SN en GTIN', 'SN', 'GTIN'). U kunt ook zoeken op bereik, catalogusitem of endpoint.

      Hoe u een service-endpoint toevoegt

      Een endpoint is alleen nodig als u opzoekaanvragen naar uw eigen service wilt doorsturen. U hoeft een endpoint slechts één keer te definiëren en kunt het vervolgens in meerdere serviceregels gebruiken.

      1. Klik in het gedeelte 'Uw service-endpoints' op 'Endpoint toevoegen'.
      2. Voer een naam in die herkenbaar is voor uw team, bijvoorbeeld 'Productieservice' of 'Staging'.
      3. Voer het endpoint in: een HTTPS-URL die dezelfde query als het publieke endpoint ontvangt (?sn= of ?gtin=) en hetzelfde antwoord weergeeft.
      4. Klik op "Opslaan".

      Hoe u een resolutieregel toevoegt

      1. Klik op „Regel toevoegen”.
      2. Selecteer onder 1 · Welke identificatiecodes de identificatiecode: 'Serienummer (SN)' of 'GTIN'.
      3. Selecteer het bereik:
        • Min/Max: voer de onder- en bovengrens in (inclusief). Voor SN bestaat het formaat uit de fabrikantcode, gevolgd door 8 hexadecimale cijfers (MMMM:HHHHHHHH). Voer voor de GTIN maximaal 14 cijfers in; kortere GTIN’s worden automatisch aangepast.
        • Wildcard: voer een patroon in waarbij vraagtekens (?) elk willekeurig teken vertegenwoordigen, bijvoorbeeld 00FA:0000????.
        • Al mijn serienummers: omvat alle serienummers van uw fabrikantcode (alleen SN).
      4. Kies onder 2 · Hoe ze worden opgelost:
        • Door KNX gehoste mapping: Selecteer het catalogusitem (begin te typen om op productnaam of catalogusitem-ID te zoeken), of
        • Doorsturen naar uw service en selecteer het Endpoint.
      5. Klik op "Opslaan".

      Om naar uw dienst door te sturen, moet er eerst een endpoint bestaan. Als er nog geen endpoint is gedefinieerd, sluit u het dialoogvenster, voegt u een endpoint toe onder 'Uw service-endpoints' en maakt u vervolgens de regel opnieuw aan.

      Hoe u regels uit een CSV-bestand importeert

      Om meerdere regels in één stap aan te maken, klikt u op 'CSV importeren'. Elke rij koppelt serienummers of GTIN's aan een catalogusitem of stuurt de opzoekaanvraag door naar een van uw service-endpoints. Het bestand moet UTF-8-gecodeerd zijn, komma's als scheidingsteken gebruiken en een koprij bevatten. U kunt een sjabloon downloaden vanaf de importpagina ('CSV-sjabloon downloaden').

      Kolom Vereist Toegestane waarden Beschrijving
      identifier Ja SN, GTIN Het type identificatiecode waarop de regel van toepassing is.
      range_type Ja min_max, wildcard, all all (al mijn serienummers) geldt uitsluitend voor SN.
      min / max Wanneer range_type gelijk is aan min_max SN: MMMM:HHHHHHHH · GTIN: 1–14 cijfers Onder- en bovengrens, inclusief. Kortere GTIN’s worden aangepast tot 14 cijfers.
      wildcard Als range_type gelijk is aan wildcard SN: MMMM:HHHHHHHH met ? · GTIN: 14 tekens met ? Vraagteken (?) staat voor elk teken binnen het bereik.
      resolution_type Ja hosted, forward Door KNX gehoste mapping of doorsturen naar uw service.
      catalog_item_id Als resolution_type gelijk is aan hosted Een bestaande catalogusitem-ID Doel voor gehoste regels.
      endpoint_name Als resolution_type gelijk is aan forward De naam van een bestaand endpoint Doel voor doorstuurregels.

      Kolommen die niet van toepassing zijn op het gekozen range_type of resolution_type moeten leeg blijven. Endpoints worden aangemaakt onder 'Uw service-endpoints' en niet via CSV. Bij het importeren worden uitsluitend nieuwe regels toegevoegd; bestaande regels worden nooit gewijzigd.

      Hoe u een identificatiecode controleert

      Gebruik het selectievakje 'Een identificatiecode controleren' om te zien welke regel van toepassing is voordat een apparaat in gebruik wordt genomen. Voer een serienummer (bijv. 00FA:00000007) of een GTIN in en klik op „Controleren”. Het resultaat toont de overeenkomende regel of 'Niet opgelost' als de identificatiecode met geen enkele regel overeenkomt.

      Verwante artikelen

      Niet gevonden wat u zocht?
      Community