Généralité du XPSConfig

==Le fichier de configuration : XPSCONFIG.CONF==


===Définition===
Toutes les conversions du format pivot XPS vers les langages de destination sont gérées nativement dans le moteur. Elles sont définies et affinées par différents profils de conversion entièrement paramétrables et stockés dans un fichier de configuration appelé XPSConfig.conf.
Physiquement, ce fichier se trouve dans le dossier défini par la variable de configuration XPSCONFIG.

Exemple sur Windows:
 [XPSCONFIG]	C:\Program Files\M-Processing Server\Settings\XPSConfig.conf

Exemple sur Linux :
 [XPSCONFIG]	/apps/mapping/conf/XPSConfig.conf

===Structure et syntaxe===

La structure générale du fichier XPSConfig.conf est basée sur la syntaxe XML :

 <xpsconfig>
   <nom_du_profil_1>
          <param_1>valeur</param_1>
          <param_2>valeur</param_2>
          <param_3>valeur</param_3>
           …
    </nom_du_profil_1>
    <nom_du_profil_2>
            <param_1>valeur</param_1>
            <param_2>valeur</param_2>
            …
    </nom_du_profil_2>
            …
 </xpsconfig>

Autant de profils de conversion que nécessaire peuvent être déclarés en fonction des différents canaux d’entrée / sortie des documents de production. Chaque profil doit avoir un nom unique qui sera utilisé par le Spooler Mapping ou en ligne de commande pour identifier le bon profil de conversion. Pour chaque profil sont renseignés tous les paramètres utiles permettant d’effectuer la conversion, de l’affiner et de l’optimiser.


Important:

Toutes les informations contenues dans ce fichier de configuration sont sensibles à la casse : nom des différents profils, noms et valeurs des paramètres.


Remarque:

Tous les paramètres documentés ci-après sont également utilisables en ligne de commande et peuvent être surchargés lors de l’appel à une commande <FONT color="blue"> map_xps </FONT> de conversion. La syntaxe d’appel d’un paramètre en particulier est alors : <code>-param:nom_parametre=valeur</code>.

===Les paramètres génériques===

Certains paramètres sont génériques et peuvent être utilisés dans tous les profils quel que soit le langage de conversion.


====Langage====

Ce premier paramètre est requis pour tous les profils. Il définit le langage de sortie de la conversion. 
La syntaxe dans le profil est :<code><language>PCL</language></code>

Voici la liste de tous les formats de sortie supportés par ONYX Server :

*XPS (langage par défaut si non précisé dans le profil)
*Langages d’impression :

PCL		&emsp;	         ZEBRA

AFPDS		&emsp;	         IGP

PS (PostScript) &emsp;           TEC

PROPRINTER	&emsp;	         EPL

ESCP		&emsp;	         MONARCH

XMLPOS		&emsp;           DPL (Datamax)

DB4

*Langages web :

HTML		&emsp;	RTF

PDF		&emsp;  DOCX

TXT

*Sorties ONYX Server :

MAPDRAW (utilisé pour l’importation de ressources XPS dans M-Designer)

*Sorties Image :

IMAGE

BMP


====Label====

Ce paramètre, optionnel, permet de donner une description utilisateur au profil. Cette description sera notamment utilisée dans le Spooler ONYX Server pour la configuration des files d’attentes d’impression (paramètre de compatibilité XPS).

La syntaxe dans le profil est :<code><label>Impression PCL5 en noir et blanc</label></code>


====Couleur====

Ce paramètre, optionnel, permet d’activer ou de désactiver la conversion en couleur pour les destinations qui le supportent. Lorsque ce paramètre n’est pas renseigné dans le profil, le principe est de respecter une conversion fidèle au document XPS original. Ainsi, pour les destinations qui le supportent, la conversion en couleur est activée par défaut.

La syntaxe dans le profil est :<code> <color>on</color></code>

<u>Valeurs supportées</u> : ON/OFF, on/off, YES/NO, yes/no, 0/1

<u>Valeur par défaut</u> : ON, sauf pour le langage AFPDS.

Pour les langages qui le supportent, les profils de couleurs ICC (International Color Consortium) sont également supportés, avec la syntaxe :<code><outputICC>chemin_du_fichier_ICC</outputICC></code>


====Page de code====

Ce paramètre, optionnel, permet de définir la page de code en sortie pour les destinations qui le supportent.
La syntaxe dans le profil est :<code><codepage>850</codepage></code>

<u>Valeurs supportées</u> : dépendant du langage de sortie

<u>Valeur par défaut</u>: dépendant du langage de sortie


====Résolution====

Ce paramètre, optionnel, permet de définir la résolution de sortie du document exprimée en dpi (dots per inch).
La syntaxe dans le profil est :<resolution>240</resolution>

<u>Valeurs supportées</u> : 200, 300 , 600 ....

<u>Valeur par défaut</u> : celle du langage de sortie défini


Pour les destinations qui le supportent, la résolution (en dpi) des images du document peut également être précisée avec la syntaxe :<code><resolutionimage>240</resolutionimage></code>

