Marques pages
Se connecter

Adressage des canaux de sortie

Affichage écran(Windows uniquement)

Sous Windows, l’utilisation de l’interface graphique (Graphics Device Interface) permet d’afficher un document à l’écran.

Exemple :

map_xps -infile:C:\temp\label.zpl -fromZPL -toGDI

Envoyer un document dans le spooler systeme(Windows uniquement)

En sortie des traitements effectués par la commande map_xps, la possibilité est donnée de rediriger le fichier résultant vers une imprimante Windows déclarée sur le poste. Le pilote d’impression configurée sera alors utilisé pour l’impression.


Exemple :

map_xps -infile:C:\temp\myfile.xps<strong> -toPrinter</strong>:"Ricoh C830DN"


Les commutateurs suivants peuvent venir compléter cet envoi :

  • -FitPage : pour forcer l’impression pleine page
  • -Orientation:NN : pour changer l’orientation (1=Portrait, 2=Paysage)
  • -res:NN : pour changer la résolution (valeur numérique, exprimée en dpi)
  • -bpp:NN : gestion du mode couleur (1=Noir et blanc, 8=niveau de gris, 16 et 24=couleur)
  • -rotation:NN : angle de rotation en degrés (90, 180, 270, -90)
  • -logfile:XXX : écriture des erreurs dans un fichier de log
  • -TimeOut:NN : délai d’attente maximal (en secondes) si l’imprimante ne répond pas

Envoyer un document dans le spooler Mapping

En sortie des traitements effectués par la commande map_xps, le principe est de rediriger le fichier résultant vers une file d’attente du Spooler ONYX Server. Le commutateur utilisé est : -toQueue:XXX, où XXX est le nom de la file d’attente configurée dans le Spooler Mapping.


Remarque : Cette redirection ne peut se faire qu’en local.


Commutateurs optionnels :

  • -title:XXX : titre du spool
  • -user:XXX : propriétaire du spool
  • -map_save : conserver le spool après édition
  • -map_hold : envoyer le spool à l’état suspendu
  • -map_priority:NN : ordre de priorité du spool
  • -map_nb_copy:NN : nombre de copies
  • -map_retention:NN : durée de rétention du spool
  • -map_security:NN : niveau de sécurité du spool
  • -map_codecompta:NN : code de comptabilité du spool
  • -map_fidelity:NN : attribut « Fidélité »
  • -map_userData:XXX=XXX : attribut userData
  • -o:XXX=XXX : attribut userData

Exécution d’actions

Trois commutateurs permettent d’exécuter des actions particulières en sortie des traitements sur les documents XPS :

  • -exec:XXX : exécution d’une commande ou d’un script
  • -onError:XXX : exécution d’une commande ou d’un script en cas d’erreur de traitement
  • -onSuccess:XXX : exécution d’une commande ou d’un script lorsque le traitement réussit


Exemples:

map_xps -infile:/tmp/invoices.xps -toPDF -outfile:/share/invoices.pdf "-exec:/home/shell/call_archive.sh"
map_xps -infile:/tmp/invoices.xps -toPDF -outfile:/share/invoices.pdf "-onError:/home/shell/alert_exploit.sh"
"-onSuccess:/home/shell/send_sms.sh"

Envoi des mails

La commande map_xps permet également d’envoyer des documents par email en les joignant en pièce jointe ou directement dans le corps du message. Le commutateur à utiliser est -toEmail (ou -toMail) suivi de tous les paramètres permettant la personnalisation des messages envoyés.


Attention : Le caractère requis ou optionnel des arguments listés ci-après dépend de la configuration du serveur SMTP adressé.


Paramètres obligatoires :

  • -server:XXX => adresse IP ou nom DNS du serveur SMTP
  • -from:XXX => adresse de l’expéditeur du message
  • -to:XXX => adresse(s) du ou des destinataires, séparées par des ‘;’
  • -infile:XXX => document XPS à joindre à l’email envoyé

Paramètres optionnels :

  • -domain:XXX => domaine du serveur SMTP
  • -port:NN => port du serveur SMTP (25 par défaut)
  • -login:XXX => identifiant de connexion au serveur SMTP
  • -passwd:******* => mot de passé de connexion au serveur SMTP
  • -cc:XXX => destinataire(s) en copie -bcc:XXX => destinataire(s) en copie cachée
  • ’’-subject:This is my subject’’ => sujet du message
  • ’’-body:This is my body’’ => corps du message au format texte
  • -bodyhtml:XXX => corps du message au format HTML
  • -footer:XXX => Pied de page du mail au format texte
  • -footerhtml:XXX => Pied de page du mail au format HTML
  • -attachment:XXX => ajout de pièce(s) jointe(s) supplémentaire(s) séparées par une virgule
  • -outfile:XXX => dans le cas de l’envoi d’email, cet argument sert à nommer la pièce jointe principale (argument infile)envoyée


Remarque :

Pour les deux commutateurs -bodyhtml et -footerhtml, le code HTML peut être passé directement en ligne de commandes. Plus généralement, on utilisera des fichiers externes stockés sur disque qui seront liés à l’envoi d’email avec les syntaxes suivantes :

-bodyhtml:FILE=/home/extern/mail_body.html
-footerhtml: FILE=/home/extern/mail_footer.html

Ces fichiers externes peuvent contenir des paramètres dynamiques (variables d’environnement, valeurs de critères d’indexation) qui seront remplacés à l’exécution.


Exemple 1 :

map_xps -infile:/tmp/invoice.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX ”-subject:Test envoi email” ”-body:
Ceci est un test” -outfile:nomPJ.xps

Exemple 2 : avec ajout de deux pièces jointes

map_xps -infile:/temp/invoice.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX “-subject:Test envoi email” ”-body:
Ceci est un test” -outfile:nomPJ.xps -attachment:/home/extern/PJ1.pdf,/home/extern/PJ2.pdf

Exemple 3 : conversion en PDF de la pièce jointe principale

map_xps -infile:/tmp/invoice.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX “-server:XXX-subject:Test envoi email” “-body:
Ceci est un test” -toPDF -outfile:nomPJ.pdf

Envoi dans M-Storage

Le principe est de créer les fichiers nécessaires au module M-Storage pour le stockage et l’indexation du document XPS. Le commutateur à utiliser est : -mapout. Les paramètres standards pour M-Storage peuvent être utilisés pour personnaliser l’intégration des documents dans la base de stockage soit dans un profil de conversion soit en ligne de commandes avec la syntaxe -param:NOM=valeur.


Exemple :

map_xps -infile:/tmp/invoice.xps -mapout -param:mapoutUserName=user -param:mapoutSpoolName=spoolname
-param:mapoutJobNum=jobnum -param:mapoutPrinterName=printer -param:mapoutReference=ref
-param:mapoutPaperFormat=paper -param:mapoutPgm=pgm -param:mapoutMapName=mapnam

Signification des paramètres :

  • -mapoutUserName : Propriétaire du document
  • -mapoutSpoolName : Nom du fichier spool
  • -mapoutJobNum : Numéro du travail
  • -mapoutPrinterName : Nom de l’imprimante
  • -mapoutReference : Référence
  • -mapoutPaperFormat : Format de papier
  • -mapoutPgm : Nom du programme
Ajouter aux favoris
Exporter en PDF
Modifier l’article
Table des matières