Tipos de archivo de comando

Los comandos NiceLabel se usan en archivos de comandos para controlar la impresión de etiquetas. Desktop Designer ejecuta los comandos dentro de los archivos de comandos de arriba abajo.

COMMENT

;

Si se está desarrollando un archivo de comando, es una buena práctica documentar los comandos. Esto le permitirá 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 trata como comentario y no se procesa.

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. Puede usarlo 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 se incluyó el comando. 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.

DELETEFILE

DELETEFILE <file name>

Elimina el archivo especificado. 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.

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 puede recuperar la etiqueta con el teclado en la impresora o enviar un archivo de comando a la impresora. La misma funcionalidad también está disponible con la acción Almacenar etiqueta en impresora.

Para obtener más información sobre la impresión sin conexión, consulte el tema Usar modo de impresión almacenar/recuperar.

IGNOREERROR

IGNOREERROR <on> [,<off>]

Especifica que los errores en el archivo JOB detallados abajo no finalizan el proceso de impresión:

LABEL

LABEL <label name> [,<printer_name>]

El comando abre una 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 la sección Acceso a recursos de red compartidos en la Guía del usuario NiceLabel Automation.

El parámetro opcional printer_name 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>]

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 la sección Acceso a recursos de red compartidos en la Guía del usuario NiceLabel Automation.

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

PRINT <quantity> [,<skip> [,<identical label copies> [,number of label sets]]]

Este comando comienza el proceso de impresión.

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 \\servidor\compartir.

PRINTJOBNAME

PRINTJOBNAME

