ONYX - 9.0 - Utilisation - Configuration des imprimantes/en

Différence entre versions

De MappingDoc
(Page créée avec « '''Queue''': Onyx server object which receives the list of files to print and puts them on hold (based on priorities). The queue does not make any connection with a printe... »)
(Page créée avec « ====Enable banners==== Banners are separator pages that are added before and after the print file. Consult the specific documentation on the creation and use of banners. »)
 
(64 révisions intermédiaires par le même utilisateur non affichées)
Ligne 12 : Ligne 12 :
 
The name of a queue must be unique.
 
The name of a queue must be unique.
  
'''Device''' : objet Onyx Serveur chargé de la communication avec l’imprimante (en fonction des paramètres adresse ip,protocole…). Elle doit être rattachée à une (et une seule) file d’attente. Elle peut être à l’état Prêt, Stop ou en Erreur (dans ces 2 derniers cas, les fichiers ne sont pas traités par la device). Plusieurs devices peuvent être
+
'''Device''': Onyx Server object responsible for communication with the printer (depending on the IP address, protocol, etc. parameters). It must be attached to one (and only one) queue. It can be in the Ready, Stop or Error state (in these last 2 cases, the files are not processed by the device). Several devices can be
connectées à une seule file d’attente. Le nom d’une device doit être unique.
+
connected to a single queue. The name of a device must be unique.
  
==Configuration des imprimantes==
 
'''Pilote d’impression''' : cela concerne uniquement la partie connexion à l’imprimante pour envoi des données. La configuration du pilote d’impression Mapping est indépendant des contrôles d’impression (retour sur erreur, interrogation du statut de l’imprimante).
 
  
===Pilote d'impression===
+
==Printer configuration==
====Connexion====
+
'''Print driver''': this only concerns the part connecting to the printer for sending data. The configuration of the Mapping print driver is independent of the printing controls (error feedback, querying the printer status).
LPR (valeur par défaut et valeur recommandée) : Il s’agit de la connexion standard pour une imprimante réseau. Le spooler se connecte
 
  
sur le port lpr de l’imprimante (515) et envoie les données. Le protocole intègre plusieurs contrôles de connexion intermédiaire.
 
  
Il fonctionne avec quasiment l’intégralité des imprimantes et permet également de communiquer avec des serveurs d’impression.
+
===Print driver===
 +
====Login====
 +
LPR (default and recommended value): This is the standard connection for a network printer. The spooler connects
  
* RAW : Le protocole RAW est utilisé : connexion sur un port donné (à préciser par ailleurs), envoi des données,déconnexion. Aucun contrôle n’est géré par ce protocole.
 
* SHELL : La device n’est pas connectée à une imprimante mais à un programme (bat ou shell en fonction des OS).
 
* RULES : La device n’est pas connectée à une imprimante mais au moteur de règles et au Workflow.
 
* USB : L’imprimante doit être connectée à un port USB. Le nom du port doit être précisé par ailleurs.
 
* SERIAL : L’imprimante doit être connectée à un port série. Le nom du port doit être précisé par ailleurs.
 
* LOCAL OS SPOOLER (sous Windows uniquement) : La device envoie les fichiers à une imprimante déclarée sur le serveur d’impression Windows. Il faut alors sélectionner le nom de l’imprimante Windows dans le paramètre Remote_queue.
 
* DUMMY : Connexion de type test. Les fichiers ne sont pas traités.
 
* IPDS : Le protocole utilisé est l’IPDS, il permet d’imprimer des flux en AFPDS avec communication bidirectionnelle avec les
 
* imprimantes.
 
* EMAIL : Device de type Email pour envoi de courrier électronique. Consultez la documentation spécifique sur les imprimantes
 
* de type Email.
 
  
====Type d'mpression====
+
to the printer's lpr port (515) and sends the data. The protocol incorporates several intermediate connection controls.
* DEFAULT : Protocole par défaut
 
* MAPPING : A utiliser pour envoi des données à un spooler Mapping. Il permet notamment de compresser les fichiers avant envoi au serveur distant.
 
* AXHIOM (disponible pour les protocoles RAW et USB uniquement) : Protocole spécifique aux imprimantes AXHIOM.
 
* ESCPOS (disponible pour les protocoles RAW et SERIAL uniquement) : Protocole spécifique aux imprimantes de caisse EPSON.
 
* SAMSUNG (disponible pour le protocole RAW uniquement) : Protocole spécifique aux imprimantes de caisse SAMSUNG.
 
* ZEBRA (disponible pour le protocole RAW uniquement) : Protocole spécifique aux imprimantes de caisse ZEBRA (pour les imprimantes thermiques ZEBRA, utiliser le protocole LPR par défaut).
 
  
====Résolution des polices====
 
