Conversion de documents

==Méthodes de conversion==

Le principe de base des conversions consiste à utiliser le format pivot Mapping XPS.  

Il existe deux méthodes pour utiliser les conversions :

*Conversion sans appel de profil : Dans ce cas, la commande map_xps effectue la conversion directement avec les paramètres saisis.

*Conversion avec appel de profil : Dans ce cas, un profil de conversion générique ou spécifique est appelé permettant de gérer des paramètres propres à un modèle d'imprimante par exemple. Un profil de conversion peut aussi être utilisé pour simplifier l'automatisation des traitements car dans ce cas il suffit d'appeler un profil dans la commande map_xps sans devoir saisir tous les paramètres à chaque fois.


Avant d'aller plus loin, il est recommandé de lire la section dédiée à l'utilisation des profils de conversion ici :
[[ONYX:9.0:Utilisation:Convertisseurs_de_sortie#Le_fichier_de_configuration_:_XPSCONFIG.CONF|Profils de conversion]]

==Conversion en sortie==

Le principe est de convertir des fichiers XPS, générés ou non par ONYX Server, en vue de leur diffusion finale (impression, envoi par mail, archivage…) et en fonction de leur canal de diffusion. Les commutateurs pour réaliser ces conversions sont de la forme :<code> -toXXX</code>.

Les langages de sortie supportés dans ONYX Server sont : AFP, BMP, DOCX, DPL, EPL, ESC, ESCP, HTML, IGP, IPDS, JPG, Monarch, PCL, PDF, PNG, ProPrinter, PS, RTF, TEC, TIF, TXT, XMLDRAW, XMLPOS, XPS, ZEBRA / ZPL.

Exemples :

 map_xps -infile:/tmp/invoice.xps -toPCL -outfile:/tmp/invoice.pcl

 map_xps -infile:/tmp/invoice.xps -toPDF -outfile:/tmp/invoice.pdf

Ces conversions peuvent en outre être affinées en utilisant un profil défini dans le fichier de configuration.

Exemple :

 map_xps -infile:/tmp/invoice.xps -outfile:/tmp/invoice.pdf -convert -profile:MYPDF

Avec les paramètres :

 -config:XXXX ou -profile:XXXX &rArr;  sélection du profil à utiliser pour la conversion

 -convert &rArr;  force la conversion en utilisant le profil sélectionné

Et un profil MYPDF défini dans le fichier de configuration XPSConfig.conf :
 <MYPDF>
       <label>for Adobe Reader</label>
       <language>PDF</language>
       <embeddedfont>off</embeddedfont>
       <color>on</color>
 </MYPDF>

==Surcharge des conversions==

Tous les paramètres mentionnés et expliqués dans les deux parties sur les conversions (entrée et sortie) peuvent être utilisés en ligne de commandes pour venir surcharger les valeurs par défaut de la conversion. Pour cela, la syntaxe suivante devra être ajoutée à la commande <code>map_xps</code> de conversion :<code>-param:nom_du_paramètre=valeur</code>


Exemple: 
 map_xps -infile:/tmp/label.xps -outfile:/tmp/label.zpl -toZPL -param:resolution=203 -param:barcode=off