Trabajos/Órdenes de producción
¡Su guía para la integración de V5!
La integración de trabajos/órdenes de producción entre V5 Traceability y el sistema ERP de un cliente permite programar órdenes de trabajo para fórmulas de lotes y productos dentro de V5 Traceability. Estos detalles permitirán que estos trabajos sean procesados por la Terminal V5.
Índice
1. Disposición del centro de control
En términos de cómo podemos relacionar los detalles del trabajo con lo que vemos en el Centro de control, usaremos la API V5 principalmente para completar el panel superior "Trabajo" para importar y exportar estos detalles, con información en el panel inferior "Línea de trabajo". se completa automáticamente según la configuración de la fórmula/receta.
Usando V5 Gateway podemos completar fácilmente los datos aquí usando el ‘Job’ punto final. Sin embargo, se puede adoptar un enfoque más avanzado que haga uso de la ‘PreBatch’ punto final. Veremos el uso de ambos a continuación.
2. Enlaces API
3. Plantilla de integración
Se puede descargar la plantilla de integración para Trabajos/Órdenes de Producción aquí.
4. Guía de campo de órdenes de trabajo/producción
4.1. Claves primarias
Las claves primarias son el identificador único para cada tabla dentro de la API V5. Para Job, estos son:
jobNumber – El código de identificación único para el trabajo.
formula.commodity.code – El código de identificación único de la fórmula que se programará.
Para PreBatch, las claves primarias son:
jobLine.job.jobNumber – Como arriba, el código de identificación único para el trabajo.
BatchSeq – La secuencia de producción del lote para esa línea de trabajo en particular.
4.2. Campos requeridos
SG requiere otros campos para completar una línea de trabajo válida en el Centro de control. Para Job, esto es:
products – La cantidad de productos necesarios (relacionados con la UM base de la fórmula) por lote en la línea superior (trabajo) de este trabajo.
Para PreBatch, esto es:
products – La cantidad de productos que debe producir el lote individual.
4.3. Campos preferidos
Los campos preferidos sirven para agregar más información sobre el trabajo en cuestión y, aunque no son obligatorios, son útiles cuando se trata de funciones adicionales dentro de Trazabilidad V5. Para Job, estos podrían incluir:
batchesRequired – El número de lotes necesarios para el trabajo. Si esto no está presente, entonces el sistema utilizará la cantidad de productos (descrita anteriormente) y el tamaño base + productos mínimo/máximo para calcular el número de lotes a producir.
status – El estado con el que se importará el trabajo (0 = Pendiente, 1 = Programado, 2 = En curso, 3 = Completo, 4 = En prueba, 5 = En espera), los trabajos normalmente se importarían con el estado de '1', a menos que deban programarse manualmente en una fecha posterior y, por lo tanto, puedan importarse con el estado '0'.
Estos campos también podrían aplicarse a PreBatch una vez que hayamos atravesado el objeto de trabajo dentro de la API.
4.4. Campos Adicionales
También se pueden incluir campos adicionales para el Job punto final, como por ejemplo:
productionDate – La fecha en que se producirá el trabajo. Se importará como en blanco si no está presente, lo que permitirá que los terminales vean los trabajos en todo momento.
Para PreBatch, podemos atravesar este mismo campo bajo jobLine.job.productionDate. Sin embargo, también podemos utilizar el jobLine.productionDate campo para afectar la fecha de producción de la línea de trabajo individual en lugar de todo el trabajo en sí, lo que nos permite un control más estricto sobre nuestro proceso de producción.
5. Metodología
Dependiendo del método utilizado para nuestra integración, podemos utilizar los siguientes puntos finales para facilitar las importaciones. Esto puede ser:
- ‘Job’ or ‘Prebatch’ puntos finales para la integración JSON.
- ‘Job’ punto final para la integración de archivos compartidos CSV.
Las exportaciones se pueden manejar de varias maneras, las cuales veremos a continuación.
5.1. JSON – Importar
Trabajo:
Podemos hacer uso de la ‘Job’ endpoint para crear nuevos trabajos para la producción en V5 Traceability.
‘Job’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/job
Para esta importación de muestra usando el ‘Job’ punto final, podemos estructurar un archivo de importación básico para un solo trabajo de la siguiente manera:
Este archivo JSON de muestra se puede descargar aquí.
Usando el manual de API, podemos ver aquí que estamos usando varios de los puntos de datos dentro del ‘Job’ clase para estructurar este archivo. Sin embargo, para recordar correctamente el código de fórmula que queremos producir, primero debemos atravesar el ‘Formula’ clase, y luego usar el ‘Commodity’ clase para definir el ‘Code’ punto de datos que podemos usar y luego anidarlo en el archivo JSON de manera adecuada, como podemos ver arriba.
Podemos ver un resumen de este proceso de flujo de datos a continuación:
Si ejecutamos el archivo JSON anterior, veremos que nuestro trabajo ahora está visible en la pestaña 'Producción' en el Centro de control.
Notarás que esto ha creado automáticamente las líneas de trabajo en el panel inferior. El ‘Job’ El punto final hará esto automáticamente según el estructura de la fórmula.
Pre-lote:
Podemos ver arriba que podemos usar el ‘Job’ endpoint para ingresar trabajos simples en el plan de producción en Trazabilidad V5. Sin embargo, si queremos un control más preciso sobre la configuración de nuestro trabajo, podemos hacer uso del ‘PreBatch’ URI en su lugar. Esto nos permite especificar detalles como el tamaño del lote individual/recuento de productos y la ubicación de producción.
‘PreBatch’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/pre_batch
Para esta importación de muestra usando el ‘PreBatch’ punto final, podemos estructurar un archivo de importación básico para un solo trabajo con múltiples lotes como se muestra a continuación
Este archivo JSON de muestra se puede descargar aquí.
Entonces podemos ver al examinar este archivo que estamos creando un nuevo trabajo (Trabajo-111) con 2 lotes de una fórmula de 'Masa de pan básica', uno de 30 libras, que se fabricará en la fabricación 1, y otro de 50 libras, que se hecho en fabricación 2. Si miramos el manual API para el ‘PreBatch’ clase, entonces podemos ver un método de recorrido similar en juego aquí para construir nuestro archivo.
Si ejecutamos el archivo JSON anterior, veremos este nuevo trabajo creado y luego, si echamos un vistazo a la vista por lotes, veremos las diferencias en los tamaños de lote/ubicaciones de producción, así como nuestra configuración personalizada preestablecida. números de lote. La secuenciación por lotes también se puede incluir aquí si se desea.
5.2. JSON – Exportar
En términos de recibir archivos relacionados con trabajos desde la API V5, hay algunas opciones diferentes de las clases IntegrationExport y ExportTransaction que podemos usar, que veremos aquí.
Trabajo:
Punto final/URI de exportación de trabajos individuales –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
Este punto final exportará un archivo JSON con toda la información relacionada para el trabajo especificado. Si ejecutamos esta solicitud usando el número de trabajo que acabamos de importar, obtendremos un archivo similar a este:
Se puede descargar un archivo JSON de ejemplo de este tipo. aquí.
Todos los trabajos:
Punto final/URI de exportación de todos los trabajos
http://host:port/V5-API/api/integrate/export/jobs
Este punto final exportará un archivo JSON que incluye una lista de todos activo trabajos en el sistema, definidos como trabajos que tienen un estado distinto de "completado" o que han sido eliminados del Centro de control.
Si ejecutamos esta solicitud, recibiremos un archivo JSON de retorno que está estructurado de manera muy similar a la exportación anterior para un trabajo singular, pero como se mencionó, incluirá todos los trabajos activos.
Se pueden descargar archivos JSON de muestra de este tipo aquí.
También podemos utilizar puntos finales transaccionales y de registro para recuperar información más relevante sobre trabajos y órdenes de producción.
Para Registro del sistema puntos finales, estos son:
5.3. CSV – Importar
Nombre de archivo de definición de encabezado/columna: “job.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “job-datetime.csv”
Los CSV para la importación deben colocarse en: “<installdir>\SG Control Center\gateway\import”
Archivo de cabecera:
Los archivos de encabezado generalmente serán compilados por SG Systems antes de que se realicen las integraciones CSV, pero podemos ver un ejemplo básico de uno que podemos usar para trabajos, usando el formato previamente definido. definiciones de claseabajo:
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 puntos de datos en el encabezado para estructurar nuestro archivo de importación. SG Systems puede proporcionar un archivo de plantilla para esto, enumerando el punto de datos para cada columna para aclarar las cosas al completar la lista. Tenga en cuenta que el Centro de control puede ignorar esta primera fila y, por lo tanto, puede conservarse en el archivo cuando se envía para importar.
Un archivo de importación CSV de ejemplo para trabajos podría verse así:
Este archivo de importación de muestra se puede descargar aquí.
Una vez completada la importación, podemos ver que estos trabajos adicionales se agregaron al Centro de control junto con el trabajo que creamos usando la importación JSON arriba.
5.4. CSV – Exportar
Al igual que con las exportaciones JSON, aquí tenemos un par de opciones diferentes. Podemos empezar simplemente exportando una lista de trabajos dentro del sistema:
Trabajos/Horario:
Exportar nombre de archivo CSV: “job.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\export/order”
Exportar nombre de archivo CSV: “job-datetime.csv”
Los CSV para las exportaciones se generarán en: “<installdir>\SG Control Center\gateway\export”
Podemos usar las definiciones de clases definidas previamente para estructurar un archivo de encabezado para definir qué datos recuperaremos.
Esta exportación deberá habilitarse en la sección Puerta de enlace del Centro de control. Podemos elegir aquí exportar 'Programación'.
Archivo de cabecera:
En este caso, usemos el mismo archivo de encabezado que usamos anteriormente para la importación:
Archivo de exportación CSV:
Obtendríamos un archivo CSV de retorno que se vería así:
Se puede descargar un ejemplo de este tipo de archivo. aquí. Tenga en cuenta que si un archivo de encabezado no está presente en la carpeta indicada, se exportará un CSV que incluye todos los puntos de datos en la carpeta indicada. ‘Job’ clase.
Si bien este punto final solo exportará una lista de trabajos, podemos usar un par de puntos finales diferentes para recuperar información más detallada relacionada con el consumo y la producción.
Registros de lotes:
Exportar nombre de archivo CSV: “BatchLog-datetime.csv”
Los CSV para las exportaciones se generarán en: “<installdir>\SG Control Center\gateway\export”
La forma más sencilla de recuperar datos de producción de trabajos de V5 Traceability en forma de CSV es simplemente usar y procesar "registros de lotes".
Nuevamente, esta exportación también deberá habilitarse en la sección Puerta de enlace del Centro de control. Podemos elegir aquí exportar 'Registros por lotes'.
Archivo de exportación CSV:
No necesitaríamos crear un archivo de encabezado aquí ya que V5 Gateway completará una lista establecida de puntos de datos de forma predeterminada. Con esta exportación habilitada, el sistema exportará un ‘BatchLog’ archivo cada vez que el sistema completa un lote dentro de un trabajo. Un ejemplo básico de esto se muestra a continuación:
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Registro del sistema:
Si queremos recibir datos de producción de trabajos más personalizados o detallados (‘CONSUMED’/’PRODUCE’) Sin embargo, después de la trazabilidad V5, podemos hacer uso de la ‘SystemLog’ punto final para hacer esto.
Nombre de archivo de definición de encabezado/columna: “SystemLog.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\export\order”
Exportar nombre de archivo CSV: “SystemLog-datetime.csv”
Los CSV para las exportaciones se generarán en: “<installdir>\SG Control Center\gateway\export”
Para este tipo de exportación usando este punto final, estructuraríamos nuestro encabezado usando el ‘SystemLog’ definiciones de clases de bases de datos.
Al igual que con los otros ejemplos anteriores, esta exportación debería habilitarse en la sección Puerta de enlace del Centro de control:
Archivo de cabecera:
Desde aquí podemos estructurar nuestro encabezado dependiendo de qué datos transaccionales relacionados con los trabajos queremos recibir de regreso al ERP. Para nuestros propósitos aquí, esto podría verse así:
Este archivo de encabezado de muestra se puede descargar aquí.
Archivo de exportación CSV:
Si luego ejecutamos un lote simple, la exportación del registro del sistema se verá así:
Este ejemplo de exportación se puede descargar aquí.
