La fonctionnalité Résolution des articles du catalogue du fabricant permet d'associer les numéros de série et les codes GTIN aux articles du catalogue via des mappages hébergés sur KNX ou des points de terminaison de service HTTPS. MyKNX permet aux fabricants de créer des terminaux, d'ajouter ou d'importer des règles, de comprendre l'ordre de résolution et de vérifier les identifiants.
Cet article couvre les sujets suivants :
- Insérer
- Comment un identifiant est résolu
- Comment ouvrir la résolution d'un article du catalogue
- Comment ajouter un point de terminaison de service
- Comment ajouter une règle de résolution
- Comment importer des règles à partir d'un fichier CSV
- Comment vérifier un identifiant
Insérer
La fonction Résolution des références du catalogue du fabricant est une fonctionnalité de MyKNX destinée aux fabricants KNX. Elle définit la manière dont les numéros de série (SN) et les GTIN de vos appareils sont associés aux articles du catalogue, par exemple lors du scan d’un appareil dans ETS. Pour chaque plage d'identifiants, vous choisissez l'une des deux options suivantes :
- Mappage géré par KNX: KNX stocke le mappage et renvoie l'élément du catalogue que vous avez sélectionné.
- Transfert vers votre service: la requête est transmise à un point de terminaison HTTPS que vous gérez, lequel renvoie l'élément du catalogue.
Sans règles de mise en correspondance, vos numéros de série et vos GTIN ne peuvent pas être associés à des articles du catalogue.
Comment un identifiant est résolu
Lorsqu'une recherche est effectuée sur un numéro de série ou un GTIN, les règles sont évaluées dans l'ordre suivant :
- Le numéro SN ou GTIN est recherché, par exemple lorsqu'un appareil est scanné dans ETS.
- Vos règles de service sont vérifiées en premier lieu. Si l'identifiant correspond à la plage d'une règle de prestation de service, la requête est transmise à votre point de terminaison.
- Les mappages hébergés par KNX constituent la solution de secours. Si aucune règle de service ne correspond et qu'un mappage hébergé par KNX correspond, KNX renvoie votre élément de catalogue.
- Non résolu. Si aucune règle ne correspond, aucun article de catalogue n'est renvoyé.
Vous pouvez également consulter cette explication dans MyKNX en cliquant sur « Comment un identifiant est-il résolu ? ».
Comment ouvrir la résolution d'un article du catalogue
- Connectez-vous à MyKNX et sélectionnez votre entreprise dans le menu de sélection des organisations.
- Accédez à la rubrique « Compte » et, dans la colonne « Membre », cliquez sur « Résolution des références du catalogue du fabricant ».
Cette page répertorie vos règles existantes. Vous pouvez les filtrer par type de règle (« Toutes les règles », « Votre service », « Hébergées par KNX ») et par identifiant (« SN et GTIN », « SN », « GTIN »), ou effectuer une recherche par plage, référence de catalogue ou point de terminaison.
Comment ajouter un point de terminaison de service
Un point de terminaison n'est nécessaire que si vous souhaitez rediriger les requêtes vers votre propre service. Définissez un point de terminaison une seule fois et réutilisez-le dans plusieurs règles de prestation de service.
- Dans la zone « Vos points de terminaison de service », cliquez sur « Ajouter un point de terminaison ».
- Saisissez un Nom pour votre équipe, p. ex. « Service de production » ou « Environnement de test ».
- Saisissez le point de terminaison: une URL HTTPS qui reçoit la même requête que le point de terminaison public (
?sn=ou?gtin=) et renvoie la même réponse. - Cliquez sur « Enregistrer ».
Comment ajouter une règle de résolution
- Cliquez sur « Ajouter une règle ».
- Sous 1 · Quels identifiants? Sélectionnez l'identifiant: « Numéro de série (SN) » ou « GTIN ».
- Sélectionnez la Plage:
-
Min/Max: saisissez les limites inférieures et supérieures (incluses). Pour le numéro de série (SN), le format est le suivant : le code du fabricant suivi de 8 chiffres hexadécimaux (
MMMM:HHHHHHHH). Pour le GTIN, saisissez jusqu'à 14 chiffres ; les GTIN plus courts sont normalisés automatiquement. -
Caractère générique: saisissez un motif dans lequel les points d'interrogation (?) remplacent n'importe quel caractère, par exemple
00FA:0000????. - Tous mes numéros de série: cela couvre tous les numéros de série correspondants à votre code fabricant (numéros de série uniquement).
-
Min/Max: saisissez les limites inférieures et supérieures (incluses). Pour le numéro de série (SN), le format est le suivant : le code du fabricant suivi de 8 chiffres hexadécimaux (
- Sous 2 · Comment sont-elles résolues, choisissez :
- « Mapping hébergé par KNX » et sélectionnez l'élément du catalogue (commencez à saisir le nom du produit ou l'identifiant de l'élément du catalogue pour lancer la recherche), ou
- Accédez à votre service et sélectionnez le point de terminaison.
- Cliquez sur « Enregistrer ».
Pour pouvoir rediriger vers votre service, un point de terminaison doit d'abord exister. Si aucun n'est défini, fermez la boîte de dialogue, ajoutez un point de terminaison sous « Vos points de terminaison de service », puis recréez la règle.
Comment importer des règles à partir d'un fichier CSV
Pour créer plusieurs règles en une seule fois, cliquez sur « Importer un fichier CSV ». Chaque ligne associe des numéros de série ou des GTIN à un article du catalogue, ou transfère la requête vers l'un de vos points de terminaison de service. Le fichier doit être au format UTF-8, les données doivent être séparées par des virgules et il doit comporter une ligne d'en-tête. Vous pouvez télécharger un modèle depuis la page d'importation (« Télécharger le modèle CSV »).
| Colonne | Requis | Valeurs autorisées | Description |
|---|---|---|---|
identifiant |
Oui |
SN, GTIN
|
Type d'identifiant auquel la règle s'applique. |
type_de_plage |
Oui |
min_max, caractère générique, tout
|
all (tous mes numéros de série) ne s'applique qu'aux numéros de série. |
min / max
|
Quand range_type est min_max | SN : MMMM:HHHHHHHH · GTIN : 1 à 14 chiffres |
Limites inférieures et supérieures, incluses. Les codes GTIN plus courts sont normalisés à 14 chiffres. |
caractère générique |
Quand range_type est un caractère générique | SN : MMMM : HHHHHHHH avec ? · GTIN : 14 caractères, dont un ? |
Les points d'interrogation (?) correspondent à n'importe quel caractère de la plage. |
type_de_résolution |
Oui |
hébergé, transféré
|
Mappage hébergé par KNX ou transmission à votre prestation de service. |
catalog_item_id |
Quand resolution_type est hosted | ID d'un article de catalogue existant | Cible des règles hébergées. |
endpoint_name |
Lorsque resolution_type est forward | Le nom d'un point de terminaison existant | Cible pour les règles de transfert. |
Les colonnes qui ne s'appliquent pas au type de plage (range_type) ou au type de résolution (resolution_type) sélectionné doivent rester vides. Les points de terminaison sont créés dans la section « Vos points de terminaison de service », et non via un fichier CSV. L'importation se contente d'ajouter des règles ; les règles existantes ne sont jamais modifiées.
Comment vérifier un identifiant
Cochez la case « Vérifier un identifiant » pour savoir quelle règle s'applique avant qu'un appareil n'atteigne le terrain. Saisissez un numéro de série (p. ex. 00FA:00000007) ou un GTIN, puis cliquez sur « Vérifier ». Le résultat indique la règle de correspondance, ou « Non résolu » si l'identifiant ne correspond à aucune règle.