Para saber más sobre los desencadenadores en general, consulte el tema Comprender los desencadenadores.
El evento de desencadenador HTTP se dispara si se reciben datos en el socket monitoreado (dirección IP y número de puerto).
A diferencia de lo que sucede con el desencadenador TCP/IP, los datos recibidos no están en una secuencia de datos sin procesar, sino que incluyen el encabezado HTTP estándar. Las aplicaciones de terceros deben usar los métodos de solicitud POST o GET. Deben proporcionar datos en el cuerpo del mensaje o en una cadena de búsqueda. Puede usar ambos tipos de medios de Internet en el cuerpo de mensaje: tipo MIME o tipo de contenido. NiceLabel Automation recibe el mensaje y extraer los datos relevantes del contenido del mensaje usando un filtro.
Uso típico: el sistema de negocio existente ejecuta una transacción, que envía los datos al servidor NiceLabel Automation con formato de mensaje HTTP POST en un socket específico. Los datos enviados pueden estar estructurados en CSV, XML y otros formatos, o bien pueden estructurarse usando formato heredado propio. De cualquier modo, NiceLabel Automation leerá los datos, analizará los valores utilizando los filtros y los imprimirá los datos extraídos en etiquetas. Para obtener más información sobre el modo de analizar y extraer datos, consulte la sección Comprender los filtros.
Suministrar datos
Proporcione datos al desencadenador HTTP usando cualquiera de los siguientes métodos. De ser necesario, también puede combinar los métodos y utilizar ambos en la misma solicitud HTTP.
Datos en la cadena de consulta
Una cadena de consulta es la parte de un localizador uniforme de recursos (URL) que contiene los datos que se pasarán al desencadenador HTTP.
Un ejemplo de un URL típico que contiene una cadena de consulta:
http://server/path/?query_string
El signo de pregunta se utiliza como separador y no forma parte de la cadena de consulta.
La cadena de consulta generalmente está compuesta de una serie de pares name:value
. Dentro de cada par, el nombre de campo y el valor están separados por signos igual (=). La serie de pares se separa mediante la Y comercial (&). Una cadena de consulta típica proporciona valores para campos (variables) en el siguiente formato:
field1=value1&field2=value2&field3=value3
El desencadenador HTTP ofrece soporte integrado para extraer valores de todos los campos y almacenarlos en variables que llevan el mismo nombre. Como resultado, no debe definir ningún filtro para extraer valores de la cadena de consulta.
-
No debe definir variables dentro de un desencadenador para cargarlas con valores de la cadena de consulta. NiceLabel Automation extraerá todas las variables en la cadena de consulta y enviará los valores a la etiqueta activa. Si existen variables con el mismo nombre en la etiqueta, Automation los carga con valores. Si las variables no existen en la etiqueta, Automation ignora sus valores sin informar ningún error.
-
Si una acción requiere valores de variables, defina las variables correspondientes en el desencadenador. Para obtener y almacenar todos los valores de la cadena de consulta, cree variables correspondientes usando los mismos nombres como campos de la cadena de consulta. Para el ejemplo anterior, tiene que definir las variables del desencadenador con los nombres
field1
,field2
yfield3
.
Por lo general, debe utilizar el método de solicitud GET HTTP para proporcionar la cadena de consulta.
Datos en el cuerpo de la solicitud HTTP
Debe utilizar el método de solicitud para proporcionar el mensaje en el cuerpo de la solicitud HTTP.
Puede enviar cualquier tipo de datos o usar cualquier estructura de datos que desee en el cuerpo. Solo debe asegurarse de poder manejar los datos usando NiceLabel Automation filtros. El contenido puede tener formato como XML. CSV o texto sin formato. El contenido enviado puede ser incluso datos binarios (codificado en Base64).. Tenga en cuenta que deberá analizar los datos con filtros.
Si puede influenciar en la estructura del mensaje de entrada, utilice estructuras estandarizadas, como XML o CSV, para simplificar la configuración de los filtros.
Utilice el método de solicitud POST HTTP para proporcionar los datos en el cuerpo del mensaje.
General
Esta sección le permite configurar los parámetros más importantes del desencadenador de archivo.
-
Nombre: Especifica el nombre único del desencadenador. El nombre lo ayuda a distinguir los diferentes desencadenadores cuando los configura en Automation Builder y luego cuando los ejecuta en Automation Manager.
-
Descripción: Le permite describir el rol de este desencadenador. Ingrese una breve explicación acerca de lo que hace el desencadenador para ayudar a los usuarios.
Comunicación
Esta sección le permite configurar el número de puerto obligatorio y las opciones de comentarios opcionales. Puede utilizar los Códigos de respuesta HTTP estándares para indicar que la acción se ejecutó correctamente. Para propósitos más avanzados, también puede enviar el contenido personalizado a la aplicación que suministra los datos. Dicho contenido puede ser simple cadena de comentarios o datos binarios, tales como vista previa de etiqueta o secuencia de impresión.
El URL típico para conectar al desencadenador HTTP es el siguiente:
http://server:port/path/?query_string
-
Servidor: Es la dirección IP o FQDN de la máquina en la que se instaló NiceLabel Automation.
-
Puerto: Número del puerto en el que se reciben los datos entrantes. 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últiples direcciones IP en una o más tarjetas de red), NiceLabel Automation responderá en el puerto definido en todas las direcciones IP.
-
Ruta: Especifica la ruta de acceso opcional en el URL. Esta funcionalidad permite a NiceLabel Automation exponer múltiples desencadenadores HTTP en el mismo puerto. El cliente utilizará los desencadenadores a través de un solo puerto en una sintaxis tipo REST, lo que ocasiona que los distintos desencadenadores se disparen por un URL diferente. Si no está seguro sobre qué utilizar, deje la ruta de acceso predeterminada (\).
-
Conexión segura (HTTPS): habilita una capa de transporte seguro para su mensaje HTTP y previene la intercepción de usuarios no autorizados. Para obtener más información sobre el modo de asegurar la conexión, consulte la sección Usar capa de transporte seguro (HTTPS).
-
Cadena de consulta: Especifica los pares nombre-valor en el URL. Este es un parámetro opcional. Los datos se proporcionan por lo general en el cuerpo de la solicitud HTTP.
-
Esperar a que termine la ejecución del desencadenador: El protocolo HTTP requiere que el receptor (en este caso NiceLabel Automation) envíe una respuesta numérica al remitente para indicar el estado del mensaje recibido. De manera predeterminada, NiceLabel Automation responde con el código 200. Esto indica que Automation recibió correctamente los datos, pero no da información acerca del éxito de las acciones del desencadenador.
Esta opción especifica que un desencadenador no envía una respuesta inmediatamente después de recibir los datos, sino que espera hasta que la acción se ejecute. Luego envía el código de respuesta indicando una ejecución de la acción exitosa. Cuando esta opción está habilitada, puede enviar un tipo de respuesta y datos personalizados (por ejemplo, la respuesta a una solicitud HTTP es una vista previa de etiqueta en formato PDF).
Los códigos de respuesta HTTP integrados disponibles son:
Código de respuesta HTTP
Descripción
200
Todas las acciones ejecutadas correctamente.
401
No autorizado, se especificó un nombre de usuario y una contraseña incorrectos.
500
Se produjeron errores durante la ejecución de la acción.
Nota
Para enviar comentarios acerca del proceso de impresión, habilite el modo de impresiónsincrónico. Para obtener más información, consulte el tema Modo de impresión sincronizada.
-
Número máximo de llamadas simultáneas: especifica el número máximo de conexiones entrantes simultáneas. Esa cantidad de clientes simultáneos pueden enviar datos al desencadenador al mismo tiempo. La cantidad también depende del rendimiento de hardware de su servidor.
Obtenga más información sobre Procesamiento paralelo.
-
Tipo de respuesta: Especifica el tipo de mensaje de respuesta. Los tipos de medios de Internet utilizados frecuentemente (también denominados "tipos MIME" o "tipos de contenido") se predefinen en la casilla desplegable. Si su tipo de medio no está disponible en la lista, ingréselo usted mismo. Automation envía los datos de respuestas de salida como comentario, con formato en el tipo de medio definido. Variable habilita los tipos de medio variables. Si se habilita, seleccione o cree una variable que contenga el tipo de medio.
Nota
Si no especifica el tipo de contenido, NiceLabel Automation utilizará
application/octet-stream
como opción predeterminada. -
Datos de respuesta: Especifica el contenido de su mensaje de respuesta. Algunos ejemplos de lo que puede enviar como una respuesta HTTP: mensajes de error personalizados, vista previa de etiqueta, archivos PDF generados, archivo de secuencia de impresión (archivo de cola de impresión), archivo XML con detalles del motor de impresión más la vista previa de etiqueta (codificada como cadena Base64). Las posibilidades son ilimitadas.
Si enviará contenido únicamente binario (como una vista previa de etiqueta o secuencia de impresión), asegúrese de seleccionar el tipo de medio adecuado; por ejemplo,
image/jpeg
oapplication/octet-stream
.
-
Encabezados adicionales: Le permiten definir encabezados personalizados tipo MIME para el mensaje de respuesta HTTP.
Encontrará la sintaxis del encabezado de la respuesta y ejemplos en la sección acción Solicitud HTTP.
Sugerencia
Con los datos de la respuesta y los Encabezados adicionales, puede utilizar contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para insertar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte la variable desde la lista (o cree una nueva) que contiene los datos que desea usar. Para obtener más información, consulte la sección Usar valores compuestos.
Autenticación
-
Ninguno: No hay ningún método de autenticación en uso.
-
Usuario: Especifica que los mensajes de entrada incluyen nombre de usuario y contraseña. Cuando está en uso, el desencadenador solamente acepta mensajes HTTP cuyas credenciales coincidan. Para obtener más información sobre problemas de seguridad, consulte la sección Asegurar el acceso a sus desencadenadores.
-
Grupo de aplicación (definido NiceLabel Control Center): Como en el caso del tipo de autenticación Usuario, esta opción también especifica que los mensajes de entrada incluyen nombre de usuario y contraseña. Cuando está en uso el desencadenador solo acepta mensajes HTTP con las credenciales adecuadas para usuarios NiceLabel Control Center que pertenecen a un grupo de aplicación específico.
-
Grupo: Pueden definirse múltiples grupos de la aplicación en el NiceLabel Control Center. Para ganar que el grupo debe tener acceso al desencadenador del servidor HTTP, use la lista desplegable Grupo. El grupo seleccionado y sus usuarios deben configurarse como activos cuando el desencadenador se está ejecutando.
Nota
El grupo con un nombre específico debe existir en NiceLabel Control Center cuando el desencadenador se está ejecutando. Mientras trabaja en la configuración en Automation Builder, puede utilizar cualquier nombre de grupo. Asegúrese de eventualmente definir un nombre final en NiceLabel Control Center y hágalo coincidir en la configuración antes de implementarlo.
Sugerencia
Los usuarios se autentican a sí mismos usando sus credenciales según lo definido en NiceLabel Control Center, pestaña Usuarios. Consulte la Guía del usuario NiceLabel Control Center para obtener más detalles sobre la administración de usuarios (sección Usuarios y grupos).
-
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 24. 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, no puede detectar errores durante la ejecución. Para obtener más información, consulte el tema Modo de impresión sincronizada.
Nota
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.