Résolution des fichiers pour création et envoi des polices AFPDS. Valeur exprimée en dpi (240 ou 300). Paramètre concernant les connexions de type IPDS.
 
  
====Activer Log====
+
It works with almost all printers and also allows you to communicate with print servers.
Activation des traces IPDS. Elles sont créées dans le sous répertoire \afpds\ipds du répertoire de base Mapping. Paramètre concernant les connexions de type IPDS.
 
  
====Compatibilité XPS====
+
* RAW: The RAW protocol is used: connection on a given port (to be specified elsewhere), sending of data, disconnection. No controls are managed by this protocol.
Il s’agit du profil de conversion à utiliser pour l’envoi des fichiers de type XPS. Le profil affiché est repris dans le paramètre <label> du fichier XPSConfig.conf.
+
* SHELL: The device is not connected to a printer but to a program (bat or shell depending on the OS).
 +
* RULES: The device is not connected to a printer but to the rules engine and the Workflow.
 +
* USB: The printer must be connected to a USB port. The port name must also be specified.
 +
* SERIAL: The printer must be connected to a serial port. The port name must also be specified.
 +
* LOCAL OS SPOOLER (under Windows only): The device sends the files to a printer declared on the Windows print server. You must then select the name of the Windows printer in the Remote_queue parameter.
 +
* DUMMY: Test type connection. The files are not processed.
 +
* IPDS: The protocol used is IPDS, it allows you to print AFPDS flows with bidirectional communication with the
 +
* printers.
 +
* EMAIL: Email type device for sending electronic mail. Consult specific printer documentation
 +
* Email type.
  
Si le fichier à imprimer est au format XPS, le profil de conversion sélectionné sera appliqué (pour conversion PCL,ZPL…). Si le fichier n’est pas au format XPS, le paramètre sera ignoré et aucune conversion effectuée.
 
  
Si aucun profil de conversion n’est renseigné, le fichier sera envoyé sans conversion (attention, l’envoi d’un fichier XPS à une
+
====Print Type====
 +
* DEFAULT: Default protocol
 +
* MAPPING: To be used to send data to a Mapping spooler. In particular, it allows files to be compressed before sending to the remote server.
 +
* AXHIOM (available for RAW and USB protocols only): Protocol specific to AXHIOM printers.
 +
* ESCPOS (available for RAW and SERIAL protocols only): Protocol specific to EPSON cash register printers.
 +
* SAMSUNG (available for RAW protocol only): Protocol specific to SAMSUNG cash register printers.
 +
* ZEBRA (available for RAW protocol only): Protocol specific to ZEBRA cash register printers (for ZEBRA thermal printers, use the LPR protocol by default).
  
imprimante ne le supportant pas produit généralement l’impression de caractères illisibles en continu jusqu’au vidage complet des bacs
 
  
de l’imprimante….) Paramètre concernant les connexions de type LPR.
+
====Font resolution====
 +
Resolution of files for creating and sending AFPDS fonts. Value expressed in dpi (240 or 300). Parameter concerning IPDS type connections.
 +
 
 +
 
 +
====Enable Log====
 +
Enabling IPDS traces. They are created in the \afpds\ipds subdirectory of the Mapping base directory. Parameter concerning IPDS type connections.
 +
 
 +
 
 +
====XPS Compatibility====
 +
This is the conversion profile to use for sending XPS type files. The displayed profile is included in the <label> parameter of the XPSConfig.conf file.
 +
 
 +
 
 +
If the file to be printed is in XPS format, the selected conversion profile will be applied (for PCL, ZPL conversion, etc.). If the file is not in XPS format, the setting will be ignored and no conversion performed.
 +
 
 +
 
 +
If no conversion profile is provided, the file will be sent without conversion (note, sending an XPS file to a
 +
 
 +
 
 +
A printer that does not support it generally produces illegible characters continuously until the trays are completely emptied.
 +
 
 +
 
 +
of the printer….) Parameter concerning LPR type connections.
 +
 
  
 
===== <u>IP</u> =====
 
===== <u>IP</u> =====
Il s’agit de l’adresse de destination de l’imprimante (ou du serveur d’impression). Vous pouvez saisir soit le hostname soit l’adresse
+
This is the destination address of the printer (or print server). You can enter either the hostname or the address
  
IP du périphérique. Paramètre concernant les connexions de type LPR, RAW, IPDS.
+
 
 +
Device IP. Parameter concerning LPR, RAW, IPDS type connections.
  
 
=====<u>Remote Queue</u>=====
 
=====<u>Remote Queue</u>=====
  
Nom de la file d’attente interne de l’imprimante (ou du serveur d’impression).Le nom de la file d’attente dépend du constructeur
 
  
d’imprimante, le plus commun est PASS mais il peut également s’agir de RAW, PR1, PR0, PR3, TEXT, mp ou autre. Attention, ce paramètre est généralement case sensitive.
+
Name of the internal queue of the printer (or print server). The name of the queue depends on the manufacturer
  
