Cómo usar varios registros con una integración POST de socket o servicio web
Descripción general
Al enviar datos a través de un socket o en una integración de servicios web, tienes la opción de enviar más de un registro, de manera similar a una estructura de tabla en una integración de archivos. Esto te permitirá enviar más información en un solo archivo de activación.
Cuando creas una nueva integración, solo leerá y procesará un registro. Sin embargo, con algunas acciones adicionales, puedes hacer que la integración procese varios registros en su lugar.
Aplicable a
BarTender 2019 y versiones posteriores
Edición Automation y superiores
Información
Es posible enviar datos por TCP o mediante POST que ya tengan una estructura similar a una "tabla", como en el siguiente ejemplo:
Para poder usar el contenido de archivos "planos" como variables, primero se necesitan dos acciones adicionales: "Para cada registro de base de datos" y "Transformar texto en conjunto de registros":
Estas dos acciones se pueden usar "sin importar el tipo de integración", ya que se basarán en los valores de la variable %EventData%, que es la variable donde se guarda toda la información entrante para la integración.
La acción Transformar texto en conjunto de registros solo acepta bases de datos basadas en texto como CSV, delimitadas por tabulaciones u otras bases de datos delimitadas de forma similar. Bases de datos basadas en texto más complejas como XML o JSON no funcionarán correctamente.
Configurar la acción "Transformar texto en conjunto de registros"
La primera acción que debes definir es la acción "Transformar texto en conjunto de registros" (esta acción transformará los datos en una estructura similar a una base de datos):
- Primero necesitarás tener un archivo de "ejemplo" que se usará para definir la estructura de los datos entrantes. Por ejemplo, utiliza un documento de muestra con la misma estructura que luego se usará en los datos enviados por TCP o POST.
- Haz clic en el botón "Configuración de conexión de base de datos..." y luego usa el asistente para vincular el archivo de base de datos de "ejemplo" a la integración. Una vez conectada la base de datos, cierra el cuadro de diálogo.
- En la opción "Fuente de texto" asegúrate de que la "Variable" esté configurada como "%EventData%" y que la salida también sea "%EventData%".
Esto significa que los datos que la acción va a usar son los que están en la variable "%EventData%", que es donde la integración guarda automáticamente todos los datos entrantes.
Configurar la acción "Para cada registro de base de datos"
Después de que los datos se dividan en registros, la integración necesitará saber cómo manejar estos registros entrantes. La acción "Para cada registro de base de datos" con una acción "Imprimir documento" anidada como su hija asegurará que cada registro se imprima individualmente durante la impresión:
La acción "Para cada registro de base de datos" no requiere configuración, sin embargo, deberás definir cómo se ajustan los datos a la etiqueta. Esto se hace en la acción Imprimir documento.
- Primero, tu etiqueta debe tener todos los valores configurados con Fuentes de datos con nombre.
- Haz clic en el botón Importar configuración de documento para importar y rellenar los nombres de las fuentes de datos con nombre.
- Luego, relaciona la fuente de datos con nombre de la etiqueta con los nombres de los campos de la base de datos de ejemplo. Si no asignaste nombres de campo, serán los nombres generados automáticamente como Campo1, Campo2, etc.
- Selecciona el ícono de variable en la tabla de fuentes de datos con nombre para insertar el nombre del campo desde el cuadro de diálogo. Los nombres de los campos se encontrarán en la sección Acción como se muestra a continuación:
Si conoces los nombres de los campos, puedes escribirlos manualmente con la sintaxis %NOMBREDECAMPO%.