Enlace de campo personalizado

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.

Puede encontrar más información sobre cómo funciona esto y diferentes ejemplos de uso de campos personalizados. aquí.

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.

1. Disposición del centro de control
2. Enlaces API
3. Guía de campo de CustomFieldLink
   1. Claves primarias
   2. Campos requeridos
4. Ejemplo de conjunto de datos
5. Metodología
   1. 1. JSON – Importar
      2. CSV – Importar

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:

Enlace de campo personalizado 

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 le estamos asignando nuestra fórmula. Podemos verlo arriba como "Distribuido por".

Código de mercancía – El código único de la fórmula del producto/mercancía que se asignará al grupo de campos personalizados.

Podemos agregar otros datos necesarios para completar la importación tanto desde el 'Campo personalizado'Y'Enlace de campo personalizado' clases de base de datos. Estas son:

Desde CustomField:

Campo_EtiquetaParámetro – Necesario si se crea 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 se trata de "DIST".

Campo_Valor_predeterminado – El valor predeterminado que se recordará cuando se use el parámetro de etiqueta, siempre que no haya un valor específico de producto o fórmula para anularlo en el panel inferior, "CustomFieldLink". En el ejemplo del Centro de control anterior, podemos ver que es "SG Systems LLC".

Desde CustomFieldLink:

Dato – La información que debe recordarse en la etiqueta para ese producto o fórmula específicos cuando se utiliza 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:

• P006:
  • Distribuido por: Distribución ABC.
  • Instrucciones de preparación: Lavar antes de usar.
• P007:
  • Distribuido por: Distribuidores de Dave
  • Instrucciones de preparación: Lavar antes de usar.
• P008:
  • Distribuido por: Distribución SGS.
  • Instrucciones de preparación: Lavar antes de usar.

Punto final/URI de importación 'CustomFieldLink'

http://host:port/V5-API/api/integrate/import/custom_field_link

Descripción del punto final

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 muestra 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 de archivo de definición de encabezado/columna: “enlace de campo personalizado.csvh”

Los archivos de encabezado completos deben colocarse en: “ \SG Control Center\gateway\import\column_defs”

Importar nombre de archivo CSV: “Enlace de campo personalizado-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 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 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í:

Este archivo de importación de muestra 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: