Enlace de alérgenos
¡Su guía para la integración de V5!
El punto final de importación 'AllergenLink' se puede utilizar para asignar rápidamente productos a grupos de alérgenos dentro de V5 Traceability.
Esta guía se centrará en cómo utilizar este punto final, tanto a través de la importación CSV como mediante JSON a través de la API V5.
Índice
1. Grupos de alérgenos predeterminados
La base de datos V5 predeterminada incluye varios de los grupos de alérgenos más comunes, pero este punto final se puede utilizar para crear otros grupos adicionales si es necesario. Los grupos de alérgenos estándar que se incluyen se pueden ver en la siguiente captura de pantalla:
Este punto final no está diseñado para la creación de productos básicos; esto siempre debe hacerse a través del punto final " Productos básicos ".
2. Enlaces API
Para obtener más información sobre las definiciones de este 'AllergenLink' y las clases de bases de datos relacionadas, consulte el siguiente enlace:
3. Guía de campo de AllergenLink
3.1. Claves primarias
Para ambas metodologías de importación, las claves principales son:
Alérgeno_Alérgeno : el nombre del grupo de alérgenos (es decir, trigo, gluten, etc.).
Código_de_producto : El código único del producto que se asignará al Grupo de Alérgenos.
3.2. Campos Adicionales
Otras opciones aquí que podemos agregar desde la clase de base de datos 'Alérgeno' son:
Allergen_TextColor : Permite ingresar un número RGB para asignar un color al grupo de alérgenos. Tenga en cuenta que este color debe ser el mismo para todos los productos dentro del mismo grupo de alérgenos. Además, al importar colores mediante este método, los números RGB no necesitan estar separados por comas (por ejemplo, 219 125 33 en lugar de 219, 125, 33).
4. Conjunto de datos de ejemplo
Para este artículo, analizaremos un conjunto de datos de ejemplo simple que incluye cinco ingredientes que podrían usarse durante la producción:
Aquí asignaremos los siguientes grupos de alérgenos predeterminados a estos productos. Para las importaciones CSV, también asignaremos colores de texto al mismo tiempo:
- Harina – Trigo (rojo) y gluten (morado)
- Queso – Lácteos (amarillo)
- Huevos – Huevo (verde)
- Soja – Soja (azul)
- Almendras – Frutos secos (naranja)
5. Metodología
5.1. JSON – Importar
Punto final/URI de importación de 'AllergenLink' –
http://host:port/V5-API/api/integrate/import/allergen_link
muestras:
Usando el punto final 'AllergenLink', podemos estructurar un archivo de importación para las adiciones anteriores de la siguiente manera:
Este archivo JSON de ejemplo se puede descargar aquí.
Y una vez que hemos publicado esto en el sistema, podemos ver que todos nuestros productos han sido asignados al grupo de alérgenos correcto, en este caso las almendras bajo "Frutos secos".
5.2. CSV – Importar
Para las importaciones CSV, primero debemos construir un archivo de encabezado para nuestras importaciones.
Nombre del archivo de definición de encabezado/columna: “allergenLink.csvh”
Los archivos de encabezado completados deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar archivo CSV: “allergenLink-datetime.csv”
Los archivos CSV para importar deben colocarse en: “<installdir>\SG Control Center\gateway\import”
muestras:
Archivo de cabecera:
A continuación, se muestra un ejemplo de archivo de encabezado. Aquí asignaremos nuestros productos a los grupos de alérgenos definidos y también agregaremos un color a los grupos:
Para obtener más información sobre cómo estructuramos estos archivos, consulte la página principal de integración . Este archivo de encabezado de ejemplo se puede descargar aquí.
Archivo de importación CSV:
Luego, podemos usar el orden definido de los puntos de datos en el encabezado para estructurar nuestro archivo de importación. Tenga en cuenta que el Centro de control puede ignorar esta primera fila y, por lo tanto, puede conservarla en el archivo al enviarlo para su importación. Un ejemplo de importación basado en nuestros requisitos anteriores se vería así:
Nótese de nuevo que no necesitamos las comas que normalmente separan los valores RGB. Este archivo de importación de ejemplo se puede descargar aquí.
Luego podemos colocar este archivo en nuestra carpeta de importación como se definió anteriormente, y una vez que se complete la importación, ya podemos ver que los colores del texto del grupo de alérgenos se han actualizado:
Y si examinamos cada grupo veremos que se han añadido los alérgenos deseados:
