La commande MAP XPS/en

<languages/>
==Introduction==

the MAP_XPS command is one of the main commands of OPALE Server. It allows you to process files for multiple final purposes.

The usal processing involves a file to map which is first generated in XPS format  using the MAPCPYSPLF command, the MAP_XPS command is then used to edit this XPS file.

[[File:Xps-intro.PNG|200px|center|sans_cadre]]   


To use the MAP_XPS command, run a <code> CALL PGM(MAP_XPS) PARM ('-infile:/home/map2019/file.PDF' '-outfile:/home/map2019/file.xps' '-toXPS' '-fromPDF') </code>

The MAPXPS command (without underscore) also exists. This one does not have as many applications and is mainly useful to convert files.

==Converting files==
=== Converting input files ===

Converting existing files to XPS is done to prepare them for future processing in the Mapping software. 

The supported input languages are: AFP, ESCP, IGP, Image (BMP, JPG, PCX, PNG et TIFF), PCL, PDF, PS, SCS, TXT, Xerox, XPS, ZEBRA (ou ZPL), TEC


Examples :
 map_xps -infile:/home/map2019/email.pcl -fromPCL -outfile:/home/map2019/email.xps -toXPS 
 map_xps -infile:/home/map2019/email.pdf -fromPDF -outfile:/home/map2019/email.xps -toXPS 
 map_xps -infile:/home/map2019/email.afp -fromAFP -outfile:/home/map2019/email.xps -toXPS 
 map_xps -infile:/home/map2019/email.igp -fromIGP -outfile:/home/map2019/email.xps -toXPS 
 map_xps -infile:/home/map2019/email.zpl -fromZPL -outfile:/home/map2019/email.xps -toXPS 
 map_xps -infile:/home/map2019/email.ps -fromPS -outfile:/home/map2019/email.xps -toXPS  
 map_xps -infile:/home/map2019/image.jpg -fromImage -outfile:/home/map2019/image.xps -toXPS -profile:fromJPEG

Such conversions can also be refined using a profile defined in the configuration file.

[[File:Mapxps entree.PNG|600px|center|sans_cadre]]

=== Converting XPS files to an output format ===

The aim is to convert XPS files (whether generated by Mapping or not) depending on their final purpose (printing, e-mail, archiving...) and communication channel. 

The supported output formats are: 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:/home/map2019/email.xps -toPCL -outfile:/home/map2019/email.pcl 
 map_xps -infile:/home/map2019/email.xps -toPDF -outfile:/home/map2019/email.pdf

[[File:MAP_XPS.PNG|600px|center|sans_cadre]]   


Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration. 

Exemple :
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –convert –config:MYPDF

[[File:Mapxps-profil.PNG|600px|center|sans_cadre]]   

Avec les paramètres :
 <code>-config:XXXX</code> ou <code>-profile:XXXX</code>	=> sélection du profil à utiliser pour la conversion
 <code>-convert</code>	=> 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 à <code>*AUTO</code> sur iSeries, et ne doit pas être "forcé" sur Unix ou Windows (pas d’utilisation simultanée des arguments <code>-profile:XXX</code> et <code>-toPCL</code> par exemple).


Remarque : 

Sur iSeries, le fichier XPSConfig.conf se trouve dans le dossier home/mapping.

=== 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:/home/map2019/label.xps -outfile:/home/map2019/label.zpl -toZPL -param:resolution=203 -param:barcode=off

===Gestion des critères d’indexation===
==== Lister les index disponibles et leurs valeurs ====

Pour lister tous les critères d’indexation présents dans le document

Exemple :
 map_xps -infile:/home/map2019/email.xps -dumpIndex

[[File:Mapxps-index.PNG|600px|center|sans_cadre]] 


Pour lister toutes les valeurs d’un index présent dans le document Indexation d’un document


Exemple :
 map_xps -infile:/home/map2019/email.xps –dumpIndex:CUSTOMER

====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:/home/map2019/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:/home/map2019/email.xps -addCriteria:NUMORDER=123456


