M-PS DT MAPPING V7 La Commande MAP XPS
Sommaire
- 1 Introduction
- 2 Conversions de fichiers
- 3 Ajout de critères d’indexation au document
- 4 Extraction de valeurs de critères du document
- 5 Exporter les index et leurs valeurs
- 6 Utilisation des critères d’indexation
- 7 Concaténer des fichiers XPS
- 8 Gestion des codes OMR
- 9 Gestion des "PrintTickets"
- 10 Documents PDF ou HTML interactifs
- 11 Action exécutée après conversion
- 12 Divers
Introduction
Seule la version XPS permet de générer en XPS et elle est disponible en Unicode uniquement. La génération dans les anciens langages reste possible mais ne permet pas de bénéficier des nouvelles fonctionnalités liées au XPS, ce qui présente donc peu d’intérêt.
Conversions de fichiers
Conversion de documents en entrée
Le principe est de convertir des documents existants au format XPS, en vue de leur prise en charge et de leurs traitements futurs dans Mapping.
Les langages d’entrée supportés sont : AFP, ESCP, IGP, Image (BMP, JPG, PCX, PNG et TIFF), PCL, PDF, PS, SCS, TXT, Xerox, XPS, ZEBRA (ou ZPL), TEC
Exemples :
map_xps -infile:/tmp/email.pcl -fromPCL -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/email.pdf -fromPDF -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/email.afp -fromAFP -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/email.igp -fromIGP -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/email.zpl -fromZPL -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/email.ps -fromPS -outfile:/tmp/email.xps -toXPS map_xps -infile:/tmp/image.jpg -fromImage -outfile:/tmp/image.xps -toXPS -profile:fromJPEG
Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.
Conversion des fichiers XPS vers un format de sortie
Le principe est de convertir des fichiers XPS (générés ou non par Mapping) en vue de leur diffusion finale (impression, envoi par mail, archivage…) et en fonction de leur canal de diffusion.
Les langages de sortie supportés sont : AFP, BMP, DOCX, DPL, EPL, ESC, ESCP, HTML, IGP, JPG, Monarch, PCL, PDF, PNG, ProPrinter, PS, RTF, TEC, TIF, TXT, XMLDRAW, XPS, ZEBRA / ZPL.
Exemples :
map_xps -infile:/tmp/email.xps -toPCL -outfile:/tmp/email.pcl map_xps -infile:/tmp/email.xps -toPDF -outfile:/tmp/email.pdf
Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.
Exemple :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf –convert –config:MYPDF
Avec les paramètres :
-config:XXXX ou -profile:XXXX => sélection du profil à utiliser pour la conversion -convert => force la conversion en utilisant le profil sélectionné
Et un profil MYPDF défini dans le fichier de configuration :
<MYPDF> <label>for Adobe Reader</label> <language>PDF</language> <embeddedfont>OFF</embeddedfont> <color>ON</color> </MYPDF>
Pour appeler un profil de conversion en ligne de commande, le langage doit être à « *AUTO » sur iSeries, et ne doit pas être "forcé" sur Unix ou Windows (pas d’utilisation simultanée des arguments - profile:XXX et -toPCL par exemple).
Paramètres spécifiques pour la sortie AFPDS
En complément de la conversion XPS vers AFPDS, il est possible de forcer la résolution des polices et des images :
-fontRes:300 : résolution des polices -imageRes:300 : résolution des images Valeurs supportées : 240, 300 ou 600 dpi.
Utilisation des paramètres de profils
Tous les paramètres mentionnés et expliqués dans les conversions (entrée ou sortie) sont également utilisables en ligne de commande. Pour cela, la syntaxe suivante devra être ajoutée à la commande map_xps de conversion :
-param:nom_du_paramètre=valeur
Exemple :
map_xps -infile:/tmp/label.xps -outfile:/tmp/label.zpl -toZPL -param:resolution=203 -param:barcode=off
Gestion des critères d’indexation
Lister les index disponibles et leurs valeurs
Exemple :
map_xps -infile:/tmp/email.xps -dumpIndex
Pour lister tous les critères d’indexation présents dans le document
Exemple :
map_xps -infile:/tmp/email.xps –dumpIndex:CUSTOMER
Pour lister toutes les valeurs d’un index présent dans le document Indexation d’un document Ajout d’une valeur d’index sur toutes les pages d’un document Dans certains cas, il se peut qu’un critère d’indexation soit bien présent sur toutes les pages, mais sans valeur pour certaines pages, ou bien que le critère d’indexation ne soit pas présent sur toutes les pages. La commande suivante permet alors de réindexer le document en copiant, pour les pages sans valeur d’index, la valeur de l’index se trouvant sur la page précédente.
Exemple :
map_xps -infile:/tmp/email.xps –copyEmptyIndex:INVOICE
Fichier avant passage de la commande :
Page Index Valeur 1 INVOICE 1 2 3 INVOICE 2 4 INVOICE 3 5
Fichier après passage de la commande :
Page Index Valeur 1 INVOICE 1 2 INVOICE 1 3 INVOICE 2 4 INVOICE 3 5 INVOICE 3
Ajout de critères d’indexation au document
Le principe est d’indexer un document en ajoutant un ou plusieurs critères.
Les valeurs de chaque critère peuvent être précisées en clair sur la ligne de commande : toutes les pages du document auront alors la même valeur d’index.
Exemple :
map_xps -infile:C:\tmp\email.xps -addCriteria:NUMORDER=123456
Plus généralement, les valeurs d’un index seront issues d’une extraction préalable d’informations contenues dans le document lui-même, et stockées dans un fichier texte temporaire (consulter ci-après). La syntaxe précédente doit utiliser le mot clé « FILE: » pour spécifier que les valeurs de l’index ajouté doivent être reprises du fichier créé précédemment.
Exemple :
map_xps -infile:C:\tmp\email.xps -addCriteria:NUMORDER=FILE:C:\tmp\email.txt [ –outfile:C:\tmp\email_indexed.xps ]
Extraction de valeurs de critères du document
Le principe est de rechercher des informations contenues dans le document et de les extraire dans un fichier temporaire, pour ensuite les ajouter comme valeurs d’un critère d’indexation du même document. Le fichier temporaire créé est au format texte, en Unicode, avec la syntaxe suivante : "valeur[TAB]page[CRLF]"
La collecte des informations dans le document peut se faire par mot clé ou par position.
Les informations retournées peuvent être nettoyées des espaces superflus avant et/ou après le texte, avec les paramètres suivants :
-ltrim : suppression des espaces avant le texte -rtrim : suppression des espaces après le texte -trim : suppression des espaces avant et après le texte
Exemple 1 : recherche par mot clé
map_xps -infile:C:\tmp\email.xps -extract:C:\tmp\email.txt "-filter:Invoice for order" -length:10 –shift:2 -rtrim
Extraction de 10 caractères, situés 2 caractères après le mot clé "Invoice for order", en supprimant les espaces superflus après le texte retourné
Exemple 2 : recherche par position
map_xps -infile:C:\tmp\email.xps -extract:C:\tmp\email.txt "-box:100,150,180,30,mm"
Les paramètres de la « box » précisent ses dimensions. La syntaxe est : xx.xx,xx.xx,xx.xx,xx.xx[,cm|in|mm]
4 nombres décimaux, spécifiant dans l’ordre : top (haut), bottom (bas), left (gauche), right (droite)
Le séparateur de décimale est le ‘.’
Le séparateur de valeurs est ‘,’ ou ‘;’
Le dernier paramètre (optionnel) est l’unité de ces coordonnées : en point (pour une résolution de 96dpi) par défaut, en millimètre (mm), en centimètre (cm) ou en pouce (in)
Exporter les index et leurs valeurs
Le principe est la création d’un fichier d’index à partir d’un document, en vue de son archivage dans un logiciel tiers. Le fichier d’index peut être au format TXT, XML, ou IND (compatible Content Manager).
Le paramètre « -duplicateindex » permet d’exporter également les index dont la valeur est la même sur plusieurs pages.
Exemples :
map_xps -infile:/tmp/email.xps -indexfile:/tmp/file.txt –toXPS [-duplicateindex] map_xps -infile:/tmp/email.xps -indexfile:/tmp/file.xml -toXPS [-duplicateindex] map_xps -infile:/tmp/email.xps -indexfile:/tmp/file.ind -toXPS [-duplicateindex]
Utilisation des critères d’indexation
Trier un document
Le principe est de trier un document suivant les valeurs d’un ou plusieurs critères d’indexation. Un seul fichier sera créé en sortie. Le tri s’effectue par ordre croissant sur des valeurs numériques par défaut. L’utilisation de l’option ALPHA permet de réaliser un tri sur des valeurs alphanumériques, l’option REVERSE permet un tri par ordre décroissant.
Exemples :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf –sort:CUSTNBR -toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf –sort:ALPHA:MAPSEND -toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf –sort:CUSTNBR,INV_NBR -toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -sort:CUSTNBR,REVERSE:INV_NBR -toPDF
Éclater un document
Le principe est d’éclater un document suivant les valeurs d’un ou plusieurs critères d’indexation. Autant de fichiers peuvent être créés en sortie qu’il y a de valeurs différentes du ou des critères utilisés.
Exemple :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email_MAPSEND.pdf –toPDF
Le mode BUNDLEONINDEX permet de créer des lots en fonction du nombre de pages pour chaque valeur de critère (par exemple : 1 fichier avec les documents de 1 à 4 pages, 1 fichier pour les documents de 5 à 9 pages, un fichier pour les documents de plus de 10 pages). Il est possible de créer autant de lots que souhaité.
Exemple :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email_BUNDDLEONINDEX,MAPSEND,1,5,10.pdf –toPDF
En mode BUNDLEONINDEX, l’éclatement peut également se faire suivant un nombre de feuilles (en fonction des informations de recto/verso ou non), la syntaxe devient :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email_BUNDDLEONINDEX=LEAF,MAPSEND,1,5,10.pdf –toPDF
Filtres sur des valeurs de critères
Le principe est "d’isoler" certaines pages d’un document en fonction des valeurs d’un ou plusieurs critères d’indexation. Cela peut servir notamment pour créer un document en sortie ne concernant que certains clients.
Exemples :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -toPDF –filter:CUSTOMER=426 map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -toPDF "-filter:(CUSTOMER=4026) OR (CUSTOMER=1458) AND (PRICE=15)"
Cela peut également s’avérer très utile pour n’effectuer des actions que sur certaines pages, dépendant de valeurs de critères (notamment la gestion des PrintTickets).
Concaténer des fichiers XPS
Le principe est d’ajouter plusieurs documents les uns à la suite des autres. Le document de sortie est la concaténation de tous les fichiers précisés sur la ligne de commande, dans l’ordre où ils ont été précisés.
On peut ensuite imaginer un tri suivant des critères d’indexation préalablement définis sur chaque fichier pour faire du regroupement de fichiers de plusieurs sources différentes (facture + CGV + lettre d’information…)
Exemples :
Concaténation de plusieurs fichiers XPS en une seule fois :
map_xps -outfile:/tmp/final.xps -add:/tmp/test1.xps -add:/tmp/test2.xps –add:/tmp/test3.xps
Concaténation en plusieurs fois, dans le cas où l’on ne connait pas d’avance le nombre de fichiers XPS en entrée :
map_xps -tempfile:/tmp/final.xps -add:/tmp/test1.xps map_xps -tempfile:/tmp/final.xps -add:/tmp/test2.xps map_xps -tempfile:/tmp/final.xps -add:/tmp/test3.xps
Gestion des codes OMR
Consulter la documentation correspondante.
Gestion des "PrintTickets"
Le principe est de gérer les différents paramètres d’un travail d’impression pour un document, soit au niveau travail complet, soit à la page.
La syntaxe générale est :
map_xps -infile:/tmp/email.xps -set:NOM=VALEUR
L’option « -filter:XXX » permet de n’affecter un attribut d’impression que sur certaines pages, en fonction de valeurs d’indexation du document.
Les différents attributs "PrintTicket" reconnus sont :
DUPLEX : gestion du recto/verso
- yes/no : recto/verso en suivant les bords longs, ou recto seul
- long/short/F : recto/verso en suivant les bords longs ou courts, ou recto seul
FRONTSIDE (on/off): force l’impression sur le recto (en sortie PCL uniquement, en combinaison avec les options -filter:XXX et -pages:*)
INPUTBIN / OUTPUTBIN (valeur numérique) : gestion des bacs d’entrée/sortie
- ORIENTATION (valeur numérique)
- 0: Portrait
- 1: Landscape (paysage)
- 2: ReversePortrait (portrait retourné/inversé) 3: ReverseLandscape (paysage retourné/inversé)
COPY (valeur numérique) : nombre de copies
STAPLE (valeur numérique) : agrafage
- 1 = SaddleStitch (agrafage au milieu de la feuille)
- 2 = StapleBottomLeft (agrafage en bas à gauche)
- 3 = StapleBottomRight (agrafage en bas à droite)
- 4 = StapleDualBottom (agrafage en bas)
- 5 = StapleDualLeft (agrafage à gauche)
- 6 = StapleDualRight (agrafage à droite)
- 7 = StapleDualTop (agrafage en haut)
- 8 = StapleTopLeft (agrafage en haut à gauche)
- 9 = StapleTopRight (agrafage en bas à droite)
- 10 = None (stopper l’agrafage)
MEDIATYPE (valeur alphabétique) : type de papier Exemples : Archive, Etiquette, Bristol, AutoSelect…
NUP (valeur numérique : 1, 2 ou 4) : regroupement de 1, 2 ou 4 pages du document initial sur 1 page en sortie
LEFTOFFSET : marge de gauche en points
TOPOFFSET : marge supérieure en points
JOBCUT : yes/no. Commande de rupture de job (pour utiliser le cutter sur les imprimantes possédant le dispositif)
TOGGLE : yes/no. Commande de décalage du papier.
Tous ces différents paramètres devront ensuite être gérés dans des profils de conversion du fichier XPSConfig.conf, en fonction de la destination finale des documents.
Il est également possible d’utiliser ces paramètres lors d’une conversion directe sans passer par le -set : -duplex:LONG au lieu de -set:DUPLEX=LONG.
Exemples :
- Pour paramétrer le recto/verso sur un fichier XPS existant :
map_xps -infile:/tmp/myfile.xps -set:DUPLEX=yes
- Pour paramétrer le recto uniquement sur un fichier XPS existant :
map_xps -infile:/tmp/myfile.xps -set:DUPLEX=no
- Pour gérer les PrintTickets au niveau page :
map_xps -infile:/tmp/email.xps -set:INPUTBIN=2 -pages:2,3
- Pour paramétrer le recto sur la première page et recto/verso sur les suivantes :
map_xps -infile:c:\myfile.xps -set:DUPLEX=yes map_xps -infile:c:\myfile.xps -set:DUPLEX=no -pages:1
Documents PDF ou HTML interactifs
Gestion des inputs box
Le nom du bouton doit champs bouton doit être « SUBMIT ».
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost ?
map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.pdf -toPDF -param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?
map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML -param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?
Avec envoi d’e-mail :
map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML -param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost? -toMail - from:exp@mydomain.net -to:dest@mydomain.net -subject:form -server:192.168.1.2 -domain:mydomain.net
Remplacement des inputs box en automatique
Remplacement des champs input box par des valeurs en dur.
Création de la commande par défaut :
map_echo "Cache-Control: no-cache\nContent-type: application/pdf;\n\n" map_xps -infile:/tmp/form_vide.xps "-formfile:[%MAP_FILE%]" -outfile:/tmp/testfill.pdf "-toPDF" map_echo -infile:/tmp/testfill.pdf
Exemple du fichier XML de remplacement :
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> <input><post><ADD1>Votre nom</ADD1><ADD2>Votre nom</ADD2><CITY>Votre nom</CITY><NAME>LABEL_NAME</NAME><SUBMIT>Yes</SUBMIT><SURNAME>Votre pr%e9nom</SURNAME><ZIP>Votre nom</ZIP></post></input>
Exemple :
map_xps -infile:/tmp/email.xps -formfile:xxx.xml –outfile:/tmp/test.xps -toXPS
Adressage des canaux de sortie
Affichage d’un fichier à l’écran (Windows uniquement)
map_xps -infile:c:\trash\label.zpl -fromZPL –toGDI
Envoyer le document vers le spooler Windows
Principe : en sortie des traitements effectués par la commande map_xps, redirection du fichier résultant vers une imprimante Windows déclarée sur le poste, en utilisant son driver. Note : requiert la dll MapXpsTools.dll
Exemple :
map_xps -infile:/tmp/label.zpl -fromZPL -toGDI -toPrinter:XXX
Options supplémentaires :
-FitPage : impression pleine page -Orientation:X : 1=Portrait, 2=Paysage -res:72 : résolution -bpp:X : paramètre pour la couleur : 1=Noir et blanc, 8=niveau de gris, 16 et 24=couleur -rotation:XX : angle de rotation en degrés (90,180,270,-90) -verbose : affichage des erreurs dans la sortie standard (stderr) -logfile:C:\log.txt : redirection des erreurs dans un fichier de log -TimeOut:XX : Timeout (en secondes) si l’imprimante ne répond pas
Envoyer le document vers le spooler Mapping
Principe : en sortie du ou des traitements effectués par la commande map_xps, redirection du fichier résultant vers une file d’attente du Spooler Mapping.
Paramètre obligatoire :
-toQueue:XXXX => la file d’attente configurée dans le Spooler Mapping
Paramètres optionnels :
-title:XXX => Titre du spool -user:XXX => Utilisateur propriétaire du spool -map_save => Conserver le spool après édition -map_hold => Envoyer le spool à l’état "Pause" -map_priority:NNN => Ordre de priorité du spool -map_nb_copy:NNN => Nombre de copies -map_retention:NNN => Durée de rétention du spool -map_compress:NNN => Attribut "Date de compression" -map_security:NNN => Niveau de sécurité du spool -map_codecompta:NNN => Code de comptabilité du spool -map_fidelity:NNN => Attribut "Fidélité" -map_userData:XXX=XXX => Attribut userData -o:XXX=XXX => Attribut userData
Action exécutée après conversion
Il est possible d’exécuter une commande (ligne de commande, bat, shell) après la conversion à l’aide du paramètre – exec.
-exec: exécute une commande après la conversion
map_xps -infile:c:\tmp\infile.xps -toPDF –outfile:U:\share\file.pdf "-exec:c:\tmp\cmd.bat"
Action sur erreur ou succès
Principe : exécution d’actions particulières lors du déclenchement des événements « Erreur » et/ou « Succès ».
-onError: commande exécutée en cas d’erreur -onSuccess: commande exécutée en cas d’erreur map_xps -infile:c:\tmp\infile.xps -toPDF –outfile:U:\share\file.pdf "-onError:c:\tmp\error.bat" "- onSuccess:c:\temp\success.bat"
Envoyer un email
Principe : en sortie des traitements effectués par la commande map_xps, envoi direct du fichier résultant par email.
Paramètres obligatoires :
-toEmail | -toMail -server:XXX => serveur SMTP -from:XXX => expéditeur -to:XXX => destinataire(s) -infile:XXX => fichier XPS à joindre à l’email envoyé
Paramètres optionnels (le caractère optionnel ou non de certains arguments listés ci-après peut dépendre du serveur SMTP adressé) :
-domain:mydomain.net => domaine du serveur SMTP -port:25 => port du serveur SMTP -login:username => 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 -bodyhtml:FILE:c:\tmp\bodyhtml.html -footer:XXX => Pied de page du mail au format texte -footerhtml:XXX => Pied de page du mail au format HTML -footerhtml:FILE=c:\tmp\footer.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
Exemple 1 :
map_xps -infile:c:\temp\fichier.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 2 pièces jointes
map_xps -infile:c:\temp\fichier.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:C:\temp\PJ1.pdf,C:\temp\PJ2.pdf
Exemple 3 : avec conversion en PDF de la pièce jointe
map_xps -infile:c:\temp\fichier.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
Archiver le document dans MapOut
Principe : envoyer le document à notre logiciel MapOut pour son archivage direct au format XPS.
Syntaxe :
map_xps -infile:c:\tmp\fichier.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
Les différents paramètres sont ceux couramment utilisés pour adresser MapOut / M-Storage:
- Propriétaire du document
- Nom du fichier spool
- Numéro du travail
- Nom de l'imprimante
- Référence
- Format de papier
- Nom du programme
- Nom du format Mapping
Ces paramètres sont alors exploitables dans les règles d’archivage MapOut / M-Storage.
Divers
Rediriger la log dans un fichier
Principe : récupérer toutes les logs des commandes map_xps dans un fichier texte.
Exemple :
map_xps -infile:/tmp/email.xps –logfile:/tmp/mylog.log
Lister les ressources
Principe : affichage de toutes les ressources (polices et images) embarquées dans un fichier XPS.
Exemple :
map_xps -infile:/tmp/email.xps –listResource
Extraction de pages
Principe : définir des intervalles et/ou des sélections de pages à traiter. Les intervalles de pages sont à préciser sur la ligne de commande, les sélections peuvent être dans un fichier texte, où la syntaxe est : numéro de page+CRLF. L’utilisation du caractère ‘*’ est possible pour les intervalles de pages, pour choisir la fin du document.
Exemples :
map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -pages:1,3,4,7,10 –toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -pages:3-10 –toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -pages:1,5,10-* –toPDF map_xps -infile:/tmp/email.xps -outfile:/tmp/email.pdf -pages:FILE:/tmp/test.txt –toPDF
Extraction des données en XML (pour MapDraw / Designer)
Principe : créer un fichier XML compatible pour MapDraw/Designer, dans lequel toutes les données textes du fichier XPS sont extraites. Chaque zone de texte dans le fichier XPS devient un champ XML, nommé de manière unique par ses positions en X et Y. Les positions X et Y sont définies en 72 dpi.
Ce mode est aussi utilisé pour créer un fichier XML servant de base à l’ajout de codes OMR. Voir à ce sujet la documentation spécifique à l’ajout de code OMR.
Exemple :
map_xps -infile:c:\test\billing.xps –toXMLDRAW -outfile:c:\test\result\billing.draw.xml
Remplacement de champs
Principe : utiliser des champs de remplacement dans un fichier XPS. Il est possible de définir dans un fichier XPS des champs en attente d’affectation. Par exemple, vous souhaitez imprimer la date d’édition sur un document, mais cette date ne correspond pas forcément au moment exact du maquettage du document.
Vous pouvez donc, dans la partie variable de la maquette, créer un champ en attente de remplacement sous la forme MA_DATE (zone de texte). Une fois le document XPS composé, la valeur de ce champ MA_DATE sera retrouvée dans l’environnement système, par l’argument de ligne commande -replaceEnv.
Tout l’enjeu consiste donc à inscrire dans l’environnement une variable MA_DATE et à lui donner une valeur. Plusieurs moyens pour cela :
Avant composition, elle est passée en paramètre par l’application envoyant le fichier de données à composer dans Mapping, et donc automatiquement gérée dans Mapping comme une variable d’environnement attachée au traitement.
Exemple : argument "-o:MA_DATE=20110309" de la commande map_lpr
Pendant les traitements de composition, elle est définie dans le Workflow Mapping d’exécution comme un paramètre, et ainsi automatiquement gérée dans Mapping comme une variable d’environnement attachée au traitement.
Après composition, elle peut prendre la valeur d’un index positionné dans le document XPS, préalablement exporté dans l’environnement par l’argument -environment. Exemple : à l’issu de la composition, un document billing.xps est obtenu, contenant l’index MA_DATE. La commande suivante exporte les valeurs de l’index dans l’environnement, puis utilise l’environnement pour remplacer dynamiquement le champ MA_DATE :
map_xps -infile:c:\test\xps\billing.xps -toXPS -outfile:c:\test\xps\billing.replace.xps -environment:MA_DATE -replaceEnv
L’ensemble des variables d’environnement propres au système Windows ou Unix (DATE, TIME, COMPUTERNAME, etc.) et des variables d’environnement propres à Mapping (MAP_FILE, MAP_USER, MAP_TITLE, etc.) sont accessibles nativement par cet argument -replaceEnv.
Conversion d’images Taille -sizeX : largeur de l’image en pixels -sizeY : hauteur de l’image en pixels Si un seul des 2 paramètres est renseigné, le ratio initial est conservé. Si les 2 paramètres sont renseignés, le ratio est recalculé en fonction de ces 2 valeurs (et l’image déformée si nécessaire).
Nombre de couleurs -bpp : nombre de bits par pixels. Valeurs possibles : 1, 4, 8, 16 et 24 2 couleurs (1 bit), 16 couleurs (4 bits), 256 couleurs (8 bits), 65 536 couleurs (16 bits) ou 16,8 millions de couleurs (24 bits).
Format et taille des pages d’un document Pour modifier la taille des pages du document, ou la taille des données à l’intérieur d’une page, il existe 3 arguments de la ligne de commande, ayant chacun leur fonctionnel :
-paper:XXX : permet de changer la taille du papier (de la page), sans toucher au contenu. -scale:XXX : permet de changer la taille du contenu, sans toucher au papier. -changeformat:XXX : permet de changer le format du document, en modifiant la taille du papier tout en adaptant en contenu (avec conservation des proportions).
Syntaxes
Pour une mise à l’échelle du contenu d’une page, l’argument « -scale:XXX » prend des valeurs de pourcentage, de 0 (si si, juré !!) à infini (attention aux pertes de données avec des valeurs supérieures à 100, puisque la taille du papier n’est pas modifiée). Pour modifier la taille de la page en sortie, avec modification ou non du contenu, les arguments « - changeformat:XXX » et « -paper:XXX » permettent de définir la taille du format, soit à la norme ISO, soit en personnalisé. Valeurs possibles ISO : AUTO, EXECUTIVE, LETTER, LEGAL, LEDGER, A4, A3, A2, A1, A0, MONARCH, COM10, DL, CS, B5 Syntaxe pour taille personnalisée : -changeformat:xx.xx,xx.xx[,cm|in|mm] 2 valeurs décimales correspondant respectivement à largeur et hauteur Le séparateur de décimale est le ‘.’ Le séparateur de valeurs est ‘,’ ou ‘;’ L’unité est optionnelle : cm (par défaut), mm ou in (pour inch) Exemples :
map_xps -infile:c:\test\billing.xps –scale:50 -outfile:c:\test\out.xps map_xps -infile:c:\test\billing.xps –changeformat:A4 -outfile:c:\test\out.xps map_xps -infile:c:\test\billing.xps –changeformat:21,29.7,cm -outfile:c:\test\out.xps
Rotation de documents
Principe : effectuer une rotation sur un fichier XPS L’angle de rotation (en degré) est précisé sur la ligne de commande, le sens de rotation par défaut étant le sens trigonométrique (anti horaire). Sur le principe, tous les angles sont supportés, mais seuls les angles droits respectent la cohérence des dimensions de la page d’origine. D’où les valeurs supportées suivantes : -90 (rotation de 90° dans le sens horaire), 90, 180, 270. Notes : les valeurs -180 et -270 ne sont pas supportées (page blanche en sortie), il convient d’utiliser respectivement 180 et 90.
Exemple :
map_xps -infile:c:\test\fichier.xps -outfile:c:\test\fichier_90.xps –rotation:90 -toXPS
Fusion d’un fond de page sur un document existant
Principe : sur un document XPS existant, il est possible de venir rajouter un autre document en tant que fond de page, ou calque. Par exemple : ajouter un logo sur une facture existante n’en comportant pas. De plus, l’argument optionnel « -mergemode:XXX » permet de contrôler plus finement la manière dont est rajouté ce calque.
Exemple :
map_xps -infile:C:\test\billing.xps -merge:C:\tmp\logo.xps -mergemode:REPEATALL -outfile:C:\test\final.xps
L’argument « -merge:XXX » précise le nom du fichier à ajouter en tant que calque sur le document d’entrée. L’argument « -mergemode:XXX » précise la méthode d’ajout : REPEATALL : toutes les pages sont fusionnées, en répétant le calque jusqu’à la fin du fichier d’entrée. C’est le fonctionnement par défaut si rien n’est précisé.
Exemple :
En entrée : fichier d’entrée de 5 pages (identifiées par 1,2,3,4,5) et un calque de 2 pages (identifiées a,b)
En sortie : un fichier de 5 pages identifiées 1a,2b,3a,4b,5a
REPEATFULL : toutes les pages sont fusionnées, en répétant le calque tant qu’il peut être inséré entièrement.
Exemple : Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3a,4b,5 (la dernière page n’étant donc pas modifiée).
ONCE : le calque n’est inséré qu’une seule fois, sur la ou les premières pages du fichier d’entrée.
Exemple : Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3,4,5.
Variable d’environnement exportée
MAP_XPSFILE : contient le nom du fichier en cours d’extraction.