Voir la source de M-PS DT MAPPING V7 La Commande MAP XPS


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