
¡Su guía para la integración de V5!

El punto final de importación 'CustomFieldLink' se puede utilizar para asignar rápidamente mensajes de etiquetas personalizados a productos básicos (generalmente fórmulas de productos terminados) que se pueden imprimir en etiquetas de productos por producto.
Aquí encontrará más información sobre cómo funciona esto y diferentes ejemplos de uso de campos personalizados.
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.
En términos de cómo podemos relacionar los detalles de los campos personalizados con lo que vemos en el Centro de control, utilizaremos la API V5 y Gateway para completar el panel superior 'CustomField' para nombrar nuestros campos personalizados y detalles de parámetros de etiqueta de entrada, así como el panel inferior 'CustomFieldLink' para asignar productos al campo personalizado e ingresar información específica de la fórmula que luego se puede recuperar en el parámetro de etiqueta establecido en el panel superior.

Para obtener más información sobre las definiciones de esta clase 'CustomFieldLink', consulte el siguiente enlace:
Para importar a través del punto final 'CustomFieldLink', las claves principales son:
Nombre_del_campo : el nombre único del campo personalizado que estamos agregando o al que estamos asignando nuestra fórmula. Arriba podemos verlo como 'Distribuido por'.
Código_de_producto : El código único de la fórmula de producto/producto que se asignará al Grupo de campos personalizados.
Podemos agregar otros datos necesarios para completar la importación desde las clases de base de datos ' CustomField ' y ' CustomFieldLink '. Estos son:
Desde CustomField:
Field_LabelParameter : necesario al crear un nuevo grupo de campos personalizados. Este es el parámetro que se utilizará en las etiquetas para recuperar datos personalizados de este grupo. En el ejemplo del Centro de control anterior, podemos ver que es 'DIST'.
Field_DefaultValue : el valor predeterminado que se recuperará al usar el parámetro de etiqueta, siempre que no exista un valor específico de producto/fórmula que lo anule en el panel inferior 'CustomFieldLink'. En el ejemplo del Centro de control anterior, podemos ver que este valor es 'SG Systems LLC'.
Desde CustomFieldLink:
Datos : la información que se mostrará en la etiqueta de ese producto/fórmula específica cuando se utilice el parámetro de etiqueta del grupo de campos personalizados en una etiqueta.
En este artículo, analizaremos un conjunto de datos de ejemplo simple que incluye tres fórmulas de productos diferentes que podemos asignar a la fórmula "Distribuido por" ya creada, lo que le otorga a cada una un mensaje de distribución único. También agregaremos un nuevo grupo de campos personalizados llamado "Instrucciones de preparación", con el parámetro de etiqueta "PREP".

Entonces agregaremos los siguientes datos al sistema:
Punto final/URI de importación 'CustomFieldLink'
http://host:port/V5-API/api/integrate/import/custom_field_link
muestras:
Usando el punto final 'CustomFieldLink', podemos estructurar un archivo de importación para las adiciones anteriores de la siguiente manera:

Tenga en cuenta que, dado que estábamos creando el grupo "Instrucciones de preparación", necesitábamos incluir el parámetro de etiqueta en esta importación. Para el grupo "Distribuido por", no lo necesitamos y podemos simplemente hacer referencia al nombre del grupo en nuestra importación.
Este archivo JSON de ejemplo se puede descargar aquí.
Y una vez que hemos publicado esto en el sistema, podemos ver que nuestras fórmulas de muestra se han agregado al grupo 'Distribuido por', con su mensaje único en la columna 'Datos' del panel inferior:

Y también podemos ver que nuestro nuevo grupo ha sido creado para tener las mismas 'Instrucciones de preparación' para los tres:

Para las importaciones CSV, primero debemos construir un archivo de encabezado para nuestras importaciones.
Nombre del archivo de definición de encabezado/columna: “customFieldLink.csvh”
Los archivos de encabezado completados deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar archivo CSV: “customFieldLink-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 campos personalizados definidos y también agregaremos un nuevo grupo como se definió anteriormente:

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í:

Este archivo de importación de ejemplo se puede descargar aquí.
A diferencia de nuestra importación JSON, debido al mecanismo de importación CSV, en este caso necesitaríamos incluir el parámetro de etiqueta 'DIST' para el grupo 'Distribuido por'.
Luego podemos colocar este archivo en nuestra carpeta de importación como se definió anteriormente, y una vez que se complete la importación, podremos ver que los grupos de campos personalizados se han actualizado/agregado en consecuencia:

Y:
