Tipi di file di comando

I comandi NiceLabel sono usati nei file di comando per controllare la stampa di etichette. Desktop Designer esegue il comando all'interno dei file di comando dall'alto in basso.

COMMENT

;

Se si sviluppa un file di comando è buona norma documentare i comandi. In tal modo, osservando il codice dopo un po' di tempo è possibile decodificare le operazioni effettivamente eseguite dallo script. Usare un punto e virgola (;) all'inizio della riga. Tutto ciò che segue il punto e virgola viene trattato come commento e non viene elaborato.

CLEARVARIABLEVALUES

CLEARVARIABLEVALUES

Questo comando reimposta i valori delle variabili sulle impostazioni predefinite.

CREATEFILE

CREATEFILE <file name> [, <contents>]

Questo comando crea un file di testo. È possibile usarlo per segnalare a un'applicazione di terzi che il processo di stampa è iniziato o finito, a seconda della posizione in cui viene inserito il comando. Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.

DELETEFILE

DELETEFILE <file name>

Elimina il file specificato. Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.

EXPORTLABEL

EXPORTLABEL ExportFileName [, ExportVariant]

Questo comando è implementato per automatizzare il comando "Esporta alla stampante", disponibile nel progettista di etichette. L'etichetta viene esportata direttamente sulla stampante e memorizzata per la stampa offline. L'utente può richiamare l'etichetta con la tastiera sulla stampante o inviare un file di comando alla stampante. La stessa funzionalità è disponibile anche con l'azione Memorizza etichetta sulla stampante.

Per ulteriori informazioni sulla stampa offline, vedere l'argomento Uso della modalità di stampa Memorizza/richiama.

IGNOREERROR

IGNOREERROR <on> [,<off>]

Specifica che i seguenti errori di file JOB non terminano il processo di stampa:

LABEL

LABEL <label name> [,<printer_name>]

Il comando apre un'etichetta da stampare. Se l'etichetta è già caricata, essa non verrà riaperta. È possibile includere il nome del percorso. Se il nome o il percorso contiene spazi, mettere tra virgolette il nome dell'etichetta. Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere l'argomento Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.

Il parametro opzionale printer_name specifica la stampante per la quale verrà aperta l'etichetta. Usare questa impostazione se si desidera escludere il nome della stampante salvato nel modello di etichetta. Se il driver per il nome stampante specificato non è installato o non è disponibile, il comando genera un errore.

MESSAGEBOX

MESSAGEBOX <message> [,<caption>]