Este comando especifica el nombre del trabajo de impresión que aparece en el Administrador de trabajos de impresión de Windows. Si el nombre tiene caracteres de espacio o comas, debe escribir el valor entre comillas dobles (").

SESSIONEND

SESSIONEND

Este comando cierra la secuencia de impresión. Consulte también SESSIONSTART.

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 del NiceLabel comando PRINT. Consulte también SESSIONSTART.

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 IMPRMIR, 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. Debe comenzar con el comando SESSIONSTART, seguido de un número de comandos SESSIONPRINT y, por último, debe usar el comando SESSIONEND.

Use estos comandos para optimizar el proceso de impresión de etiquetas. Es más rápido imprimir etiquetas de un solo trabajo de impresión que imprimir etiquetas de diversos trabajos de impresión.

Debe seguir algunas reglas para que la impresión de la sesión no se interrumpa.

SET

SET <name>=<value> [,<step> [,<number or repetitions>]]

Este comando asigna un valor a la variable de nombre. La variable debe definirse en la etiqueta, o se genera un error. Si la variable no está en la etiqueta, ocurre un error. Paso y número de repeticiones son parámetros para las variables del contador. Estos parámetros especifican el incremento del contador y las etiquetas de números 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.

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:

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.

TEXTQUALIFIER % SET Variable = %EPAK 12"X10 7/32"%

El archivo JOB abre la etiqueta label2.nlbl, configura valores de variable e imprime una única etiqueta. Debido a que no se usa un comando PRINTER para redirigir la impresión, la etiqueta se imprimirá usando el nombre de la impresora definido en la etiqueta.

LABEL "label2.nlbl"
SET code="12345"
SET article="FUSILLI"
SET ean="383860026501"
SET weight="1,0 kg"
PRINT 1

Esta sección define la descripción de la estructura de los archivos de comandos XML. Hay varios elementos que contienen atributos. Algunos atributos son obligatorios, otros son opcionales. Algunos atributos pueden ocupar solamente valores predefinidos. En otros, puede especificar valores personalizados.

Definición de esquema XML (XSD) para archivo de comandos XML

<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://tempuri.org/XMLSchema.xsd" elementFormDefault="qualified" xmlns="http://tempuri.org/XMLSchema.xsd" xmlns:mstns="http://tempuri.org/XMLSchema.xsd" xmlns:xs="http://www.w3.org/2001/X
MLSchema">
 <xs:element name="nice_commands">
  <xs:complexType>
   <xs:sequence>
    <xs:element name="label" maxOccurs="unbounded" minOccurs="1">
     <xs:complexType>
      <xs:sequence>
       <xs:element name="print_job" maxOccurs="unbounded" minOccurs="0">
        <xs:complexType>
         <xs:sequence>
          <xs:element name="database" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="table" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="variable" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
         </xs:sequence>
         <xs:attribute name="quantity" type="xs:string" use="required" />
         <xs:attribute name="printer" type="xs:string" use="optional" />
         <xs:attribute name="skip" type="xs:integer" use="optional" />
         <xs:attribute name="identical_copies" type="xs:integer" use="optional" />
         <xs:attribute name="number_of_sets" type="xs:integer" use="optional" />
         <xs:attribute name="job_name" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file_append" type="xs:boolean" use="optional" />
         <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
        </xs:complexType>
       </xs:element>
       <xs:element name="session_print_job" maxOccurs="unbounded" minOccurs="0">
        <xs:complexType>
         <xs:sequence>
          <xs:element name="database" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="table" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="session" minOccurs="1" maxOccurs="unbounded">
           <xs:complexType>
            <xs:sequence>
             <xs:element name="variable" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
               <xs:simpleContent>
                <xs:extension base="xs:string">
                 <xs:attribute name="name" type="xs:string" use="required" />
                </xs:extension>
               </xs:simpleContent>
              </xs:complexType>
             </xs:element>
            </xs:sequence>
            <xs:attribute name="quantity" type="xs:string" use="required" />
            <xs:attribute name="skip" type="xs:string" use="optional" />
            <xs:attribute name="identical_copies" type="xs:string" use="optional" />
            <xs:attribute name="number_of_sets" type="xs:string" use="optional" />
           </xs:complexType>
          </xs:element>
         </xs:sequence>
         <xs:attribute name="printer" type="xs:string" use="optional" />
         <xs:attribute name="skip" type="xs:integer" use="optional" />
         <xs:attribute name="job_name" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file_append" type="xs:boolean" use="optional" />
         <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
        </xs:complexType>
       </xs:element>
      </xs:sequence>
      <xs:attribute name="name" type="xs:string" use="required" />
      <xs:attribute name="close" type="xs:boolean" use="optional" />
      <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
     </xs:complexType>
    </xs:element>
   </xs:sequence>
   <xs:attribute name="quit" type="xs:boolean" use="required" />
  </xs:complexType>
 </xs:element>
</xs:schema>

El ejemplo a continuación presenta la vista estructural de los elementos y sus atributos como pueden usarse en un archivo de comando XML.

<nice_commands>
 <label name="label1.nlbl">
  <session_print_job printer="CAB A3 203DPI" skip=0 job_name="job name 1" print_to_file="filename 1">
   <session quantity="10" skip="2" identical_copies="1" number_of_sets="4">
    <variable name="variable name 1" >variable value 1</variable>
   </session>
  </session_print_job>
  <print_job printer="Zebra R-402" quantity="10" skip=0 identical_copies=1 number_of_sets=1 job_name="job name 2" print_to_file="filename 2">
   <variable name="variable1" >1</variable>
   <variable name="variable2" >2</variable>
   <variable name="variable3" >3</variable>
  </print_job>
 </label>
</nice_commands>

Este ejemplo presenta el almacenamiento de una etiqueta en la impresora.

<nice_commands>
 <label name="label1.nlbl" close="false">
  <store_job store_name="label011" store_variant= "DRAM" printer="Zebra R-402" job_name="recall011">
   <variable name="country" >Slovenia</variable>
   <variable name="packaging_type" >big box</variable>
   <variable name="Warehouse_no" >3</variable>
  </store_job>
 </label>
</nice_commands>

Los comandos de la primera línea de datos deben expresarse con el carácter (@). Los campos sin @ al principio son nombres de variables y se extraerán con su valor como pares nombre-valor.

El siguiente ejemplo presenta una vista estructural de los campos que puede usar en un archivo de comando CSV.

@Label,@Printer,@Quantity,@Skip,@IdenticalCopies,NumberOfSets,@Port,Product_ID, Product_Name
label1.nlbl, CAB A3 203 DPI, 100, , , , , 100A, Product 1
label2.nlbl, Zebra R-402, 20, , , , , 200A, Product 2

*FORMAT,\\127.0.0.1\labelcomputer$\labels\ML2193.lwl
*JOBNAME,PastaPallet002
*QUANTITY,1
*PRINTERNUMBER,1
Text0000,New Data
Text0001,New Data
*PRINTLABEL

Para obtener más detalles sobre los comandos PAS, consulte la Guía del usuario de Loftware LPS.