Enlace de peligro
¡Su guía para la integración de V5!
El punto final de importación 'HazardLink' se puede utilizar para asignar rápidamente productos a peligro grupos dentro de V5 Trazabilidad.
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 riesgo predeterminados
La base de datos V5 predeterminada incluye varios de los grupos de riesgo más comunes, pero este punto final se puede utilizar para crear otros grupos adicionales si es necesario. Los grupos de riesgo estándar que se incluyen se pueden ver en la siguiente captura de pantalla:
Este punto final no está destinado a ser utilizado para la creación de productos básicos, esto siempre debe hacerse a través de 'Mercancía' punto final.
2. Enlaces API
Para obtener más información sobre las definiciones de este 'HazardLink' y las clases de bases de datos relacionadas, consulte el siguiente enlace:
3. Guía de campo de HazardLink
3.1. Claves primarias
Para ambas metodologías de importación, las claves principales son:
Peligro_Peligro – el nombre del grupo de peligro (es decir, gafas de seguridad, protectores auditivos, etc.).
Código de mercancía – El código único del producto que se asignará al Grupo de Peligro.
3.2. Campos Adicionales
Otras opciones aquí que podemos agregar desde la clase de base de datos 'Hazard' son:
Texto de advertencia de peligro – El texto que se mostrará a un operador de terminal o WMS cuando se manipule el producto asociado a un peligro. Solo es necesario si se crean nuevos grupos de peligros.
Color del texto de peligro – Permite la entrada de un número RGB para asignar un color al grupo de riesgo. Tenga en cuenta que esto debe ser igual para todos los productos dentro del mismo grupo de riesgo. Tenga en cuenta también que 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).
Tenga en cuenta que esta opción no está disponible para la metodología JSON, a menos que se cree un nuevo grupo de riesgo a través de este punto de conexión. Si se requiere modificar los colores de los grupos existentes, se recomienda utilizar el punto de conexión CSV.
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:
- Alcohol bencílico – Máscara de seguridad (naranja) y guantes de seguridad (rojos)
- Propilenglicol – Gafas de seguridad (azules) y guantes de seguridad (rojos)
5. Metodología
5.1. JSON – Importar
Punto final/URI de importación 'HazardLink' –
http://host:port/V5-API/api/integrate/import/hazard_link
muestras:
Usando el punto final 'HazardLink', podemos estructurar un archivo de importación para las adiciones anteriores de la siguiente manera:
Este archivo JSON de muestra 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 peligro correcto, en este caso podemos ver ambos productos agregados al grupo de peligro "Guantes de seguridad".
5.2. CSV – Importar
Para las importaciones CSV, primero debemos construir un archivo de encabezado para nuestras importaciones.
Nombre de archivo de definición de encabezado/columna: “enlace de peligro.csvh”
Los archivos de encabezado completos deben colocarse en: “ \SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “hazardLink-fecha y hora.csv”
Los CSV para la importación deben colocarse en: " \SG Control Center\puerta de enlace\importación”
muestras:
Archivo de cabecera:
A continuación se muestra un ejemplo de archivo de encabezado. Aquí asignaremos nuestros productos a los grupos de riesgo definidos y también agregaremos un color a los grupos:
Para obtener más información sobre cómo estructuramos estos archivos, consulte el página principal de integración. Este archivo de encabezado de muestra 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í:
Tenga en cuenta nuevamente que no necesitamos las comas que normalmente separan los valores RGB. Este archivo de importación de muestra 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, podemos ver que los colores del texto del grupo de peligro se han actualizado y, como se indicó anteriormente, los 2 ingredientes ahora se agregan al grupo 'Guantes de seguridad':
