Les commandes NiceLabel sont utilisées dans les fichiers de commande pour contrôler l'impression des étiquettes. NiceLabel Automation exécute les commandes du fichier de commande, de haut en bas. Pour plus d'informations, voir l'article Spécifications des Fichiers de Commande.
Vous pouvez utiliser la commande personnalisée spécifique, quand elle est disponible en tant qu'actions dans votre produit NiceLabel Automation.
Caractéristiques des commandes de NiceLabel
COMMENTAIRE
;
Il est conseillé de documenter vos commandes durant le développement du fichier de commande. Cela permettra de décoder ce que le script fait vraiment en jetant un œil dessus de temps en temps. Mettre un point-virgule (;
) au début de la ligne. Tout ce qui suit le point-virgule sera considéré comme un commentaire et ne sera pas traité.
CLEARVARIABLEVALUES
CLEARVARIABLEVALUES
Cette commande réinitialise les valeurs des variables à leur valeur par défaut.
CREATEFILE
CREATEFILE <nom de fichier> [, <contents>]
Cette commande va créer un fichier texte. L'utiliser pour signaler à une application tierce que le processus d'impression a commencé ou s'est terminé, selon l'endroit où est placée la commande. Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées.
DELETEFILE
DELETEFILE <nom de fichier>
Efface le fichier spécifié. Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées.
EXPORTLABEL
EXPORTLABEL ExportFileName [, ExportVariant]
La commande permet d'automatiser la commande « Exporter vers l'imprimante » qui se trouve dans l'éditeur d'étiquettes. L'étiquette est exportée directement vers l'imprimante et stockée dans sa mémoire pour une impression hors ligne. L'utilisateur peut rappeler l'étiquette par le clavier de l'imprimante ou en envoyant une commande à l'imprimante. La même fonction est disponible dans l'action Enregistrer l'étiquette dans l'imprimante.
Note
Pour spécifier l'étiquette à exporter, commencer par utiliser la commande LABEL.
-
ExportFileName : Ce paramètre est obligatoire. Il définit le nom du fichier d'exportation. Le contenu du fichier est en langage imprimante.
-
ExportVariant : Certaines imprimantes supportent plusieurs variantes d'exportation. Durant l'exportation manuelle, l'utilisateur peut choisir la variante d'exportation dans l'interface. Avec la commande EXPORTLABEL, il faut spécifier la variante d'exportation à utiliser. Les variantes se voient dans l'éditeur d'étiquettes, quand le mode d'impression Stocker/Rappeler est activé.
La première variante de la liste a la valeur 0. La seconde variante a la valeur 1, etc.
S'il n'y a aucune précision sur le type de variante à utiliser, la valeur 0 est prise par défaut.
Pour plus d'informations sur l'impression hors ligne, voir l'article Utiliser le mode d'impression Stocker/Rappeler.
IGNOREERROR
IGNOREERROR <on> [,<off>]
Cette commande spécifie que l'erreur survenant dans le fichier JOB ne stoppera pas le processus d'impression, si l'une des erreurs suivantes se produit :
-
Un nom de variable incorrect est utilisé.
-
Une valeur incorrecte est envoyée à la variable.
-
L'étiquette n'existe pas/n'est pas accessible.
-
L'imprimante n'existe pas/n'est pas accessible.
LABEL
LABEL <label name> [,<printer_name>]
La commande ouvre l'étiquette à imprimer. Si l'étiquette est déjà chargée, elle ne se rouvrira pas. Mettre éventuellement le nom du chemin. Mettre le nom de l'étiquette entre guillemets, si le nom ou le chemin contiennent des espaces. Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées.
L'option printer_name
spécifie l'imprimante pour laquelle l'étiquette sera ouverte. Utiliser ce paramètre pour remplacer l'imprimante qui est enregistrée dans le masque de l'étiquette. Si le pilote de cette imprimante n'est pas installé ou pas disponible, la commande signalera une erreur.
MESSAGEBOX
MESSAGEBOX <message> [,<caption>]
Cette commande enregistre le message
personnalisé dans le journal du déclencheur. Si le message contient des caractères d'espacement ou des virgules, il faut placer le texte entre guillemets ("
).
PORT
PORT <file name> [, APPEND]
Cette commande remplace le port défini dans le pilote d'imprimante et redirige l'impression vers un fichier. Si le nom de chemin ou de fichier contient des espaces, mettre la valeur entre guillemets ("
). Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées.
Le paramètre APPEND
est facultatif. Par défaut, le fichier est écrasé. Utiliser ce paramètre pour joindre des données à un fichier existant.
À chaque utilisation d'une commande PORT dans le fichier JOB, elle reste valable jusqu'à la commande PORT suivante, ou jusqu'à la fin du fichier (ce qui arrive en premier). Si une commande PRINTER suit l'exécution de la commande PORT, le paramètre PORT va écraser le port défini pour l'imprimante sélectionnée. Pour utiliser le port défini pour l'imprimante sélectionnée, il faut utiliser une autre commande PORT avec une valeur vide, telle que PORT = ""
.
PRINT <quantité> [,<skip> [,<identical label copies> [,number of label sets]]] - Imprimer, quantité, saut, copies identiques, nombre de lots d'étiquettes
Cette commande lance le processus d'impression.
-
Quantité : Spécifie le nombre d'étiquettes imprimées.
-
<number> : Le nombre d'étiquettes spécifié est imprimé.
-
VARIABLE : Spécifie qu'une variable d'étiquette est définie comme quantité variable et contient le nombre d'étiquettes à imprimer. L'étiquette détermine le nombre d'étiquettes à imprimer.
-
IILIMITÉ : Avec une base de données comportant les valeurs des objets, l'impression illimitée imprimera autant d'étiquettes qu'il y a d'enregistrements dans la base de données. Sans base de données, le nombre maximal d'étiquettes supporté par l'imprimante thermique sera imprimé.
-
-
Sauter : Spécifie le nombre d'étiquettes à sauter sur la première page. Ce paramètre est utilisé pour l'impression d'étiquettes sur des feuilles de papier. Quand une partie de la page a déjà été utilisée, réutiliser la même feuille en déplaçant le point de départ de la première étiquette.
-
Le paramètre « identical label copies » (copies d'étiquettes identiques) : Spécifie le nombre de copies de la même étiquette à imprimer.
-
Nombre de jeux d'étiquettes. Spécifie combien de fois le processus d'impression complet doit être répété.
Note
Il faut que les valeurs de quantité soient saisies en valeurs numériques, et pas en chaînes de caractères. Ne pas placer les valeurs entre guillemets.
PRINTER
PRINTER <nom d'imprimante>
Cette commande remplace l'imprimante définie dans le fichier d'étiquette. Si le nom d'imprimante contient des caractères espace, il faut le mettre entre guillemets("
).
Utiliser le nom d'imprimante tel qu'il est affiché dans l'éditeur d'étiquettes. Les imprimantes ont généralement les mêmes noms que celles du panneau de configuration Imprimantes et Fax, mais pas toujours. Avec des imprimantes réseau, le nom peut s'afficher avec la syntaxe \\server\share
.
PRINTJOBNAME
PRINTJOBNAME
Cette commande spécifie le nom du travail d'impression visible dans le Spouleur Windows. Si le nom contient des caractères d'espacement ou virgules, il faut les mettre entre guillemets ("
).
SESSIONEND
SESSIONEND
Cette commande ferme le flux d'impression. Voir aussi SESSIONSTART (début de session).
Note
SESSIONEND
doit être le seul élément envoyé dans l'action Envoyer une commande personnalisée. Si vous souhaitez envoyer d'autres commandes, utiliser différentes actions Envoyer une commande personnalisée.
SESSIONPRINT
SESSIONPRINT <quantity> [,<skip>]
Cette commande imprime l'étiquette actuellement référencée et l'ajoute à la session d'impression actuellement ouverte. Il est possible d'utiliser plusieurs commandes SESSIONPRINT l'une après l'autre et de joindre les étiquettes référencées dans un flux d'impression unique. Le flux ne se fermera pas avant la commande SESSIONEND. Les paramètres quantity (quantité) et skip (sauter) ont la même signification que dans la commande PRINT. Voir aussi la commande SESSIONSTART (début de session).
-
Quantité : Spécifie le nombre d'étiquettes à imprimer.
-
Sauter : Spécifie le nombre d'étiquettes à sauter sur la première page. Ce paramètre est utilisé pour l'impression d'étiquettes sur des feuilles de papier. Quand une partie de la page a déjà été utilisée, réutiliser la même feuille en déplaçant le point de départ de la première étiquette.
SESSIONSTART
SESSIONSTART
Cette commande initie le type d'impression session-print.
Les trois commandes d'impression de session (SESSIONSTART, SESSIONPRINT et SESSIONEND) sont utilisées ensemble. Avec la commande PRINT, toutes les données d'étiquettes sont envoyées à l'imprimante dans un travail d'impression différent. Pour joindre les données d'étiquettes dans un flux d'impression, utiliser les commandes d'impression de session. Pour ce faire, commencer avec la commande SESSIONSTART suivie de n'importe quel nombre de commandes SESSIONPRINT. La séquence se termine par la commande SESSIONEND.
Utiliser ces commandes pour optimiser le processus d'impression des étiquettes. L'impression d'étiquettes appartenant à un même travail d'impression est beaucoup plus rapide que d'imprimer des étiquettes appartenant à plusieurs travaux d'impression.
Utiliser les règles ci-dessous pour vous assurer la session d'impression ne soit pas rompue :
-
Ne pas changer d'étiquette pendant une session.
-
Ne pas changer d'imprimante pendant une session.
-
Il faut paramétrer des valeurs pour toutes les variables de l'étiquette durant la session, même si certaines variables ont une valeur vide.
SET
SET <nom>=<valeur> [,<pas> [,<nombre ou répétitions>]]
Cette commande assigne le nom
de variable à la valeur
. La variable doit être définie sur l'étiquette, sinon une erreur sera signalée. Une erreur surviendra si la variable n'est pas sur l'étiquette. L'incrément
et le nombre de répétitions
sont des paramètres pour les variables de comptage. Ces paramètres spécifient l'incrémentation du compteur et le nombre d'étiquettes avant que le compteur change de valeur.
Si la valeur contient des caractères d'espacement ou virgule, les mettre entre guillemets ("
). Voir aussi TEXTQUALIFIER.
Pour assigner une valeur en plusieurs lignes, utiliser \r\n
pour encoder un caractère de retour à la ligne. \r
est remplacé par CR (Retour Chariot) et \n
est remplacé par LF (Nouvelle Ligne).
Attention en paramétrant les valeurs de variables procurant des données pour les images des étiquettes, puisque la barre oblique inversée peut être remplacée par un autre caractère.
Exemple 94. Exemple
Avec la valeur "c:\Mes Images\raw.jpg" pour la variable, le "\r" sera remplacé par le caractère CR.
SETPRINTPARAM
SETPRINTPARAM <nom paramètre> = <valeur>
Cette commande permet d'affiner les paramètres de l'imprimante avant d'imprimer. Les paramètres supportés pour les réglages d'imprimante (paramname
) sont :
-
PAPERBIN : Spécifie le réservoir contenant le support d'étiquette. Si l'imprimante est équipée de plus d'un bac à papier/bac à étiquettes, contrôler celui qui sera utilisé pour l'impression. Le nom du bac à papier doit provenir du pilote d'imprimante.
-
PRINTSPEED : Spécifie la vitesse d'impression. Les valeurs acceptables varient d'une imprimante à l'autre. Consulter le manuel de l'imprimante pour connaître les valeurs exactes.
-
PRINTDARKNESS : Spécifie le contraste de l'impression. Les valeurs acceptables varient d'une imprimante à l'autre. Consulter le manuel de l'imprimante pour connaître les valeurs exactes.
-
PRINTOFFSETX : Spécifie la marge de gauche pour tous les objets imprimables. La valeur du paramètre est numérique, exprimée en pixels. Elle peut être positive ou négative.
-
PRINTOFFSETY : Spécifie la marge supérieure pour tous les objets imprimables. La valeur du paramètre est numérique, exprimée en pixels. Elle peut être positive ou négative.
-
PRINTERSETTINGS : Spécifie les paramètres personnalisés à appliquer au travail d'impression. Le paramètre a besoin du DEVMODE entier de l'imprimante ciblée, il est fourni par une chaîne de caractères codée en Base64. Le DEVMODE contient tous les paramètres du pilote d'imprimante (vitesse, contraste, décalage et autre). Pour plus d'informations, voir l'article Comprendre les paramètres d'imprimante et DEVMODE.
Note
La chaîne de caractères codée en Base64 doit être fournie entre guillemets (").
TEXTQUALIFIER
TEXTQUALIFIER <caractère>
Le délimiteur de texte est le caractère qui entoure la valeur de la donnée qui est assignée à une variable. Si la valeur comprend des caractères d'espacement, ils doivent être inclus dans des délimiteurs de texte. Le délimiteur de texte par défaut sont les guillemets ("
). Comme les guillemets sont utilisés comme raccourci pour les unités de mesure en pouces, il est parfois difficile de passer les données avec le signe pouce dans les fichiers JOB. Il faut alors utiliser des guillemets doubles pour en encoder un ou utiliser TEXTQUALIFIER.
Exemple
TEXTQUALIFIER%
SET Variable = %EPAK 12"X10 7/32"%