<u>Valeurs supportées</u> : 203, 300, 600…

<u>Valeur par défaut</u> : celle du langage de sortie défini


====Rotation====

Ce paramètre, optionnel, permet de définir l’angle de rotation des pages en sortie. La syntaxe dans le profil est :<code><pagerotation>90</pagerotation></code>

<u>Valeurs supportées</u> : 0, 90, 180, 270

<u>Valeur par défaut</u> : 0 (pas de rotation)


====Format de papier====

Ce paramètre, optionnel, permet de modifier le format des pages en sortie. La taille des pages ainsi que le contenu seront recalculés.
La syntaxe dans le profil est :<code><changeformat>Letter</changeformat></code>

<u>Valeurs standards ISO supportées</u> : A2, A3, A3 Extra, A4, A4 Plus, A4 Extra, A5, A5 Extra, A6, B4, B5, B5 Extra, B6, Envelope #9, Envelope #10, Envelope #11, Envelope #12, Envelope #14, Envelope B4, Envelope B5, Envelope B6, Envelope C3, Envelope C4, Envelope C5, Envelope C6, Envelope C65, Envelope DL, Envelope Invite, Envelope Monarch, Envelope, Executive, Folio, German Legal Fanfold, German Std Fanfold, Japanese Postcard, Japanese Double Postcard, Ledger, Legal, Legal Extra, Letter, Letter Extra, Letter Plus, Letter Small, Note,PRC 16K, PRC 32K, PRC 32K(Big), PRC Envelope #1, PRC Envelope #2, PRC Envelope #3, PRC Envelope #4, PRC Envelope #5, PRC Envelope #6, PRC Envelope #7, PRC Envelope #8, PRC Envelope #9, PRC Envelope #10, Quarto, Statement, SuperA, SuperB, Tabloid, Tabloid Extra, US Std Fanfold.


Les valeurs personnalisées sont également supportées, avec la syntaxe :<code><changeformat>xx.xx,xx.xx[,cm|in|mm]</changeformat></code>

*deux valeurs décimales, séparées par une virgule correspondant respectivement à largeur et hauteur
*Le séparateur de décimale est le ‘.’
*L’unité est optionnelle : cm (par défaut), mm ou in (pour inch)


====Sortie image====

Ce paramètre, optionnel, permet une conversion en mode image, pour les langages qui le supporte. La taille des flux n’est pas optimale mais le rendu de tous les éléments est ainsi garanti.
La syntaxe dans le profil est :<code><fullimage>on</fullimage></code>


<u>Valeurs supportées</u> : ON/OFF, on/off, YES/NO, yes/no, 0/1

<u>Valeur par défaut</u> : off


====Intervalle entre 2 étiquettes==== 

Ce paramètre, optionnel, permet de définir, pour les langages thermiques, l’écart entre deux étiquettes. La valeur est exprimée en points. La syntaxe dans le profil est :<code><gap>24</gap></code>


====Décalage de la page====

Ces paramètres, optionnels, permettent de décaler l’ensemble des pages d’un document sans en modifier les marges. Les valeurs sont exprimées en 96dpi et sont décimales. La syntaxe dans le profil est :
 <XpsTopOffset>10.2</XpsTopOffset>
 <XpsLeftOffset>8.1</XpsLeftOffset>


====Qualité du redimensionnement des images====

Ce paramètre, optionnel, permet d’améliorer la qualité du redimensionnement des images afin de le rendre plus précis. La syntaxe dans le profil est :<code><precisemode>on</precisemode></code>


<u>Valeurs supportées</u> : ON/OFF, on/off, YES/NO, yes/no, 0/1

<u>Valeur par défaut</u> : off


===Gestion des polices de caractères===

Le document XPS contient l’ensemble des ressources nécessaires à son affichage incluant, en particulier, les polices de caractères utilisées au format ODTTF. En conversion vers un langage de sortie, le choix est possible, d’embarquer ou non, les polices dans le flux. Ce choix dépendra des langages et du matériel d’impression.


====Polices embarquées====

Ce paramètre, optionnel, permet d’activer ou de désactiver l’incorporation des polices dans le document final. Lorsque ce paramètre est activé, les polices utilisées dans le document XPS seront embarquées dans le flux de sortie et donc envoyées à l’imprimante. Sinon, les polices résidentes de l’imprimante seront utilisées pour l’impression. Lorsque ce paramètre n’est pas renseigné, il est activé par défaut.La syntaxe dans le profil est :<code><embeddedfont>ON</embeddedfont></code>


<u>Valeurs supportées</u> : ON/OFF

<u>Valeur par défaut</u> : ON (sauf pour les langages AFPDS, PS et RTF)

Lorsque ce paramètre est désactivé, un autre paramètre permet de forcer l’utilisation d’une police résidente par défaut pour toute police XPS non déclarée (voir ci-après). La syntaxe dans le profil est :<code><defaultfont>1</defaultfont></code>


<u>Valeurs supportées</u> : de 1 à n, identifiant le numéro de la correspondance de police à utiliser par défaut dans le profil.