Dans le cas d’un serveur d’impression, il s’agit de la file d’attente de destination sur ce serveur (pour le cas d’un serveur Mapping :
 
  
le nom de la file d’attente, pour un serveur d’impression Windows : le nom de l’imprimante,pour un iSeries : le nom de l’OUTQ….)
+
printer, the most common is PASS but it can also be RAW, PR1, PR0, PR3, TEXT, mp or other. Please note, this parameter is generally case sensitive.
  
Pour une connexion de type LOCAL OS SPOOLER, il faut sélectionner le nom de l’imprimante déclaré dans le spooler Windows.
 
  
Paramètre concernant les connexions de type LPR et LOCAL OS SPOOLER.
+
In the case of a print server, this is the destination queue on this server (for the case of a Mapping server:
 +
 
 +
 
 +
the name of the queue, for a Windows print server: the name of the printer, for an iSeries: the name of the OUTQ….)
 +
 
 +
 
 +
For a LOCAL OS SPOOLER type connection, you must select the name of the printer declared in the Windows spooler.
 +
 
 +
 
 +
Parameter concerning LPR and LOCAL OS SPOOLER type connections.
 +
 
  
 
=====<u>Port</u>=====
 
=====<u>Port</u>=====
Port de connexion à l’imprimante (ou au serveur d’impression). 515 par défaut.En connexion de type IPDS, mettre 9100 ou 2501.
+
Port for connecting to the printer (or print server). 515 by default. In IPDS type connection, set 9100 or 2501.
  
Paramètre concernant les connexions de type LPR, USB, SERIAL et IPDS.
 
  
=====<u>Délai</u>=====
+
Parameter concerning LPR, USB, SERIAL and IPDS type connections.
Temps accordé pour l’envoi complet du fichier à l’imprimante y compris la réception des accusés de réception. La valeur à indiquer
 
  
dépend de la taille maximale des fichiers et de la bande passante disponible sur le réseau (inutile de choisir 10 secondes si vous avez
 
  
des fichiers de 10.000 pages : l’imprimante n’aura pas le temps suffisant pour absorber le fichier complètement).
+
=====<u>Deadline</u>=====
 +
Time allowed for complete sending of the file to the printer including receipt of acknowledgments of receipt. The value to indicate
  
Si à l’expiration du délai, l’accusé de réception final (assurant que l’intégralité du fichier a été envoyée correctement) n’a pas été reçu, l’impression sera considérée comme échouée.
 
  
La valeur * signifie que l’on ne contrôle pas l’accusé de réception de l’imprimante et qu’elle ne tombe donc jamais en erreur.
+
depends on maximum file size and available network bandwidth (no need to choose 10 seconds if you have
 +
 
 +
 
 +
files of 10,000 pages: the printer will not have sufficient time to absorb the file completely).
 +
 
 +
 
 +
If at the end of the deadline, the final acknowledgment of receipt (ensuring that the entire file has been sent correctly) has not been received, the print will be considered unsuccessful.
 +
 
 +
 
 +
Translations:ONYX:9.0:Usage:Configuring printers/33/en
 +
The value * means that we do not check the acknowledgment of receipt of the printer and that it therefore never fails.
 +
 
 +
Parameter concerning LPR, USB, SERIAL, LOCAL OS SPOOLER type connections
  
Paramètre concernant les connexions de type LPR, USB, SERIAL, LOCAL OS SPOOLER
 
  
 
=====<u>Shell</u>=====
 
=====<u>Shell</u>=====
Chemin complet du shell à exécuter par la device (un .bat sur OS Windows, un .sh sur OS Unix ou Linux).Paramètre concernant les connexions de type SHELL.
+
Full path to the shell to be executed by the device (a .bat on Windows OS, a .sh on Unix or Linux OS). Parameter concerning SHELL type connections.
 +
 
  
 
=====<u>Rules set</u>=====
 
=====<u>Rules set</u>=====
Nom du Workflow à utiliser par la device. Paramètre concernant les connexions de type RULES.
+
Name of the Workflow to be used by the device. Parameter concerning RULES type connections.
 +
 
 +
 
 +
=====<u>Customized</u>=====
 +
This parameter allows you to add custom parameters (metadata) when sending to lpr. The available parameters are those of
 +
 
 +
 
 +
the map_lpr command (be careful not to use an already existing parameter: see the queue log for more details on the
 +
 
 +
 
 +
map_lpr command executed).
 +
 
 +
 
 +
Example: -sleep:10 to pause 10 seconds between each file.
 +
 
 +
 
 +
=== State===
 +
This involves activating or not monitoring the printer status for display in the spooler interface. This is independent of the print check which is carried out in addition to sending data to check for errors.
 +
 
 +
 
 +
Using status monitoring assumes that the destination printer (or device) is capable of
 +
return this type of information.
 +
 
 +
 
 +
Please note, if your printer is connected to the network using an additional box (AXIS or HP box type
 +
JetDirect), the feedback will be provided by the box and not by the printer. The returned state will therefore be that of
 +
case and not that of the printer.
 +
 
 +
 
 +
