I comandi NiceLabel sono usati nei file di comando per controllare la stampa di etichette. NiceLabel Automation esegue i comandi all'interno dei file di comando nell’ordine dall'alto in basso. Per ulteriori dettagli, vedere la sezione Specifiche dei file di comando.
È possibile usare comandi personalizzati specifici se essi sono disponibili nel prodotto NiceLabel Automation sotto forma di azione.
Specifica dei comandi NiceLabel
COMMENT
;
Quando 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 il punto e virgola (;) all'inizio della riga. Tutto ciò che segue il punto e virgola vien trattato come un 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. Usare il file di testo 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.
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.
EXPORTLABEL
EXPORTLABEL ExportFileName [, ExportVariant]
Questo comando automatizza 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 richiama l'etichetta con la tastiera della stampante o inviando un file di comando alla stampante. La stessa funzionalità è disponibile anche con l'azione Memorizza etichetta sulla stampante.
Nota
Per specificare l'etichetta da esportare, usare prima il comando LABEL.
-
ExportFileName: questo parametro obbligatorio definisce il nome del file di comandi generati dalla stampante.
-
ExportVariant: Alcune stampanti supportano più varianti di esportazione. Durante l'esportazione manuale, l'utente può selezionare la variante di esportazione nella finestra di dialogo. Con il comando EXPORTLABEL è necessario specificare quale variante di esportazione usare. Le varianti sono visibili nel progettista di etichette dopo aver attivato la modalità di stampa Memorizza/richiama.
La prima variante nell'elenco ha valore 0. La seconda variante ha valore 1, ecc.
Se non si specifica nessun tipo di variante, per impostazione predefinita viene usato il valore 0.
Per ulteriori informazioni sulla stampa offline, vedere la sezione Uso della modalità di stampa Memorizza/richiama.
IGNOREERROR
IGNOREERROR <on> [,<off>]
Questo comando specifica che l'errore che si verifica nel file JOB non interrompe il processo di stampa qualora si verifichino i seguenti errori:
-
Viene usato un nome di variabile errato.
-
Alla variabile viene inviato un valore errato.
-
L'etichetta non esiste/non è accessibile.
-
La stampante non esiste/non è accessibile.
LABEL
LABEL <label name> [,<printer_name>]
Questo comando apre l'etichetta da stampare. Se l'etichetta è già caricata, essa non viene 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 la sezione Accesso alle risorse di rete condivise.
Il valore printer_name opzionale specifica la stampante per la quale viene 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>]
Questo comando registra il valore message personalizzato nel registro di trigger. Se il messaggio contiene caratteri spazio o virgole, 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 la sezione Accesso alle risorse di rete condivise.
Il parametro APPEND è opzionale. Per impostazione predefinita, il file viene sovrascritto. Usare questo parametro per aggiungere dati al file esistente.
Dopo aver usato il 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 <quantity> [,<skip> [,<identical label copies> [,number of label sets]]]
Questo comando avvia il processo di stampa.
-
Quantity: specifica il numero di etichette stampate.
-
<number>: viene stampato il numero di etichette specificato.
-
VARIABLE: specifica che una variabile di etichetta è definita come quantità variabile e che contiene il numero di etichette da stampare. L'etichetta determina quante etichette vengono stampate.
-
UNLIMITED: se si usa un database per acquisire valori per gli oggetti, con la stampa illimitata vengono stampate tutte le etichette presenti nei record del database. Se non si usa un database, viene stampato il numero massimo di etichette supportate internamente dalla stampante termica.
-
-
Skip: Specifica il numero di etichette da ignorare nella prima pagina. Il parametro è usato per stampare etichette su fogli di carta. Se la parte della pagina è già stata usata, riutilizzare lo stesso foglio spostando la posizione iniziale della prima etichetta.
-
C opie di etichette identiche: Specifica quante copie della stessa etichetta devono essere stampate.
-
Numero di set di etichette. Specifica il numero di volte che l'intero processo di stampa deve essere ripetuto.
Nota
Assicurarsi che i valori di quantità siano specificati come valore numerico, non valore di stringa. Non mettere il valore tra virgolette.
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 corrispondono 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 con la sintassi \\server\share.
PRINTJOBNAME
PRINTJOBNAME
Questo comando specifica il nome del processo di stampa visualizzato nello spooler Windows. Se il nome contiene caratteri spazio o virgole, racchiudere il valore tra virgolette (").
SESSIONEND
SESSIONEND
Questo comando chiude il flusso di stampa. Vedere anche SESSIONSTART.
Nota
SESSIONEND va inviato come unica voce nell'azione Invia comandi personalizzati. Se si desidera inviare comandi aggiuntivi, usare azioni Invia comandi personalizzati separate.
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 PRINT. Vedere anche il comando SESSIONSTART.
-
Quantity: specifica il numero di etichette da stampare.
-
Skip: Specifica il numero di etichette da ignorare nella prima pagina. Il parametro è usato per stampare etichette su fogli di carta. Se la parte della pagina è già stata usata, è possibile rifiutare lo stesso foglio spostando la posizione iniziale della prima etichetta.
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, i dati relativi a ciascuna etichetta vengono inviati alla stampante in un processo di stampa separato. Se si desidera unire i dati dell'etichetta per più etichette nel flusso, usare i comandi di stampa della sessione. A tal fine, iniziare con il comando SESSIONSTART, seguito da qualsiasi numero di comandi SESSIONPRINT. La sequenza finisce con il comando SESSIONEND.
Usare questi comandi per ottimizzare il processo di stampa di etichette. La stampa di etichette appartenenti a un singolo processo di stampa è molto più veloce della stampa di etichette con più processi di stampa.
Usare le regole seguenti per assicurarsi che la stampa della sessione non si interrompa:
-
Non è possibile cambiare l'etichetta all'interno di una sessione.
-
Non è possibile cambiare la stampante all'interno di una sessione.
-
È necessario impostare i valori per tutte le variabili dall'etichetta all'interno di una sessione, anche se alcune hanno dei valori vuoti.
SET
SET <name>=<value> [,<step> [,<number or repetitions>]]
Questo comando assegna alla variabile name il valore value. 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 il valore dell'incremento del contatore e il numero di etichette stampate prima che il contatore cambi valore.
Se il valore contiene caratteri spazio o virgola, mettere il testo tra virgolette ("). Vedere anche TEXTQUALIFIER.
Se si desidera assegnare un valore multilinea, usare \r\n per codificare un 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.
Esempio 94. Esempio
Se si assegna un valore "c:\My Pictures\raw.jpg" alla variabile, "\r" viene sostituito con il carattere di ritorno a capo.
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:
-
PAPERBIN: Specifica il vassoio che contiene il supporto dell'etichetta. Se la stampante dispone di più di un vassoio di carta/etichette, è possibile controllare quale viene usato per la stampa. Il nome del vassoio va acquisito dal driver della stampante.
-
PRINTSPEED: Specifica la velocità di stampa. I valori accettabili variano da una stampante all'altra. Per informazioni sugli intervalli di valori esatti, consultare i manuali della stampante.
-
PRINTDARKNESS: Specifica la scurezza o il contrasto della stampa. I valori accettabili variano da una stampante all'altra. Per informazioni sugli intervalli di valori esatti, consultare i manuali della stampante.
-
PRINTOFFSETX: Specifica l'offset sinistro per tutti gli oggetti di stampa. Il valore per il parametro deve essere numerico, positivo o negativo, in punti.
-
PRINTOFFSETY: Specifica l'offset superiore per tutti gli oggetti di stampa. Il valore per il parametro deve essere numerico, positivo o negativo, in punti.
-
PRINTERSETTINGS: Specifica le impostazioni personalizzate della stampante da applicare al processo di stampa. Il parametro richiede l'intero valore DEVMODE per la stampante di destinazione, fornito in una stringa codificata Base64. Il valore DEVMODE contiene tutti i parametri del driver della stampante (velocità, scurezza, offset e altro). Per ulteriori informazioni, vedere la sezione Impostazioni della stampante e DEVMODE.
Nota
La stringa codificata Base64 deve essere specificata tra virgolette (").
TEXTQUALIFIER
TEXTQUALIFIER <character>
Il qualificatore di testo è il carattere che incorpora il valore dei dati assegnato a una variabile. Ogni volta che un 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.
Esempio
TEXTQUALIFIER %
SET Variable = %EPAK 12"X10 7/32"%