Desencadenador de servidor TCP/IP

Para saber más sobre los desencadenadores en general, consulte el tema Comprender los desencadenadores.

El evento de desencadenador de servidor TCP/IP se produce cuando se reciben datos en el socket monitoreado (dirección IP y número de puerto).

Uso típico: El sistema de negocio existente ejecuta una transacción, que en efecto envía los datos al servidor NiceLabel Automation en un socket específico. El contenido de los datos puede estructurarse en CSV, XML y otros formatos, o bien en un formato heredado. De cualquier modo, NiceLabel Automation leerá los datos, analizará los valores utilizando los filtros y los imprimirá en etiquetas. Para obtener más información sobre el modo de analizar y extraer datos, consulte la sección Comprender los filtros.

General

Nota

Este desencadenador admite el Protocolo de Internet versión 6 (IPv6).

Esta sección le permite configurar los parámetros más importantes del desencadenador de archivo.

Puerto: Especifica el número de puerto donde se aceptarán los datos de entrada. Utilice el número de puerto que no está en uso por otra aplicación. Si el puerto seleccionado está en uso, no podrá iniciar el desencadenador en Automation Manager. Para obtener más información sobre problemas de seguridad, consulte la sección Asegurar el acceso a sus desencadenadores.

Nota

Si su servidor tiene hospedaje múltiple habilitado (más direcciones IP en una o más tarjetas de red), NiceLabel Automation responderá en el puerto definido en todas las direcciones IP.

Número máximo de llamadas concurrentes: especifica el número máximo de conexiones aceptadas. Esa cantidad de clientes simultáneos pueden enviar datos al desencadenador al mismo tiempo.

Las opciones de la sección Evento de ejecución especifican cuándo se debe disparar el desencadenador y comenzar a ejecutar las acciones.

Cuando se desconecta el cliente: Especifica que el desencadenador se disparará después de que el cliente envíe datos y cierre la conexión. Este es un parámetro predeterminado.

Nota

Si desea enviar el estado del trabajo de impresión a la aplicación de terceros como comentarios, no utilice esta opción. Si la conexión se deja abierta, pueden enviarse comentarios utilizando la acción Enviar datos a puerto TCP/IP con el parámetro Responder al remitente.

Cuando se recibe cierta cantidad de caracteres: especifica que el desencadenador se dispara cada vez que se recibe la cantidad requerida de caracteres. En este caso, la aplicación de terceros puede mantener una conexión abierta y enviar datos continuamente. Todos los segmentos de datos deben tener el mismo tamaño.
Cuando se recibe una secuencia de caracteres: Especifica que el desencadenador se dispara cada vez que se recibe la secuencia requerida de caracteres. Utilice esta opción si sabe que el "final de los datos" siempre está identificado por un conjunto único de caracteres. Puede insertar caracteres especiales (binarios) utilizando el botón que se encuentra junto al campo de edición.
- Incluir en datos de desencadenador: La secuencia de caracteres que determina que el evento de desencadenador no se elimina de los datos, sino que se incluye junto con los datos. El evento recibe la secuencia completa de datos recibidos.
Cuando no se recibe nada después de un intervalo específico de tiempo: especifica que el desencadenador se activa después de que transcurre un intervalo específico de tiempo después de que se recibe el último carácter.

Ejecución

Permitir conexiones desde los siguientes hosts: Especifica la lista de direcciones IP o nombres de host de computadoras que tienen permitido conectarse al desencadenador. Coloque cada entrada en una nueva línea.
Negar conexiones desde los siguientes hosts: Especifica la lista de direcciones IP o nombres de host de computadoras que no tienen permitido conectarse al desencadenador. Coloque cada entrada en una nueva línea.
Mensaje de bienvenida: Especifica el mensaje de texto que se muestra al cliente cada vez que se conecta al desencadenador TCP/IP.
Mensaje de respuesta: Especifica el mensaje de texto que se muestra al cliente cada vez que se ejecutan acciones. Utilice esta opción cuando el cliente no se desconecta después de enviar datos y espera la respuesta cuando termina la ejecución de acciones. El mensaje de respuesta tiene una codificación rígida y, por lo tanto, es siempre el mismo.
Codificación de mensaje: Especifica el esquema de codificación de datos para que los caracteres especiales puedan procesarse correctamente. NiceLabel Automation puede detectar automáticamente la codificación de datos, en función del encabezado BOM (archivos de texto) o del atributo de codificación (archivos XML).

Otros

Las opciones en la sección Comentarios del motor de impresión especifican los parámetros de comunicación que le permiten recibir comentarios del motor de impresión.

Impresión supervisada: Activa el modo de impresión sincronizada. Utilícela siempre que quiera enviar el estado del trabajo de impresión a una aplicación de terceros. Para obtener más información, consulte el tema Modo de impresión sincronizada.