By activating the status check, the spooler web interface will be able to display the status of the printer (ready, offline, paper jam, etc.).
 +
 
 +
 
 +
 
 +
Note: Unless automatic refresh is requested, the spooler retrieves the status of a printer only at the time of sending
 +
of a file. The information displayed in this case corresponds to the state of the printer during the last printing by Mapping.
 +
 
 +
 
 +
====Protocol====
 +
* NONE: No query is made on the status of the printer.
 +
* SNMP: The SNMP protocol is used to monitor status. This is the most reliable and complete protocol. He is very good
 +
supported by the majority of recent printers. SNMP notably manages the page counter, which makes it possible to verify that all the pages of a file have been printed. Recommended mode.
 +
* LPQ: The LPQ protocol allows basic feedback on the status of the printer: only the status (active or inactive) is displayed.
 +
* PJL: Printer status is returned using the PJL protocol. This protocol is quite complete but unreliable because the
 +
protocol is not very standardized (the implementation of PJL is different depending on the manufacturer or even the printer model). THE
 +
error messages are not standardized (hence the parameters for calling a PJL message file and a language). Deprecated mode (retained only for backward compatibility reasons).
 +
 
 +
 
 +
====Delay====
 +
Time allowed to receive printer status. If you use automatic refresh, be careful not to set the delay too short so as not to send too many network frames.
 +
 
  
=====<u>Personnalises</u>=====
+
====Auto refresh====
Ce paramètre permet d’ajouter des paramètres personnalisés (métadonnées) lors de l’envoi en lpr. Les paramètres disponibles sont ceux de
+
Allows you to automatically refresh the printer status even when there is no printing. This is useful for an operator who
 +
manages the entire fleet and wants to control the general condition of the printer fleet.
  
la commande map_lpr (attention à ne pas utiliser un paramètre déjà existant : voir la log de la queue pour plus de détails sur la
+
=== Print control ===
 +
====Protocol====
 +
Print control is used to verify that a file has been completely printed and also to perform automatic restarts if necessary.
 +
* SNMP: The SNMP protocol is used to monitor status. This is the most reliable and complete protocol. It is very well supported by the majority of recent printers. SNMP notably manages the page counter, which makes it possible to verify that all the pages of a file have been printed. Recommended mode.
 +
* LPQ: The LPQ protocol provides basic feedback on the status of the printer. The page counter is not
 +
not managed, which means that automatic recovery can only be done on the entire file.
  
commande map_lpr exécutée).
 
  
Exemple : -sleep:10 pour faire une pause de 10 secondes entre chaque fichier.
+
====On error====
 +
* Default: Default operation depending on the [DAEMON_NO_HOLD_ON_ERROR] parameter of the mapping.conf.
 +
* Stop: In the event of an error, the current spool goes into error state. The device Mapping also fails: any printing on this printer is stopped until the device Mapping is restarted (in the Web interface or by command). If a backup printer is defined, the following files will be printed by the backup device.
 +
* Ignore: Errors are ignored, the current spool is considered processed, the next spool is sent to the printer.
 +
* Continue: The device remains in the ready state, the current spool goes into error. The next spool is sent to the printer.
  
=== Etat===
+
====Auto Resume====
Il s’agit d’activer ou non le contrôle de l’état de l’imprimante pour affichage dans l’interface du spooler. C’est indépendant du contrôle d’impression qui est effectué en plus de l’envoi des données pour contrôler les erreurs.
+
If the box is checked, the spooler will send the file back to the printer in the event of an error. In this case, a maximum time limit must be specified.  
  
L’utilisation du contrôle d’état suppose que l’imprimante (ou le périphérique) de destination soit capable de
 
renvoyer ce type d’information.
 
  
Attention, si votre imprimante est connectée au réseau grâce à un boitier additionnel (type boitier AXIS ou HP
+
for recovery and a recovery mode: complete or partial. During the recovery time, the device goes into error but the spool
JetDirect), le retour d’information sera fait par le boitier et non par l’imprimante. L’état renvoyé sera donc celui du
 
boitier et non celui de l’imprimante.
 
  
En activant le contrôle d’état, l’interface web du spooler pourra afficher l’état de l’imprimante (prête, hors-ligne,bourrage papier…).
 
  
 +
remains printing. If automatic recovery fails, the spool will also go into error. If it succeeds, the device will return to the ready state.
  
Remarque : Sauf si l’actualisation automatique est demandée, le spooler récupère l’état d’une imprimante uniquement au moment de l’envoi
+
- Delay: The delay is the maximum time during which the spooler will restart printing. It should be compared to the delay defined at the printer driver level: if the delay at the driver level is 1 minute, the file will be sent every minute until the recovery time expires (30 minutes for example ). Please note: some printers can print the file several times.
d’un fichier. L’information affichée correspond dans ce cas à l'étet de l'imprimante lors de la dernière impression par Mapping.
 
  
====Protocole====
 
* NONE : Auncune interrogation n'est faite sur l'état de l'imprimante.
 
