Cette macro représente la balise <fox:external-document> (cliquez ici pour plus de détails).
Elle produit en sortie <fox:external-document src="…" /> (cf. https://xmlgraphics.apache.org/fop/fop-pdf-images.html)
Cette balise permet d'insérer le contenu d'un document externe au format PDF à l'intérieur du document produit. Pour l'utiliser, il est nécessaire de définir l'espace de nom XML "xmlns:fox" dans le template APE comme suit :
<@hardisFo.foRoot xmlns\:fox="http://xmlgraphics.apache.org/fop/extensions">
Attention :
Dans un template, cette balise doit être fille de la balise hardisFo.foRoot (donc se trouver au même niveau que les balises hardisFo.foPageSequence).
Il est possible d'insérer une seule page d'un document PDF : pour cela, l'attribut src de la balise doit contenir une URL définissant le document externe et se terminant par "#page=XXX" où XXX représente le numéro de la page dans ce document.
Directive vide : Oui
Paramètres
String |
src |
Caractère alphanumérique d'URI vers un document |
Obligatoire |
Cette macro peut aussi avoir des paramètres optionnels (voir la spécification de la balise associée).
Par exemple
<#-- Inclure un document PDF se trouvant dans le sous-répertoire data du répertoire contenant le template principal -->
<@hardisFo.foxExternalDocument contentType="pdf" src=hardisCore.templateResToBase64DataURI("data/sample_pdf_doc.pdf", "main", "application/pdf")/>
<#-- Inclure un document PDF se trouvant dans le répertoire c:\data -->
<@hardisFo.foxExternalDocument contentType="pdf" src="url(file:///C:/data/sample_pdf_doc.pdf)"/>
<#-- Inclure la troisième page du document PDF défini par cette URL d'exemple -->
<@hardisFo.foxExternalDocument content-type="pdf" src="https://file-examples.com/wp-content/uploads/2017/10/file-example_PDF_500_kB.pdf#page=3"/>