La función 'Resolución de Elementos del Catálogo del Fabricante asocia los números de serie y los GTIN a los artículos del catálogo mediante asignaciones alojadas en KNX o puntos finales de servicio HTTPS. MyKNX permite a los fabricantes crear dispositivos finales, añadir o importar reglas, comprender el orden de resolución y comprobar los identificadores.
Este artículo cubre los siguientes temas:
- Introducción
- Cómo se resuelve un identificador
- Cómo abrir la Resolución de un Elemento del Catálogo
- Cómo añadir un punto final de servicio
- Cómo añadir una regla de resolución
- Cómo importar reglas desde un archivo CSV
- Cómo comprobar un identificador
Introducción
Resolución de Elementos del Catálogo del Fabricante es una función dentro de MyKNX dirigida a los fabricantes KNX. Define cómo se asocian los números de serie (SN) y los GTIN de sus dispositivos a los elementos del catálogo, por ejemplo, cuando se escanea un dispositivo en ETS. Para cada rango de identificadores, se debe elegir una de las dos opciones siguientes:
- Asignación gestionada por KNX: KNX almacena la asignación y devuelve el elemento del catálogo que ha seleccionado.
- Reenvío a su servicio: la consulta se reenvía a un endpoint HTTPS gestionado por usted, que devuelve el elemento del catálogo.
Sin reglas de resolución, sus números de serie y GTIN no podrán asociarse a artículos del catálogo.
Cómo se resuelve un identificador
Cuando se consulta un número de serie o un GTIN, las reglas se evalúan en este orden:
- Se consulta el SN o el GTIN, por ejemplo, cuando se escanea un dispositivo en ETS.
- En primer lugar, se comprueban sus normas de servicio. Si el identificador coincide con el rango de una regla de servicio, la solicitud se reenvía a su endpoint.
- Las asignaciones gestionadas por KNX constituyen la solución alternativa. Si no hay ninguna regla de servicio que coincida y sí hay una asignación gestionada por KNX que coincida, KNX devuelve su elemento del catálogo.
- Sin resolver. Si ninguna regla coincide, no se devuelve ningún elemento del catálogo.
También puede consultar esta explicación en MyKNX haciendo clic en 'Cómo se resuelve un identificador'.
Cómo abrir la Resolución de Elementos del Catálogo
- Inicie sesión en MyKNX y seleccione su empresa en el selector de organizaciones.
- Vaya a 'Cuenta' y, en la columna 'Miembro', haga clic en 'Resolución de Elementos del Catálogo del Fabricante'.
En esta página se muestran las reglas que tiene actualmente. Puede filtrarlas por tipo de regla ('Todas las reglas', 'Su servicio', 'Gestionado por KNX') y por identificador ('SN y GTIN', 'SN', 'GTIN'), o bien realizar una búsqueda por rango, elemento de catálogo o endpoint.
Cómo añadir un endpoint de servicio
Solo se necesita un endpoint si desea redirigir las consultas a su propio servicio. Defina un endpoint una vez y reutilícelo en varias reglas de servicio.
- En el cuadro 'Sus endpoints de servicio', haga clic en 'Añadir endpoint'.
- Introduzca un Nombre para su equipo, por ejemplo, 'Servicio de producción' o 'Entorno de pruebas'.
- Introduzca el Endpoint: una URL HTTPS que reciba la misma consulta que el endpoint público (
?sn=o bien?gtin=) y devuelva la misma respuesta. - Haga clic en 'Guardar'.
Cómo añadir una regla de resolución
- Haga clic en 'Añadir regla'.
- En el apartado 1 · Identificadores: seleccione el Identificador: 'Número de serie (SN)' o 'GTIN'.
- Seleccione el Rango:
-
Mín/Máx: introduzca los valores mínimo y máximo (ambos inclusive). En el caso de SN, el formato consiste en el código del fabricante seguido de 8 dígitos hexadecimales (
MMMM:HHHHHHHH). Introduzca un GTIN de hasta 14 dígitos; los GTIN más cortos se normalizan automáticamente. -
Carácter comodín: introduzca un patrón en el que los signos de interrogación (?) representen cualquier carácter; por ejemplo:
00FA:0000????. - Todos mis números de serie: incluye todos los números de serie de su código de fabricante (solo SN).
-
Mín/Máx: introduzca los valores mínimo y máximo (ambos inclusive). En el caso de SN, el formato consiste en el código del fabricante seguido de 8 dígitos hexadecimales (
- En el apartado 2 · Cómo se resuelven; elija:
- Seleccione Mapeo gestionado por KNX y el Elemento del catálogo (comience a escribir para buscar por nombre de producto o por ID del elemento del catálogo), o bien
- Redirigir a su servicio y seleccione el Endpoint.
- Haga clic en 'Guardar'.
Para poder redirigir a su servicio, primero debe existir un endpoint. Si no se ha definido ninguno, cierre el cuadro de diálogo, añada un endpoint en 'Sus endpoints de servicio' y, a continuación, vuelva a crear la regla.
Cómo importar reglas desde un archivo CSV
Para crear varias reglas de una sola vez, haga clic en 'Importar CSV'. Cada fila asocia números de serie o GTIN a un elemento del catálogo, o bien reenvía la consulta a uno de sus endpoints de servicio. El archivo debe estar en formato UTF-8, con los datos separados por comas y debe contener una fila de encabezado. Puede descargar una plantilla desde la página de importación ('Descargar la plantilla CSV').
| Columna | Requerido | Valores permitidos | Descripción |
|---|---|---|---|
identifier |
Sí |
SN, GTIN
|
Tipo de identificador al que se aplica la regla. |
range_type |
Sí |
min_max, wildcard, all
|
all (todos mis números de serie) solo es válido para SN. |
min / max
|
Cuando range_type es min_max | SN: MMMM:HHHHHHHH · GTIN: 1–14 dígitos |
Límites inferior y superior, ambos inclusive. Los GTIN más cortos se normalizan a 14 dígitos. |
wildcard |
Cuando range_type es wildcard | SN: MMMM:HHHHHHHH, con '?' · GTIN: 14 caracteres con '?' |
Los signos de interrogación (?) coinciden con cualquier carácter del rango. |
resolution_type |
Sí |
hosted, forward
|
Asignación gestionada por KNX o reenviada a su servicio. |
catalog_item_id |
Cuando resolution_type es hosted | Un ID de elemento del catálogo existente | Destino de las reglas gestionadas. |
endpoint_name |
Cuando resolution_type es forward | El nombre de un endpoint existente | Destino de las reglas de reenvío. |
Las columnas que no sean aplicables al 'range_type' o al 'resolution_type' seleccionados deben dejarse en blanco. Los endpoints se crean en la sección 'Sus endpoints de servicio', no mediante el archivo CSV. La importación solo añade reglas; las reglas existentes nunca se modifican.
Cómo comprobar un identificador
Utilice la casilla 'Comprobar un identificador' para ver qué regla se aplica antes de que un dispositivo llegue al campo. Introduzca un número de serie (por ejemplo, 00FA:00000007) o un GTIN y haga clic en 'Comprobar'. El resultado muestra la regla con la que coincide, o bien muestra la respuesta 'Sin resolver' si el identificador no coincide con ninguna regla.