* SNMP : Le protocole SNMP est utilisé pour contrôler l’état. Il s’agit du protocole le plus fiable et le plus complet. Il est très bien
 
supporté par la majorité des imprimantes récentes. Le SNMP gère notamment le compteur de pages, ce qui permet de vérifier que toutes les pages d’un fichier ont bien été imprimées. Mode recommandé.
 
* LPQ : Le protocole LPQ permet un retour d’information basique sur l’état de l’imprimante : seul le statut (active ou inactive) est affiché.
 
* PJL : L’état de l’imprimante est renvoyé en utilisant le protocole PJL. Ce protocole est assez complet mais peu fiable car le
 
protocole est peu normalisé (l’implémentation du PJL est différente en fonction du constructeur voire du modèle d’imprimante). Les
 
messages d’erreur ne sont pas normalisés (d’où les paramètres pour appeler un fichier de message PJL et une langue). Mode déconseillé (conservé uniquement pour des questions de retro-compatibilité).
 
  
====Délai====
+
- Mode defines the file recovery type:
Délai alloué pour recevoir l’état de l’imprimante. Si vous utilisez l’actualisation automatique, veillez à ne pas mettre un délai trop court pour ne pas envoyer trop de trames réseau.
 
  
====Actualisation automatique====
+
Complete: the complete file is returned from page 1
Permet de rafraichir automatiquement l’état de l’imprimante même lorsqu’il n’y a pas d’impression. C’est utile pour un opérateur qui
 
gère l’ensemble du parc et veut contrôler l’état général du parc d’imprimantes.
 
  
=== Contrôle d’impression ===
+
Min page: the file is returned from the last known printed page minus n pages (n being
====Protocole====
+
defined in the length of the paper path)
Le contrôle d’impression est utilisé pour vérifier qu’un fichier à bien été complètement imprimé et également pour effectuer des reprises automatiques si nécessaire.
 
* SNMP : Le protocole SNMP est utilisé pour contrôler l’état. Il s’agit du protocole le plus fiable et le plus complet. Il est très bien supporté par la majorité des imprimantes récentes. Le SNMP gère notamment le compteur de pages, ce qui permet de vérifier que toutes les pages d’un fichier ont bien été imprimées. Mode recommandé.
 
* LPQ : Le protocole LPQ permet un retour d’information basique sur l’état de l’imprimante. Le compteur de pages n’est
 
pas géré, ce qui signifie que la reprise automatique ne peut se faire que sur l’intégralité du fichier.
 
  
====Sur erreur====
 
* Default : Fonctionnement par défaut en fonction du paramètre [DAEMON_NO_HOLD_ON_ERROR] du mapping.conf.
 
* Stop : En cas d’erreur, le spool en cours passe à l’état erreur. La device Mapping tombe en erreur également : toute impression sur cette imprimante est stoppée jusqu’à une intervention de redémarrage de la device Mapping (dans l’interface Web ou par commande). Si une imprimante de backup est définie, les fichiers suivants seront imprimées par la device de backup.
 
* Ignore : Les erreurs sont ignorées, le spool en cours est considéré comme traité, le spool suivant est envoyé à l’imprimante.
 
* Continue : La device reste à l’état prêt, le spool en cours passe en erreur. Le spool suivant est envoyé à l’imprimante.
 
  
====Reprise automatique====
+
Max page: the file is returned from the last known printed page plus n pages (n being defined
Si la case est cochée, le spooler va renvoyer le fichier à l’imprimante en cas d’erreur. Il faut dans ce cas préciser un délai maximum
+
in the length of the paper path)
  
pour la reprise et un mode de reprise : complet ou partiel. Pendant le temps de la reprise, la device passe en erreur mais le spool
 
  
reste en cours d’impression. Si la reprise automatique échoue, le spool passera en erreur également. Si elle réussit, la device repassera à l’état prêt.
+
The information on the number of pages returned by the printer is not always 100% reliable. Some printers count pages at
  
- Délai : Le délai est le temps maximum pendant lequel le spooler va relancer l’impression. Il est à rapprocher du délai défini au niveau du pilote d’impression : si le délai au niveau du pilote est de 1 minute, l’envoi du fichier se fera toutes les minutes jusqu’à expiration du délai de reprise (30 minutes par exemple). Attention : certaines imprimantes peuvent imprimer plusieurs fois le fichier.
 
  
- Mode définit le type de reprise du fichier :
+
from the moment they are received in the buffer and not physically printed: if printing is cut off during
  
Complet : le fichier complet est renvoyé depuis la page 1
 
  
Page min : le fichier est renvoyé à partir de la dernière page imprimée connue moins n pages (n étant
+
processing and the printer counter reads 50 pages, only 47 pages may have been physically printed (the 3
défini dans la longueur du chemin papier)
 
  
Page max : le fichier est renvoyé à partir de la dernière page imprimée connue plus n pages (n étant défini
 
dans la longueur du chemin papier)
 
  
L’information du nombre de pages renvoyé par l’imprimante n’est pas toujours fiable à 100%. Certaines imprimantes comptent les pages à
+
others being somewhere between the input and output tray: the famous paper path).
  