Registra il valore message personalizzato nel registro di trigger. Se il messaggio contiene caratteri spazio o virgole, è necessario racchiudere il testo tra virgolette (").

PORT

PORT <file name> [, APPEND]

Questo comando esclude la porta definita nel driver della stampante e reindirizza la stampa su un file. Se il percorso o il nome del file contiene spazi, mettere il valore tra virgolette ("). Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere l'argomento Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.

Il parametro APPEND è opzionale. Per impostazione predefinita, il file viene sovrascritto. Usare questo parametro per aggiungere dati al file esistente.

Dopo aver usato un comando PORT nel file JOB esso sarà valido fino al successivo comando PORT o fino alla fine del file (a seconda dell'evento che si verifica per primo). Se si usa il comando PRINTER dopo che è stato eseguito il comando PORT, l'impostazione PORT sovrascrive la porta definita per la stampante selezionata. Se si desidera usare la porta effettivamente definita per la stampante selezionata, è necessario usare un altro comando PORT con un valore vuoto, come PORT = "".

PRINT

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

Questo comando avvia il processo di stampa.

PRINTER

PRINTER <printer name>

Questo comando esclude la stampante definita nel file di etichetta. Se il nome della stampante contiene caratteri spazio metterlo tra virgolette (").

Usare il nome della stampante visualizzato nella riga di stato nell'applicazione di progettazione dell'etichetta. Di solito i nomi delle stampanti sono identici ai nomi delle stampanti indicati in Stampanti e fax, nel Pannello di controllo, ma non sempre. Se si usano stampanti di rete, i relativi nomi potrebbero essere visualizzati mediante la sintassi \\server\share.

PRINTJOBNAME

PRINTJOBNAME

Questo comando specifica il nome del processo di stampa da visualizzare nello spooler Windows. Se il nome contiene caratteri spazio o virgole è necessario racchiudere il valore tra virgolette (").

SESSIONEND

SESSIONEND

Questo comando chiude il flusso di stampa. Vedere anche SESSIONSTART.

SESSIONPRINT

SESSIONPRINT <quantity> [,<skip>]

Questo comando stampa l'etichetta di riferimento corrente e la aggiunge al flusso sessione-stampa correntemente aperto. È possibile usare più comandi SESSIONPRINT uno dopo l'altro e unire le etichette di riferimento in un unico flusso di stampa. Il flusso non si chiude fino a quando non si usa il comando SESSIONEND. Il significato dei parametri quantity e skip è identico al comando PRINTNiceLabel. Vedere anche SESSIONSTART.

SESSIONSTART

SESSIONSTART

Questo comando avvia il tipo di stampa sessione-stampa.

I tre comandi relativi alla sessione alla stampa (SESSIONSTART, SESSIONPRINT, SESSIONEND) vengono usati insieme. Quando si usa il comando PRINT, tutti i dati relativi all'etichetta saranno inviati alla stampante in un processo di stampa separato. Se si desidera unire i dati dell'etichetta per più etichette nel flusso di stampa, è opportuno usare i comandi di stampa della sessione. È necessario iniziare con il comando SESSIONSTART, seguito da qualsiasi numero di comandi SESSIONPRINT e alla fine dal comando SESSIONEND.

Usare questi comandi per ottimizzare il processo di stampa di etichette. La stampa di etichette provenienti da un processo di stampa è molto più veloce della stampa di etichette da una serie di processi di stampa.

È necessario seguire alcune regole, in modo tale che la stampa della sessione non si interrompa.

SET

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

Questo comando assegna un valore alla variabilename. La variabile deve essere definita sull'etichetta, altrimenti viene generato un errore. Se la variabile non è presente sull'etichetta, si verifica un errore. step e number of repetitions sono parametri che si riferiscono alle variabili del contatore. Questi parametri specificano l'incremento del contatore e le etichette di numeri prima che il contatore cambi valore.

Se il valore contiene caratteri spazio o virgola, è necessario mettere il testo tra virgolette ("). Vedere anche TEXTQUALIFIER.

Se si desidera assegnare un valore multilinea, usare \r\n per codificare il carattere di a capo. \r viene sostituito con CR (ritorno a capo) e \n viene sostituito con LF (avanzamento riga).

Fare attenzione quando si impostano valori su variabili che forniscono i dati per le immagini sull'etichetta, in quanto i caratteri barra rovesciata potrebbero essere sostituiti con altri caratteri.

SETPRINTPARAM

SETPRINTPARAM <paramname> = <value>

Questo comando consente di definire le impostazioni della stampante appena prima di stampare. I parametri supportati per le impostazioni della stampante (paramname) sono:

TEXTQUALIFIER

TEXTQUALIFIER <character>

Il qualificatore di testo è il carattere che incorpora il valore dei dati assegnato a una variabile. Ogni volta che il valore dei dati include caratteri spazio deve essere corredato da qualificatori di testo. Il qualificatore di testo predefinito è il carattere delle virgolette ("). Poiché il carattere delle virgolette è usato come abbreviazione di "pollici", talvolta risulta difficile inviare dati contenenti simboli di pollici nei file JOB. Per codificare le virgolette è possibile usare due volte in successione le virgolette, oppure usare TEXTQUALIFIER.

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

Questo file JOB apre l'etichetta label2.nlbl, imposta i valori delle variabili e stampa un'unica etichetta. Poiché per reindirizzare la stampa non viene usato alcun comando PRINTER, l'etichetta verrà stampata usando il nome della stampante, come definito nell'etichetta.

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

Questa sezione definisce la struttura del file di comando XML. Sono presenti diversi elementi contenenti attributi. Alcuni attributi sono obbligatori, mentre altri sono opzionali. Alcuni attributi possono occupare solo valori predefiniti. Per altri è possibile specificare valori personalizzati.

XML Schema Definition (XSD) for XML Command File

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

L'esempio seguente rappresenta la vista strutturale sugli elementi e i loro attributi, utilizzabili n un file di 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>

Questo esempio presenta la memorizzazione di un'etichetta nella stampante.

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

I comandi nella prima riga di dati devono essere espressi con un carattere (@). I campi senza @ all'inizio sono nomi di variabili e saranno estratti insieme ai loro valori come coppie name-value.

L'esempio seguente illustra una panoramica strutturale sui campi utilizzabili in un file di 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

È possibile trovare maggiori dettagli sui comandi PAS nella Guida dell'utente di Loftware LPS.