Commande PDF Transformation (-PDF

La commande -PDF permet à la mappe de transformer les données de mappe au format XML en données PDF à l’aide de la règle de mappe GET. PUT reçoit les données de mappe au format XML et les transforme en données PDF formatées. Cette commande donne la même autorisation que GET, de sorte qu’elle peut renvoyer des données PDF vers la mappe, en effectuant une transformation en mémoire. Les données de format XML doivent être conformes à l'importateur PDF généré, schéma XML natif, pour le document PDF correspondant.

Cette commande est utile dans les environnements où l’accès au système de fichiers est restreint aux utilisateurs. Les transformations PDF doivent être exécutées en mémoire, puis la sortie transformée doit être renvoyée à la mappe pour un traitement ultérieur. Un flux de données PDF est transmis à la mappe à l'aide de GET :

=GET("PDF","-PDF -NAMES memory://<names-document-id> -TEMPLATE memory://<template-document-id>",<xml-map-data>)

Un modèle doit être ajouté à la mémoire, s’il ne s’agit pas d’un fichier distant, à l’aide de la commande -ADOC lors de la transformation en mémoire de données au format XML en données au format PDF. La commande -ADOC renvoie un ID de document spécifié par l’utilisateur ou un ID système pour le modèle.
Remarque : Le document en mémoire est référencé comme suit : memory://
Ce processus en trois étapes est présenté ici :
  • template-document-id=GET("PDF","-ADOC",<template-file-data-as-stream>) ou =GET("PDF","-ADOC <my-template-documentid>",<template-file-data-as-stream>)
  • names-document-id=GET("PDF","-ADOC",<names-file-data-as-stream>) ou =GET("PDF","-ADOC <my-names-documentid>",<names-file-data-as-stream>)
  • pdf-data-out=GET("PDF,"-PDF -NAMES memory://<names-document-id> -TEMPLATE memory://<template-document-id>",<xml-map-data>)

Si vous devez spécifier -SCHEMA (ou -S), vous pouvez le faire aussi pour les fichiers de schéma.

Stockage du document de sortie en mémoire

Sans la commande -PDF, au lieu de transmettre à une mappe, l’opération de sortie peut conserver le document de sortie en mémoire jusqu’à ce qu’il soit extrait avec l'option -GDOC. Il s'agit d'un processus en deux étapes :
  • =PUT("PDF","-URL memory://<my-output-doc-id> -NAMES memory://<names-document-id> -TEMPLATE memory://<template-document-id>",<xml-map-data>) ou la ligne de commande de l’adaptateur peut être utilisée avec la carte de sortie.
  • pdf-data-out=GET("PDF","-GDOC <my-output-doc-id>")

URL de fichier par défaut

Il est nécessaire de spécifier memory:// pour les documents en mémoire, http:// pour les documents distants ou file:/// pour les documents du système de fichiers local à l’aide des commandes -URL (-U), -NAMES (-N), -SCHEMA (-S) et -TEMPLATE (-P).

Référencer des données XML

-URL memory://<xml-data-document-id> peut être spécifié. Les données XML sont en mémoire et peuvent être référencées au lieu de transmettre des données de mappe en tant que troisième paramètre de GET. Le troisième paramètre est prioritaire sur l'option -URL.