partir du moment où elles sont reçues dans le buffer et non pas physiquement imprimées : si l’impression est coupée en cours de
 
  
traitement et que le compteur de l’imprimante indique 50 pages, il se peut que seules 47 pages aient été physiquement imprimées (les 3
+
On other (rarer) printers, the counter is “late” compared to the number of pages actually printed and you have to count down a few pages.
  
autres étant quelque part entre le bac d’entrée et de sortie : le fameux chemin papier).
+
Examples:
  
Sur d’autres imprimantes (plus rares), le compteur est « en retard » par rapport au nombre de pages réellement imprimé et il faut décompter quelques pages.
+
If the last page is page 50 and min page has been selected with a paper path length of 3 pages, the reissue will start on page 47.
  
Exemples :
 
  
Si la dernière page est la page 50 et page min a été sélectionné avec une longueur de chemin papier de 3 pages, la réédition commencera en page 47.
+
If the last page is page 50 and page max was selected with a paper path length of 3 pages, re-editing will start on page 53.
  
Si la dernière page est la page 50 et page max a été sélectionné avec une longueur de chemin papier de 3 pages, la réédition commencera en page 53.
 
  
==== Attendre ====
+
==== Wait ====
Le paramètre attendre (mode par défaut) définit que le spooler attend l’accusé d’impression finale du spool en
+
The wait parameter (default mode) defines that the spooler waits for the final print acknowledgment of the spool in
cours avant d’envoyer le suivant. Il s’agit du mode par défaut. Si le paramètre n’est pas activé, le comptage des
+
course before sending the next one. This is the default mode. If the parameter is not activated, the counting of
pages n’est plus effectif.
+
pages is no longer effective.
  
====Unité de page====
+
====Page unit====
L’unité de page dépend du type d’imprimante (et de compteur) et est utilisé pour vérifier que toutes les pages d’un spool ont été imprimées.
+
The page unit depends on the printer type (and counter) and is used to verify that all pages in a spool have been printed.
Si l’imprimante est de type feuille à feuille (cutsheet) soit la quasi-totalité des imprimantes laser workgroup,l’imprimante compte en
+
If the printer is of the cutsheet type, i.e. almost all workgroup laser printers, the printer has
pages physiques. Il n’y a donc aucun souci de compatibilité avec Mapping qui compte lui aussi en page. L’unité de page est donc à 1 (par défaut).
+
physical pages. There is therefore no problem of compatibility with Mapping which also counts on the page. The page unit is therefore 1 (default).
Par contre, pour les imprimantes à papier continu qui utilise des rouleaux de papier (laser à papier continu,imprimantes matricielles ou
+
On the other hand, for continuous paper printers which use rolls of paper (continuous paper laser, dot matrix printers or
thermiques), le compteur est défini en distance imprimé (généralement en inch). Il faut donc « calibrer » la taille du papier en
+
thermal), the counter is defined in printed distance (generally in inches). It is therefore necessary to “calibrate” the size of the paper by
précisant l’unité de page. Par exemple, sur une imprimante thermique imprimant des étiquettes de 4 pouces de long, il faut définir une unité de page de 4.
+
specifying the page unit. For example, on a thermal printer printing 4-inch long labels, you should set a page unit of 4.
  
====Activer les bannières====
+
====Enable banners====
Les bannières sont des pages de séparation qui sont ajoutées avant et après le fichier d’impression. Consultez la
+
Banners are separator pages that are added before and after the print file. Consult the
documentation spécifique sur la création et l’utilisation de bannières.
+
specific documentation on the creation and use of banners.

Version actuelle datée du 2 janvier 2025 à 14:46

Autres langues :
English • ‎français

Prerequisites

Software version: ONYX 9.0 or higher on Linux or Windows.

Introduction

Configuring printers in Onyx server allows you to connect many types of printers to the Mapping spooler. Different configuration parameters depending on the type of printer connected. In all cases, the reliability of the information displayed in the spooler depends on the quality of the information returned by the printer. The information return is based on the SNMP protocol.

Queue: Onyx server object which receives the list of files to print and puts them on hold (based on priorities). The queue does not make any connection with a printer, it is an object which manages only a list of files. It is linked to at least one device which will connect to the physical printer. It can be in the Ready or Stop state (in this case, the files are not processed by the device). The name of a queue must be unique.

Device: Onyx Server object responsible for communication with the printer (depending on the IP address, protocol, etc. parameters). It must be attached to one (and only one) queue. It can be in the Ready, Stop or Error state (in these last 2 cases, the files are not processed by the device). Several devices can be connected to a single queue. The name of a device must be unique.


Printer configuration

Print driver: this only concerns the part connecting to the printer for sending data. The configuration of the Mapping print driver is independent of the printing controls (error feedback, querying the printer status).