Las opciones en la sección Procesamiento de datos especifican si quiere recortar los datos para que entren en la variable o ignorar las variables de las etiquetas faltantes. En forma predeterminada, notificará los errores e interrumpirá el proceso de impresión si intenta guardar valores muy largos en la variable de la etiqueta o intenta configurar valores para variables de etiquetas no existentes.

Ignorar exceso de contenido de variables: trunca los valores de datos que exceden la longitud de la variable tal lo definido en el diseñador de etiquetas para que se ajusten. Esta opción está en efecto cuando se configuran valores de variables en los filtros, desde los archivos de comandos y cuando se configuran valores de variables de desencadenadores para las variables de etiquetas del mismo nombre.

Ejemplo 22. Ejemplo

La variable de la etiqueta acepta 5 caracteres como máximo. Con esta opción habilitada, cualquier valor de más de cinco caracteres se trunca a los primeros cinco caracteres. Si el valor es 1234567 ignora los dígitos 6 y 7.
Ignorar variables de etiquetas faltantes: Al imprimir con archivos de comandos (como un archivo JOB), el proceso de impresión ignora todas las variables que están:
- especificadas en el archivo de comandos (que usan el comando SET)
- no definidas en la etiqueta
Lo mismo sucede si define el área de asignación en un filtro para que extraiga todos los pares nombre-valor, pero su etiqueta contiene menos variables.

Al configurar valores de variables de etiquetas no existentes, informo un error. Si esta opción está habilitada la impresión continúa.

Las opciones en la sección Secuencia de comandos especifican las posibilidades de las secuencias de comandos.

Idioma de secuencias: Selecciona el idioma de secuencias para el desencadenador. Todas las acciones Ejecutar secuencia de comandos que utiliza dentro de un solo desencadenador usan el idioma de secuencia de comandos. seleccionado.

Las opciones en la sección Guardar datos recibidos especifican los comandos disponibles para los datos recibidos por el desencadenador.

Guardar datos recibidos por el desencadenador en el archivo: Habilite esta opción y guarde los datos recibidos por el desencadenador. La opción Variable habilita un nombre de archivo variable. Seleccione una variable que contenga la ruta y el nombre de archivo.
Al guardar datos recibidos por el desencadenador en el archivo: Habilite esta opción para guardar los datos en el desencadenador sólo si se produce un error durante la ejecución de la acción. Puede activar esta opción para mantener los datos que causaron el problema listos para resolver el problema más adelante.

Nota

Asegúrese de habilitar el soporte para impresión supervisada. De lo contrario, Automation no puede detectar errores durante la ejecución. Para obtener más información, consulte el tema Modo de impresión sincronizada.

Nota

Automation guarda los datos recibidos en un archivo temporal. Este archivo temporal se elimina inmediatamente después de que se completa la ejecución del desencadenador. La variable interna DataFileName hace referencia a ese nombre de archivo. Para obtener más información, consulte el tema Variables internas.

Enviar señales keepalive

El sistema de enrutamiento de la red puede perder la conexión sin avisar cuando no hay tráfico TCP/IP durante algunos minutos. A fin de evitar la desconexión, puede hacer que se envíen periódicamente señales keepalive en NiceLabel Automation.

Habilite el envío de señales keepalive en su archivo product.config:

Navegue a la carpeta Sistema.

%PROGRAMDATA%\NiceLabel\NiceLabel 10
Haga una copia de seguridad del archivo product.config.
Abra product.config en el editor de texto. El archivo tiene una estructura XML.
Agregue las siguientes líneas:
```
<configuration>
   <IntegrationService>
     <KeepAliveTime>60000</KeepAliveTime>
     <KeepAliveInterval>10000</KeepAliveInterval>
   </IntegrationService>
</configuration>
```
Nota

KeepAliveTime (en milisegundos): Especifica durante cuánto tiempo debe estar inactiva la conexión del socket de conexión TCP antes de que Automation envíe una señal keepalive y espere a que se responda con paquetes de reconocimiento.

KeepAliveInterval (en milisegundos): Especifica los intervalos entre el envío de un paquete keepalive y otro en caso de que el host no responda con ningún paquete de reconocimiento.

Cuando el desencadenador TCP/IP recibe el paquete keepalive y responde con un paquete de reconocimiento, el temporizador de KeepAliveTime se reinicia.

Ambos valores (KeepAliveTime y KeepAliveInterval) son obligatorios para habilitar el envío de señales keepalive, y deben tener un valor superior a 0.
Guarde el archivo product.config.
Reinicie su Automation service.

Una vez habilitadas las señales keepalive, la conexión se mantendrá activa.