Las acciones son una parte esencial de las soluciones de etiquetado automático. Cada acción ejecuta un comando predefinido (o una serie de comandos) cuando se produce un evento definido.
Desktop Designer incluye un amplio rango de acciones. Su propósito es eliminar la necesidad de comenzar desde cero con la programación de la solución.
Administre las acciones utilizando el cuadro de diálogo Editor de acciones.
A continuación, se describen las propiedades y conceptos básicos de la Acción.
-
Acciones disponibles: el rango de acciones incluidas en Desktop Designer. Estas acciones se agrupan en conjuntos funcionales.
-
Definición de acciones: las acciones se definen en el Editor de acciones haciendo clic en el icono de acción correspondiente en el grupo de la banda de opciones Agregar. La banda de opciones principal contiene acciones utilizadas comúnmente y, más adelante, las acciones que usted define como acciones comunes. Para ver todas las acciones disponibles, haga clic en Todas las acciones.
-
Acciones anidadas: acciones que no pueden utilizarse independientemente. Sus características específicas requieren que estén anidadas dentro de otra acción. Utilice los botones del grupo de la banda de opciones Orden de las acciones para cambiar la ubicación de las acciones. Cada acción se identifica con un número de ID que indica su posición en la lista, incluidas sus acciones anidadas. Este número de ID se muestra en el mensaje de error potencial para que encuentre la acción problemática más rápidamente.
La acción Imprimir etiqueta es un ejemplo de este tipo de acción. Esta acción está anidada dentro de la acción Abrir etiqueta, de modo que hace referencia a la etiqueta exacta que debe imprimirse.
-
Ejecución de acciones: las acciones de la lista (activas) se ejecutan una vez por cada evento. El orden de las acciones es crucial; la ejecución comienza desde arriba y continúa hacia abajo en la lista.
-
Acciones condicionales: las acciones condicionales solo se ejecutan cuando las condiciones dispuestas permiten su ejecución. La condición se define con una sola línea Expresión VBScript o secuencia de comandos Python.
-
Errores en las acciones: si una acción no está completamente configurada, se marca con un icono de exclamación rojo. Dicha acción puede incluirse en la lista de eventos, pero no puede ejecutarse.
Nota
Si una de las acciones anidadas indica un error, todas las acciones principales también estarán marcadas en rojo. Esto sirve de indicación de error de las acciones anidadas.
-
Deshabilitación de acciones: previene la ejecución de una acción. En forma predeterminada, todas las acciones agregadas están activadas. Las acciones que no son necesarias pueden deshabilitarse y conservarse en la configuración. El acceso directo a la habilitación y deshabilitación de acciones es la casilla de verificación que se encuentra junto al nombre de acción en la lista de acciones definidas.
-
Copiado de acciones: todas las acciones pueden copiarse y pegarse. Utilice los accesos directos convencionales del teclado de Windows o haga clic con el botón derecho en la acción.
El Editor de acciones es un cuadro de diálogo para administrar acciones en una Desktop Designer solución.
Se pueden definir acciones para:
-
Formulario: estas acciones se desencadenan con eventos de formularios. Son aplicables para los siguientes eventos:
-
En carga de formulario: la acción se ejecuta cuando se cierra el formulario.
-
En cierre de formulario: la acción se ejecuta cuando se cierra el formulario.
-
En cronómetro de formulario: la acción se ejecuta después de un intervalo de tiempo específico.
-
En inactividad de formulario: ejecuta la acción definida cuando el formulario ha estado inactivo durante un intervalo determinado.
-
-
Objeto del formulario: estas acciones se desencadenan con eventos de relacionados con objetos.
-
Variable: estas acciones se desencadenan de acuerdo con los valores recibidos.
La banda de opciones Diálogo del Editor de acciones incluye comandos para agregar, eliminar y ordenar las acciones. También brinda acceso directo a las acciones que se utilizan con frecuencia.
Los iconos del grupo Portapapeles activan las siguientes acciones:
-
Pegar: pega los datos del portapapeles.
-
Cortar: corta la selección del portapapeles.
-
Copiar: copia la selección del portapapeles.
-
Eliminar: elimina los elementos seleccionados.
El grupo Deshacer y rehacer permite deshacer o repetir acciones.
-
Deshacer: Desktop Designer permite al usuario deshacer la secuencia completa de acciones desde la última vez que se abrió el editor.
-
Rehacer: repite el rango de acciones solicitado.
El grupo Orden de las acciones define el orden de ejecución de las acciones seleccionadas.
-
Arriba y Abajo: estas flechas colocan la acción seleccionada delante o detrás de cualquier otra acción existente.
-
Derecha: esta flecha anida la acción seleccionada dentro de la acción existente previa.
Nota
Una acción anidada es cualquier acción que comienza cuando la acción principal ya está en curso.
-
Izquierda: esta flecha hace que una acción anidada sea independiente de la acción precedente.
Nota
Ciertas acciones no pueden existir independientemente. Si una acción así se agrega a la lista de acciones, aparecerá una advertencia. La advertencia define dentro de qué acción debe anidarse.
Agregar asigna acciones al objeto del formulario seleccionado.
-
El botón Todas las acciones brinda acceso al rango completo de Desktop Designeracciones. Las acciones Utilizadas recientemente se colocan en la parte superior de la lista. Utilice el campo Buscar... para ubicar rápidamente cualquier acción ingresando su nombre.
-
Cuatro botones dan acceso directo a las acciones usadas más frecuentemente:
-
El botón Abrir etiqueta: agrega la acción Abrir etiqueta a la lista de acciones.
-
El botón Imprimir etiqueta: agrega la acción Imprimir etiqueta a la lista de acciones.
-
El botón Establecer impresora: agrega la acción Establecer impresora a la lista de acciones.
-
El botón Salir: agrega la acción Salir a la lista de acciones.
-
El Explorador de acciones es una herramienta para agregar, eliminar y ordenar las acciones asignadas. Utilice los comandos de la banda de opciones para trabajar con las acciones existentes o agregar acciones nuevas.
Las columnas del explorador brindan información general instantáneamente de las opciones de ejecución de las acciones y sus descripciones.
-
Habilitada: habilita o deshabilita la acción incluida.
-
Condición: muestra la condición para ejecutar una acción (si se configuró).
-
Descripción: muestra la información sobre una acción como la definió el usuario.
El Explorador de acciones le permite hacer una selección de múltiples acciones y realizar las operaciones de copiar, pegar y eliminar con ellas. Para hacer una selección, use Ctrl/Shift + Clic en las acciones requeridas.
Nota
Solo es posible seleccionar múltiples acciones en la misma acción principal, es decir todas las acciones seleccionadas deben estar en el mismo nivel. Ver imagen a continuación.
El Campo de edición permite editar las propiedades avanzadas de las acciones.
-
Las propiedades principales de la acción seleccionada están disponibles para editarse en la parte superior del campo Principales/edición. Las propiedades principales son diferentes para cada acción; lea las secciones de descripción de acciones dedicadas para conocer los detalles.
-
El grupo Acerca de permite describir todas las acciones NiceLabel 10.
-
Nombre: en forma predeterminada, el nombre de la acción se define según el tipo y, por lo tanto, no es único. Defina un nombre personalizado para poder reconocerla inmediatamente de otras acciones, en los registros y en los mensajes de errores potenciales.
-
Descripción: notas del usuario para la acción seleccionada. La descripción se muestra en el explorador de acciones.
-
Tipo de acción: campo de solo lectura que muestra el tipo de acción.
Nota
Al actualizar soluciones heredadas (creadas con NiceLabel V6 y anterior), se actualizan los nombres de acciones basados en el idioma seleccionado actualmente. Se actualiza la versión de la solución.
-
-
Las propiedades ocultas definen las propiedades utilizadas con menos frecuencia. Las propiedades ocultas son diferentes para cada acción; lea las secciones de descripción de acciones dedicadas para conocer los detalles.
Las acciones Desktop Designer se agrupan en múltiples conjuntos funcionales. A continuación, se presentan los grupos con descripciones de las acciones básicas.
El grupo General contiene los comandos que se utilizan frecuentemente relacionados con la activación y la apertura de etiquetas:
El grupo Impresora contiene acciones relacionadas con la impresión:
El grupo Formulario define acciones relacionadas con los objetos del formulario:
El grupo Variables define acciones relacionadas con las variables:
El grupo Datos y conectividad define las acciones relacionadas con las bases de datos; el envío, la lectura o la recepción de datos; y las redes.
El grupo Operaciones de archivos define las acciones relacionadas con los archivos activos:
El grupo Control de flujo define varias secuencias de acciones:
El grupo Otras contiene acciones específicas para ejecutar comandos, enviar comandos personalizados y verificar las licencias:
La acción Abrir etiqueta especifica el archivo de etiqueta que se imprimirá. Cuando se ejecuta la acción, la plantilla de la etiqueta se abre en la memoria caché. La etiqueta permanece en el caché siempre y cuando la utilicen los desencadenadores o eventos.
No hay límite para la cantidad de etiquetas que pueden abrirse simultáneamente. Si la etiqueta ya está cargada y vuelve a solicitarse, NiceLabel Automation determinará primero si hay una versión más nueva disponible y aprobada para la impresión y luego la abrirá.
En este ejemplo, carga la etiqueta label.nlbl desde la carpeta C:\ProjectA\Labels.
C:\ProjectA\Labels\label.nlbl
Si no se encuentra la etiqueta especificada, NiceLabel 10 intenta encontrarlas en ubicaciones alternativas. Para obtener más información, consulte el tema Combinación de valores en un objeto en la guía del usuario de NiceLabel Desktop Designer.
Usar rutas de acceso relativas
NiceLabel 10 admite el uso de rutas relativas para hacer referencia a su archivo de etiquetas. La carpeta raíz es siempre la carpeta en la que se almacena la solución (o la configuración, en el caso de que la acción se use en una configuración NiceLabel Automation).
Con la siguiente sintaxis, la etiqueta se cargará relativamente desde la ubicación del archivo de configuración. Automation Builder buscará la etiqueta en la carpeta ProyectoA, que se encuentra dos niveles arriba de la etiqueta actual, y luego en la carpeta Etiquetas.
..\..\ProjectA\Labels\label.nlbl
El grupo Configuración selecciona el archivo de etiqueta.
-
Nombre de etiqueta especifica el nombre de la etiqueta. Puede integrarse como parte del código, y la misma etiqueta se imprimirá todas las veces. La opción Origen de datos permite que el nombre del archivo se defina de forma dinámica. Seleccione o agregue una variable que contenga la ruta de acceso o el nombre del archivo. una vez que se ejecuta un desencadenador o que se lleva a cabo un evento.
Sugerencia
Generalmente, el valor de la variable se asigna según un filtro.
Nota
Utilice la sintaxis UNC para los recursos de red.
Esta acción ejecuta la impresión de etiquetas. Siempre debe anidarse dentro de la acción Abrir etiqueta. El anidamiento permite obtener la referencia a la etiqueta que se imprimirá. Esto a su vez le permite conservar múltiples etiquetas abiertas al mismo tiempo y le permite especificar qué etiqueta se debe imprimir.
Al emitir esta acción, la etiqueta se imprime utilizando el controlador de la impresora definida en la plantilla de la etiqueta. Si el controlador de la impresora definido no se encuentra en el sistema, la etiqueta se imprime utilizando el controlador de la impresora predeterminada del sistema. Puede invalidar el controlador de la impresora utilizando la acción Establecer impresora.
Para lograr una impresión de etiquetas de alto rendimiento, activa dos configuraciones de manera predeterminada:
-
Procesamiento paralelo. Se realizan múltiples procesos de impresión simultáneamente. La cantidad de subprocesos de impresión en segundo plano depende del hardware, específicamente del tipo de procesador. Cada procesador central puede admitir un único subproceso de impresión. Esta configuración predeterminada puede modificarse. Para obtener más información, consulte la sección Procesamiento paralelo en la guía de usuario NiceLabel Automation.
-
Modo asincrónico. Tan pronto como se completa el preprocesamiento del desencadenador y las instrucciones para el motor de impresión están disponibles, el subproceso de impresión lo toma en segundo plano. Se devuelve el control al desencadenador para que pueda aceptar la siguiente secuencia de datos de entrada lo antes posible. Cuando el modo sincronizado está habilitado, no se devuelve el control al desencadenador hasta que finaliza el proceso de impresión. Esto puede tardar un tiempo, pero el desencadenador tiene el beneficio de proporcionar comentarios de respuesta a la aplicación que suministra los datos. Para obtener más información, consulte la sección Modo sincronizado en la NiceLabel Automation guía de usuario.
Nota
La opción Guardar error en variable enEjecución de acciones y tratamiento de errores no producirá ningún resultado en modo asincrónico, ya que el desencadenador no recibirá comentarios desde el proceso de impresión. Para capturar los comentarios del proceso de impresión, primero habilite el modo sincrónico.
Nota
Si la acción Imprimir etiqueta está anidada debajo de una acción Para bucle, la Automatización la ejecuta en modo de impresión de sesiones. Este modo funciona como modo de optimización de la impresión que imprime todas las etiquetas en un bucle utilizando un único archivo de trabajo de impresión. Para obtener más detalles, consulte la sección Impresión de sesiones en la guía del usuario NiceLabel Automation.
El grupo Cantidad define el número de etiquetas que se imprimirán utilizando el formulario activo.
-
Etiquetas: establece el número de etiquetas impresas. Origen de datos especifica o agrega una variable de etiqueta que define en forma dinámica la cantidad de etiquetas que se imprimirán.
Nota
El valor variable generalmente se asigna mediante la acción Usar filtro de datos y debe ser un número entero.
Todas (cantidad ilimitada): dependiendo del diseño de la plantilla de etiquetas, las etiquetas se imprimen en distintas cantidades.
Detalles de cantidad ilimitada de impresión
Generalmente, esta opción se usa en dos escenarios.
-
Se indica a la impresora que imprima continuamente la misma etiqueta hasta que se apague o reciba un comando para borrar su búfer de memoria.
Aviso
Este escenario requiere que el controlador de impresora Loftware esté instalado y se use para la impresión de etiquetas.
Cuando imprime la etiqueta fija, se envía un solo trabajo de impresión a la impresora, con la cantidad configurada como "ilimitada". Las impresoras de etiquetas tienen un parámetro de comando de impresora que indica impresión "ilimitada".
Cuando la etiqueta no es fija pero incluye objetos que cambian durante la impresión, como los contadores, la cantidad impresa se configurará como la cantidad máxima admitida por la impresora. El controlador de impresoras de Loftware reconoce el límite de cantidad de la impresora e imprime tantas etiquetas como sea posible.
Ejemplo 70. Ejemplo
La cantidad máxima de impresiones admitida es 32.000. Esta es la cantidad de etiquetas que se imprimen después de seleccionar la opción Todas (cantidad ilimitada).
-
El desencadenador no proporciona datos, sino que solo actúa como indicador de que "el evento se ha producido". La lógica para adquirir los datos necesarios se encuentra en la etiqueta. Generalmente, se configura una conexión con una base de datos en la etiqueta y en cada desencadenador que la etiqueta debe conectarse con la base de datos, y se adquieren todos los registros de la base de datos. En este caso, la opción Todas (cantidad ilimitada) se interpreta como "imprimir todos los registros de la base de datos".
-
Cantidad variable (definida desde la variable de la etiqueta): especifica una variable de etiqueta que define la cantidad de etiquetas que se imprimirán.
El desencadenador no recibe el número de etiquetas que se imprimirán, así que pasa la decisión a la plantilla de la etiqueta. La etiqueta puede contener una conexión a una base de datos, que proporcionará la cantidad de etiquetas, o puede haber otro origen para la información de la cantidad. Una variable de la etiqueta debe definirse como "cantidad variable".
El grupo Avanzadas define los detalles de impresión de etiquetas. Haga clic en Mostrar opciones de impresión avanzadas para definir las opciones de impresión Avanzadas:
Esta sección especifica ajustes de configuración que no se utilizan frecuentemente relacionados con la cantidad de etiquetas.
-
El Número de etiquetas omitidas define el número de etiquetas que se omitirán en la primera página de etiquetas. Esta hoja de etiquetas ya puede haberse imprimido una vez, pero no por completo. Puede reutilizar la misma hoja si desplaza la posición de inicio. Puede aplicar esta opción cuando imprime etiquetas en hojas de etiquetas, no en rollos de etiquetas, así que es eficaz para impresoras de oficina, no de etiquetas.
-
Copias de etiquetas idénticas: especifica el número de copias de etiquetas que se imprimirán para cada registro de la base de datos. Esta opción produce el mismo resultado que la opción principal Número de etiquetas cuando tiene etiquetas fijas. Para etiquetas variables, como las que utilizan contadores, puede obtener las copias de etiquetas reales.
-
Conjuntos de etiquetas: especifica cuántas veces debe repetirse el proceso de impresión de etiquetas.
Ejemplo 71. Ejemplo
El desencadenador recibirá el contenido con 3 líneas de datos con formato CSV, así que se espera que se impriman 3 etiquetas (1, 2, 3). Si configura esta opción en 3, la impresión se realizará en el siguiente orden: 1, 2, 3, 1, 2, 3, 1, 2, 3.
Sugerencia
Los valores del grupo Avanzado pueden ser preprogramados o proporcionarse en forma dinámica por una variable existente o recientemente creada.
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 procesamiento adicional y devolver el resultado a NiceLabel 10. Esta acción permite que se enlace con cualquier software de terceros que pueda ejecutar procesamientos de datos adicionales o adquirir datos. El software externo puede proporcionar respuesta de datos y guardarla en un archivo, desde donde puede leerse en variables.
Puede enviar el valor de las variables al programa incluyéndolas 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.
-
Ocultar ventana: hace invisible la ventana del programa abierto. Como NiceLabel 10 se ejecuta como una aplicación de servicio dentro de su propia sesión, no puede interactuar con el escritorio, aunque se ejecute con los privilegios del usuario que tiene la sesión iniciada. Microsoft ha bloqueado esta interacción en Windows Vista y en los sistemas operativos más nuevos por motivos de seguridad.
-
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 mejora la funcionalidad de software utilizando las secuencias de comandos personalizadas VBScript o Python. Utilice esta acción si las acciones integradas no cumplen con los requisitos de manipulación de datos existentes.
Las secuencias de comandos pueden incluir las variables de los desencadenadores, tanto las internas como las que usted define o importa desde etiquetas.
Asegúrese también de que la cuenta de Windows con la que se utiliza el servicio tenga privilegios para ejecutar los comandos de la secuencia.
Nota
El tipo de secuencia de comandos se configura para cada desencadenador en sus propiedades. Todas las acciones Ejecutar secuencia de comandos dentro de un desencadenador deben ser del mismo tipo.
El editor de Secuencias de comandos ofrece las siguientes funciones:
-
Insertar origen de datos: inserta una variable existente o creada recientemente en la secuencia de comandos.
-
Verificar: valida la sintaxis de la secuencia de comandos ingresada.
-
Editor de Secuencias de comandos: abre el editor, que facilita la creación de secuencias de comandos y la hace más eficiente.
NiceLabel 10 proporciona un editor de secuencias de comandos que facilita la creación de secuencias de Python o VBScript, no presenta errores y es más rápido.
La selección de los idiomas de secuencias que deben usarse en el Editor de secuencias de comandos difiere entre NiceLabel Designer Pro y Automation Builder :
-
En Desktop Designer , haga doble clic en la superficie de diseño del formulario para abrirPropiedades del formulario> Configuración adicional > Idioma de secuencias de comandos.
-
En Automation Builder , vaya a Elementos de configuración > haga clic en Editar para abrir las propiedades del desencadenador > Configuración > Otras > Secuencia de comandos.
Sugerencia
NiceLabel 10 usa la variante .NET de Python llamada IronPython. Funciona como una implementación totalmente compatible del idioma de la secuencia de comandos de Python y también es compatible con los métodos .NET.
La banda de opciones Editor incluye los comandos utilizados comúnmente, que se distribuyen a múltiples grupos de funciones.
-
Grupo Portapapeles ofrece los comandos Cortar, Copiar, Pegar y Eliminar.
-
Grupo Deshacer permite deshacer y repetir acciones de edición de secuencias de comandos.
-
El grupo Archivo permite cargar y guardar secuencias de comando en un archivo.
-
Cargar desde archivo: carga una secuencia de comandos desde un archivo textual externo previamente guardado.
-
Guardar en el archivo: almacena una secuencia de comandos editada actualmente en un archivo de texto.
-
-
Grupo Edición: permite buscar y reemplazar cadenas en una secuencia de comandos.
-
Buscar: busca la cadena ingresada en la secuencia de comandos.
-
Reemplazar: reemplaza la cadena en la secuencia de comandos.
-
-
El grupo Insertar: el comando Origen de datos inserta orígenes de datos existentes o definidos recientemente en la secuencia de comandos.
-
Grupo Secuencia de comandos: el comando Validar secuencia de comandos valida la sintaxis de la secuencia de comandos ingresada.
Los Elementos de secuencias de comandos disponibles contienen todos los elementos de la secuencia de comandos disponibles que se pueden utilizar al crear una secuencia de comandos. Haga doble clic en el elemento o clic en el botón Insertar para insertar el elemento en la posición del cursor en la secuencia de comandos.
La Descripción de elementos brinda información básica sobre el elemento de la secuencia de comandos insertado.
La Lista de errores presenta los errores que se informaron después de ejecutar el comando Validar secuencia de comandos.
La acción especifica el nombre de la impresora que se utilizará para imprimir la etiqueta activa.
Nota
Esta acción anula la impresora seleccionada en las propiedades de las etiquetas.
Esta acción es útil al imprimir una etiqueta idéntica en varias impresoras. Siempre anide esta acción debajo de la acción Abrir etiqueta para dar a la etiqueta la referencia para la impresora preferida.
Esta acción lee la configuración predeterminada, como la velocidad y la oscuridad, del controlador de la impresora seleccionada y la aplica a la etiqueta. Si no utiliza la acción Establecer impresora, la etiqueta se imprimirá en la impresora según lo definido en la plantilla de la etiqueta.
Aviso
Tenga cuidado al cambiar la impresora de una a otra marca, por ejemplo, de Zebra a SATO, o incluso un modelo por otro de la misma marca. La configuración de la impresora puede no ser compatible y es posible que la impresión de la etiqueta no sea idéntica. Asimismo, la optimización del diseño de las etiquetas para la impresora original, como los contadores internos y las fuentes internas, puede no estar disponible en la impresora seleccionada recientemente.
El grupo Impresora especifica el nombre de la impresora que se utilizará para el trabajo de impresión en curso.
-
Nombre de la impresora: selecciónelo de la lista de controladores de impresoras instalados localmente, o escriba el nombre de la impresora. Seleccione el Origen de datos para seleccionar en forma dinámica la impresora usando una variable. Cuando esté activado, seleccione o cree una variable que contenga el nombre de la impresora que se usa cuando se ejecuta la acción.
Esta acción abre el cuadro de diálogo de las propiedades de los controladores de la impresora seleccionada. La configuración se guarda en el archivo de la etiqueta y sirve únicamente para la etiqueta actual.
Nota
Las modificaciones que realiza el usuario utilizando esta acción son temporales y afectan únicamente al trabajo de impresión actual. Las modificaciones no se guardan en una etiqueta o formulario.
El grupo Configuración define una variable para la configuración de la impresora.
-
Configuración de impresora: selecciona o crea una variable para almacenar la configuración de la impresora recibida. Si la configuración de la impresora está incluida en la variable, el diálogo Propiedades de la impresora la muestra.
Esta acción especifica el nombre del trabajo de impresión como aparece en el administrador de trabajos de impresión de Windows. Un nombre de trabajo de impresión predeterminado es el nombre del archivo de la etiqueta usado. Esta acción lo anula.
Nota
Siempre anide la acción debajo de la acción Abrir etiqueta, de modo que se aplique al archivo de la etiqueta adecuado.
El grupo Trabajo de impresión define el nombre del trabajo de impresión.
-
Nombre: establece el nombre del trabajo de impresión. Puede tener una codificación rígida, y se utilizará el mismo nombre para cada acción de impresión. Variable habilita un nombre de archivo variable. Seleccione o cree una variable que contenga la ruta de acceso o el nombre del archivo, si se ejecuta un desencadenador o se lleva a cabo un evento.
Nota
En Automation Builder, generalmente, el valor de la variable se asigna según un filtro.
Esta acción desvía el trabajo de impresión a un archivo. En lugar de enviar el archivo de impresión creado al puerto de una impresora como se define en el controlador de la impresora, la impresión se redirecciona a un archivo. Puede anexar los datos a un archivo existente o sobrescribirlo.
Esta acción le permite capturar los comandos de impresora en un archivo separado.
La acción instruye al módulo de Automation Builder a redireccionar la impresión; como resultado, las etiquetas no se imprimirán. Asegúrese de que la acción esté seguida de la acción Imprimir etiqueta.
Nota
NiceLabel se ejecuta como servicio con una cuenta de usuario de Windows. Asegúrese de que esta cuenta de usuario tenga privilegios para acceder a la carpeta especificada con permisos para leer/escribir. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario de NiceLabel Automation.
La acción Redireccionar la impresión al archivo es útil para imprimir varias etiquetas diferentes (archivos .NLBL) en la impresora de red manteniendo el orden correcto de las etiquetas. Cuando se imprimen múltiples archivos .NLBL del mismo desencadenador, Automation Builder envía cada etiqueta a la impresora en un trabajo de impresión separado, incluso si la impresora de destino es la misma para ambas etiquetas. Cuando se usa una impresora de red, se puede insertar el trabajo de otro usuario entre dos trabajos que el desencadenador deba enviar juntos. Al usar esta acción puede anexar datos de impresión al mismo archivo y luego enviar su contenido a la impresora usando la acción Enviar datos a impresora.
El grupo de configuración Archivo define cómo se realiza la selección del archivo para la redirección.
-
Nombre de archivo especifica el nombre del archivo. Pueden ser preprogramados o proporcionarse en forma dinámica usando una variable existente o recientemente creada.
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.
Nota
Al utilizar esta acción, asegúrese de que su cuenta de usuario tenga suficientes privilegios para acceder a la carpeta especificada con permisos para leer/escribir.
El grupo de configuración Modo de escritura de archivo selecciona el modo en que se trata el archivo en caso de redirecciones repetidas.
-
Sobrescribir el archivo: si el archivo especificado ya existe en el disco, se sobrescribirá.
-
Anexar datos al archivo: el archivo del trabajo se agrega a los datos existentes del archivo proporcionado.
El grupo Persistencia controla la continuidad de la acción de redirección. Define el número de acciones Imprimir etiqueta que se ven afectadas por la acción Redireccionar impresión a archivo.
-
Aplicar a la próxima acción de impresión: especifica que la redirección de la impresión se aplique únicamente a la próxima acción Imprimir etiqueta (evento único).
-
Aplicar a todas las acciones de impresión subsiguientes: especifica que la redirección de la impresión se aplique a todas las acciones de Imprimir etiqueta definidas después de la acción Redireccionar impresión a archivo actual.
Nota
La acción únicamente redirecciona la impresión. Asegúrese de que siga la acción Imprimir etiqueta.
Esta acción le permite ajustar los parámetros relacionados con el controlador de la impresora. Entre estos parámetros se incluyen la velocidad y la oscuridad para las impresoras de etiquetas, o la bandeja del papel para las impresoras láser.
La configuración de la impresora se aplica a la impresión en curso únicamente y no se recuerda durante el próximo evento.
Aviso
Los parámetros de Establecer parámetro de impresión no se aplican cuando se obtiene una vista previa o se hace una reimpresión de las etiquetas desde Control Center.
Puede evitar esto con la opción Usar las propiedades de la impresora guardadas en: Etiqueta. Las propiedades de la impresora pueden variar según el controlador y según la impresora.
Nota
Si utiliza el parámetro Establecer impresora para cambiar el nombre de la impresora, asegúrese de usar la acción Establecer parámetro de impresión a continuación. Antes de aplicar la estructura DEVMODE al controlador de la impresora, primero debe cargar la configuración predeterminada del controlador. Esto se realiza con la acción Establecer impresora. DEVMODE únicamente es compatible con DEVMODE del mismo controlador de la impresora.
El grupo Establecer parámetros permite realizar ajustes antes de imprimir.
-
Bandeja de papel: nombre de la bandeja de papel que contiene los medios de las etiquetas. Esta opción se utiliza comúnmente con impresoras láser y de inyección de tinta con varias bandejas de papel. El nombre de la bandeja de papel debe coincidir con el nombre de la bandeja del controlador de la impresora. Consulte las propiedades del controlador de la impresora para obtener más detalles.
-
Velocidad de impresión: define la velocidad de impresión. Esta configuración anula la configuración definida con la etiqueta. El valor provisto debe estar en el rango de valores aceptados.
Ejemplo 79. Ejemplo
El primer modelo de impresora admite un rango de valores de 0 a 30, mientras que el segundo modelo de impresora admite los valores de -15 a 15. Para obtener más información, consulte las propiedades del controlador de la impresora.
-
Oscuridad: define la oscuridad de los objetos impresos en el papel y anula la configuración de la etiqueta. El valor provisto debe estar en el rango de valores aceptados.
-
Desplazamiento de la impresora X: aplica el desplazamiento horizontal. La impresión de etiquetas se reubicará según el número de puntos específico en la dirección horizontal. Se puede definir un desplazamiento negativo.
-
Desplazamiento de la impresora Y: aplica el desplazamiento vertical. La impresión de etiquetas se reubicará según el número de puntos específico en la dirección vertical. Se puede definir un desplazamiento negativo.
Sugerencia
Todos los parámetros de impresión pueden ser preprogramados o proporcionarse en forma dinámica usando una variable existente o recientemente creada.
El grupo Avanzada personaliza la configuración de la impresora enviada con el trabajo de impresión.
La configuración de la impresora, como la velocidad de impresión, la oscuridad, el tipo de medios, el desplazamiento y otros, puede definirse de la siguiente manera:
-
Definido en la etiqueta
-
Recuperado de un controlador de impresora
-
Recuperado de una impresora al momento de la impresión
Los métodos admitidos dependen de las capacidades de la impresora y del controlador de la impresora. El modo de impresión (recuperar configuración de la etiqueta, del controlador o de la impresora) se configura en el diseño de la etiqueta. Es posible que necesite aplicar esta configuración de la impresora al momento de la impresión, pueden variar con cada impresión.
Ejemplo 80. Ejemplo
Una etiqueta simple debe imprimirse usando una variedad de impresoras, pero cada impresora necesita parámetros ligeramente distintos. Las impresoras de varios fabricantes no utilizan los mismos valores para configurar la velocidad o la temperatura de impresión. Además, algunas impresoras necesitan desplazamiento vertical u horizontal para imprimir la etiqueta en la posición correcta. Durante la etapa de prueba, puede determinar la configuración óptima para cada impresora que quiera utilizar y aplicarla a una plantilla de etiqueta simple justo antes de imprimir. Esta acción aplicará la configuración correspondiente a cada impresora definida.
Esta acción espera recibir la configuración de la impresión en una estructura DEVMODE. Es una estructura de datos estándar de Windows con información sobre la inicialización y el entorno de una impresora.
La opción Configuración de la impresora aplica la configuración de la impresora predeterminada. Están disponibles las siguientes entradas:
-
DEVMODE codificada en Base64 con datos fijos. En este caso, brinde la cadena codificada en Base64 DEVMODE de la impresora directamente en el campo de edición. Al ejecutar esta acción, se convierten los datos codificados en Base64 nuevamente a la forma binaria.
-
DEVMODE codificada en Base64 con datos variables. En este caso, el origen de datos seleccionado debe tener la estructura DEVMODE codificada en Base64. Habilite Origen de datos y seleccione la variable adecuada de la lista. Al ejecutar esta acción, se convierten los datos codificados en Base64 nuevamente a la forma binaria.
-
DEVMODE binaria con datos variables (disponible en Automation Builder). En este caso, la variable seleccionada debe tener la estructura DEVMODE en su forma binaria nativa. Habilite Origen de datos y seleccione la variable adecuada de la lista. Al ejecutar esta acción, se utilizará la estructura DEVMODE como está, sin ninguna conversión.
Nota
Si la variable no brinda la estructura DEVMODE binaria, asegúrese de que la variable seleccionada esté definida como variable binaria en la configuración.
Nota
Asegúrese de que la acción Establecer impresora esté definida delante de esta acción.
La Configuración de la etiqueta anula las propiedades de etiquedas definidas en Propiedades de etiqueta en Designer. Use esta opción cuando imprima sus etiquetas en una impresora o medio con diferentes propiedades como aparecen en Propiedades de etiqueta en Designer. Con esta opción puede:
-
Cambiar las dimensiones (altura, ancho) de su etiqueta.
-
Agregar o cambiar márgenes en la etiqueta.
-
Desactivar el cortador.
-
Desactivar la impresión por lotes.
-
Aplicar diferentes papeles cambiando el parámetro Etiqueta horizontal (conteo horizontal y vertical, espacios, orden de procesamiento).
-
Redefinir la orientación como paisaje o retrato.
-
Girar las etiquetas 180º.
PowerForms aplica la Configuración de la etiqueta al momento de imprimir. Los parámetros de la configuración de la etiqueta no se guardan en las plantillas de etiquetas. Puede proporcionar la Configuración de la etiqueta como carga XML.
XML de Configuración de etiqueta de muestra
La siguiente muestra presenta una vista estructural de la configuración de la etiqueta y sus atributos.
<LabelSettings>
<Width>100</Width>
<Height>30</Height>
<Margin>
<Left>2</Left>
<Right>3</Right>
<Top>4</Top>
<Bottom>5</Bottom>
</Margin>
<LabelsAcross>
<Horizontal>
<Count>2</Count>
<Gap>4</Gap>
</Horizontal>
<Vertical>
<Count>3</Count>
<Gap>5</Gap>
</Vertical>
<ProcessingOrder>HorizontalTopRight</ProcessingOrder>
</LabelsAcross>
<Orientation>Landscape</Orientation>
<Rotated>true</Rotated>
<DisableCutter/>
<DisableBatchPrinting/>
<PaperType>Roll or Sheet</PaperType>
<PaperName>A5</PaperName>
</LabelSettings>
Especificación de XML para Configuración de etiqueta
Esta sección contiene una descripción de la estructura del archivo XML para definir los parámetros y valores de la Configuración de etiqueta.
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="nonNegativeFloat">
<xs:restriction base="xs:float">
<xs:minInclusive value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="LabelSettings">
<xs:complexType>
<xs:all>
<xs:element name="DisableCutter" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:sequence/>
</xs:complexType>
</xs:element>
<xs:element name="DisableBatchPrinting" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:sequence/>
</xs:complexType>
</xs:element>
<xs:element name="Width" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
<xs:element name="Height" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
<xs:element name="Margin" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:all>
<xs:element name="Left" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
<xs:element name="Right" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
<xs:element name="Top" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
<xs:element name="Bottom" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="LabelsAcross" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:all>
<xs:element name="Horizontal" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:all>
<xs:element name="Count" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1" />
<xs:element name="Gap" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="Vertical" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:all>
<xs:element name="Count" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1" />
<xs:element name="Gap" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="ProcessingOrder" minOccurs="0" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="HorizontalTopLeft"/>
<xs:enumeration value="HorizontalTopRight"/>
<xs:enumeration value="HorizontalBottomLeft"/>
<xs:enumeration value="HorizontalBottomRight"/>
<xs:enumeration value="VerticalTopLeft"/>
<xs:enumeration value="VerticalTopRight"/>
<xs:enumeration value="VerticalBottomLeft"/>
<xs:enumeration value="VerticalBottomRight"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="Orientation" minOccurs="0" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Portrait"/>
<xs:enumeration value="Landscape"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="Rotated" type="xs:boolean" minOccurs="0" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Esta acción desvía el trabajo de impresión a un documento PDF. El documento PDF creado retiene las dimensiones exactas de la etiqueta, que se definen durante el diseño de la etiqueta. La calidad de representación de los gráficos en el PDF coincide con la resolución de la impresora de destino y el tamaño de impresión deseado.
Los datos de la secuencia de impresión pueden anexarse al archivo existente, o sobrescribir un archivo existente.
La acción instruye a NiceLabel 10 a redireccionar la impresión; como resultado, las etiquetas no se imprimirán. Asegúrese de que la acción esté seguida de la acción Imprimir etiqueta.
Nota
El módulo NiceLabel Automation se ejecuta como servicio con una cuenta de usuario de Windows. Asegúrese de que esta cuenta de usuario tenga privilegios para acceder a la carpeta especificada con permisos para leer/escribir. 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 Archivo define el archivo de redirección.
-
Nombre de archivo: especifica el nombre de archivo hacia el cual desviar el trabajo de impresión. Si está integrado como parte del código, la impresión se redirecciona todas las veces hacia el archivo especificado. Para definirlo en forma dinámica, use una variable existente o cree una nueva.
-
Sobrescribir el archivo: si el archivo especificado ya existe en el disco, se sobrescribirá (seleccionado de manera predeterminada).
-
Anexar datos al archivo: el archivo de trabajo se anexa a los datos existentes del archivo en cuestión (no seleccionado de manera predeterminada).
-
Incorporar fuentes en PDF: Si utiliza alguna fuente no estándar, puede que su solución genere un resultado en PDF diferente en las computadoras que no tengan esa fuente. Si habilita la opción Incorporar fuentes en PDF, la fuente no estándar se incorporará en la solución, de modo que la solución genere el mismo PDF en cualquier computadora.
La opción Incorporar fuentes en PDF crea un documento conforme a la norma de PDF para archivado (PDF/A). La norma PDF/A garantiza que los documentos se reproduzcan exactamente de la misma manera sin importar software utilizado. La información necesaria para mostrar el contenido, como las imágenes, las fuentes y los datos de colores, se incorporan en el archivo PDF.
Nota
El archivo PDF resultante ocupa más espacio cuando se guarda con esta opción habilitada.
El grupo Persistencia permite controlar la persistencia de la acción de redirección. Defina el número de acciones Imprimir etiqueta que se ven afectadas por la acción Redireccionar impresión a archivo.
-
Aplicar a la próxima acción de impresión: especifica que la redirección de la impresión se aplique únicamente a la próxima acción Imprimir etiqueta (evento único).
-
Aplicar a todas las acciones de impresión subsiguientes: especifica que la redirección de la impresión se aplique a todas las acciones de Imprimir etiqueta definidas después de la acción Redireccionar impresión a archivo actual.
Esta acción se comunica con la impresora para adquirir su estado en tiempo real y se contacta con el administrador de trabajos de impresión de Windows para obtener información adicional sobre la impresora y sus trabajos.
Como resultado, se recopila la información sobre errores, el estado del administrador de trabajos de impresión y la cantidad de trabajos en el administrador. Esto expone potenciales errores y hace que sea fácil identificarlos.
Posibles escenarios de casos de uso. (1) Verificar el estado de la impresora antes de imprimir. Si la impresora está en estado de error, usted imprimirá la etiqueta en una impresora de respaldo. (2) Contar el número de trabajos que se encuentran a la espera en el administrador de trabajos de impresión de la impresora principal. Si hay demasiados, imprimirá la etiqueta en la impresora alternativa. (3) Usted verificará el estado de la impresora antes de imprimir. Si la impresora se encuentra en estado de error, usted no imprimirá la etiquetas, sino que informará sobre el error al sistema principal utilizando alguna de las acciones de salida, como Enviar datos a puerto TCP/IP, Enviar datos a HTTP, Ejecutar instrucción SQL, Servicio Web, o como una respuesta de desencadenador.
Prerrequisitos del estado en vivo de la impresora
Para que el monitoreo del estado en vivo de la impresora, siga estas instrucciones:
-
Utilice el controlador de impresora Loftware para recibir información detallada sobre el estado. Si está usando otro controlador de impresora, solo puede monitorear los parámetros recuperados desde el Administrador de trabajos de impresión de Windows.
-
La impresora debe tener capacidad para informar el estado en vivo. Para ver los modelos de impresoras que admiten comunicación bidireccional, consulte la página web de descargas.
-
La impresora debe estar conectada a una interfaz que admita comunicación bidireccional.
-
La compatibilidad bidireccional debe habilitarse en Panel de control > Hardware y sonido > Dispositivos e impresoras > controlador > Propiedades de las impresoras > pestaña Puertos > Habilitar compatibilidad bidireccional.
-
Si utiliza una impresora de etiquetas conectada en red, asegúrese de usar el Puerto TCP/IP avanzado, no el Puerto TCP/IP estándar. Para obtener más información, consulte Artículo de base de conocimiento KB 189.
El grupo Impresora selecciona la impresora.
-
Nombre de impresora especifica el nombre de la impresora que se utilizará para el trabajo de impresión en curso.
Puede seleccionar una impresora de la lista de controladores de impresoras instalados localmente, o puede escribir el nombre de la impresora. El origen de datos habilita el nombre de la impresora variable. Cuando esté activado, seleccione o cree una variable que contenga el nombre de la impresora cuando se ejecuta un desencadenador o se lleva a cabo un evento. Generalmente, el valor de la variable se asigna según un filtro.
El grupo Asignación de datos establece los parámetros que se devuelven como resultado de la acción Estado de impresora.
Aviso
La mayoría de los parámetros siguientes solo son compatibles con el controlador de impresora Loftware. Si utiliza cualquier otro controlador de impresora, solamente podrá usar los parámetros relacionados con el administrador de trabajos de impresión.
-
Estado de impresora: especifica el estado en vivo de la impresora con formato de cadena.
Si la impresora informa múltiples estados, todos los estados se combinan en una sola cadena, delimitados por comas ",". Si no se informan problemas de la impresora, este campo estará vacío. El estado de la impresora puede ser Sin conexión, Sin etiquetas o Banda de opciones cerca del final. Como no existe ningún protocolo estándar de informe, cada proveedor de impresoras utiliza sus propios mensajes de estado.
-
Error de impresora: valor booleano (verdadero/falso) del estado de error de la impresora.
-
Impresora sin conexión: valor booleano (verdadero/falso) del estado sin conexión de la impresora.
-
Impresora pausada: valor booleano (verdadero/falso) del estado de pausa de la impresora.
-
Controlador Loftware : valor booleano (verdadero/falso) del estado del controlador de la impresora. Proporciona información si el controlador seleccionado es un controlador Loftware.
-
ID de estado del administrador de trabajos de impresión: especifica el estado del administrador de trabajos de impresión en forma de cadena, de acuerdo con lo informado por el sistema Windows. El administrador de trabajos de impresión puede informar simultáneamente varios estados. En este caso, los estados se combinan mediante comas ",".
-
ID de estado del administrador de trabajos de impresión: especifica el estado del administrador de trabajos de impresión en formato de número, de acuerdo con lo informado por el sistema Windows. El administrador de trabajos de impresión puede informar simultáneamente varios estados. En este caso, los ID de estado devueltos contienen todos los ID como indicadores. Por ejemplo, el valor 5 representa los ID de estado 4 y 1, lo cual significa que "La impresora tiene errores, La impresora está pausada". Consulte la siguiente tabla.
Sugerencia
La acción devolverá un valor decimal; los valores de la siguiente tabla se encuentran en hexa, así que tendrá que hacer la conversión antes de analizar la respuesta.
-
Tabla de ID de estados del administrador de trabajos de impresión y descripciones correspondientes
ID de estado del administrador de trabajos de impresión (en hexa)
Descripción del estado del administrador de trabajos de impresión
0
Sin estado.
1
La impresora está en pausa.
2
La impresora está imprimiendo.
4
Ocurrió un error con la impresora.
8
La impresora no está disponible.
10
La impresora no tiene papel.
20
Se necesita alimentación manual.
40
La impresora tiene un problema con el papel.
80
La impresora está desconectada.
100
Estado de entrada/salida activo.
200
La impresora está ocupada.
400
Atasco de papel.
800
La bandeja de salida está llena.
2000
La impresora está esperando.
4000
La impresora está procesando.
10000
La impresora se está preparando.
20000
El nivel de tóner/tinta es bajo.
40000
No hay tóner en la impresora.
80000
La página actual no se puede imprimir.
100000
Se necesita la intervención del usuario.
200000
La impresora no tiene memoria.
400000
La puerta está abierta.
800000
Error desconocido.
1000000
La impresora está en modo de ahorro de energía.
-
Cantidad de trabajos en el administrador de trabajos de impresión: especifica la cantidad de trabajos en curso en el administrador de trabajos de impresión para la impresora seleccionada.
-
Estado de impresora extendido del controlador de LoftwareNiceLabel: devuelve el estado de la impresora y los datos de errores en formato JSON. Los datos incluyen también los parámetros de la impresora, como la versión de firmware, la distancia del cabezal y el nivel de tinta.
Nota
Debe contar con la versión más reciente del controlador de Loftware para obtener el Estado de impresora extendido del controlador de Loftware.
Ejemplo 83. Ejemplo
NiceLabel Automation devuelve el siguiente contenido JSON:
{ "printerName":"Production_printer_09", "version":"1", "responseType":"status3", "overallStatus":"error", "operationState":"pause", "printerType":"Thermal Transfer Label Printer", "deviceStatus": [ { "item": "fatalError", "type": "string", "internalId":"ERR_PAPER_OUT", "shortString":"Paper Out", "longString":"Printer is out of paper." }, { "item": "error", "type": "string", "internalId": "ERR_RIBBON_OUT", "shortString": "Ribbon Out", "longString": "Printer is out of Ribbon." } ], "deviceParameters": [ { "item":"state", "type":"float", "internalId":"INFO_PRINTHEAD_DISTANCE", "unit": "meter", "value": 789, "shortDescription":"Printhead distance", "longDescription":"Distance of printhead usage." }, { "item": "state", "type": "string", "internalId": "INFO_FW", "unit": "", "value": "FW27.3.13", "shortDescription": "Firmware version", "longDescription": "The version of the Firmware loaded on the printer." }, { "item": "property", "type": "integer", "internalId": "INFO_PRINT_DISTANCE", "unit": "seconds", "value": 16004, "shortDescription": "Print Distance", "longDescription": "Print Distance that the printer printed since odometer reset." } ] }
Esta acción guarda una plantilla de etiqueta en la memoria de la impresora. La acción es una parte vital del modo de impresión almacenar/recuperar, con la cual primero almacena una plantilla de etiquetas en la memoria de la impresora y luego la recupera. Las partes que no se cambian del diseño de la etiqueta ya están almacenadas en la impresora, solo tiene que proporcionar los datos para los objetos de etiquetas variables al momento de imprimir. Para obtener más información, consulte la sección Usar modo de impresión almacenar/recuperar en la guía de usuario NiceLabel Automation.
Nota
El tiempo de transferencia de datos de la etiqueta requerida está ampliamente minimizado, ya que hay menos información para enviar. Esta acción se usa generalmente en situaciones de impresión independiente, en las que se almacena la etiqueta en la impresora o el aplicador en la línea de producción y luego se recupera del desencadenador del mismo software o hardware, como el escáner de códigos de barras o la fotocélula.
El grupo Opciones avanzadas para almacenar etiqueta en impresora le permite seleccionar una etiqueta y la variante de almacenamiento preferida.
-
Nombre de la etiqueta que se usará en la impresora: especifica el nombre que se usará para almacenar la plantilla de la etiqueta en la memoria de la impresora. Ingrese el nombre manualmente o habilite Origen de datos para definir el nombre dinámicamente usando un valor variable existente o recientemente creado.
Aviso
Al almacenar la etiqueta en una impresora, se recomienda dejar vacío el nombre de la etiqueta debajo de las opciones avanzadas. De esta manera, se evitan conflictos con el nombre de la etiqueta durante el proceso de recuperación de etiquetas.
-
Variante de almacenamiento: define la ubicación en la memoria de la impresora para las plantillas de etiquetas almacenadas. Ingrese la ubicación manualmente o habilite Origen de datos para definir el nombre dinámicamente usando un valor variable existente o recientemente creado.
La acción Imprimir documento PDF imprime documentos PDF estáticos que no están vinculados a las etiquetas en sus soluciones de PowerForms. Utilice esta acción para imprimir cualquier documento PDF directamente desde sus soluciones. Los documentos PDF se pueden almacenar en:
-
Su computadora
-
NiceLabel Control Center
-
Servidor web
-
Unidades de red compartidas
Sugerencia
Esta acción es útil si planea equipar sus paquetes con informes en PDF impresos sobre los elementos incluidos, o si desea imprimir la documentación del paquete sin abrir el explorador de archivos.
El grupo Impresora especifica el nombre de la impresora que se utilizará para el trabajo de impresión en curso.
-
Nombre de la impresora: selecciónelo de la lista de controladores de impresoras instalados localmente, o escriba el nombre de la impresora. Seleccione el Origen de datos para seleccionar en forma dinámica la impresora usando una variable. Cuando esté activado, seleccione o cree una variable que contenga el nombre de la impresora que se usa cuando se ejecuta la acción.
El grupo Archivo define el archivo de redirección.
-
Nombre del archivo: especifica qué PDF imprimir.
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 abre otro formulario desde la misma solución o desde su disco.
El grupo Configuración incluye las siguientes opciones:
-
Regresar al formulario abierto anteriormente: vuelve a abrir el formulario precedente cuando se ejecuta la acción Abrir otro formulario.
-
Abrir formulario: define el formulario que se abrirá cuando se ejecute la acción Abrir otro formulario.
Hay cuatro modos de abrir un formulario:
-
Ingresar la ruta absoluta de acceso del archivo.
-
Seleccionar un formulario existente desde la solución.
-
Hacer clic en Abrir para buscar el archivo en el disco.
-
Utilizar un origen de datos para definir la ruta de acceso del archivo dinámicamente
El grupo Orígenes de datos de formulario lo ayuda a administrar valores de variables al alternar entre formularios.
-
Restablecer valores de variables: De manera predeterminada, si el contenido de un objeto de formulario es un valor variable, alternar a otro formulario conserva su valor actual. Si habilita la opción Restablecer valores de variable, el valor de la variable se restablece a su valor inicial después de que abre otro formulario.
-
Nota
La acción Abrir otro formulario solo conserva los valores de las variables que están en uso como orígenes de datos de objetos. Si las variables solo se detallan en el Administrador de datos dinámicos, sus valores no se transfieren.
Nota
Si la variable no tiene valor inicial, el objeto aparece vacío.
Ejemplo 87. Ejemplo
Esta opción puede ser útil para soluciones de administración de datos. Al editar los datos, debe conservar los valores existentes. Al agregar datos nuevos, debe restablecer los valores. Si usa el primer formulario para edición de datos y el segundo para agregar datos nuevos, conserve la opción Restablecer valores de variables desactivada para el formulario de edición de datos, y habilite esta opción para el formulario de adición de datos.
Esta acción mueve el enfoque a un objeto especificado en un formulario.
El grupo Configuración define el movimiento del enfoque:
-
Mover enfoque al primer objeto en el orden de tabulación: establece el enfoque en el primer objeto en el orden definido después de ejecutar el formulario.
-
Mover enfoque al objeto seleccionado coloca el enfoque después de ejecutar el formulario en el objeto seleccionado.
Esta acción le permite recuperar los números de las filas seleccionadas o valores de campos seleccionados en objeto formulario de tabla de base de datos. Los valores se almacenan en una variable nueva o creada recientemente. La acción Obtener fila de tabla seleccionada actúa como la contraparte de la acción Seleccionar fila de tabla.
El grupo Tabla de formulario le permite elegir el objeto Tabla de base de datos en el formulario y seleccionar qué valores deben almacenarse en una variable.
-
Tabla: define qué objeto Tabla de base de datos en el formulario se usa con esta acción.
-
Números de fila seleccionada: almacena los números de las filas de tabla seleccionadas en la variable Filas seleccionadas.
-
Contenido de campo tabla para filas seleccionadas: almacena el valor relacionado con el campo de las filas de la tabla seleccionadas.
-
Campo de tabla: define el campo de tabla desde el que se toman los valores y se almacenan en la variable Filas seleccionadas.
-
Nota
Si se seleccionan múltiples filas, los valores almacenados (números de filas o valores de campo) se separan por comas. Para habilitar la selección de múltiples filas, abra Propiedades de objeto Tabla de base de datos > Configuración y active selección de múltiples filas.
Nota
Si los valores almacenados (números de fila o valores de campo) contienen coma, se rodean con signos de interrogación.
-
-
Variable de filas seleccionadas: selecciona o crea una variable que almacena el campo Tabla o el valor de Números de filas seleccionadas.
Sugerencia
Use esta variable como origen de datos para mostrar los valores seleccionados en un objeto formulario.
Sugerencia
Para mostrar la selección del registro inmediatamente después de ejecutar el formulario, use el evento En carga de formulario. Vaya a Propiedades de formulario > Eventos > En carga de formulario y haga clic en Acciones.... Agregue la acción Seleccionar fila de tabla y defina las filas como se explica en esta sección.
Esta acción le permite definir qué fila en un objeto formulario de tabla de base de datos se selecciona. Funciona como contraparte de la acción Obtener fila de tabla seleccionada.
El grupo Tabla de formulario le permite elegir el objeto Tabla de base de datos en el formulario y seleccionar el modo con el cual se selecciona la fila en la tabla elegida.
-
Tabla: define qué objeto Tabla de base de datos en el formulario se usa con esta acción.
-
Modo de selección: define el modo de selección del registro de base de datos.
-
Primera fila: selecciona la primera fila en el objeto Tabla de base de datos.
-
Última fila: selecciona la última fila en el objeto Tabla de base de datos.
-
Número de fila: permite la selección personalizada de las filas de una tabla de base de datos. Ingrese los números de fila o defínalos en forma dinámica usando un origen de datos. Para seleccionar múltiples filas, ingrese sus números de fila separados por comas.
-
Valor de campo: seleccione todos los registros en la tabla de base de datos con valores de datos coincidentes.
-
Campo Tabla: campo de la base de datos con valores que se seleccionan en caso de una coincidencia.
-
Valor de campo: valor que selecciona la fila (registro) en caso de una coincidencia.
-
Nota
Las opciones Número de fila y Valor de campo seleccionan la fila de tabla sin tener en cuenta la clasificación actual de las filas de la tabla. Por ejemplo, la "fila número 3" permanece seleccionada aun si la clasificación de la tabla reposiciona la "fila número 3" en cualquier otra fila.
-
Seleccionar todas las filas: selecciona todas las filas en la tabla.
-
Cancelar la selección de todas las filas: cancela todas las filas en la tabla.
Nota
Se seleccionan múltiples filas si la tabla lo admite. De lo contrario, solo se selecciona la primera fila.
-
Cuando se selecciona una fila de la tabla, el número de fila puede almacenarse en una variable. Para habilitar esta opción, use la opción Almacenar número de fila seleccionado en la variable en las propiedades de Tabla de base de datos.
Nota
La acción Seleccionar fila de tabla define su rango de selección en el conjunto de datos. Esto significa que los registros se seleccionan directamente desde la base de datos conectada y no desde la tabla. Si el filtrado está habilitado en el objeto Tabla de base de datos, no afecta la acción Seleccionar fila de tabla.
Esta acción configura las propiedades del objeto de formulario, como el ancho, el alto y el color.
El grupo Configuración define qué propiedades se establecerán:
-
Nombre de objeto: objeto de formulario que se editará. La lista desplegable contiene objetos en el formulario.
-
Propiedades: define las propiedades del objeto de formulario que se establecerán. La disponibilidad de propiedades depende del objeto seleccionado actualmente.
Sugerencia
La configuración tiene efecto una vez que se ejecuta el formulario y se lleva a cabo el evento asignado.
Propiedades
Rol
Aplicabilidad
X
Establece la distancia desde el borde izquierdo/derecho del formulario.
Todos los objetos de formulario.
Y
Establece la distancia desde el borde superior/inferior del formulario.
Todos los objetos de formulario.
Ancho
Establece el ancho del objeto.
Todos los objetos de formulario.
Altura
Establece la altura del objeto.
Todos los objetos de formulario.
Activada
Hace que el objeto esté habilitado o deshabilitado.
Todos los objetos de formulario.
Visible
Hace que el objeto sea visible o invisible.
Todos los objetos de formulario.
Nombre de fuente
Cambia el nombre de fuente a la fuente seleccionada.
Todos los objetos de formulario con contenido textual.
Tamaño de fuente
Cambia el tamaño de fuente al valor seleccionado.
Todos los objetos de formulario con contenido textual.
Estilo de fuente
Cambia el estilo de fuente al estilo seleccionado.
Todos los objetos de formulario con contenido textual.
Color de fuente
Cambia el color de fuente al color seleccionado.
Todos los objetos de formulario con contenido textual.
Color
Cambia el color de objeto al color seleccionado.
Todos los objetos de formulario, excepto Navegador de base de datos, Imagen.
Columnas visibles
Hace que la selección de columnas de la tabla sea visible.
Las columnas se ven en el mismo orden en el que se ingresaron en el campo Valor.
Tabla de bases de datos.
-
Valor: valores separados por coma. Use el carácter " si el nombre del valor incluye una coma.
Sugerencia
Encontrará un ejemplo de definición de propiedad de objeto descrito en el tema objeto formulario de Tabla de base de datos de la Guía de usuario para diseñadores.
Esta acción traduce todas las cadenas de un formulario al idioma seleccionado. El archivo de traducción contiene cadenas en el idioma de origen y para esta acción es obligatorio tener cadenas traducidas. Si debe crear un nuevo archivo de traducción, siga las reglas de formato a continuación.
El grupo Configuración para traducir formulario selecciona el idioma y selecciona o crea un nuevo archivo de traducción.
-
Idioma: idioma que se utilizará en el formulario traducido. El nombre del idioma se define en la primera fila del archivo de traducción.
Sugerencia
El nombre del idioma en el archivo de traducción lo configura el usuario. Use el mismo Id (nombre) en la acción que definió en el archivo de traducción. El nombre del idioma puede ser fijo o variable. Su uso depende del tipo de selección de idioma que se utilizó en el formulario.
Nombre fijo: nombre del idioma con codificación rígida que debe coincidir con el nombre de la primera fila del archivo de traducción.
Nombre de variable: Ejemplo es un cuadro desplegable con nombres de idiomas. Cuando el usuario cambia el idioma de la lista, el evento Al cambiar ejecuta la acción Traducir formulario. El cuadro desplegable guarda la selección del usuario en una variable, que se utiliza para la acción.
-
Archivo de traducción: archivo que contiene cadenas de origen y traducciones a varios idiomas. Es un archivo de texto estructurado, similar a un archivo CSV.
-
Crear archivo de traducción: haga clic en este botón para crear el archivo de traducción que contenga las cadenas de origen y traducidas.
Estructura del archivo de traducción: es un archivo de texto con datos codificados UTF-8. Es similar a los valores separados por comas (CSV).
Las Reglas de formato son obligatorias. Siempre siga las reglas incluidas a continuación.
-
La primera línea contiene el Id del idioma.
-
El primer campo siempre se llama Origen. No debe cambiarlo.
-
Los nombres de otros campos de la primera fila los configura el usuario. Use los nombres sugeridos, como "Idioma 2" e "Idioma 3", o reemplácelos con una descripción del idioma más precisa, como "Alemán", "Francés" y "Chino", etc.
-
Todas las líneas posteriores a la primera línea son traducciones del idioma original. El primer campo tiene la cadena original, los campos siguientes de la misma línea tienen traducciones a otros idiomas. La primera línea especifica en qué orden la traducción debe seguir la cadena.
-
Todos los valores están encerrados entre comillas dobles (").
-
Todos los valores están delimitados con un punto y coma (;).
-
Si tiene objetos de texto de varias líneas en el formulario, la nueva línea (<CR><LF>) estará codificada como una cadena especial $NUEVALÍNEA$.
-
Si deja la traducción vacía, se utiliza la cadena Origen.
Ejemplo de archivo de traducción:
Source";"DE" "&Print";"&Druck" "Customize$NEWLINE$your$NEWLINE$printing$NEWLINE$forms";" Anpassen$NEWLINE$Sie$NEWLINE$Ihre$NEWLINE$Druckformen" "Printer:";"Drucker" "Quantity";"Menge" "SAMPLE";"PROBE" "Se&ttings";"Einstellungen" "Translate";"Übersetzen" "www.loftware.com/solutions";""
Traducir cadenas
Al utilizar la acción Traducir formulario en cualquier lugar del formulario, todas las cadenas del formulario se guardan automáticamente en el archivo de traducción siempre que guarde el formulario. De esta manera se asegura de que el archivo de traducción esté actualizado en el formulario.
El archivo de traducción es un archivo de texto con reconocimiento Unicode. Puede editarlo en cualquier editor de texto, pero quizás tenga problemas para reconocer los campos, ya que sus valores están separado con punto y coma y no están alineados uno debajo del otro.
También puede abrir el archivo en una aplicación de hojas de cálculo, como Microsoft Excel. En este caso, los campos que pertenecen a un idioma particular se muestran en la misma columna de datos, y son más fáciles de editar.
Nota
Las aplicaciones de hojas de cálculo pueden cambiar la estructura del archivo de entrada del archivo de traducción. En este caso, vuelva a formatear los datos usted mismo después de guardar el archivo de traducción.
Ejemplo 94. Ejemplo
Microsoft Excel guardará el archivo de traducción como CSV. Los campos pierden las comillas dobles en los valores y se delimitan con coma (,) en lugar de punto y coma (;). Deberá convertir las comas en puntos y comas y colocar comillas dobles en los campos. Puede hacerlo con la acción buscar & reemplazar.
Traducir valores de etiquetas en una solución
A veces, los formularios muestran valores que provienen de etiquetas en el mismo documento de la solución. La acción Traducir formulario no traduce estos valores de etiquetas automáticamente, ya que usted tiene que agregarlos manualmente al archivo de traducción.
Agregue valores de etiquetas al archivo de traducción usando las mismas reglas de formato que se describen arriba.
Ejemplo 95. Ejemplo
Su solución contiene un formulario y una etiqueta. El formulario incluye el objeto Inicialización de datos para asignar valores a las variables de etiqueta. Quiere mostrar el formulario original en inglés en idioma alemán usando la acción Traducir formulario (es decir, haciendo clic en un botón del formulario).
El texto original del mensaje para las variables es "Define variable value". Para mostrar la traducción al alemán, agregue esta línea al archivo de traducción: "Define variable value";"Definieren Sie den Variablenwert"; Una vez que hace clic en el botón con la acción Traducir formulario asignada, aparece el texto del mensaje en alemán.
La acción de Mensaje crea ventanas emergentes con mensajes personalizados en sus Soluciones para que pueda proveerles a sus operadores:
-
Advertencias específicas
-
Mensajes de error
-
Información
-
Preguntas
Puede asignar valores fijos a las acciones de Título y Mensaje o conectarlas a orígenes de datos dinámicos. Se pueden guardar respuestas a los mensajes ("Acetar", "Cancelar", "Sí" o "No") como variables. También puede utilizar los Mensajes como herramientas de depuración cuando diseñe y pruebe los formularios mostrando los resultados de funciones en los mensajes.
Creación de mensajes personalizados para formularios en el Editor de acciones.
Los mensajes contienen símbolos que corresponden a diferentes tipos de mensajes:
-
Información
-
Errores
-
Advertencias
-
Preguntas
Añada mensajes con la acción Mensajes para evitar confusiones e informar a los operadores sobre errores de procesamiento de datos cuando se ejecuten sus soluciones.
Esta acción asigna un valor nuevo a la variable seleccionada.
Generalmente, las variables obtendrán los valores con la acción Usar filtro de datos (disponible en Automation Builder), la cual extraerá los campos de los datos recibidos y los asignará a las variables. Además, tal vez necesite configurar usted mismo los valores de las variables, en general, por motivos de resolución de problemas. En Automation Builder, los valores de las variables no se transmiten entre múltiples desencadenadores, pero sí se mantienen mientras el mismo desencadenador se está procesando.
El grupo Variable define el nombre de variable y su valor.
-
Nombre: nombre de la variable cuyo valor debería cambiar.
-
Valor: valor que se establecerá para una variable. Pueden definirse en forma manual o dinámica usando una variable existente o recientemente creada.
Esta acción almacena los valores de una sola o de múltiples variables en un archivo asociado.
En el módulo NiceLabel Automation, esta acción permite el intercambio de datos entre desencadenadores. Para leer datos nuevamente en el desencadenador, use la acción Cargar datos de variables.
Sugerencia
Los valores se guardan utilizando el formato CSV, y la primera línea contiene los nombres de las variables. Si las variables contienen múltiples valores, se codifican nuevos caracteres de línea (CR/LF) como \n\r.
El grupo Configuración define el nombre del archivo.
-
Nombre de archivo: archivo en el que se guardarán los datos de variable. Si el nombre está integrado como parte del código, los valores se guardan cada vez en el mismo archivo.
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 Si el archivo existe ofrece opciones adicionales para guardar los valores.
-
Sobrescribir el archivo: sobrescribe los datos existentes con los datos de variable nuevos. El contenido anterior se pierde.
-
Anexar datos al archivo: anexa los valores de variable a los archivos de datos existentes.
El grupo Estructura del archivo define los parámetros del archivo de datos variables CSV:
-
Delimitador: especifica el tipo de delimitador (tabulación, punto y coma, coma o carácter personalizado). El delimitador es un carácter que separa los valores de variables almacenados.
-
Calificador de texto: especifica el carácter que califica el contenido almacenado como texto.
-
Codificación de archivos: especifica el tipo de codificación de caracteres que se utilizará en el archivo de datos. Automática define la codificación automáticamente. De ser necesario, el tipo de codificación preferida puede seleccionarse en la lista desplegable.
Sugerencia
UTF-8 es una buena selección predeterminada.
-
Agregar nombres de variable en la primera fila: coloca el nombre de la variable en la primera fila del archivo.
El grupo Variables define las variables que se leerán de los archivos de datos. Los valores de las variables existentes se sobrescribirán con valores del archivo.
-
Todas las variables: datos variables de todas las variables del archivo de datos que se lee.
-
Variables seleccionadas: los datos variables de las variables enumeradas se leen del archivo de datos.
Esta acción carga los valores de una o múltiples variables del archivo de datos asociado como se guardaron con la acción Guardar datos de variables . Use esta acción para intercambiar datos entre desencadenadores. Puede cargar una variable específica o todas las variables almacenadas en el archivo de datos.
El grupo Configuración define el nombre del archivo.
-
Nombre de archivo: especifica el archivo desde el que deben cargarse los datos de variable. Si el nombre está integrado como parte del código, los valores se cargan cada vez desde el mismo archivo.
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.
La configuración del grupo Estructura del archivo debe reflejar la estructura del archivo guardado mediante la acción Guardar datos de variable.
-
Delimitador: especifica el tipo de delimitador (tabulación, punto y coma, coma o carácter personalizado). El delimitador es un carácter que separa los valores.
-
Calificador de texto: especifica el carácter que califica el contenido como texto.
-
Codificación de archivos: especifica el tipo de codificación de caracteres que se utiliza en el archivo de datos. Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Sugerencia
UTF-8 es una buena selección predeterminada.
El grupo Variables define las variables cuyos datos se leerán desde los archivos de datos.
-
Todas las variables: especifica todas las variables definidas en el archivo de datos que se leerá.
-
Variables seleccionadas: especifica la selección de variables específicas que se leerán desde el archivo de datos.
Esta acción define la forma en que deben formatearse los valores de las variables seleccionadas.
Las acciones de manipulación de cadenas más conocidas son: eliminar espacios iniciales y finales, buscar y reemplazar caracteres y eliminar comillas de apertura y de cierre.
Esta característica a menudo se requiere si un desencadenador recibe un archivo de datos no estructurados o datos heredados. En estos casos, los datos deben analizarse usando el filtro Datos no estructurados. La acción de manipulación de cadenas le permite ajustar el valor de los datos.
Nota
Si esta acción no proporciona suficiente poder de manipulación de cadenas en un caso en particular, use la acción Ejecutar secuencia de comandos para manipular los datos usando Visual Basic Script o Python scripts.
El grupo Variables define las variables cuyos valores deben formatearse.
-
Todas las variables: especifica todas las variables definidas en el archivo de datos al que se le aplicará el formato.
-
Variables seleccionadas: especifica la selección de variables a las que se aplicará el formato del archivo de datos.
El grupo Formato de texto define las funciones de manipulación de cadenas que se aplican a las variables o campos seleccionados. Se pueden utilizar varias funciones. Las funciones se aplican en el mismo orden del editor, de arriba abajo.
-
Borrar espacios en el comienzo: borra todos los caracteres de espacio (código 32 ASCII decimal) en el comienzo de la cadena.
-
Borrar espacios en el final: borra todos los caracteres de espacio (valor 32 ASCII decimal) en el final de una cadena.
-
Borrar caracteres de apertura y cierre: borra los caracteres de apertura y cierre seleccionados que aparecen por primera vez en la cadena.
Ejemplo 100. Ejemplo
Al utilizar "{" como carácter de apertura y "}" como carácter de cierre, la cadena de entrada
{{selección}}se convierte en{selección}.
-
Buscar y reemplazar: ejecuta la función estándar de buscar y reemplazar a partir de los valores provistos para buscar qué y reemplazar con. Se admiten expresiones comunes.
Nota
Existen distintas implementaciones de expresiones comunes. NiceLabel 10 utiliza la sintaxis de .NET Framework para las expresiones comunes. Para obtener más información, consulte Artículo de base de conocimiento KB 250.
-
Reemplazar caracteres que no se pueden imprimir con espacios: reemplaza todos los caracteres de control en la cadena con espacios (código 32 ASCII decimal). Los caracteres que no se pueden imprimir son caracteres con valores ASCII decimales entre 0 y 31, y 127 y 159.
-
Borrar caracteres que no se pueden imprimir: borra todos los caracteres de control de la cadena. Los caracteres que no se pueden imprimir son caracteres con valores ASCII decimales entre 0 y 31, y 127 y 159.
-
Descodificar caracteres especiales: descodifica los caracteres (o códigos de control) que no están disponibles en el teclado, como Retorno de carro y Avance de línea. NiceLabel 10 utiliza una notación para codificar dichos caracteres en lenguaje natural, como <CR> para Retorno de carro y <LF> para Avance de línea. Esta opción convierte caracteres especiales de la sintaxis NiceLabel en caracteres binarios reales.
Ejemplo 101. Ejemplo
Cuando reciba los datos "<CR><LF>", Desktop Designer utilícelos como una cadena simple de 8 caracteres. Deberá habilitar esta opción para interpretar y usar los datos recibidos como dos caracteres binarios
CR(Retorno de carro – ASCII código 13) yLF(Avance de línea – ASCII código 10).
-
Buscar y borrar todo antes de: busca la cadena provista y borra todos los caracteres que preceden a la cadena definida. La cadena también se puede borrar.
-
Buscar y borrar todo después de: busca la cadena provista y borra todos los caracteres que están detrás de la cadena definida. La cadena también se puede borrar.
Esta acción envía comandos SQL al servidor SQL 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: Desea imprimir etiquetas con datos de su base de datos, pero no con todos los valores requeridos. Por ejemplo, quiere incluir solo los valores de
ID de productoyDescripción, pero no el valor dePrecio. Cree una instrucción SQL para buscar los valores dePrecioen la base de datos 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 imprimir las etiquetas, actualice los registros de la base de datos e informe al sistema que ese registro en particular ya se ha procesado. Ejemplo de código SQL: Configure el valor del campo de la tabla
AlreadyPrintedenTruepara 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 (CREATE DATABASE, CREATE TABLE), o para eliminarlas (DROP TABLE).
-
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 INSERT, DELETE y UPDATE. Esto le permite conocer los comentarios sobre cuántos registros se verán afectados; luego todas las transacciones se invierten.
Si utiliza variables 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 SELECT. Después de ejecutar una instrucción SELECT, 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.
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 INSERT, DELETE y UPDATE. Si utilizan las instrucciones INSERT, DELETE y UPDATE, 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.
Se repiten todas las acciones anidadas para cada registro devuelto utilizando la instrucción SQL.
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, se registra un error.
-
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.
Aviso
No coloque el objeto Tabla de bases de datos en su formulario de impresión si usa la acción Ejecutar instrucción SQL. Los resultados pueden ser incorrectos.
Ejemplo 103. 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 vuelve a leer la tabla de base de datos especificada.
El grupo Tabla selecciona la tabla de base de datos que se volverá a leer.
-
Tabla: define una tabla existente que se volverá a leer o crea una nueva utilizando el Asistente de bases de datos paso a paso.
Esta acción lee los datos de un archivo de texto con formato CSV y los importa en una base de datos SQL.
Nota
Antes de utilizar esta acción, se debe establecer una conexión con la base de datos SQL. La acción no funciona con bases de datos basadas en archivos, como Microsoft Access, con archivos de datos como Microsoft Excel ni con archivos de texto sin formato. Utilice una base de datos SQL basada en servidor, como Microsoft SQL Server.
Las siguientes reglas se aplican a esta acción:
-
La tabla ya debe existir dentro de la base de datos SQL.
-
La tabla debe contener CLAVE PRINCIPAL.
-
La primera línea en un archivo de texto debe definir los nombres de campo.
-
Los nombres de campo en el archivo de texto deben coincidir con los nombres de campo en la tabla de la base de datos.
-
Si el archivo de texto no proporciona un valor para algún campo, se escribe NULO en la base de datos. Si el campo no acepta valores NULOS, se escribe una cadena vacía ("").
-
Se ignoran los valores de configuración para los campos con incremento automático. La base de datos proporciona el valor para dichos campos.
-
Si el valor del archivo de texto no coincide con la estructura del campo, la acción se cancela y se muestra un mensaje de error. Por ejemplo, al intentar ingresar un valor alfanumérico en un campo numérico.
-
Si filtra registros en el formulario y muestra únicamente los registros que coinciden con cierta condición, solo podrá importar registros que no proporcionen un valor para el campo del filtro o que proporcionen el mismo valor para el filtro como se define en el formulario.
-
Solo se permiten filtros con la condición "es igual a", no "mayor que", "menor que", "contiene" o similares.
-
Si el archivo de texto contiene campos no definidos en la base de datos SQL, se ignorarán durante la importación. Solo se importarán los campos conocidos.
El grupo Configuración selecciona la tabla.
-
Tabla define la tabla predefinida en el menú desplegable o crea una nueva utilizando el Asistente de bases de datos paso a paso.
El grupo Estructura de los archivos de texto especifica los parámetros de las bases de datos de texto:
-
Delimitador: especifica el tipo de delimitador en el archivo de datos. Seleccione un delimitador predefinido o cree uno personalizado.
-
Calificador de texto: especifica el calificador de texto. Seleccione un delimitador predefinido o inserte uno personalizado.
-
Codificación de archivos: especifica el tipo de codificación de caracteres que se utiliza en el archivo de datos. 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 los datos a un dispositivo externo, aceptando una conexión TCP/IP en un número de puerto predefinido.
Enviar datos a puerto TCP/IP establece 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 107. Ejemplo
Si la variable
hostnameproporciona el nombre del servidor TCP/IP y la variableportproporciona 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 110. 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, 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.
Nota
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 113. 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.
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
Accept,User-AgentyContent-Type, 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 de encabezado como parte del código, u obtener sus valores a partir de las variables del desencadenador. 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 Content-Type.
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.
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í. 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.
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 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 datos habilita 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 abre el examinador del sistema con el cuadro de diálogo para buscar archivos o carpetas.
El grupo Diálogo establece las preferencias del examinador.
-
Examinar: selecciona entre examinar en busca de un archivo o de una carpeta.
-
Filtrar: establece el tipo de archivo que se debe buscar. Ingrese el tipo de archivo manualmente, defina los filtros utilizando un diálogo Definir filtros de archivo o seleccione Origen de datos para determinar el filtro dinámicamente utilizando un valor de variable. El diálogo Definir filtros de archivo permite al usuario:
-
Listar los filtros. Cada filtro se identifica mediante un Nombre de filtro y un tipo de Filtro.
-
Administre los filtros existentes utilizando los botones Agregar, Eliminar, Subir y Bajar.
Nota
Si quita todos los filtros, la lista desplegable de selección del tipo de archivo no se mostrará cuando se abra el diálogo.
-
-
Carpeta inicial: establece la carpeta inicial para abrir con la acción.
-
Título del diálogo: título de la ventana del examinador de archivos que se abre con la acción.
-
Permitir archivo no existente: permite examinar en busca de un archivo que no existe en la carpeta especificada. Esta opción le permite almacenar la ruta de acceso a un archivo no existente en una variable y utilizarla en una serie de acciones. El archivo puede crearse más adelante utilizando otras acciones, como Guardar datos en el archivo.
El grupo Origen de datos de salida selecciona una variable para la ruta de acceso del archivo/carpeta.
-
Guardar ruta de acceso en: variable existente o nueva para guardar la ruta de acceso del archivo/carpeta.
Esta acción ejecuta todas las acciones subordinadas (anidadas) múltiples veces. Todas las acciones anidadas se ejecutarán en bucle todas las veces definidas por la diferencia entre el valor de inicio y el valor de finalización.
Nota
La acción Para bucle inicia el modo de impresión de sesiones, un modo de optimización de la impresión que imrpime todas las etiquetas en un bucle utilizando un único archivo de trabajo de impresión. Para obtener más detalles, consulte la sección Impresión de sesiones en la guía del usuario NiceLabel Automation.
El grupo Configuración de bucle incluye las siguientes opciones:
-
Valor de inicio: referencia de punto de inicio del bucle. Seleccione Origen de datos para definir el valor de inicio en forma dinámica usando un valor de variable. Seleccione o cree una variable que contenga un valor numérico para el inicio.
-
Valor de finalización: referencia de punto de finalización. Seleccione Origen de datos para definir el valor de inicio en forma dinámica usando un valor de variable. Seleccione o cree una variable que contenga un valor numérico para el inicio.
Sugerencia
Se permiten valores negativos para el Valor inicial y el Valor final.
-
Guardar valor de bucle en una variable: guarda el valor del paso del bucle actual en una variable existente o nueva. Se permite que el valor del paso del bucle contenga algún valor entre el valor de inicio y de finalización. Guarde el valor a fin de reutilizarlo en otra acción para identificar la iteración.
Esta acción ejecuta las acciones anidadas subordinadas múltiples veces. Todas las acciones anidadas se ejecutan en un bucle tantas veces como registros haya en la tabla del formulario con una base de datos conectada.
Puede usar todos los registros o solo los que desee para ejecutar acciones anidadas subordinadas.
El grupo Configuración selecciona los registros.
-
Tabla de formulario: tabla del formulario que contiene registros para los que debe repetirse una acción.
-
Utilizar todos los registros: repite una acción para todos los registros de una tabla definida.
-
Utilizar registro seleccionado: repite una acción únicamente para los registros seleccionados.
Si usa la acción Ejecutar instrucción SQL con la opción Iterar Para cada registro habilitada, NiceLabel inserta automáticamente la acción Para cada registro. Aparecerá una nota sobre la asignación automática de sus variables.
|
|
|
Las variables de solicitud de la etiqueta se conectan automáticamente a los campos de la base de datos que tengan el mismo nombre. Consulte las instrucciones sobre cómo crear sus soluciones:
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.
Ejemplo 121. Ejemplo
La solución se conecta a la base de datos. Desea imprimir registros seleccionados en sus etiquetas.
Use la acción Para cada registro y las acciones anidadas para imprimir las etiquetas. Elija la opción Usar registros seleccionados.
Seleccione los registros de la tabla de la base de datos de la que imprimirá y, luego, imprima las etiquetas.
Esta acción le permite:
-
monitorear los errores mientras se ejecutan las acciones;
-
ejecutar un conjunto de acciones alternativas, si se produce un error
La acción Intentar crea los marcadores de posición Hacer y Al ocurrir un error para las acciones. Todas las acciones que deban ejecutarse cuando los desencadenadores se activan, deben colocarse dentro del marcador de posición Hacer. Si no se detecta ningún error al ejecutar acciones desde el marcador de posición Hacer, estas son las únicas acciones que se ejecutan. No obstante, si ocurre un error, la ejecución de acciones del marcador de posición Hacer se detiene y la ejecución se transfiere a las acciones del marcador de posición Al ocurrir un error.
Ejemplo 123. Ejemplo
Si falla alguna de las acciones del marcador de posición Hacer, se detiene la ejecución de la acción y se reanudan las acciones del marcador de posición Al ocurrir un error. Si Intentar se colocara independientemente, terminaría la ejecución del desencadenador. En este caso, Intentar está anidada debajo de la acción Para bucle. Normalmente, todo error en el marcador de posición Hacer también detendría la ejecución de la acción Para bucle, incluso si todavía hay más pasos hasta completar la acción de bucle. En este caso, Guardar datos en archivo tampoco se ejecutará. En forma predeterminada, cada error interrumpe el procesamiento total de los desencadenadores. Sin embargo, puede continuar con la ejecución de la siguiente iteración en la acción Para bucle. Para que esto suceda, habilite la opción Ignorar error en la acción Intentar. Si los datos del paso actual en Para bucle producen un error en el marcador de posición Hacer, se ejecutan las acciones de Al ocurrir un error. A continuación, se ejecuta Guardar datos en archivo en nivel 2 y luego la acción Para bucle continúa su ejecución en la siguiente iteración.
Esta acción brinda la fácil detección de errores y ejecución de "comentarios" e "informes". Por ejemplo, si ocurre un error durante el procesamiento del desencadenador, puede enviar una advertencia. Para obtener más información, consulte la sección Comentarios sobre el estado del trabajo de impresión en la guía de usuario NiceLabel Automation.
Nota
¡Importante! La acción Intentar proporciona los resultados previstos con acciones asincrónicas. Si el bucle Intentar incluye la acción Imprimir etiqueta que falla, la ejecución de la acción aún completa el bucle Intentar y no cambia a las acciones Al ocurrir un error como se espera. L resultado de no cambiar a las acciones Al ocurrir un error es la acción Imprimir etiqueta que se ejecuta de modo sincronizado de forma predeterminada. Para evitarlo, asegúrese de que esté activada la impresión supervisada. Vaya a la configuración del desencadenador > Otro > Comentarios del motor de impresión y habilite Impresión supervisada.
Nota
Lea más sobre la impresión supervisada en la sección Modo de impresión sincronizada.
Use esta acción para configurar muchas acciones dentro del mismo contenedor. Todas las acciones colocadas debajo de una acción Agrupar pertenecen al mismo grupo y se ejecutan juntas.
Esta acción brinda los siguientes beneficios:
-
Mejor organización y visualización del flujo de trabajo de la acción. Puede expandir o contraer la acción Agrupar y mostrar las acciones anidadas solo cuando sea necesario. Esto ayuda a mantener más ordenada el área de configuración.
-
Definir la ejecución condicional. Puede definir una condición en la acción Agrupar una sola vez, no individualmente para cada acción. Cuando se cumple con una condición, se ejecutan todas las acciones dentro del grupo. De este modo, se ahorra mucho tiempo de configuración y se puede reducir la cantidad de errores de configuración. La acción Agrupar es un buen método para definir la ejecución condicional SI..., ENTONCES para múltiples acciones.
Esta acción devuelve información estructural sobre el archivo de etiqueta asociado. La acción proporciona información sobre las dimensiones de la etiqueta, el controlador de la impresora y todas las variables de la etiqueta y sus propiedades principales.
La acción Obtener información de etiqueta devuelve la información original guardada en el archivo de la etiqueta. Además, proporciona información una vez que se ha simulado el proceso de impresión. La simulación garantiza que todas las variables de etiquetas obtengan el valor que tendrían durante una impresión normal. Asimismo, la información de la altura de la etiqueta proporciona las dimensiones correctas si la etiqueta está definida como de altura variable (en cuyo caso el tamaño de la etiqueta depende de la cantidad de datos que se imprimirán). La acción devolverá las dimensiones para un tamaño de etiqueta, no para un tamaño de página.
La acción guarda información de la estructura de la etiqueta en una variable seleccionada. Puede enviar los datos de vuelta al sistema utilizando la acción Solicitud HTTP (o una acción de conectividad de datos de salida similar), o en la respuesta del desencadenador, si este es bidireccional.
Nota
Esta acción debe anidarse debajo de la acción Abrir etiqueta.
El grupo Variable selecciona o crea una variable que almacena la información estructural acerca de una etiqueta.
-
Nombre: especifica el nombre de la variable. Selecciona o crea una variable que almacena la información de la etiqueta en formato XML.
-
Si desea utilizar la información de XML dentro de este desencadenador, puede definir el Filtro XML y ejecutarlo con la acción Usar filtro de datos (Automation Builder solamente).
-
Si desea devolver los datos XML como respuesta en su desencadenador HTTP o de Servicio Web, utilice esta variable directamente en el campo Datos de respuesta de la página de configuración del desencadenador.
-
Si desea guardar los datos XML en un archivo, utilice la acción Guardar datos en el archivo.
-
El grupo Configuración adicionalle permite habilitar el uso de valores provisionales.
-
Usar valores provisionales: reemplaza valores de orígenes de datos faltantes con valores provisionales.
Sugerencia
Consulte la sección Variable en NiceLabel 10 la guía del usuario para conocer una descripción detallada de los valores provisionales.
Información de etiqueta XML de muestra
La siguiente muestra presenta una vista estructural de los elementos y sus atributos tal cual se devuelven.
<?xml version="1.0" encoding="UTF-8"?>
<Label>
<Original>
<Width>25000</Width>
<Height>179670</Height>
<PrinterName>QLS 3001 Xe</Printer>
</Original>
<Current>
<Width>25000</Width>
<Height>15120</Height>
<PrinterName>QLS 3001 Xe</Printer>
</Current>
<Variables>
<Variable>
<Name>barcode</Name>
<Description></Description>
<DefaultValue></DefaultValue>
<Format>All</Format>
<CurrentValue></CurrentValue>
<IncrementType>None</IncrementType>
<IncrementStep>0</IncrementStep>
<IncrementCount>0</IncrementCount>
<Length>100</Length>
</Variable>
</Variables>
</Format>
Especificación de información de etiqueta XML
Esta sección contiene una descripción de la estructura del archivo XML según la devuelve la acción Obtener información de etiqueta.
Nota
Todos los valores de medidas se expresan en unidades 1/1000 mm. Por ejemplo, un ancho de 25000 es 25 mm.
-
<Label>: este es un elemento de raíz.
-
<Original>: especifica las dimensiones de la etiqueta y el nombre de la impresora como están guardados en el archivo de etiqueta.
-
Width: este elemento contiene el ancho original de la etiqueta.
-
Height: este elemento contiene la altura de la etiqueta original.
-
PrinterName: Este elemento contiene el nombre de la impresora para la cual se ha creado la etiqueta.
-
-
Current: especifica las dimensiones de la etiqueta y el nombre de la impresora después de que se completa la impresión simulada.
-
Width: este elemento contiene el ancho real de la etiqueta.
-
Height: este elemento contiene la altura real de la etiqueta. Si una etiqueta está definida como de altura variable, puede crecer junto con los objetos de la etiqueta. Por ejemplo, el tamaño de los objetos RTF y Cuadro de texto puede crecer en dirección vertical y hacer que la etiqueta también se expanda.
-
PrinterName: este elemento contiene el nombre de la impresora que se utilizará para imprimir.
Ejemplo 126. Ejemplo
Se usará una impresora distinta de la original si el controlador de impresora original no está instalado en esta computadora o si la impresora se ha cambiado usando la acción Establecer impresora.
-
-
<Variables> y <Variable>: el elemento
Variablescontiene la lista de todas las variables de etiquetas de solicitud, cada una definida en un elementoVariableseparado. Las variables de solicitud son aquellas que se incluyen en el cuadro de diálogo de impresión cuando se imprimen etiquetas desde el NiceLabel 10. Si no hay variables de solicitud definidas en la etiqueta, el elementoVariablesestará vacío.-
Name: contiene el nombre de variable.
-
Description: contiene la descripción de variable.
-
DefaultValue: contiene el valor predeterminado según lo definido para la variable durante el proceso de diseño.
-
Format: contiene el tipo aceptable de contenido variable (caracteres).
-
IsPrompted: contiene información acerca de si la variable es solicitada o no al momento de imprimir.
-
PromptText: contiene texto que el solicita al usuario la entrada de un valor.
-
CurrentValue: contiene el valor real que se usa para imprimir.
-
IncrementType: contiene información, si la variable se definió o no como contador. Si se definió como contador, informa qué tipo de contador es.
-
IncrementStep: contiene información sobre el paso del contador. El valor del contador aumenta o disminuye según este valor en la siguiente etiqueta.
-
IncrementCount: contiene información acerca del punto de aumentar/disminuir el valor de contador. Por lo general, el contador cambia de valor en cada etiqueta, pero eso puede modificarse.
-
Length: contiene el número máximo de caracteres almacenados en una variable.
-
IsPickListEnabled: contiene información acerca de si el usuario selecciona o no valores variables de una lista de selección.
-
PickListValues: contiene los valores reales (seleccionables) de la lista de selección.
-
Definición de esquema XML (XSD) para especificación de etiqueta XML
<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Label">
<xs:complexType>
<xs:all>
<xs:element name="Original">
<xs:complexType>
<xs:sequence>
<xs:element name="Width" type="xs:decimal" minOccurs="1" />
<xs:element name="Height" type="xs:decimal" minOccurs="1" />
<xs:element name="PrinterName" type="xs:string" minOccurs="1" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Current">
<xs:complexType>
<xs:sequence>
<xs:element name="Width" type="xs:decimal" minOccurs="1" />
<xs:element name="Height" type="xs:decimal" minOccurs="1" />
<xs:element name="PrinterName" type="xs:string" minOccurs="1" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Variables">
<xs:complexType>
<xs:sequence>
<xs:element name="Variable" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="1" />
<xs:element name="Description" type="xs:string" minOccurs="1" />
<xs:element name="DefaultValue" type="xs:string" minOccurs="1" />
<xs:element name="Format" type="xs:string" minOccurs="1" />
<xs:element name="CurrentValue" type="xs:string" minOccurs="1" />
<xs:element name="IncrementType" type="xs:string" minOccurs="1" />
<xs:element name="IncrementStep" type="xs:integer" minOccurs="1" />
<xs:element name="IncrementCount" type="xs:integer" minOccurs="1" />
<xs:element name="Length" type="xs:string" minOccurs="1" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Esta acción ejecuta comandos que se incluyen en un archivo de comandos seleccionado. Todas las opciones Tipo de archivo proporcionan comandos que NiceLabel 10 se ejecutan en orden de arriba abajo.
Los archivos de comandos generalmente proporcionan datos para una sola etiqueta, pero puede definir archivos de cualquier nivel de complejidad. Para obtener más información, consulte la sección Tipos de archivos de comandos.
El grupo Archivo define el tipo y nombre del archivo de comando que se ejecutará (JOB, XML o CSV).
-
Tipo de archivo. Especifica el tipo del archivo de comandos que se ejecutará.
-
Nombre de archivo. Especifica el nombre del archivo de comandos.
Nombre de archivo puede integrarse como parte del código, y el mismo archivo de comandos se ejecutará todas las veces. La opción Variable habilita un nombre de archivo variable. Seleccione o cree una variable que contenga la ruta de acceso o el nombre del archivo. una vez que se ejecuta un desencadenador o que se lleva a cabo un evento. Generalmente, el valor de la variable se asigna según un filtro.
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 ejecuta los comandos personalizados ingresados de NiceLabel.
Siempre anide esta acción debajo de la acción Abrir etiqueta. Permite hacer referencia a la etiqueta a la cual se aplican los comandos. Para obtener más información, consulte la sección Usar comandos personalizados en la guía de usuario NiceLabel Automation.
Nota
La mayoría de los comandos personalizados están disponibles con acciones individuales, de modo que en la mayor parte de los casos no necesita comandos personalizados.
Nota
La acción Enviar comandos personalizados puede utilizarse para finalizar el modo Impresión de sesiones. Este modo funciona como modo de optimización de la impresión que imprime todas las etiquetas en un bucle utilizando un único archivo de trabajo de impresión. Para finalizar la impresión de sesiones, anide la acción Enviar comandos personalizados debajo de la acción Para bucle y utilice el comando SESSIONEND. Para obtener más detalles, consulte las secciones Impresión de sesiones y Usar comandos personalizados en la guía del usuarioNiceLabel Automation.
El editor de Secuencias de comandos ofrece las siguientes funciones:
-
Insertar origen de datos: inserta una variable existente o creada recientemente en la secuencia de comandos.
-
Editor de Secuencias de comandos: abre el editor, que facilita la creación de secuencias de comandos y la hace más eficiente.
Esta acción lee la licencia activada y ejecuta las acciones anidadas debajo de esta acción únicamente si se utiliza cierto tipo de licencia.
Sugerencia
La acción Verificar licencia proporciona protección para la configuración del desencadenador contra la ejecución en máquinas no autorizadas.
Nota
La clave de la licencia que activa el software también puede codificar la ID de solución. Es un número único que identifica al proveedor de la solución que vendió la licencia NiceLabel 10.
Si el ID de la solución coincide con el ID de la solución codificado en la licencia, la máquina de destino puede ejecutar las acciones anidadas, limitando efectivamente la ejecución de licencias vendidas por el proveedor de la solución.
Los desencadenadores pueden cifrarse más y bloquearse de modo que solo los usuarios autorizados puedan abrir la configuración. Para obtener más información, consulte la sección Proteger configuración de desencadenadores en la guía de usuario de NiceLabel Automation.
El grupo Información de licencia le permite seleccionar el ID de la licencia.
-
El ID de la licencia define el número de licencias que pueden ejecutar las acciones anidadas.
-
Si el valor ingresado no es el ID de la licencia codificado en la licencia, las acciones anidadas no se ejecutan.
-
Si el valor ingresado es 0, las acciones se ejecutan si se encuentra una licencia válida.
-
Nota
El UID de Socio Digital también puede usarse como ID de licencia. Esta opción está disponible para miembros del Programa de Socio Digital de NiceLabel.
Esta acción registra un evento en NiceLabel Control Center como historial y para resolver problemas.
Nota
Para activar la acción Registrar eventos, asegúrese de que esté habilitado el registro de trabajos de impresión NiceLabel Control Center.
El grupo Datos de evento ofrece información acerca del evento registrado.
-
Información: descripción básica del evento que se incluirá en el registro de eventos NiceLabel Control Center. Se permiten hasta 255 caracteres en esta área.
-
Detalles: descripción detallada del evento que se registrará en NiceLabel Control Center. Se permiten hasta 2000 caracteres en esta área.
Sugerencia
Las descripciones ingresadas en los campos Información y Detalles le permiten filtrar los eventos Historial de todas las actividades del Centro de control. Al trabajar con el Centro de control, vaya a Historial > Todas las actividades > Definir filtro. Para obtener más detalles, lea la Guía del usuario del Centro de control.
Esta acción ejecuta el proceso de impresión y proporciona una vista previa de la imagen. De manera predeterminada, la vista previa se guarda en el disco como imagen JPEG, pero se puede seleccionar otro formato de imagen. También se puede controlar el tamaño de la imagen de vista previa creada. La acción genera la vista previa de una única etiqueta.
Cuando tenga la vista previa de la etiqueta creada en un archivo, podrá enviarlo a una aplicación de terceros utilizando una de las acciones de salida, como Enviar datos a HTTP, Enviar datos a puerto de serie o Enviar datos a puerto TCP/IP, o bien como mensaje de respuesta de desencadenadores bidireccionales, como Desencadenador de servidor HTTP y Desencadenador de servicio Web. La aplicación de terceros puede tomar la imagen y mostrarla como vista previa de etiqueta al usuario.
El grupo Vista previa define el archivo a previsualizar y sus detalles.
-
Nombre de archivo especifica el nombre del archivo y la ruta. Si está preprogramados, el mismo archivo se usa cada vez. Si utiliza solo el nombre del archivo sin la ruta de acceso, se usa la carpeta en la que se guardó el archivo de configuración (.MISX). Puede usar referencias relativas 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. una vez que se ejecuta un desencadenador. Generalmente, el valor de la variable se asigna según un filtro.
-
Tipo de imagen: especifica el tipo de imagen que se usa para guardar la vista previa de la etiqueta.
-
Vista previa del reverso de la etiqueta (etiquetas de dos lados): permite la vista previa del reverso de la etiqueta. Esto es útil cuando se utilizan etiquetas de dos lados y se desea generar la vista previa del reverso de la etiqueta.
Ejemplo 132. Ejemplo
Por ejemplo, si su plantilla de etiquetas define las dimensiones como 4" × 3" y la impresora tiene una resolución de 200 DPI, las dimensiones de la imagen de vista previa resultante serán 800 × 600 píxeles. El ancho equivale a 4 pulgadas multiplicadas por 200 DPI, cuyo resultado es 800 píxeles. La altura equivale a 3 pulgadas multiplicadas por 200 DPI, cuyo resultado es 600 píxeles.
El grupo Configuración adicional le permite habilitar el uso de valores provisionales.
-
Usar valores provisionales: reemplaza los valores faltantes del origen de datos con valores provisionales y los muestra en la vista previa de la etiqueta.
Sugerencia
Valor provisional: define el valor variable de un marcador de posición personalizado en un objeto al diseñar etiquetas o formularios. En un objeto de etiqueta, el valor provisional se reemplaza por el valor real de la variable al momento de la impresión.
Esta acción le permite crear una variante de una etiqueta existente lista para revisión. Los objetos de etiquetas en dichas variantes tienen valores de orígenes de datos bloqueados. Su contenido está definido por el valor actual del origen de datos aplicable.
El propósito de crear una variante de una etiqueta lista para revisión con orígenes de datos "bloqueados" es hacer que la etiqueta sea adecuada para el proceso un proceso de aprobación en el que los datos y las plantillas deben aprobarse juntos. En lugar de ver una etiqueta sin contenido definido para los objetos incluidos, el aprobador revisa una variante con valores definidos. Esto le permite ver y aprobar rápidamente el diseño de etiqueta final con los valores reales que se usarán para impresión.
Sugerencia
El proceso de aprobación de la etiqueta se aplica a las etiquetas almacenadas en el Almacenamiento de documentos del Centro de control. Puede aplicar distintos tipos de flujo de trabajo de aprobación para las etiquetas almacenadas y las variantes de etiquetas. La selección del flujo de trabajo de aprobación depende de los requerimientos de su entorno empresarial. Consulte NiceLabel 10 Guía del usuario del Centro de control para conocer más detalles.
El grupo Configuración define el archivo de etiqueta a convertir y el archivo de salida (variante de etiqueta).
-
Nombre de la etiqueta: el nombre del archivo de la etiqueta puede convertirse a una variante lista para revisión con valores de orígenes de datos bloqueados. El origen de datos define en forma dinámica el nombre de la etiqueta usando una variable existente o recientemente creada.
-
Orígenes de datos al momento de impresión: esta opción le permite definir orígenes de datos para los cuales el valor se proporcionará al momento de la impresión. Si un origen de datos aparece en este campo, su valor no se bloquea y puede proporcionarse al momento de impresión. Algunos ejemplos típicos son orígenes de datos para valores de producción, como número de lote, fecha de vencimiento, etc.
Sugerencia
Inserte solo nombres de orígenes de datos sin corchetes, separados por comas o enumerados en una columna usando la tecla Enter.
-
Nombre de archivo de salida: el nombre del archivo de variante de etiqueta que estará listo para revisión. El origen de datos define en forma dinámica el nombre de la etiqueta usando una variable existente o recientemente creada.
Hay distintas reglas que se aplican a la variante de etiqueta lista para revisión:
-
Los valores de orígenes de datos están bloqueados de manera predeterminada. Para que los orígenes de datos no estén bloqueados, inclúyalos en el campo Orígenes de datos al momento de impresión para que se mantengan activos en la etiqueta lista para revisión. Puede definir su valor al momento de impresión.
-
Las variables del contador, funciones, campos de base de datos y variables globales se convierten a variables no solicitadas.
-
Los gráficos están insertados.
-
La variante de etiqueta de destino almacenada en el NiceLabel Almacenamiento de documentos del Centro de control se protege automáticamente. El Nombre de etiqueta y los Orígenes de datos al momento de impresión originales se usan como comentario de protección.
-
Las variantes de etiquetas pueden abrirse en NiceLabel 10 Designer en estado bloqueado.
-
Los archivos de etiquetas generados con esta acción no pueden importarse.
-
Si dichas variantes de etiquetas se almacenan en la memoria de la impresora, el comando de recuperación solo puede proporcionar valores para los orígenes de datos al momento de impresión.
-
Si se usa el NiceLabel Centro de control, la vista previa de la etiqueta en Almacenamiento de documentos permite editar los orígenes de datos al momento de impresión.
-
Las variables de hora y fecha actuales no pueden configurarse como orígenes de datos al momento de impresión en la variante de etiqueta lista para revisión.
Ciertos objetos aceptan varios valores como contenido. Dicho contenido puede ser una combinación de valores fijos, variables y caracteres especiales (códigos de control). Los objetos que aceptan valores combinados se identifican con un pequeño botón de flecha derecha en el lado derecho del objeto. Haga clic en el botón de la flecha para ingresar una variable o un carácter especial.
-
Uso de valores fijos. Ingrese un valor fijo para la variable.
-
Uso de valores fijos y datos de variables. Los valores combinados pueden tener valores fijos y variables. Los nombres de las variables deben estar encerrados entre corchetes
[]. Ingrese las variables en forma manual o insértelas haciendo clic en el botón de la flecha de la derecha. Durante el procesamiento, los valores de las variables se combinan con los datos fijos y se utilizan como el contenido del objeto.En el ejemplo de abajo, el contenido se combina a partir de tres elementos de datos fijos y variables.
-
Uso de caracteres especiales. Los caracteres especiales admiten valores combinados. Puede ingresar los caracteres especiales en forma manual o insertarlos usando la lista desplegable. En este caso, el valor de la
variable1se combina con datos fijos y caracteres binarios del avance de página. La lista de caracteres especiales disponibles se encuentra aquí.
Este tema describe los pasos de las mejores prácticas para utilizar recursos de red compartidos.
El componente de ejecución de Desktop Designer se ejecuta en el modo de servicio según los privilegios de acceso de herencia especificados para la cuenta de usuario.
Para poder abrir los archivos de etiqueta y utilizar controladores de impresoras en Desktop Designer, la cuenta de usuario asociada debe contar con suficientes privilegios.
Al ingresar al archivo en una unidad de red, utilice la sintaxis UNC y no las letras de la unidad mapeada. UNC es una convención de nomenclatura para especificar y mapear unidades de red. Desktop Designer intentará reemplazar la sintaxis de letras de la unidad con la sintaxis UNC automáticamente.
Ejemplo 137. Ejemplo
Si el archivo está disponible como G:\Etiquetas\etiqueta.nlbl, consulte la notación UNC \\servidor\recursos compartidos\Etiquetas\etiqueta.nlbl (donde la unidad G: está asignada a \\servidor\recursos compartidos).
Al abrir un archivo en Almacenamiento de documentos dentro del Centro de control, utilice la notación HTTP como http://nombredeservidor:8080/etiqueta.lbl, o la notación WebDAV \\nombredeservidor@8080\DavWWWRaíz\etiqueta.lbl.
Nota
Primero debe agregar y configurar los usuarios que trabajan con archivos almacenados en el Almacenamiento de documentos en su Centro de control. Lea más sobre la gestión de usuarios en la Guía del usuario del Centro de control.
Para imprimir etiquetas utilizando una impresora de red compartida, haga que el controlador de la impresora esté disponible en el servidor en el que Desktop Designer está instalado.
Asegúrese de que la cuenta de usuario para la que se ejecuta Desktop Designer tenga acceso al controlador de la impresora. Si la impresora de red está recién instalada en la máquina, es posible que Desktop Designer no la vea hasta que se reinicie el Servicio.
Sugerencia
Para permitir la notificación automática de los nuevos controladores de la impresora de red, debe habilitar la regla de entrada correspondiente en el firewall de Windows. Para obtener más información, consulte Artículo de base de conocimiento KB 265.
Si Desktop Designer intenta cargar un archivo de etiquetas o imágenes, y este archivo no se encuentra de inmediato, no cancela el procesamiento ni tampoco informa un error. Intenta ubicar el archivo solicitado en ubicaciones alternativas.
Desktop Designer realiza verificaciones de la ubicación del archivo en el siguiente orden:
-
Verifica si el archivo existe en la ubicación definida en la acción.
-
Verifica si el archivo existe en la misma carpeta que el archivo de la etiqueta o la solución.
-
Verifica si el archivo existe en la carpeta
.\Etiquetas(para archivos de gráficos, verifica la carpeta.\Gráficos). -
Verifica si el archivo existe en la carpeta
..\Etiquetas(para archivos de gráficos, verifica la carpeta..\Gráficos). -
Verifica si el archivo existe en la carpeta global Etiquetas (carpeta Gráficos para archivos de gráficos).
Si el archivo no se encuentra en ninguna de las ubicaciones indicadas arriba, la acción falla. Se eleva un error.
|
ID de estado del administrador de trabajos de impresión (en hexa) |
Descripción del estado del administrador de trabajos de impresión |
|
0 |
Sin estado. |
|
1 |
La impresora está en pausa. |
|
2 |
La impresora está imprimiendo. |
|
4 |
Ocurrió un error con la impresora. |
|
8 |
La impresora no está disponible. |
|
10 |
La impresora no tiene papel. |
|
20 |
Se necesita alimentación manual. |
|
40 |
La impresora tiene un problema con el papel. |
|
80 |
La impresora está desconectada. |
|
100 |
Estado de entrada/salida activo. |
|
200 |
La impresora está ocupada. |
|
400 |
Atasco de papel. |
|
800 |
La bandeja de salida está llena. |
|
2000 |
La impresora está esperando. |
|
4000 |
La impresora está procesando. |
|
10000 |
La impresora se está preparando. |
|
20000 |
El nivel de tóner/tinta es bajo. |
|
40000 |
No hay tóner en la impresora. |
|
80000 |
La página actual no se puede imprimir. |
|
100000 |
Se necesita la intervención del usuario. |
|
200000 |
La impresora no tiene memoria. |
|
400000 |
La puerta está abierta. |
|
800000 |
Error desconocido. |
|
1000000 |
La impresora está en modo de ahorro de energía. |