Print driver

Login

LPR (default and recommended value): This is the standard connection for a network printer. The spooler connects


to the printer's lpr port (515) and sends the data. The protocol incorporates several intermediate connection controls.


It works with almost all printers and also allows you to communicate with print servers.

  • RAW: The RAW protocol is used: connection on a given port (to be specified elsewhere), sending of data, disconnection. No controls are managed by this protocol.
  • SHELL: The device is not connected to a printer but to a program (bat or shell depending on the OS).
  • RULES: The device is not connected to a printer but to the rules engine and the Workflow.
  • USB: The printer must be connected to a USB port. The port name must also be specified.
  • SERIAL: The printer must be connected to a serial port. The port name must also be specified.
  • LOCAL OS SPOOLER (under Windows only): The device sends the files to a printer declared on the Windows print server. You must then select the name of the Windows printer in the Remote_queue parameter.
  • DUMMY: Test type connection. The files are not processed.
  • IPDS: The protocol used is IPDS, it allows you to print AFPDS flows with bidirectional communication with the
  • printers.
  • EMAIL: Email type device for sending electronic mail. Consult specific printer documentation
  • Email type.


Print Type

  • DEFAULT: Default protocol
  • MAPPING: To be used to send data to a Mapping spooler. In particular, it allows files to be compressed before sending to the remote server.
  • AXHIOM (available for RAW and USB protocols only): Protocol specific to AXHIOM printers.
  • ESCPOS (available for RAW and SERIAL protocols only): Protocol specific to EPSON cash register printers.
  • SAMSUNG (available for RAW protocol only): Protocol specific to SAMSUNG cash register printers.
  • ZEBRA (available for RAW protocol only): Protocol specific to ZEBRA cash register printers (for ZEBRA thermal printers, use the LPR protocol by default).


Font resolution

Resolution of files for creating and sending AFPDS fonts. Value expressed in dpi (240 or 300). Parameter concerning IPDS type connections.


Enable Log

Enabling IPDS traces. They are created in the \afpds\ipds subdirectory of the Mapping base directory. Parameter concerning IPDS type connections.


XPS Compatibility

This is the conversion profile to use for sending XPS type files. The displayed profile is included in the <label> parameter of the XPSConfig.conf file.


If the file to be printed is in XPS format, the selected conversion profile will be applied (for PCL, ZPL conversion, etc.). If the file is not in XPS format, the setting will be ignored and no conversion performed.


If no conversion profile is provided, the file will be sent without conversion (note, sending an XPS file to a


A printer that does not support it generally produces illegible characters continuously until the trays are completely emptied.


of the printer….) Parameter concerning LPR type connections.


IP

This is the destination address of the printer (or print server). You can enter either the hostname or the address


Device IP. Parameter concerning LPR, RAW, IPDS type connections.

Remote Queue

Name of the internal queue of the printer (or print server). The name of the queue depends on the manufacturer


printer, the most common is PASS but it can also be RAW, PR1, PR0, PR3, TEXT, mp or other. Please note, this parameter is generally case sensitive.


In the case of a print server, this is the destination queue on this server (for the case of a Mapping server:


the name of the queue, for a Windows print server: the name of the printer, for an iSeries: the name of the OUTQ….)


For a LOCAL OS SPOOLER type connection, you must select the name of the printer declared in the Windows spooler.


Parameter concerning LPR and LOCAL OS SPOOLER type connections.


Port

Port for connecting to the printer (or print server). 515 by default. In IPDS type connection, set 9100 or 2501.


Parameter concerning LPR, USB, SERIAL and IPDS type connections.


Deadline

Time allowed for complete sending of the file to the printer including receipt of acknowledgments of receipt. The value to indicate


depends on maximum file size and available network bandwidth (no need to choose 10 seconds if you have


files of 10,000 pages: the printer will not have sufficient time to absorb the file completely).


If at the end of the deadline, the final acknowledgment of receipt (ensuring that the entire file has been sent correctly) has not been received, the print will be considered unsuccessful.


Translations:ONYX:9.0:Usage:Configuring printers/33/en The value * means that we do not check the acknowledgment of receipt of the printer and that it therefore never fails.

Parameter concerning LPR, USB, SERIAL, LOCAL OS SPOOLER type connections


Shell

Full path to the shell to be executed by the device (a .bat on Windows OS, a .sh on Unix or Linux OS). Parameter concerning SHELL type connections.


Rules set

Name of the Workflow to be used by the device. Parameter concerning RULES type connections.


Customized

This parameter allows you to add custom parameters (metadata) when sending to lpr. The available parameters are those of


the map_lpr command (be careful not to use an already existing parameter: see the queue log for more details on the


map_lpr command executed).


Example: -sleep:10 to pause 10 seconds between each file.


State

This involves activating or not monitoring the printer status for display in the spooler interface. This is independent of the print check which is carried out in addition to sending data to check for errors.


Using status monitoring assumes that the destination printer (or device) is capable of return this type of information.


