Los comandos NiceLabel se usan en archivos de comandos para controlar la impresión de etiquetas. NiceLabel Automation ejecuta los comandos dentro de los archivos de comandos en orden descendente. Para obtener más información, consulte el tema Especificaciones de archivos de comandos.
Se puede usar el comando personalizado específico cuando esté disponible en su producto NiceLabel Automation como una acción.
NiceLabel Especificación de comandos
COMMENT
;
Al desarrollar un archivo de comando, es una buena práctica documentar los comandos. De este modo, será más fácil descodificar qué secuencia realmente desempeña cuando observe el código después de un tiempo. Use punto y coma (;) al comienzo de la línea. Todo lo que esté detrás del punto y coma se tratará como comentario y no se procesará.
CLEARVARIABLEVALUES
CLEARVARIABLEVALUES
Este comando restablece el valor predeterminado de los valores de las variables.
CREATEFILE
CREATEFILE <file name> [, <contents>]
Este comando crea un archivo de texto. Use el archivo de texto para indicar a una aplicación de terceros que comenzó o finalizó el proceso de impresión, según la ubicación en la que incluyó el comando. Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte el tema Acceso a recursos de red compartidos.
DELETEFILE
DELETEFILE <file name>
Elimina el archivo especificado. Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte el tema Acceso a recursos de red compartidos.
EXPORTLABEL
EXPORTLABEL ExportFileName [, ExportVariant]
Este comando se implementa para automatizar el comando "Exportar a impresora" que está disponible en el diseñador de etiquetas. La etiqueta se exporta directamente a la impresora y se almacena en la memoria para la impresión sin conexión. El usuario recupera la etiqueta con el teclado en la impresora o enviando un archivo de comando a la impresora. La misma funcionalidad también está disponible con la acción Almacenar etiqueta en impresora.
Nota
Para especificar qué etiqueta se exportará, use primero el comando LABEL.
-
ExportFileName: Este parámetro es obligatorio y define el nombre de archivo de comandos de impresora generados.
-
ExportVariant: Algunas impresoras admiten múltiples variantes de exportación. Al exportar en forma manual, el usuario puede seleccionar la variante de exportación en el cuadro de diálogo. Con el comando EXPORTLABEL, debe especificar qué variante de exportación quiere usar. Las variantes se ven en el diseñador de etiquetas una vez que habilita el modo de impresión Almacenar/Recuperar.
La primera variante de la lista tiene el valor 0. La segunda variante tiene el valor 1, etc.
Si no especifica algún tipo de variante, se usa en forma predeterminada el valor 0.
Para obtener más información sobre impresión en conexión, consulte la sección Usar modo de impresión almacenar/recuperar.
IGNOREERROR
IGNOREERROR <on> [,<off>]
Este comando especifica que el error que aparece en el archivo JOB no finalizará el proceso de impresión si se generan los siguientes errores:
-
Uso de nombre de variable incorrecto.
-
Valor incorrecto enviado a la variable.
-
No existe / no está accesible la etiqueta.
-
No existe / no está accesible la impresora.
LABEL
LABEL <label name> [,<printer_name>]
El comando abre la etiqueta para imprimir. Si la etiqueta ya está cargada, no se volverá a abrir. Puede incluir el nombre de la ruta de acceso. Escriba el nombre de la etiqueta entre comillas dobles si el nombre o la ruta de acceso tiene espacios. Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte el tema Acceso a recursos de red compartidos.
El printer_name opcional especifica la impresora, para la cual se abrirá la etiqueta. Use esta configuración si quiere anular el nombre de la impresora que se guardó en la plantilla de la etiqueta. Si el controlador para el nombre de la impresora provisto no está instalado o disponible, el comando arroja un error.
MESSAGEBOX
MESSAGEBOX <message> [,<caption>]
Este comando registra el mensaje personalizado en el registro de desencadenadores. Si el mensaje tiene caracteres de espacio o comas, debe escribir el texto entre comillas dobles (").
PORT
PORT <file name> [, APPEND]
Este comando anula el puerto definido en el controlador de la impresora y redirige la impresión a un archivo. Si la ruta de acceso o el nombre de archivo tiene espacios, encierre el valor entre comillas dobles ("). Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte el tema Acceso a recursos de red compartidos.
El parámetro APPEND es opcional. El archivo se sobrescribe en forma predeterminada. Use este parámetro para anexar datos en el archivo existente.
Una vez que usa un comando PORT en el archivo JOB, seguirá siendo válido hasta el siguiente comando PORT, o hasta el final del archivo (lo que ocurra primero). Si usa el comando PRINTER después de ejecutar el comando PORT, la configuración PORT sobrescribe el puerto definido para la impresora seleccionada. Si quiere usar el puerto real definido para la impresora seleccionada, debe usar otro comando PORT con un valor vacío, como PORT = "".
PRINT <quantity> [,<skip> [,<identical label copies> [,number of label sets]]]
Este comando comienza el proceso de impresión.
-
Quantity: especifica la cantidad de etiquetas impresas.
-
<number>: El número específico de etiquetas que se imprimen.
-
VARIABLE: Especifica que alguna variable de la etiqueta está definida como cantidad variable y que contiene la cantidad de etiquetas a imprimir. La etiqueta determinará cuántas etiquetas se imprimirán.
-
UNLIMITED: Si usa una base de datos para adquirir valores de objetos, la impresión ilimitada imprimirá tantas etiquetas como registros haya en la base de datos. Si no usa una base de datos, se imprimirá el número máximo de etiquetas que la impresora térmica admita internamente.
-
-
Skip: Especifica el número de etiquetas que quiere omitir en la primera página. El parámetro se usa para imprimir etiquetas en hojas de papel. Si ya usó parte de la página, puede reutilizar la misma hoja cambiando la ubicación de inicio de la primera etiqueta.
-
Copias de etiquetas idénticas: Especifica cuántas copias de la misma etiqueta se deben imprimir.
-
Número de juegos de etiquetas. Especifica el número de veces que debe repetirse el proceso de impresión completo.
Nota
Asegúrese de que los valores de cantidad se provean como valor numérico, no como valor de cadena. No escriba el valor entre comillas dobles.
PRINTER
PRINTER <printer name>
Este comando anula la impresora definida en el archivo de etiqueta. Si el nombre de la impresora tiene caracteres de espacio o comas, escríbalo entre comillas dobles (").
Use el nombre de la impresora como se muestra en la línea de estado en la aplicación de diseño de etiquetas. Los nombres de las impresoras generalmente son los mismos que los de Impresoras y Faxes del Panel de control, pero no siempre. Si usa impresoras de redes, es posible que vea el nombre mostrado con la sintaxis \\server\share.
PRINTJOBNAME
PRINTJOBNAME
Este comando especifica el nombre del trabajo de impresión como se muestra en el Administrador de trabajos de impresión de Windows. Si el nombre tiene caracteres de espacio o comas, debe escribir el texto entre comillas dobles (").
SESSIONEND
SESSIONEND
Este comando cierra la secuencia de impresión. Consulte también SESSIONSTART.
Nota
SESSIONEND debe enviarse como el único elemento en la acción Enviar comandos personalizados. Si desea enviar comandos adicionales, utilice acciones Enviar comandos personalizados separadas.
SESSIONPRINT
SESSIONPRINT <quantity> [,<skip>]
Este comando imprime la etiqueta de referencia actual y la agrega a la secuencia de impresión de la sesión abierta actualmente. Puede usar múltiples comandos de SESSIONPRINT uno después del otro y unir las etiquetas de referencia en una sola secuencia de impresión. La secuencia no se cierra si no se usa el comando SESSIONEND. La función de los parámetros de cantidad y omitir es la misma que la de PRINT de NiceCommand. Consulte también el comando SESSIONSTART.
-
Quantity: Especifica el número de etiquetas para imprimir.
-
Skip: Especifica el número de etiquetas que quiere omitir en la primera página. El parámetro se usa para imprimir etiquetas en hojas de papel. Si ya usó parte de la página, puede reutilizar la misma hoja cambiando la ubicación de inicio de la primera etiqueta.
SESSIONSTART
SESSIONSTART
Este comando empieza el tipo de sesión de la impresión.
Los tres comandos relacionados con la sesión de impresión ( SESSIONSTART, SESSIONPRINT, SESSIONEND) se usan juntos. Cuando usa el comando PRINT, cada dato de la etiqueta se envía a la impresora en un trabajo de impresión separado. Si quiere unir datos de etiquetas para múltiples etiquetas de la secuencia de impresión, debe usar los comandos de impresión de la sesión. Para ello, comience con el comando SESSIONSTART, seguido de cualquier número de comandos SESSIONPRINT. La secuencia finaliza con el comando SESSIONEND.
Use estos comandos para optimizar el proceso de impresión de etiquetas. La impresión de etiquetas que pertenecen a un único trabajo de impresión es mucho más rápida que la impresión de etiquetas utilizando múltiples trabajos de impresión.
Use las reglas a continuación para asegurarse de que la impresión de sesiones no se interrumpa:
-
No puede cambiar la etiqueta dentro de una sesión.
-
No puede cambiar la impresora dentro de una sesión.
-
Debe establecer valores para todas las variables de la etiqueta dentro de una sesión, incluso si algunas variables tienen valores vacíos.
SET
SET <name>=<value> [,<step> [,<number or repetitions>]]
Este comando le asigna al name de la variable un value. La variable debe definirse en la etiqueta, o se genera un error. Si la variable no está en la etiqueta, ocurre un error. Step y number of repetitions son parámetros para las variables del contador. Estos parámetros especifican el valor del incremento del contador y el número de etiquetas impresas antes de que cambie el valor del contador.
Si el valor tiene caracteres de espacio o comas, debe escribir el texto entre comillas dobles ("). Consulte también TEXTQUALIFIER.
Si quiere asignar un valor de múltiples líneas, use \r\n para codificar un carácter de línea nueva. \r se reemplaza con CR (Retorno de carro) y \n se reemplaza con LF (Avance de línea).
Tenga cuidado al establecer valores para variables que brindan datos para las imágenes de la etiqueta, ya que los caracteres de barra invertida pueden reemplazarse con otros caracteres.
Ejemplo 94. Ejemplo
Si asigna el valor "c:\My Pictures\raw.jpg" a la variable, "\r" se reemplazará con el carácter CR.
SETPRINTPARAM
SETPRINTPARAM <paramname> = <value>
Este comando le permite ajustar la configuración de la impresora antes de imprimir. Los parámetros admitidos para la configuración de la impresora ( paramname) son:
-
PAPERBIN: Especifica la bandeja que tiene los medios de las etiquetas. Si la impresora está equipada con más de una bandeja de papel / etiquetas, puede controlar cuál se usa para la impresión. El nombre de la bandeja debe obtenerse del controlador de la impresora.
-
PRINTSPEED: Especifica la velocidad de impresión. Los valores aceptables varían según la impresora. Consulte los manuales de las impresoras para saber el rango exacto de valores.
-
PRINTDARKNESS: Especifica la oscuridad / contraste de impresión. Los valores aceptables varían según la impresora. Consulte los manuales de las impresoras para saber el rango exacto de valores.
-
PRINTOFFSETX: Especifica el desplazamiento izquierdo para todos los objetos de impresión. El valor para este parámetro debe ser numérico, positivo o negativo, con punto.
-
PRINTOFFSETY: Especifica el desplazamiento superior para todos los objetos de impresión. El valor para este parámetro debe ser numérico, positivo o negativo, con punto.
-
PRINTERSETTINGS: Especifica la configuración de la impresora personalizada que se aplicará al trabajo de impresión. El parámetro requiere toda la estructura DEVMODE para la impresora de destino, provista en una cadena codificada como Base64. La estructura DEVMODE tiene todos los parámetros del controlador de la impresora al mismo tiempo (velocidad, oscuridad, desplazamientos y otros). Para obtener más información, consulte el tema Comprender la configuración de la impresora y DEVMODE.
Nota
La cadena codificada como Base64 debe escribirse entre comillas dobles (").
TEXTQUALIFIER
TEXTQUALIFIER <character>
El calificador de texto es el carácter que incluye el valor de los datos asignados a una variable. Siempre que los datos tengan caracteres de espacio, deben incluirse con calificadores de texto. El calificador de texto es un carácter de comillas dobles ("). Debido a que las comillas dobles se usan como acceso directo para la unidad de medida de pulgadas, algunas veces es difícil pasar los datos con marcas de pulgadas en los archivos JOB. También puede usar dos comillas dobles para codificar un carácter de comillas dobles, o usar TEXTQUALIFIER.
Ejemplo
TEXTQUALIFIER %
SET Variable = %EPAK 12"X10 7/32"%