> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/efalia-compose/mapping-suite/onyx-server/utilisation/conversion-de-documents.md). # Conversion de documents ## Méthodes de conversion Le principe de base des conversions consiste à utiliser le format pivot Mapping XPS. Cela veut dire qu’un fichier en entrée est converti dans le format Mapping XPS, puis dans son format cible en sortie dans un deuxième temps. 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 : [Profils de conversion](https://docs.mappingsuite.com/wiki/ONYX:9.0:Utilisation:Convertisseurs_de_sortie#Le_fichier_de_configuration_:_XPSCONFIG.CONF) ## Reprise de documents en entrée Le principe est de reprendre, en entrée d’ONYX Server, des documents déjà composés ou existants en les convertissant dans le format pivot XPS pour leur prise en charge et leurs traitements futurs. Les commutateurs, pour réaliser ces conversions, sont de la forme : `-fromXXX`. Les langages d’entrée supportés dans ONYX Server sont : AFP, ESCP, IGP, Image (BMP, JPG, PNG et TIFF), PCL, PDF, PS, SCS, TXT, Xerox, XPS, ZEBRA (ou ZPL), TEC Exemples : ``` map_xps -infile:/tmp/invoice.pcl -fromPCL -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/invoice.pdf -fromPDF -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/invoice.afp -fromAFP -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/invoice.igp -fromIGP -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/invoice.zpl -fromZPL -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/invoice.ps -fromPS -outfile:/tmp/invoice.xps -toXPS ``` ``` map_xps -infile:/tmp/image.jpg -fromImage -outfile:/tmp/image.xps -toXPS -profile:fromJPEG ``` Ces conversions peuvent en outre être affinées en utilisant un profil défini dans le fichier de configuration. ## 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 :`-toXXX`. 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 ⇒ 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 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 `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 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://documentation.efalia.com/documentations/efalia-compose/mapping-suite/onyx-server/utilisation/conversion-de-documents.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.