[[File:Mapxps-criteria.PNG|600px|center|sans_cadre]] 


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:/home/map2019/email.xps -addCriteria:NUMORDER=FILE:/home/map2019/email.txt [ –outfile:/home/map201/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:/home/map2019/email.xps -extract:/home/map2019/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:/home/map2019/email.xps -extract:/home/map2019/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 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:/home/map2019/mail.xps -indexfile:/home/map2019/file.txt –toXPS [-duplicateindex] 
 map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.xml -toXPS [-duplicateindex]  
 map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.ind -toXPS [-duplicateindex]

[[File:Mapxps-exportxml.PNG|600px|center|sans_cadre]]

==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:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR -toPDF 
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:ALPHA:MAPSEND -toPDF
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR,INV_NBR -toPDF 
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -sort:CUSTNBR,REVERSE:INV_NBR -toPDF

[[File:Mapxps-trie.PNG|600px|center|sans_cadre]]

=== É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 :
 <nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[MAPSEND]].pdf –toPDF</nowiki>

[[File:Mapxps-eclater.PNG|600px|center|sans_cadre]] 


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 :
 <nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

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 :
 
 <nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX=LEAF,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

=== 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 :
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF –filter:CUSTOMER=426</code>
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF "-filter:(CUSTOMER=4026) OR (CUSTOMER=1458) AND (PRICE=15)"</code>

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:/home/map2019/final.xps -add:/home/map2019/test1.xps -add:/home/map2019/test2.xps –add:/home/map2019/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:/home/map2019/final.xps -add:/home/map2019/test1.xps 
  map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test2.xps 
  map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test3.xps

==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:/home/map2019/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.


Remarque :

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:/home/map2019/myfile.xps -set:DUPLEX=yes
*Pour paramétrer le recto uniquement sur un fichier XPS existant :
  map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no
*Pour gérer les PrintTickets au niveau page :
  map_xps -infile:/home/map2019/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:/home/map2019/myfile.xps -set:DUPLEX=yes
  map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no -pages:1

==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:/home/izaopale/bodyhtml.html
 -footer:XXX	=> Pied de page du mail au format texte
 -footerhtml:XXX	=> Pied de page du mail au format HTML
 -footerhtml:FILE=/home/izaopale/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 :
<code>map_xps -infile:/home/map2019/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</code>


Exemple 2 : avec ajout de 2 pièces jointes
<code>map_xps -infile:/home/map2019/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:/home/izaopale/PJ1.pdf,/home/izaopale/PJ2.pdf</code>


Exemple 3 : avec conversion en PDF de la pièce jointe
<code>map_xps -infile:/home/map2019/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</code>

==Maquettage avec sortie imprimée – Redirection dans une OUTQ==

Maquettage du document et conversion implicite / explicite en sortie 
 
Les langages de sortie supportés lors d’un MAPCPYSPLF sont les suivants : o 	Paramètre TYPLAN :  

*PCL 	 
*AFPDS 	 
*ZEBRA 	 
*DATAMAX 	 
*AUTO 	                            
*IGP 	 
*TEC 	 
*IPL 	 
*F_D 	 
*PDF 	 
*EPL 	 
*XPS 	
 

La valeur spéciale *AUTO reprend la valeur du paramètre saisi dans l’option 1 du Menu Mapping.
 
Dans ce cas, si *AUTO est spécifié dans le paramètre TYPLAN de la commande, le logiciel utilisera les maquettes développées en langage PCL. 
 
	o 	Paramètre XPSCONVERT :  
 
Valeur 	Remarque 
*AUTO 	Valeur du 14/14 - Paramètre PROFILE 
Valeur de 
profil 	Celui spécifié dans le XPSConfig.conf 
	
 
 
La valeur spéciale *AUTO permet de récupérer le nom de profil de l’imprimante qui est paramétré dans l’option Définition des paramètres imprimantes de Menu d’exploitation.


<u>Exemple de définition</u>: 
   
Ici, pour toutes les imprimantes, le profil *PCL est spécifié. Ce qui permet par exemple, de ne pas avoir à spécifier le nom de toutes les Outq / Devices du système si les imprimantes physiques sont des Laser. 
 
Ce nom de profil doit être paramétré dans le fichier XPSConfig.conf (situé dans l’IFS, sous la racine du répertoire MAPPING). 
 
Un fichier de configuration par défaut est installé avec les valeurs suivantes : 
 
