Abrir etiqueta

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, NiceLabel 10 carga la etiqueta label.nlbl desde la carpeta C:\ProjectA\Labels.

C:\ProjectA\Labels\label.nlbl
UUID-85982b89-4df6-ce75-0252-37f1933af2f2.png

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 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.

Imprimir etiqueta

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, NiceLabel 10 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 en Ejecució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.

  1. 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 31. 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).


  2. 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 32. 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.


  • Metadatos: con cada trabajo de impresión se registran los comentarios de impresión en el Centro de control. Puede ver sus metadatos en Historial > Impresión > columna de Metadatos de impresión. Puede utilizar los metadatos para clasificar, filtrar y ejecutar otras funciones en el Centro de control. Los metadatos no afectan la impresión o las secuencias de impresión. Utilice los metadatos para registrar la información adicional sobre sus trabajos de impresión en el Centro de Control. Los metadatos pueden incluir el número LOT u otras variables de etiquetas, los nombres de las impresoras y valores generados por el usuario o el sistema.

Sugerencia

Los valores del grupo Avanzado pueden ser preprogramados o proporcionarse en forma dinámica por una variable existente o recientemente creada.

Ejecutar archivo de comando XML de Oracle

Enterprise.png

Esta acción ejecuta la impresión con datos de archivos con formato XML de Oracle.

NiceLabel Automation admite internamente archivos XML con la estructura "XML de Oracle", que están definidos por el software Oracle Warehouse Management.

Use esta acción como acceso directo. Ayuda a ejecutar los archivos XML de Oracle sin necesidad de analizarlos con el filtro XML y asignar valores a las variables.

Para poder usar esta acción, el archivo XML debe cumplir con las especificaciones de XML de Oracle. Para obtener más información, consulte la sección Especificaciones XML de Oracle en la guía de usuario NiceLabel Automation.

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 Archivo define el comando XML de Oracle que se usará.

  • Nombre de archivo: archivo de comandos XML de Oracle seleccionado. Pueden ser preprogramados o proporcionarse en forma dinámica usando una variable existente o recientemente creada.

Ejecutar todo archivo de comando XML de SAP

Esta acción ejecuta la impresión con datos de archivos con formato Todo XML de SAP.

NiceLabel Automation admite internamente archivos XML con la estructura "Todo XML de SAP", que están definidos por el software SAP.

Use esta acción como acceso directo. Esta acción permite ejecutar los archivos Todo XML de SAP directamente sin la necesidad de analizarlos con el filtro XML y asignar valores a las variables. Para poder usar esta acción, el archivo XML debe cumplir con las especificaciones de Todo XML de SAP. Para obtener más información, consulte la sección Especificaciones de Todo XML de SAP en la guía de usuario NiceLabel Automation.

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 Archivo define el comando Todo XML de SAP que se usará.

  • Nombre de archivo: archivo de comandos Todo XML de SAP seleccionado. Pueden ser preprogramados o proporcionarse en forma dinámica usando una variable existente o recientemente creada.

El grupo Parámetros opcionales permite definir el nombre de la etiqueta en caso de que no esté incluida en el archivo XML.

  • Nombre de la etiqueta: el archivo de etiqueta seleccionado que debe usarse en el archivo de comandos. Pueden ser preprogramados o proporcionarse en forma dinámica usando una variable existente o recientemente creada.

Ejecutar archivo de comando

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 archivopuede 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.

Enviar comandos personalizados

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.