<u>Valeur par défaut</u> : 1

====Polices résidentes====

Lorsque le paramètre précédent est désactivé, il est nécessaire de prévoir la correspondance entre les polices du document XPS et celles à utiliser sur l’imprimante. Cette table de correspondance se construit dans le profil avec la syntaxe suivante :
 <nowiki><fonts>
          <font name="Arial" size="10" height="100" italic="0" bold="0" zoomx="1" zoomy="1" codeFont="4" />
          <font name="Tahoma" size="10" height="100" italic="0" bold="0" zoomx="1" zoomy="1" codeFont="A" />
          …
          </fonts></nowiki>


Dans cette table, entre un et cinq paramètres servent pour identifier les polices XPS :

*name = nom de la police XPS (requis)
*size = taille en points de la police (optionnel)
*height = hauteur ou déformation verticale en pourcentage (optionnel)
*italic = police en italique ou non (optionnel)
*bold = police en gras ou non (optionnel)

Puis entre un et cinq paramètres servent à identifier la police résidente qui doit être appelée :

*codeFont = numéro de la police résidente à utiliser pour l’impression (requis). Les valeurs dépendent du langage d’impression et du modèle d’imprimante et sont généralement donnés par le constructeur de l’imprimante.


Exemples : 

-	pour une imprimante Zebra, les valeurs vont de A à Z, ou de 1 à 9

-	pour une imprimante Eltron, les valeurs vont de 1 à 5

*zoomx = facteur de multiplication de taille en largeur (optionnel)
*zoomy = facteur de multiplication de taille en hauteur (optionnel)
*type = type de police résidente (bitmap ou vectorielle) en langage TEC (optionnel)
*fgid = identifiant de police AFP (optionnel)


===Gestion des codes-barres 1D===

Les codes-barres 1D étant également rendus par des polices de caractères, le même choix que précédemment est possible en fonction des langages et du matériel d’impression.


====Code barres embarqué ou résident====

Ce paramètre, optionnel, permet, pour les langages thermiques et l’AFPDS, d’activer ou de désactiver le rendu des codes-barres 1D par les imprimantes elles-mêmes. Lorsque ce paramètre est activé, l’impression des codes-barres est gérée par l’imprimante en utilisant ses polices résidentes. Sinon, les polices utilisées dans le document XPS seront embarquées dans le flux et donc envoyées à l’imprimante. Lorsque ce paramètre n’est pas renseigné, il est activé par défaut.

La syntaxe dans le profil est :<code><barcode>PRINTER</barcode></code>

<u>Valeurs supportées</u> : IMG, FONT, PRINTER

<u>Valeur par défaut</u> : PRINTER

IMG : embarqué sous forme d'image
FONT : embarqué sous forme de police
PRINTER : le code barre est généré par l'imprimante

====Rendu imprimante====

Lorsque le paramètre précédent est activé, il est nécessaire de prévoir la correspondance entre les polices du document XPS et celles à utiliser sur l’imprimante. Cette table de correspondance se construit dans le profil avec la syntaxe suivante :
 <barcodes>
 <barcode type="21" size="35" height="200" bcheight="40" bcwidth="A,B" />
 …
 </barcodes>


Dans cette table, trois paramètres servent pour identifier les polices XPS :

*type = type du code-barres (voir tableau ci-après)
*size = taille en points de la police
*height = hauteur ou déformation verticale en pourcentage


Puis deux paramètres servent à personnaliser les dimensions physiques d’un code-barres à l’impression :

*bcheight = hauteur désirée du code-barres (en points)
*bcwidth = largeur désirée du code-barres en précisant par exemple la largeur d’un élément fin et le ratio entre élément fin et épais

La syntaxe et les valeurs de ces deux paramètres dépendent du langage final d’impression et du type de code barre. Liste des codes à barres supportés par ONYX Server, avec leur type :

{| class="wikitable"
|-
|2||PDF 417
|-
|11||Data Matrix
|-
|12||QR Code
|-
|14||MaxiCode
|-
|17||EAN 13
|-
|18||EAN 8
|-
|19||Code 39
|-
|20||Code 39 sans contrôle
|-
|21||Code 128 alpha optimisé
|-
|22||Code 128 alpha non optimisé
|-
|23||Code 128 numérique
|-
|24||2 Parmi 5 Entrelacé
|-
|25||2 Parmi 5 Entrelacé sans contrôle
|-
|26||2 Parmi 5 Industriel
|-
|27||2 Parmi 5 Industriel sans contrôle
|-
|28||EAN 128 alpha non optimisé
|-
|29||EAN 128 numérique
|-
|30||EAN 128 alpha optimisé
|-
|31||Postnet
|-
|32||Planet
|-
|35||Native
|-
|77||Japan Postal
|-
|78||Codabar
|-
|79||USPS
|-
|80||UPC-A
|-
|81||UPC-E
|-
|82||MSI
|-
|83||MSI 2 mod. 10
|-
|84||MSI mod. 11
|-
|85||MSI mod. 11 mod. 10
|-
|86||MSI no check
|}