Please note, if your printer is connected to the network using an additional box (AXIS or HP box type JetDirect), the feedback will be provided by the box and not by the printer. The returned state will therefore be that of case and not that of the printer.


By activating the status check, the spooler web interface will be able to display the status of the printer (ready, offline, paper jam, etc.).


Note: Unless automatic refresh is requested, the spooler retrieves the status of a printer only at the time of sending of a file. The information displayed in this case corresponds to the state of the printer during the last printing by Mapping.


Protocol

  • NONE: No query is made on the status of the printer.
  • SNMP: The SNMP protocol is used to monitor status. This is the most reliable and complete protocol. He is very good

supported by the majority of recent printers. SNMP notably manages the page counter, which makes it possible to verify that all the pages of a file have been printed. Recommended mode.

  • LPQ: The LPQ protocol allows basic feedback on the status of the printer: only the status (active or inactive) is displayed.
  • PJL: Printer status is returned using the PJL protocol. This protocol is quite complete but unreliable because the

protocol is not very standardized (the implementation of PJL is different depending on the manufacturer or even the printer model). THE error messages are not standardized (hence the parameters for calling a PJL message file and a language). Deprecated mode (retained only for backward compatibility reasons).


Delay

Time allowed to receive printer status. If you use automatic refresh, be careful not to set the delay too short so as not to send too many network frames.


Auto refresh

Allows you to automatically refresh the printer status even when there is no printing. This is useful for an operator who manages the entire fleet and wants to control the general condition of the printer fleet.

Print control

Protocol

Print control is used to verify that a file has been completely printed and also to perform automatic restarts if necessary.

  • SNMP: The SNMP protocol is used to monitor status. This is the most reliable and complete protocol. It is very well supported by the majority of recent printers. SNMP notably manages the page counter, which makes it possible to verify that all the pages of a file have been printed. Recommended mode.
  • LPQ: The LPQ protocol provides basic feedback on the status of the printer. The page counter is not

not managed, which means that automatic recovery can only be done on the entire file.


On error

  • Default: Default operation depending on the [DAEMON_NO_HOLD_ON_ERROR] parameter of the mapping.conf.
  • Stop: In the event of an error, the current spool goes into error state. The device Mapping also fails: any printing on this printer is stopped until the device Mapping is restarted (in the Web interface or by command). If a backup printer is defined, the following files will be printed by the backup device.
  • Ignore: Errors are ignored, the current spool is considered processed, the next spool is sent to the printer.
  • Continue: The device remains in the ready state, the current spool goes into error. The next spool is sent to the printer.

Auto Resume

If the box is checked, the spooler will send the file back to the printer in the event of an error. In this case, a maximum time limit must be specified.


for recovery and a recovery mode: complete or partial. During the recovery time, the device goes into error but the spool


remains printing. If automatic recovery fails, the spool will also go into error. If it succeeds, the device will return to the ready state.

- Delay: The delay is the maximum time during which the spooler will restart printing. It should be compared to the delay defined at the printer driver level: if the delay at the driver level is 1 minute, the file will be sent every minute until the recovery time expires (30 minutes for example ). Please note: some printers can print the file several times.


- Mode defines the file recovery type:

Complete: the complete file is returned from page 1

Min page: the file is returned from the last known printed page minus n pages (n being defined in the length of the paper path)


Max page: the file is returned from the last known printed page plus n pages (n being defined in the length of the paper path)


The information on the number of pages returned by the printer is not always 100% reliable. Some printers count pages at


from the moment they are received in the buffer and not physically printed: if printing is cut off during


processing and the printer counter reads 50 pages, only 47 pages may have been physically printed (the 3


others being somewhere between the input and output tray: the famous paper path).


On other (rarer) printers, the counter is “late” compared to the number of pages actually printed and you have to count down a few pages.

Examples:

If the last page is page 50 and min page has been selected with a paper path length of 3 pages, the reissue will start on page 47.


If the last page is page 50 and page max was selected with a paper path length of 3 pages, re-editing will start on page 53.


Wait

The wait parameter (default mode) defines that the spooler waits for the final print acknowledgment of the spool in course before sending the next one. This is the default mode. If the parameter is not activated, the counting of pages is no longer effective.

Page unit

The page unit depends on the printer type (and counter) and is used to verify that all pages in a spool have been printed. If the printer is of the cutsheet type, i.e. almost all workgroup laser printers, the printer has physical pages. There is therefore no problem of compatibility with Mapping which also counts on the page. The page unit is therefore 1 (default). On the other hand, for continuous paper printers which use rolls of paper (continuous paper laser, dot matrix printers or thermal), the counter is defined in printed distance (generally in inches). It is therefore necessary to “calibrate” the size of the paper by specifying the page unit. For example, on a thermal printer printing 4-inch long labels, you should set a page unit of 4.

Enable banners

Banners are separator pages that are added before and after the print file. Consult the specific documentation on the creation and use of banners.