Forms Data Format
FDF
&reftitle.intro;
Forms Data Format (FDF) est un format de formulaire pour les documents
PDF. Vous pouvez lire la documentation (en anglais) à
&spec.pdf.fdf;
pour plus de détails sur les tenants et les aboutissants.
L'esprit de FDF est similaire à celui des formulaires HTML. Les
différences résident dans les moyens de transmission des
données au serveur, lorsque le bouton "submit" (soumettre) est
pressé (ce qui est du ressort de Form Data Format) et le format de
formulaire lui-même (qui est plutôt du ressort de Portable Document
Format, PDF). Gérer des données FDF est un des objectifs des
fonctions FDF. Mais il y en a d'autres. Vous pouvez aussi prendre un
formulaire PDF, et pré-remplir les champs, sans modifier le
formulaire lui-même. Dans ce cas, on va créer un document FDF
(fdf_create), remplir les champs
(fdf_set_value) et l'associer à un fichier PDF
(fdf_set_file). Finalement, le tout sera envoyé
au client, avec le type MIME application/vnd.fdf. Le module "Acrobat reader"
de votre navigateur va reconnaître ce type MIME, et lire le fichier
PDF, puis le remplir avec FDF.
Si vous éditez un fichier FDF avec un éditeur de texte, vous trouverez
un catalogue d'objet avec le nom de FDF. Cet objet
peut contenir des entrées telles que Fields,
F, Status etc.
Les entrées les plus couramment utilisées sont
Fields, qui indique une liste de champs de contrôle,
et F qui contient le nom du fichier PDF a qui
appartiennent ces données. Ces entrées sont désignées dans la documentation
PDF sous le nom de /F-Key ou /Status-Key.
La modification de ces entrées est possible avec les fonctions
fdf_set_file et fdf_set_status.
Les champs sont modifiables avec les fonctions
fdf_set_value, fdf_set_opt etc.
&reftitle.required;
Vous aurez besoin du FDF toolkit SDK, disponible sur le site
&spec.pdf.fdf;.
Depuis &php; 4.3, vous aurez besoin du SDK version 5.0.
La bibliothèque FDF toolkit est disponible sous forme de bibliothèque
compilée, éditée par Adobe, sur les systèmes d'exploitation Win32,
Linux, Solaris et AIX.
&reference.fdf.configure;
&reftitle.runtime;
&no.config;
&reftitle.resources;
fdf
La plupart des fonctions FDF nécessite une ressource de type
fdf comme premier argument. Une ressource
fdf est une structure qui représente un
fichier FDF ouvert. Vous pouvez créer des ressources fdf
avec les fonctions fdf_create,
fdf_open et fdf_open_string.
&reference.fdf.constants;
&reftitle.examples;
Les exemples suivants montrent comment évaluer les données
du formulaire.
Evaluer un document FDF
' . $volume . '"
';
$date = fdf_get_value($fdf, "date");
echo 'La valeur du champ date était "' . $date . '"
';
$comment = fdf_get_value($fdf, "comment");
echo 'La valeur du champ comment était "' . $comment . '"
";
if (fdf_get_value($fdf, "show_publisher") == "On") {
$publisher = fdf_get_value($fdf, "publisher");
echo 'La valeur du champ Publisher était : "' . $publisher . '"
";
} else
echo 'La valeur du champ Publisher ne doit pas être affichée.
';
if (fdf_get_value($fdf, "show_preparer") == "On") {
$preparer = fdf_get_value($fdf, "preparer");
echo 'La valeur du champ Preparer était "' . $preparer . '"
';
} else
echo 'La valeur du champ Preparer ne doit pas être affiché.
';
fdf_close($fdf);
?>
]]>
&reference.fdf.functions;