Types de fichiers de commande

Les commandes NiceLabel sont utilisées dans les fichiers de commande pour contrôler l'impression des étiquettes. Desktop Designer exécute les commandes du fichier de commande, de haut en bas.

COMMENTAIRE

;

Il est conseillé de documenter les commandes durant le développement du fichier de commande. Cela permettra de décoder ce que le script fait vraiment en jetant un œil sur le code de temps en temps. Mettre un point-virgule (;) au début de la ligne. Tout ce qui suit le point-virgule est considéré comme commentaire et donc non traité.

CLEARVARIABLEVALUES

CLEARVARIABLEVALUES

Cette commande réinitialise les valeurs des variables à leur valeur par défaut.

CREATEFILE

CREATEFILE <file name> [, <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 la section Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

DELETEFILE

DELETEFILE <file name>

Efface le fichier spécifié. Utilisez la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter la section Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

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

Pour plus de renseignements, consulter l'article Utiliser le mode d'impression Stocker/Rappeler.

IGNOREERROR - ignorer erreur

IGNOREERROR <on> [,<off>]

Spécifie que les erreurs du fichier JOB listées dessous ne terminent pas le processus d'impression:

ÉTIQUETTE

LABEL <label name> [,<printer_name>]

La commande ouvre l'étiquette à imprimer. Si l'étiquette est déjà chargée, elle ne s'ouvrira pas. Mettre éventuellement le nom du chemin. Mettre le nom de l'étiquette entre guillemets, si le nom ou le chemin contiennent des espaces. Utilisez la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

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

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 ("). Utilisez la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter l'article Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

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 souvent 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 = "".

IMPRESSION

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

Cette commande lance le processus d'impression.

IMPRIMANTE

PRINTER <printer name>

Cette commande remplace l'imprimante définie dans le fichier d'étiquette. Si le nom d'imprimante contient des caractères espace, il faut les mettre entre guillemets (").

Utiliser le nom d'imprimante tel qu'il est affiché dans la ligne d'état de 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 -Nom du travail d'impression

PRINTJOBNAME

Cette commande spécifie le nom de la tâche 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 -Fin de session

SESSIONEND

Cette commande ferme le flux d'impression. Voir aussi SESSIONSTART (début de session).

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 de NiceLabel . Voir aussi SESSIONSTART (début de session).

SESSIONSTART -Début de session

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 une tâche d'impression différente. Pour joindre les données d'étiquettes dans un flux d'impression, il faut utiliser les commandes d'impression de session. Il faut commencer par la commande SESSIONSTART, suivie par un nombre quelconque de commandes SESSIONPRINT et terminer par la commande SESSIONEND.

Utiliser ces commandes pour optimiser le processus d'impression des étiquettes. L'impression d'étiquettes provenant dans un seul flux d'impression est plus rapide que l'impression d'étiquettes dans différents travaux d'impressions.

Il faut respecter certaines règles pour éviter de rompre la session d'impression.

SET

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

Cette action assigne une valeur à la variable nom. 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, il faut les mettre entre guillemets ("). Voir aussi TEXTQUALIFIER.

Si vous voulez assigner une valeur en plusieurs lignes, utilisez \r\n pour encoder un caractere de passage a la ligne. \r est remplacé par CR (Retour Charriot) 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.

SETPRINTPARAM

SETPRINTPARAM <paramname> = <value>

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 :

TEXTQUALIFIER

TEXTQUALIFIER <character>

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.

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

Ce fichier JOB ouvre l'étiquette label2.nlbl, définit les valeurs des variables et imprime une seule étiquette. Comme aucune commande PRINTER n'est utilisée pour rediriger l'impression, l'étiquette sera imprimée en utilisant le nom d'imprimante défini dans l'étiquette.

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

Cette section contient la description de structure du fichier de commande XML. Il y a différents éléments qui contiennent des attributs. Certains attributs sont obligatoires, d'autres sont en option. Certains attributs doivent avoir uniquement des valeurs prédéfinies. Pour les autres, elles peuvent être spécifiées.

Schéma de Définition XML (XSD) pour le fichier de commande 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>

L'exemple présente une vue structurelle des éléments et de leurs attributs tels qu'ils peuvent être utilisés dans un fichier 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>

Cet exemple illustre le stockage d’une étiquette sur l’imprimante.

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

Les commandes de la première ligne de données doivent être exprimées avec le caractère (@). Les champs sans @ au début sont des noms de variables, et ils seront extraits avec leurs valeurs comme paires nom-valeur.

L'exemple ci-dessous présente une vue structurelle des champs utilisables dans le fichier de commande 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

Plus de détails sur les commandes PAS figurent dans le Guide d’utilisateur de Loftware LPS.