La funzione Risoluzione articoli del catalogo del produttore associa i numeri di serie e i codici GTIN agli articoli del catalogo tramite mappature ospitate su KNX o endpoint di servizio HTTPS. MyKNX consente ai produttori di creare endpoint, aggiungere o importare regole, comprendere l’ordine di risoluzione e verificare gli identificativi.
Il presente articolo tratta i seguenti argomenti:
- Import
- Come viene risolto un identificativo
- Come aprire la risoluzione di un articolo del catalogo
- Come aggiungere un endpoint di servizio
- Come aggiungere una regola di risoluzione
- Come importare regole da un file CSV
- Come verificare un identificativo
Import
La funzione Risoluzione articoli del catalogo del produttore è una funzionalità di MyKNX destinata ai produttori KNX. Esso definisce in che modo i numeri di serie (SN) e i codici GTIN dei vostri dispositivi vengono associati alle voci del catalogo, ad esempio quando un dispositivo viene scansionato in ETS. Per ogni intervallo di identificativi, si sceglie una delle due opzioni seguenti:
- Mappatura gestita da KNX: KNX memorizza la mappatura e restituisce l’elemento del catalogo da lei selezionato.
- Inoltro al suo servizio: la richiesta viene inoltrata a un endpoint HTTPS gestito da lei, che restituisce la voce del catalogo.
In assenza di regole di risoluzione, i suoi numeri di serie e GTIN non possono essere associati alle voci del catalogo.
Come viene risolto un identificativo
Quando si effettua una ricerca per numero di serie o GTIN, le regole vengono valutate nel seguente ordine:
- Si effettua la ricerca del codice SN o GTIN, ad esempio quando si esegue la scansione di un dispositivo in ETS.
- Vengono verificate innanzitutto le sue regole di servizio. Se l'identificativo corrisponde all'intervallo di una regola di servizio, la richiesta viene inoltrata al suo endpoint.
- Le mappature gestite da KNX costituiscono la soluzione alternativa. Se nessuna regola di servizio corrisponde e una mappatura gestita da KNX corrisponde, KNX restituisce la voce del suo catalogo.
- Non risolto. Se nessuna regola corrisponde, non viene restituito alcun elemento di catalogo.
Potete trovare questa spiegazione anche su MyKNX cliccando su "Come viene risolto un identificativo".
Come aprire la risoluzione di un articolo del catalogo
- Acceda a MyKNX e selezioni la sua azienda dal menu di selezione delle organizzazioni.
- Vada su "Account" e, nella colonna "Membro", faccia clic su "Risoluzione articoli del catalogo del produttore".
La pagina elenca le regole già esistenti. È possibile filtrarle in base al tipo di regola (“Tutte le regole”, “Il suo servizio”, “Gestite da KNX”) e all’identificatore (“SN e GTIN”, “SN”, “GTIN”), oppure effettuare una ricerca per intervallo, articolo di catalogo o endpoint.
Come aggiungere un endpoint di servizio
Un endpoint è necessario solo se si desidera reindirizzare le ricerche al proprio servizio. Basta definire un endpoint una volta e riutilizzalo in più regole di servizio.
- Nella casella "I suoi endpoint di servizio", faccia clic su "Aggiungi endpoint".
- Inserisca un nome per il suo team, ad esempio "Servizio di produzione" o "Prove".
- Inserisca l'endpoint: un URL HTTPS che riceva la stessa query dell'endpoint pubblico (
?sn=o?gtin=) e restituisca la stessa risposta. - Clicchi su "Salva".
Come aggiungere una regola di risoluzione
- Clicchi su "Aggiungi regola".
- Al punto 1 · Quali identificativi: selezionare l’ identificativo “Numero di serie (SN)” o “GTIN”.
- Selezionare l'intervallo:
-
Min/Max: inserisca i valori limite inferiore e superiore (compresi). Per SN, il formato è costituito dal codice del produttore seguito da 8 cifre esadecimali (
MMMM:HHHHHHHH). Per il codice GTIN, inserisca fino a 14 cifre; i codici GTIN più brevi vengono normalizzati automaticamente. -
Carattere jolly: inserisca una sequenza in cui i punti interrogativi (?) sostituiscono qualsiasi carattere, ad esempio
00FA:0000????. - Tutti i miei numeri di serie: comprende tutti i numeri di serie relativi al suo codice produttore (solo SN).
-
Min/Max: inserisca i valori limite inferiore e superiore (compresi). Per SN, il formato è costituito dal codice del produttore seguito da 8 cifre esadecimali (
- Al punto 2 · Come vengono risolti? Scegliete:
- Mappatura gestita da KNX e selezionare la voce del catalogo (iniziare a digitare per effettuare la ricerca in base al nome del prodotto o all’ID della voce del catalogo), oppure
- Acceda al suo servizio e selezioni l’Endpoint.
- Clicchi su "Salva".
Per poter inoltrare al suo servizio, è necessario che esista innanzitutto un endpoint. Se non ne è stato definito alcuno, chiuda la finestra di dialogo, aggiunga un endpoint nella sezione "I vostri endpoint di servizio" e quindi crei nuovamente la regola.
Come importare regole da un file CSV
Per creare più regole in un unico passaggio, faccia clic su "Importa CSV". Ogni riga associa i numeri di serie o i codici GTIN a un articolo del catalogo oppure inoltra la richiesta di ricerca a uno dei suoi endpoint di servizio. Il file deve essere in formato UTF-8, con i valori separati da virgole e deve contenere una riga di intestazione. È possibile scaricare un modello dalla pagina di importazione ("Scarica il modello CSV").
| Colonna | Richiesto | Valori consentiti | Descrizione |
|---|---|---|---|
identificativo |
Si |
SN, GTIN
|
Tipo di identificativo a cui si applica la regola. |
tipo_intervallo |
Si |
min_max, caratteri jolly, tutti
|
tutti (tutti i miei numeri di serie) è valido solo per i numeri di serie. |
min / max
|
Quando range_type è min_max | SN: MMMM:HHHHHHHH · GTIN: da 1 a 14 cifre |
Limite inferiore e limite superiore, inclusi. I codici GTIN più brevi vengono normalizzati a 14 cifre. |
carattere jolly |
Quando range_type è un carattere jolly | SN: MMMM:HHHHHHHH con ? · GTIN: 14 caratteri con ? |
I punti interrogativi (?) corrispondono a qualsiasi carattere dell'intervallo. |
tipo_di_risoluzione |
Si |
gestito, inoltrato
|
Mappatura gestita da KNX o inoltro al tuo servizio. |
id_articolo_di_catalogo |
Quando resolution_type è gestito | L'ID di un elemento di catalogo esistente | Destinazione per le regole gestite. |
nome_endpoint |
Quando resolution_type è inoltra | Il nome di un endpoint esistente | Destinazione per le regole di inoltro. |
Le colonne che non si applicano al tipo di intervallo (range_type) o al tipo di risoluzione (resolution_type) selezionati devono essere lasciate vuote. Gli endpoint vengono creati nella sezione "I vostri endpoint di servizio", non tramite CSV. L'importazione si limita ad aggiungere regole; le regole esistenti non vengono mai modificate.
Come verificare un identificativo
Utilizzi la casella "Verifica un identificativo" per verificare quale regola si applica prima che un dispositivo raggiunga il campo. Inserisca un numero di serie (ad es. 00FA:00000007) o un codice GTIN e faccia clic su "Verifica". Il risultato mostra la regola corrispondente oppure "Non risolto" qualora l'identificativo non corrisponda ad alcuna regola.