Esta acción proporciona una interfaz con una aplicación externa y se abre usando una línea de comandos.
Las aplicaciones externas pueden ejecutar un procesamiento adicional y devolver los resultados a NiceLabel 10. Esta acción permite que NiceLabel Automation se enlace con cualquier software de terceros que pueda ejecutar procesamientos de datos adicionales o adquirir datos. El software externo puede proporcionar una respuesta de datos y guardarla en un archivo, desde donde puede leerse en variables.
Nota
NiceLabel Automation se ejecuta como una aplicación de servicio y no puede interactuar con el escritorio, aunque se ejecute con los privilegios del usuario que tenga la sesión iniciada. Microsoft impide dicha interacción por motivos de seguridad.
Esto quiere decir que la acción Abrir documento/programa de NiceLabel Automation solo puede abrir programas que se ejecuten en segundo plano.
Puede enviar los valores de las variables al programa incluyéndolos en la lista de la línea de comandos entre corchetes.
C:\Applications\Processing.exe [variable1] [variable2]
Nota
Si utiliza esta acción en NiceLabel 10 las soluciones, le permite abrir páginas web o crear mensajes de correo electrónico directamente desde sus formularios. Consulte la sección Creación de hipervínculos y envío de correos electrónicos en formulario en NiceLabel 10 la guía del usuario.
El grupo Archivo define el archivo que se abrirá.
-
Nombre de archivo: ubicación y nombre de archivo del archivo o aplicación a abrir.
El nombre de archivo seleccionado puede estar preprogramado, y el mismo archivo se usará cada vez. Si solo se define un nombre de archivo sin ruta, se usa la carpeta con el archivo de configuración (.MISX) de NiceLabel Automation. Puede usar una referencia relativa para el nombre del archivo si se usa la carpeta con el archivo .MISX como carpeta raíz.
Origen de datos: habilita el nombre de archivo variable. Seleccione una variable que contenga la ruta de acceso o el nombre del archivo, o combine varias variables para crear el nombre de archivo. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation.
Nota
Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario NiceLabel Automation.
El grupo Opciones de ejecución establece los detalles de abertura del programa.
-
Esperar la finalización: especifica que la ejecución de la acción espere a que se complete esta acción antes de continuar con la siguiente acción programada.
Sugerencia
Habilite esta opción si la acción que sigue depende del resultado de la aplicación externa.
Esta acción guarda los valores variables u otras secuencias de datos (como datos binarios) en el archivo. El servicio NiceLabel Automation debe tener acceso de escritura a la carpeta definida.
El grupo Archivo define el archivo que se abrirá.
-
Nombre de archivo: ubicación del archivo que se abrirá en esta acción.
El nombre de ruta y archivo puede estar preprogramado, y el mismo archivo se usará cada vez. Si solo se define un nombre de archivo sin ruta, se usa la carpeta con el archivo de configuración (.MISX) de NiceLabel Automation. Puede usar una referencia relativa para el nombre del archivo si se usa la carpeta con el archivo .MISX como carpeta raíz.
Origen de datos: habilita el nombre de archivo variable. Seleccione una variable que contenga la ruta de acceso o el nombre del archivo, o combine varias variables para crear el nombre de archivo. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation.
El grupo Si el archivo existe maneja las opciones en caso de un archivo existente.
-
Sobrescribir el archivo: sobrescribe los datos existentes con los datos nuevos. El contenido anterior se pierde.
-
Anexar datos al archivo: anexa los valores de variable a los archivos de datos existentes.
El grupo Contenido define qué datos se escribirán en el archivo especificado.
-
Usar datos recibidos por el desencadenador: los datos originales como los recibe el desencadenador se guardarán en el archivo. Efectivamente, esta opción hará una copia de los datos entrantes.
-
Personalizado: guarda contenido según lo que se indica en el área de texto. Se permiten valores fijos, valores variables y caracteres especiales. Para ingresar variables y caracteres especiales, haga clic en el botón de flecha que se encuentra a la derecha del área de texto. Para obtener más información, consulte la sección Combinación de valores en un objeto en la guía del usuario de NiceLabel Automation.
-
Codificación: tipo de codificación para los datos enviados. Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Esta acción lee el contenido del nombre del archivo provisto y lo guarda en la variable. Contenido de cualquier tipo de archivo, incluidos los datos binarios que pueden leerse.
Generalmente, el módulo Automation Builder recibe datos para la impresión de etiquetas con el desencadenador. Por ejemplo, cuando se usa el desencadenador del archivo, el contenido del archivo del desencadenador se lee automáticamente y puede ser analizado por filtros. No obstante, puede omitir los filtros para obtener algunos datos externos. Una vez que ejecuta esta acción y tiene los datos almacenados en una variable, puede usar cualquier acción de la variable para usar los datos.
Esta acción es útil:
-
Cuando deba combinar datos recibidos por el desencadenador con datos almacenados en algún archivo.
Aviso
Si carga datos de archivos binarios (como un archivo de impresión o imagen de mapas de bits), asegúrese de que la variable que almacena el contenido de lectura esté definida como variable binaria.
-
Cuando quiera intercambiar datos entre desencadenadores. Una vez que el desencadenador prepara los datos y los guarda en un archivo (usando la acción Guardar datos en el archivo), el otro desencadenador lee los datos.
El grupo Archivo: define el archivo desde el que se leerán los datos.
-
Nombre de archivo: ubicación del archivo que se leerá en esta acción.
El nombre de ruta y archivo puede estar preprogramado, y el mismo archivo se usará cada vez. Si solo se define un nombre de archivo sin ruta, se usa la carpeta con el archivo de configuración (.MISX) de NiceLabel Automation. Puede usar una referencia relativa para el nombre del archivo si se usa la carpeta con el archivo .MISX como carpeta raíz.
Origen de datos: habilita el nombre de archivo variable. Seleccione una variable que contenga la ruta de acceso o el nombre del archivo, o combine varias variables para crear el nombre de archivo. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation.
Nota
Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario NiceLabel Automation.
El grupo Contenido establece detalles relacionados con el contenido del archivo.
-
Variable: variable que almacena el contenido del archivo. Debe definirse al menos una variable (existente o recientemente creada).
-
Codificación: tipo de codificación para los datos enviados. Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Nota
La codificación no puede seleccionarse si los datos se leen desde una variable binaria. En este caso, la variable tendrá los datos como están.
El grupo Reintentar en caso de error define cómo debe continuar la ejecución de la acción si el archivo especificado se vuelve inaccesible.
Sugerencia
El módulo Automation Builder podría no estar en condiciones de acceder al archivo porque está bloqueado por otra aplicación. Si una aplicación continúa escribiendo datos en el archivo seleccionado y lo mantiene bloqueado en modo exclusivo, ninguna otra aplicación podrá abrirlo al mismo tiempo, ni siquiera para lectura. Otras causas posibles para los reintentos de la acción son: el archivo (aún) no existe, la carpeta (aún) no existe o el usuario del servicio no tiene privilegios para acceder al archivo.
-
Reintentos: define la cantidad de reintentos para acceder al archivo. Si el valor está configurado en 0, no se realizará ningún reintento.
-
Intervalo de reintento: intervalo de tiempo entre reintentos individuales en milisegundos.
Esta acción elimina un archivo seleccionado de un controlador.
El módulo NiceLabel Automation se ejecuta como servicio con una cuenta de usuario de Windows. Asegúrese de que la cuenta tenga permisos para eliminar el archivo en la carpeta especificada.
El grupo Archivo establece los detalles relacionados al archivo.
-
Nombre de archivo: nombre del archivo que se eliminará. El Nombre de archivo puede integrarse como parte del código. El origen de datos define en forma dinámica el nombre del archivo usando una variable existente o recientemente creada.
El nombre de ruta y archivo puede estar preprogramado, y el mismo archivo se usará cada vez. Si solo se define un nombre de archivo sin ruta, se usa la carpeta con el archivo de configuración (.MISX) de NiceLabel Automation. Puede usar una referencia relativa para el nombre del archivo si se usa la carpeta con el archivo .MISX como carpeta raíz.
Origen de datoshabilita el nombre de archivo variable. Seleccione o cree una variable que contenga la ruta de acceso o el nombre del archivo, o combine varias variables para crear el nombre de archivo. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation.
Nota
Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario NiceLabel Automation.
Esta acción envía comandos SQL a un servidor SQL conectado y recopila los resultados. Utilice los comandos SELECCIONAR, INSERTAR, ACTUALIZAR y ELIMINAR.
Use la acción Ejecutar instrucción SQL para lograr estos dos objetivos:
-
Obtener datos adicionales de una base de datos: En el módulo Automation Builder, el desencadenador recibirá datos para la impresión de etiquetas, pero no todos los valores requeridos. Por ejemplo, un desencadenador recibe valores para el
Product IDy laDescription, pero no para elPrice. Debemos buscar el valor delPrecioen la base de datos SQL.Ejemplo de código SQL:
SELECT Price FROM Products WHERE ID = :(Product ID)
El
IDes el campo en la base de datos,Product IDes una variable definida en el desencadenador.
-
Actualizar o eliminar registros en una base de datos: Después de imprimir una etiqueta, actualice el registro de la base de datos y envíe una señal al sistema de que ese registro en particular ya se ha procesado.
Ejemplo de código SQL:
Configure el valor del campo de la tabla
AlreadyPrintedenVerdaderopara el registro que se está procesando.UPDATE Products SET AlreadyPrinted = True WHERE ID = :(Product ID)
O puede eliminar el registro actual de una base de datos, porque ya no es necesario.
DELETE FROM Products WHERE ID = :(Product ID)
El
IDes el campo en la base de datos,Product IDes una variable definida en el desencadenador.
Nota
Para utilizar el valor de una variable dentro de una instrucción SQL, debe colocar dos puntos (:) delante de su nombre. Esto indica que sigue el nombre de una variable.
Importante
Cuando cree su solución con una conexión de base de datos, use las variables de solicitud de sus etiquetas en lugar de los campos de la base de datos.
Para las variables de solicitud, use los mismos nombres que se definieron para los campos de la base de datos. Por ejemplo:
Campo de la base de datos: food_products_1c.ProdCode
Variable de solicitud de su etiqueta: ProdCode
NiceLabel identifica automáticamente las variables que corresponden a los campos de la base de datos.
El grupo Conexión de bases de datos define la conexión de bases de datos que se utilizará para la instrucción.
Sugerencia
Antes de que pueda enviar una sentencia SQL a una base de datos, configure la conexión con ella. Haga clic en el botón Definir y siga las instrucciones en pantalla. Puede conectarse a un origen de datos que puede controlarse con comandos SQL, de modo que no podrá utilizar archivos de texto (CSV) ni archivos Excel.
El grupo Instrucción SQL define la consulta o instrucción SQL que se ejecutará.
Sugerencia
Las instrucciones del Lenguaje de manipulación de datos (DML) tienen permitido ejecutar consultas dentro de las tablas de bases de datos existentes.
Utilice instrucciones SQL estándares, como SELECCIONAR, INSERTAR, ELIMINAR y ACTUALIZAR, incluidas combinaciones, funciones y palabras clave. No se permiten las instrucciones en lenguaje DDL que se usan para crear bases de datos y tablas (CREAR BASE DE DATOS, CREAR TABLA), o para eliminarlas (ELIMINAR TABLA).
-
Prueba: abre la sección Vista previa de datos. La opción Simular ejecución (seleccionada en forma predeterminada) prueba la ejecución de las instrucciones SQL. Haga clic en Ejecutar para iniciar la simulación.
Sugerencia
La sección Vista precia de datos le permite probar la ejecución de su instrucción SQL con datos en directo. Para proteger los datos contra actualizaciones accidentales, asegúrese de que esté habilitada la opción Simular ejecución. Se ejecutarán las instrucciones INSERTAR, ELIMINAR y ACTUALIZAR. Esto le permite conocer los comentarios sobre cuántos registros se verán afectados; luego todas las transacciones se invierten.
Si utiliza variables de desencadenadores en la instrucción SQL, podrá ingresar sus valores para la ejecución de prueba.
-
Insertar origen de datos: inserta variables predefinidas y recientemente creadas en una instrucción SQL.
-
Exportar/Importar: habilita la exportación e importación de instrucciones SQL hacia/desde un archivo externo.
-
Modo de ejecución: especifica el modo explícito de ejecución de la instrucción SQL.
Sugerencia
En algunas consultas complejas de SQL, se vuelve cada vez más difícil determinar automáticamente cuál es la supuesta acción. Si la lógica integrada encuentra problemas para identificar su propósito, seleccione la acción principal manualmente.
-
Automática: determina la acción automáticamente.
-
Devuelve un conjunto de registros (SELECCIONAR): recibir el conjunto de datos con registros.
-
No devuelve un conjunto de registros (INSERTAR, ELIMINAR, ACTUALIZAR): use esta opción si está ejecutando una consulta que no devuelve los registros. Inserte nuevos registros, elimine o actualice los registros existentes. El resultado es una respuesta de estado que indica el número de filas que se vieron afectadas por su consulta.
-
-
Tiempo de espera de ejecución: le permite definir el tiempo de espera para enviar sus comandos al servidor SQL. Utilice el tiempo de espera de ejecución si está enviando varios comandos SQL consecutivos que requieren un tiempo de procesamiento más prolongado.
Escriba la duración del tiempo de espera solicitado en segundos. Por defecto, la duración del tiempo de espera de ejecución es de 60 s. Si desea que el proveedor de su base de datos defina el tiempo de espera, escriba 0 s.
El grupo Resultado le permite configurar cómo se debe almacenar el resultado de la instrucción SQL, y definir la iteración de la acción.
-
Guardar datos en variable: selecciona o crea una variable para almacenar el resultado de la instrucción SQL. Esta opción depende del Modo de ejecución seleccionado.
-
Resultado de la instrucción SELECCIONAR. Después de ejecutar una instrucción SELECCIONAR, el resultado es un conjunto de datos de registros. Recibirá el contenido de texto con formato CSV. La primera línea contiene los nombres de campo devueltos en un resultado. Las siguientes líneas contienen registros.
Nota
Para extraer los valores del conjunto de datos devuelto y para usarlos en otras acciones, defina y ejecute la acción Usar filtro de datos según los contenidos de esta variable (la acción está disponible en Automation Builder).
-
Resultado de las instrucciones INSERTAR, ELIMINAR y ACTUALIZAR. Si utilizan las instrucciones INSERTAR, ELIMINAR y ACTUALIZAR, el resultado será un número que indica la cantidad de registros afectados en la tabla.
-
-
Iterar Para cada registro. Si se habilita esta opción, NiceLabel agrega automáticamente una nueva acción Para cada registro. Para obtener más información sobre esta acción, consulte el tema específico.
Nota
La asignación automática está habilitada. La acción Para cada registro no puede eliminarse.
Campo de la base de datos:
food_products_1c.ProdCodeVariable de solicitud de su etiqueta:
ProdCode
El grupo Reintentar en caso de error le permite configurar la acción para reintentar continuamente establecer la conexión con el servidor de una base de datos en caso de que el primer intento no tenga éxito. Si la acción no logra conectar en toda la cantidad de intentos definida, el error se eleva.
-
Reintentos: especifica la cantidad de intentos para conectar con la base de datos.
-
Intervalo de reintento: especifica la duración de tiempo entre los intentos individuales de reintento.
Ejemplo 64. Ejemplo
Desea imprimir etiquetas con datos de la base de datos food_products_1c, pero solo para los registros que tengan el valor de campo predefinido UseBy.
Usted define el valor UseBy con la variable ProdUser. En este caso, el valor de ProdUser es “3”.
Una vez impresa cada etiqueta, NiceLabel escribe los valores de la base de datos en un archivo de texto en el disco. Use las siguientes acciones:
Solo las etiquetas en las que el valor de UseBy es igual a “3” se imprimen, y sus valores se escriben en un archivo de texto:
Esta acción envía los datos a un dispositivo externo, aceptando una conexión TCP/IP en un número de puerto predefinido.
Enviar datos a puerto TCP/IPestablece la conexión con un dispositivo, envía los datos y termina la conexión. La conexión y la comunicación están regidas por el enlace que ocurre entre un cliente y un servidor cuando se inicia o finaliza una conexión TCP.
El grupo Configuración de conexión establece los detalles de la conexión.
-
Responder al remitente: Permite responder directamente al socket desde el cual se original los datos del desencadenador. Use esta opción para proporcionar comentarios acerca del proceso de impresión.
Nota
Esta opción está disponible en NiceLabel Automation.
Los prerrequisitos para la configuración de Responder al remitente son:
-
La parte remota no cierra el canal de comunicación una vez que se entrega el mensaje.
-
La acción Enviar datos a puerto TCP/IP se usa dentro del desencadenador Servidor TCP/IP.
-
No configure el Evento de ejecución en el desencadenador del servidor TCP/IP como Cuando se desconecta el cliente.
-
-
Destino (dirección IP:puerto): dirección de destino y puerto del servidor TCP/IP. Codifique en forma rígida los parámetros de conexión y utilice el nombre de host o la dirección IP, o utilice los parámetros de conexión variables haciendo clic en la flecha derecha y seleccionando una variable predefinida. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel Automation.
Ejemplo 66. Ejemplo
Si la variable
hostnameproporciona el nombre del servidor TCP/IP y la variablepuertoproporciona el número de puerto, ingrese el siguiente parámetro para el destino:[hostname]:[port]
-
Retraso de desconexión: prolonga la conexión con el socket de destino durante los intervalos de tiempo definidos después del envío de los datos. Ciertos dispositivos requieren más tiempo para procesar los datos. Inserte el retraso manualmente o haga clic en las flechas para aumentarlo o reducirlo.
-
Guardar respuesta de datos en una variable: selecciona o crea una variable que almacena la respuesta del servidor. Los datos recibidos desde el servidor TCP/IP después de pasar el "retraso de desconexión" se almacenan en esta variable.
Nota
La acción Enviar datos al puerto TCP/IP se ejecuta en el Servidor de impresión web y no en el Cliente de impresión web.
Si utiliza la acción Enviar datos al puerto TCP/IP en NiceLabel Web Client y desea ejecutar localmente (sin pasar por el Servidor de impresión web), agregue el prefijo «LOCAL_» al nombre de su acción.
El grupo Contenido define el contenido que se enviará a un servidor TCP/IP.
Sugerencia
Utilice contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para ingresar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel Automation.
-
Datos: contenido de salida que se enviará.
-
Codificación: tipo de codificación para los datos enviados. Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Esta acción envía datos a un puerto de serie. Utilice esta acción para comunicarse con dispositivos con puertos de serie externos.
Sugerencia
Asegúrese de que la configuración del puerto coincida en ambos extremos; en la acción configurada y en el dispositivo del puerto de serie. El puerto de serie puede usarlo una sola aplicación de la máquina. Para usar satisfactoriamente el puerto desde esta acción, ninguna otra aplicación debe usar el puerto al mismo tiempo, ni siquiera un controlador de la impresora.
El grupo Puerto define el puerto de serie.
-
Nombre de puerto: nombre del puerto al cual se conecta un dispositivo externo. Puede ser un puerto COM de hardware o un puerto COM virtual.
El grupo Configuración de puerto define los parámetros adicionales de la conexión del puerto.
-
Bits por segundo: tasa de velocidad utilizada por el dispositivo externo para comunicarse con la PC. El alias habitual que se utiliza con la configuración es "velocidad en baudios". Seleccione el valor del menú desplegable.
-
Bits de datos: cantidad de datos en cada carácter. En casi todos los dispositivos más modernos, se utilizan 8 bits de datos. Seleccione el valor del menú desplegable.
-
Paridad: método de detección de errores en una transmisión. La configuración de paridad más común es "ninguna", y la detección de errores está a cargo de un protocolo de comunicación (control de flujo). Seleccione el valor del menú desplegable.
-
Detener bits: detiene los bits que se envían al final de cada carácter, con lo cual permite al hardware receptor de señal detectar el final de un carácter y resincronizarse con la secuencia de caracteres. Los dispositivos electrónicos por lo general utilizan una detención única de bits. Seleccione el valor del menú desplegable.
-
Control de flujo: el puerto de serie puede utilizar señales de interfaz para pausar y reanudar la transmisión de datos.
El grupo Contenido define el contenido que se enviará al puerto de serie.
Sugerencia
Se permite contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para ingresar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel Automation.
-
Datos: contenido de salida que se enviará.
Esta acción recopila los datos recibidos a través del puerto serial (RS-232) y lo guarda en una variable seleccionada. Utilice esta acción para comunicarse con dispositivos con puertos seriales externos.
El grupo Puerto define el puerto de serie.
-
Nombre de puerto: nombre del puerto al cual se conecta un dispositivo externo. Puede ser un puerto COM de hardware o un puerto COM virtual.
El grupo Configuración de puerto define los parámetros adicionales de la conexión del puerto.
-
Bits por segundo: tasa de velocidad utilizada por el dispositivo externo para comunicarse con la PC. El alias habitual que se utiliza con la configuración es "velocidad en baudios".
-
Bits de datos: especifica la cantidad de datos en cada carácter. En casi todos los dispositivos más modernos, se utilizan 8 bits de datos.
-
Paridad: especifica el método de detección de errores en una transmisión. La configuración de paridad más común es "ninguna", y la detección de errores está a cargo de un protocolo de comunicación (control de flujo).
-
Detener bits: detiene los bits que se envían al final de cada carácter, con lo cual permite al hardware receptor de señal detectar el final de un carácter y resincronizarse con la secuencia de caracteres. Los dispositivos electrónicos por lo general utilizan una detención única de bits.
-
Control de flujo: el puerto de serie puede utilizar señales de interfaz para pausar y reanudar la transmisión de datos.
Ejemplo 69. Ejemplo
Es posible que los dispositivos lentos necesiten enlazarse con el puerto de serie para indicar que los datos deben pausarse mientras el dispositivo procesa los datos recibidos.
El grupo Opciones incluye los siguientes parámetros:
-
Retraso de lectura: retraso opcional al leer datos desde el puerto de serie. Después del retraso, se lee todo el contenido del búfer del puerto de serie. Ingrese el retraso manualmente o haga clic en las flechas para aumentar o reducir el valor.
-
Enviar datos de inicialización: especifica la cadena que se envía al puerto de serie seleccionado antes de que se lean los datos. Esta opción permite que la acción inicialice el dispositivo para que pueda suministrar los datos. La opción puede también utilizarse para enviar una pregunta específica al dispositivo y para recibir una respuesta específica. Haga clic en el botón de flecha para ingresar caracteres especiales.
El grupo Extracción de datos define cómo se extraen las partes definidas de los datos recibidos.
-
Posición inicial: posición inicial para extracción de datos.
-
Posición final: posición final para extracción de datos.
El grupo Resultado define una variable para el almacenamiento de datos.
-
Guardar resultado en variable: selecciona o crea una variable para almacenar en los datos recibidos.
Esta acción envía datos a una impresora seleccionada. Úsela para enviar secuencias de impresora pregeneradas a cualquier impresora disponible.
El módulo NiceLabel Automation utiliza el controlador de la impresora instalada en modo indirecto solo para poder enviar datos al puerto de destino, por ejemplo, un puerto USB, TCP/IP, COM o LPT, al cual está conectada la impresora.
Nota
Escenario posible. Los datos recibidos por el desencadenador deben imprimirse en la misma impresora de red en una plantilla de etiqueta diferente (archivos de etiquetas .NLBL). La impresora puede aceptar datos de varias estaciones de trabajo y, generalmente, imprimirá los trabajos en el orden en que los recibió. El módulo Automation Builder enviará cada plantilla de etiqueta en un trabajo de impresión separado, de modo que otra estación de trabajo pueda insertar sus trabajos entre los creados en nuestro módulo Automation Builder. En lugar de enviar cada trabajo en forma separada a la impresora, puede combinar todos los trabajos juntos (usando la acción Redireccionar impresión a archivo) y luego enviar un solo gran trabajo a la impresora.
El grupo Impresora selecciona la impresora.
-
Nombre de impresora: nombre de la impresora a la cual se enviarán los datos. Seleccione la impresora desde la lista desplegable de controladores de impresora instalados en forma local, ingrese un nombre de impresora personalizado y defínalo dinámicamente usando una variable nueva o creada recientemente.
El grupo Origen de datos define el contenido que se enviará a la impresora.
-
Usar datos recibidos por el desencadenador: datos usados recibidos por el desencadenador. En este caso, quiere que la secuencia de impresora recibida se use como entrada para el filtro. Su objetivo es redireccionarlo a una impresora sin ninguna modificación. El mismo resultado puede archivarse habilitando la variable interna
DataFileNamey usando el contenido del archivo al que se refiere. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation. -
Nombre de archivo: ruta de acceso y nombre de archivo que contiene la secuencia de una impresora. El contenido del archivo especifico se envía a una impresora. Seleccione Origen de datos para definir el nombre de archivo en forma dinámica usando un valor de variable.
-
Variable: variable (nueva o existente) que almacena la secuencia de la impresora.
-
Personalizar: define el contenido personalizado que se enviará a una impresora. Se permite contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para ingresar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel 10.
Esta acción envía datos al servidor web de destino utilizando el método HTTP seleccionado. Se permiten los esquemas HTTP y HTTPS URL.
HTTP funciona como un protocolo de solicitud-respuesta en el modelo computacional cliente-servidor. En esta acción, NiceLabel 10 actúa como cliente que se comunica con un servidor remoto. Esta acción envía un mensaje de solicitud de HTTP seleccionado a un servidor. El servidor devuelve un mensaje de respuesta que puede contener información de estado de finalización sobre la solicitud y puede también incluir el contenido solicitado en el cuerpo del mensaje.
El grupo Configuración de conexión establece los parámetros de la conexión.
Nota
Esta acción admite el Protocolo de Internet versión 6 (IPv6).
-
Destino: dirección, puerto y destino (ruta directa) del servidor web.
Sugerencia
Si el servidor web se ejecuta en el puerto predeterminado 80, omita el número de puerto. Integre como parte del código los parámetros de conexión y utilice un nombre de host fijo o la dirección IP. Utilice un valor de variable para definir esta opción en forma dinámica. Para obtener más información, consulte la sección Usar valores compuestos en la guía de usuario NiceLabel Automation.
Ejemplo 72. Ejemplo
Si la variable
hostnameproporciona el nombre del servidor web y la variableportproporciona el número de puerto, puede ingresar lo siguiente para el destino:[hostname]:[port]
-
Método de solicitud: métodos de solicitud disponibles.
-
Tiempo de espera: duración del tiempo de espera (en ms) durante el cual debe establecerse la conexión al servidor y recibirse respuesta.
-
Guardar respuesta de estado en una variable: variable para almacenar el código de estado recibido desde el servidor.
Sugerencia
El código de estado en el rango 2XX es un código exitoso. La respuesta "OK" más común es código 200. Los códigos 5XX son errores de servidor.
-
Guardar respuesta de datos en una variable: variable para almacenar los datos recibidos desde el servidor.
El grupo Autenticación le permite asegurar la conexión al servidor web.
-
Habilitar autenticación básica: le permite ingresar las credenciales necesarias para conectarse al servidor web. El nombre de usuario y la contraseña pueden ser fijos o proporcionarse usando una variable.
Nota
La autenticación HTTP básica (BA) utiliza encabezados HTTP estáticos convencionales. El mecanismo BA no brinda protección de la confidencialidad de las credenciales transmitidas. Solo se codifican con Base64 en tránsito, pero no se cifran ni reciben algoritmo hash de ningún modo. La autenticación básica debe utilizarse sobre HTTPS.
-
Mostrar contraseña: desenmascara los caracteres de la contraseña.
Nota
La acción Solicitud de HTTP se ejecuta en el Servidor de impresión web y no en el Cliente de impresión web.
Si utiliza la acción Solicitud de HTTP en NiceLabel Web Client y desea ejecutar localmente (sin pasar por el Servidor de impresión web), agregue el prefijo «LOCAL_» al nombre de su acción.
Contenido define el contenido que se enviará a un servidor web.
-
Datos: contenido de salida que se enviará. Se permite contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para ingresar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel 10.
-
Codificación: tipo de codificación para los datos enviados.
Sugerencia
Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
-
Tipo: propiedad del tipo de contenido del mensaje HTTP. Si no se selecciona ningún tipo, se utiliza el tipo predeterminado
application/x-www-form-urlencoded. Si no se enumera un tipo apropiado, defina uno personalizado o establezca una variable que lo defina en forma dinámica.
Ciertos servidores HTTP requieren Encabezados HTTP adicionales (especialmente para servicios REST).
Nota
La acción Solicitud de HTTP ya utiliza una clave de suscripción incorporada, por lo que no es necesario ingresar el valor Ocp-Apim-Subscription-Key en Encabezados HTTP adicionales.
Debe proporcionar el valor Ocp-Apim-Subscription-Key si realiza una llamada a la API de la nube desde una aplicación que no es de NiceLabel.
-
Encabezados adicionales: encabezados integrados como parte del código u obtenidos a partir de valores de variable. Para acceder a las variables, haga clic en el botón de flecha pequeño que se encuentra a la derecha del área de texto. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel 10.
Algunos servidores HTTP (especialmente para servicios REST) requieren que se incluyan encabezados HTTP personalizados en el mensaje. Esta sección le permite proporcionar el encabezado de HTTP requerido.
Los encabezados HTTP deben ingresarse con la siguiente sintaxis:
header field name: header field value
Por ejemplo, para utilizar los nombres de campo de encabezado
Aceptar,Usuario-AgenteyContenido-Tipo, puede utilizar la siguiente sintaxis:Accept: application/json; charset=utf-8 User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.63 Safari/537.36 Content-Type: application/json; charset=UTF-8
Puede integrar los nombres de campo del encabezado, o puede obtener los valores a partir de las variables de desencadenadores. Utilice tantos campos de encabezado personalizados como desee, siempre y cuando se asegure de colocar cada campo de encabezado en una línea nueva.
Nota
Los encabezados HTTP ingresados sustituirán los encabezados ya definidos en cualquier otro lado de las propiedades de las acciones, como Contenido-Tipo.
Un servicio Web es un método de comunicación entre dos dispositivos electrónicos o instancias de software. Un servicio Web se define como un estándar de intercambio de datos. Utiliza formato XML para etiquetar los datos; el protocolo SOAP se usa para transferir los datos y se usa lenguaje WSDL para describir los servicios disponibles.
Esta acción establece la conexión con un servicio Web remoto y ejecuta los métodos allí. Los métodos se pueden describir como acciones que se publican en el Servicio Web. La acción envía los valores de entrada al método seleccionado en el servicio Web remoto, recopila el resultado y lo guarda en las variables seleccionadas.
Después de importar el WSDL y agregar una referencia al Servicio Web, sus métodos se incluirán en el cuadro combinado Método.
Nota
Puede transferir tipos simples al Servicio Web, como cadenas, enteros, booleanos, pero no tipos complejos. El WSDL debe contener únicamente un enlace.
Nota
Debe imprimir etiquetas de productos. Su desencadenador recibirá únicamente parte de los datos necesarios. Por ejemplo, el desencadenador recibe el valor para las variables Product ID y la Description, pero no para Price. El precio está disponible en una base de datos separada, accesible desde la llamada del servicio Web. El servicio Web define la función usando una definición del WSDL. Por ejemplo, la entrada de la función es Product ID y su salida es Price. La acción del servicio Web envía Product ID al servicio Web. Ejecuta y hace una búsqueda interna en su base de datos y proporciona el Price correspondiente como resultado. La acción guarda el resultado en una variable, la cual se puede usar en la etiqueta.
El grupo Definición de servicio Web incluye los siguientes parámetros:
Nota
Esta acción admite el Protocolo de Internet versión 6 (IPv6).
-
WSDL: ubicación de definición del WSDL.
El WSDL generalmente es provisto por el propio servicio Web. Comúnmente, debe ingresar el vínculo al WSDL y hacer clic en el botón Importar para leer la definición. Si tiene problemas para obtener el WSDL del recurso con conexión, guarde el WSDL en un archivo e ingrese la ruta de acceso con el nombre del archivo para cargar métodos desde allí. NiceLabel 10 automáticamente detecta si el Servicio Web remoto utiliza la sintaxis de RPC o documentos y si se comunica correctamente o no.
-
Dirección: dirección en la que se publica el Servicio Web.
En principio, esta información se toma del WSDL, pero puede actualizarse antes de ejecutar la acción. Es útil para entornos de desarrollo dividido, prueba y producción, en los que se utiliza la misma lista de acciones, pero con diferentes nombres de servidores donde se ejecutan los Servidores Web.
Se permite contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para ingresar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel 10.
-
Método: métodos (funciones) que están disponibles en un servicio Web seleccionado. La lista la llena automáticamente la definición del WSDL.
-
Parámetros: variables de entrada y salida para el método seleccionado (función).
Los parámetros de entrada esperan una entrada. Por motivos de prueba y resolución de problemas, puede ingresar un valor fijo y ver el resultado de la vista previa en la pantalla. Generalmente, seleccionará una variable para el parámetro de entrada. El valor de esa variable se utilizará como parámetro de entrada. El parámetro de salida proporciona un resultado desde la función. Debe seleccionar la variable que almacenará el resultado.
-
Tiempo de espera: tiempo de espera después del cual se establece la conexión al servidor.
Nota
La acción de Servicio web se ejecuta en el Servidor de impresión web y no en el Cliente de impresión web.
Si utiliza la acción de Servicio web en NiceLabel Web Client y desea ejecutar localmente (sin pasar por el Servidor de impresión web), agregue el prefijo «LOCAL_» al nombre de su acción.
La Autenticación habilita la autenticación básica del usuario. Esta opción define las credenciales del usuario necesarias para establecer una llamada de salida a un servidor Web remoto.
-
Habilitar la autenticación básica: permite definir el Nombre de usuario y la Contraseña, que se pueden escribir en forma manual o definirse con los valores variables. Seleccione los Orígenes de datos para seleccionar o crear las variables.
-
Mostrar contraseña: muestra los caracteres enmascarados del Nombre de usuario y la Contraseña.
Encontrará detalles acerca de los problemas de seguridad en la sección Asegurar el acceso a sus desencadenadores en la guía del usuario de NiceLabel Automation.
El campo Vista previa de datos le permite ejecutar una prueba del servicio Web.
-
El botón Ejecutarejecuta una llamada del servicio Web.
Envía los valores de los parámetros de entrada al servicio Web y proporciona el resultado en el parámetro de salida. Use esta funcionalidad para probar la ejecución de un servicio Web. Puede ingresar valores para los parámetros de entrada y ver el resultado en pantalla. Una vez satisfecho con la ejecución, reemplace el valor fijo ingresado para el parámetro de entrada con una variable de la lista.