Guide de déploiement d'applications FormPublisher
Exports PDF
Les données et documents traités par les applications FormPublisher peuvent être exportés au format PDF. FormPublisher produit des PDF à travers le processeur FOp ou des services tiers.
FOp v1.0 est installé avec FormPublisher Factory pour être directement utilisable avec FormPublisher Studio. En production, FOp doit être installé à disposition des applications déployées. Voici comment configurer FOp pour utiliser des polices de caractères particulières, par exemple pour afficher des caractères non latins. Cette configuration est nécessaire pour tout projet nécessitant des caractères spéciaux non compris dans la font de base Helvetica.
Fichier de configuration de FOp
Le fichier de configuration de FOP se trouve dans le répertoire conf du repertoire fop-1.0 se nomme fop.xconf. C'est un fichier XML. Pour définir une configuration personnalisée, il faut créer une copie de ce fichier, par exemple /opt/confs/myFop.xconf
FOp peut détecter les polices installées sur la machine, pour activer cette fonctionnalité il faut ajouter l'élément vide <auto-detect/> sous la balise <fonts>
Attention toutefois à respecter rigoureusement le nom des polices dans la cssPDF.
Paramétrage des fichiers métriques
Il est également possible d'ajouter de nouvelles fonts en créant des fichiers métriques. La procédure suivante concerne les polices TrueType, veuillez vous référer à la documentation officielle de FOp pour tout autre type de police.
FOP comprend TTFReader, qui lit les fichiers TTF et génère un fichier de paramètres : un fichier métrique exprimé en XML.
Pour générer ce fichier métrique, exécuter la commande suivante, à partir du répertoire d'installation de FOp :
java -cp build\fop.jar;lib\avalon-framework-4.2.0.jar;lib\commons-logging-1.0.4.jar;lib\commons-io-1.3.1.jar;lib\xmlgraphics-commons-1.4.jar org.apache.fop.fonts.apps.TTFReader C:\Windows\Fonts\ARIALN.TTF C:\MyMetrics\arialNarrow.xml
Le répertoire résultat, ici C:\MyMetrics, doit exister au moment de l'exécution de la commande.
Renouveler l'opération pour toutes les composantes de la Font (bold, italic, etc)
Déclaration des polices dans le fichier de configuration
Les nouvelles polices sont déclarées dans le fichier de configuration (dans la copie créée précédemment, exemple /opt/confs/myFop.xconf). Ajouter un élément pour chaque composant de la police (bold, italic, etc) en précisant le fichier métrique et éventuellement le fichier TTF si on souhaite embarquer la police dans le PDF.
Exemple pour la police "arial" ordinaire :
<font metrics-url="C:\temp\arial.xml" kerning="yes" embed-url="file:///C:\Windows\Fonts\arial.ttf">
<font-triplet name="Arial" style="normal" weight="normal"/>
</font>
Autres exemples :
<font embed-url="file:///D:/JWAY/FOP/Font/ARIALN.TTF " kerning="yes" metrics-url="file:///D:/JWAY/FOP/Font/arialNarrow.xml">
<font-triplet name="ArialNarrow" style="normal" weight="normal"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/Font/ARIALNB.TTF " kerning="yes" metrics-url="file:///D:/JWAY/FOP/Font/arialNarrowBold.xml">
<font-triplet name="ArialNarrow" style="normal" weight="bold"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/Font/ARIALNBI.TTF " kerning="yes" metrics-url="file:///D:/JWAY/FOP/Font/arialNarrowBoldItalic.xml">
<font-triplet name="ArialNarrow" style="italic" weight="bold"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/Font/ARIALNI.TTF " kerning="yes" metrics-url="file:///D:/JWAY/FOP/Font/arialNarrowItalic.xml">
<font-triplet name="ArialNarrow" style="italic" weight="normal"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/MyMetrics/arial.ttf " kerning="yes" metrics-url="file:///D:/JWAY/FOP/MyMetrics/arial.xml">
<font-triplet name="Arial" style="normal" weight="normal"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/MyMetrics/ariali.ttf " kerning="yes" metrics-url="file:///D:/JWAY/FOP/MyMetrics/ariali.xml">
<font-triplet name="Arial" style="italic" weight="normal"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/MyMetrics/arialbi.ttf " kerning="yes" metrics-url="file:///D:/JWAY/FOP/MyMetrics/arialbi.xml">
<font-triplet name="Arial" style="italic" weight="bold"/>
</font>
<font embed-url="file:///D:/JWAY/FOP/MyMetrics/arialbd.ttf " kerning="yes" metrics-url="file:///D:/JWAY/FOP/MyMetrics/arialbd.xml">
<font-triplet name="Arial" style="normal" weight="bold"/>
</font>
Commande d'exécution de FOp
La configuration personnalisée doit être déclarée dans la ligne de commande de FOp pour être prise en compte.
Editer le fichier de configuration de FormPublisher, formPublisherConfig.properties pour ajouter l'option :
jway_pdfCommandLine="c:\\softs\\jway\\formPublisher2.1\\fop-1.0\\fop.bat" -c "C:\\Users\\user\\.jway\\fop.xconf" -fo %i -pdf %o
Le fichier de configuration pointé dans cet exemple est situé dans le dossier ".jway" de l'utilisateur faisant fonctionner le serveur d'application.