<xpsconfig> 
## This file contains the conversion profile for Mapping.  
## You can create your own profile based on the Mapping documentation. BE CAREFUL WITH THE FILE STRUCTURE. 
## PROFILE NAME STARTING WITH * ARE RESERVED FOR MAPPING. SO DO NOT CREATE OR MODIFY A PROFILE STARTING WITH *. 
 	<*XPS> 
 	 	<label>DO NOT MODIFY - standard XPS</label> 
 	 	<language>XPS</language> 
 	</*XPS> 
 	<*PCL> 
 	 	<label>DO NOT MODIFY - standard PCL5/e</label> 
 	 	<language>PCL</language> 
 	 	<color>off</color> 
 	</*PCL> 

 
Dans cet exemple, le profil *PCL utilise le langage PCL (paramètre <language> du profil.  
 
 
Exemple de commandes pour sortie imprimée 
 
Exemple de commande : 
  MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX) 
  MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*AUTO) 
 
<u>Explications</u>: 
 
TYPLAN : 	 
Pour positionner le langage de la maquette. 
Mais ce paramètre accepte aussi la valeur *AUTO : Auquel cas, le programme récupère la valeur positionnée dans le menu Mapping/Option 1.

XPSCONVERT :
Conversion implicite réalisée en sortie. Ici, avec *AUTO le profil utilisé est celui qui est paramétré dans l’option 6 dans le menu Exploitation.  
 
 
Autre exemple de commande : 

 MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX) 
 MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL) 
 

<u>Explications</u> : 
 
XPSCONVERT : 	Conversion explicite réalisée en sortie. Ici, avec *PCL, c’est le profil *PCL du fichier XPSConfig.conf qui sera utilisé.  
 
'''  Maquettage avec sortie fichier dans l’IFS'''  /'''Maquettage du document avec conversion et stockage dans l’IFS''' 
 
Les mêmes commandes peuvent être utilisées afin de placer le résultat du maquettage et de la conversion dans un dossier de l’IFS. Il suffit pour cela de renseigner le paramètre XPSOUTFILE.  
En effet, la valeur par défaut de XPSOUTFILE est à *PRINT, pour ne pas générer de sortie fichier. 
 
Exemple : 
 
 MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX) 
 MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL) XPSOUTFILE(‘/home/map2019/invoice.pcl’)

==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:/home/map2019/email.xps –logfile:/tmp/mylog.log

[[File:Mapxps-log.PNG|600px|center|sans_cadre]]

==Lister les ressources==
Principe : affichage de toutes les ressources (polices et images) embarquées dans un fichier XPS. 

Exemple :
 map_xps -infile:/home/map2019/email.xps –listResource

[[File:Mapxps-listerR.PNG|600px|center|sans_cadre]]

==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:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,3,4,7,10 –toPDF 
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:3-10 –toPDF 
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,5,10-* –toPDF 
 map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:FILE:/home/map2019/test.txt –toPDF

==Extraction des données en XML (pour M-Designer)==

Principe : créer un fichier XML compatible pour M-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 [[OPALE:10.0:Utilisation:Gestion des codes OMR|codes OMR]].
 

Exemple :
 map_xps -infile:/home/map2019/billing.xps –toXMLDRAW -outfile:/home/map2019/billing.draw.xml

[[File:Mapxps-d-xml.PNG|500px|center|sans_cadre]]

==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 :
<code>-paper:XXX : permet de changer la taille du papier (de la page), sans toucher au contenu.</code>
<code>-scale:XXX : permet de changer la taille du contenu, sans toucher au papier.</code>
<code>-changeformat:XXX : permet de changer le format du document, en modifiant la taille du papier tout en adaptant en contenu (avec conservation des proportions).</code>

<U>Syntaxes</U>

Pour une mise à l’échelle du contenu d’une page, l’argument « -scale:XXX » prend des valeurs de pourcentage, de 0 à l'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:/home/map2019/billing.xps –scale:50 -outfile:/home/izaopale/out.xps 
 map_xps -infile:/home/map2019/billing.xps –changeformat:A4 -outfile:/home/izaopale/out.xps
 map_xps -infile:/home/map2019/billing.xps –changeformat:21,29.7,cm -outfile:/home/izaopale/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.

[[File:Mapxps-rotate.png|600px|center|sans_cadre]]   

Exemple :
 map_xps -infile:/home/map2019/fichier.xps -outfile:/home/map2019/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 :
<code> map_xps -infile:/home/map2019/billing.xps -merge:/home/map2019/logo.xps -mergemode:REPEATALL -outfile:/home/map2019/final.xps </code>


[[Fichier:Mapxps-fusion.png|centré|734x734px|sans_cadre]]


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.


==Gestion des input box==

Le nom de la zone input text 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 :

<code>map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML</code>
<code>-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost? -toMail -from:exp@mydomain.net -to:dest@mydomain.net</code>
<code>-subject:form -server:192.168.1.2 -domain:mydomain.net</code>