cvs: phpdoc-de /reference/fdf book.xml constants.xml examples.xml reference.xml setup.xml
| From: | Hartmut Holzgraefe | Date: | Thu, 06 Mar 2008 07:03:27 +0000 |
| Subject: | cvs: phpdoc-de /reference/fdf book.xml constants.xml examples.xml reference.xml setup.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2433@lists.php.net to get a copy of this message | ||
hholzgra Thu Mar 6 07:03:27 2008 UTC
Added files:
/phpdoc-de/reference/fdf book.xml constants.xml examples.xml
setup.xml
Modified files:
/phpdoc-de/reference/fdf reference.xml
Log:
file structure change
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/reference.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/fdf/reference.xml diff -u phpdoc-de/reference/fdf/reference.xml:1.7 phpdoc-de/reference/fdf/reference.xml:1.8 --- phpdoc-de/reference/fdf/reference.xml:1.7 Thu Mar 6 06:55:57 2008 +++ phpdoc-de/reference/fdf/reference.xml Thu Mar 6 07:03:26 2008 @@ -1,154 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.13 Maintainer: sts Status: ready --> -<!-- Purpose: utilspec.nontext --> -<!-- Membership: bundled, external --> - <reference xml:id="ref.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Forms Data Format Funktionen</title> - <titleabbrev>FDF</titleabbrev> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.14 Maintainer: sts Status: ready --> +<reference xml:id="ref.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>FDF &Functions;</title> + <titleabbrev>FDF</titleabbrev> - <partintro> - <section xml:id="fdf.intro"> - &reftitle.intro; - <simpara> - Forms Data Format (FDF) ist ein Format zur Verarbeitung von - Formularen innerhalb von PDF Dokumenten. Weiterführende - Informationen zu FDF und dessen Verwendung sind unter <link - xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> zu finden. - </simpara> - <simpara> - Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher - HTML Formulare. Die wesentlichen Unterschiede liegen in der - Übertragung der Daten nach Absenden des Formulars (dies ist das - eigentliche Form Data Format), sowie in dem Format des Dokuments - welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten - ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. - Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen - PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne - das Formular selbst zu verändern. Hierzu erzeugt man das FDF - Dokument (<function>fdf_create</function>), setzt die Werte der - jeweiligen Input Felder (<function>fdf_set_value</function>) und - verbindet es mit dem jeweiligen PDF Formular - (<function>fdf_set_file</function>). Nachdem man das FDF - Dokument, mit dem passenden MimeType - <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, - erkennt das Acrobat Reader PlugIn des Browsers den MimeType und - füllt das Zielformular mit den Daten des FDF Dokuments. - </simpara> + &reference.fdf.entities.functions; - <simpara> - Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich - dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann - mehrere Einträge der Art <literal>Fields</literal>, - <literal>F</literal>, <literal>Status</literal> etc.. - enthalten. Die gebräuchlichsten Einträge sind - <literal>Fields</literal>, welches zu einer Anzahl von Input - Feldern verweist, sowie <literal>F</literal> das den Dateinamen - des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich - in der FDF Dokumentation unter /F-Key oder /Status-Key. - Modifikationen dieser Einträge werden mit Hilfe der Funktionen - <function>fdf_set_file</function> und - <function>fdf_set_status</function> vorgenommen. Felder werden - u.a. mit <function>fdf_set_value</function>, - <function>fdf_set_opt</function> modifiziert. - </simpara> - </section> +</reference> - <section xml:id="fdf.requirements"> - &reftitle.required; - <para> - Benötigt wird das FDF-Toolkit-SDK, welches unter - <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> - heruntergeladen werden kann. - Ab PHP-Version 4.3.0 ist mindestens die Version 5.0 - des FDF-SDKs erforderlich. - Die FDF-Toolkit Bibliothek steht ausschließlich vorkompiliert - zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, - Solaris und AIX. - </para> - </section> - - &reference.fdf.configure; - - <section xml:id="fdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="fdf.resources"> - &reftitle.resources; - <section xml:id="fdf.resources.fdf"> - <title>fdf</title> - <para> - Die meisten FDF-Funktionen benötigen an erster Stelle einen - <parameter>fdf</parameter> Ressource-Parameter. - Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf - eine geöffnete FDF-Datei. - <parameter>fdf</parameter> Ressource-Parameter werden von den - Funktionen <function>fdf_create</function>, - <function>fdf_open</function> und <function>fdf_open_string</function> - zurückgegeben. - </para> - </section> - </section> - - &reference.fdf.constants; - - <section xml:id="fdf.examples"> - &reftitle.examples; - <para> - Das Beispiel zeigt die Auswertung der Formular Daten. - <example> - <title>Auswertung eines FDF_Dokuments</title> - <programlisting role="php"> -<![CDATA[ -<?php -// Speichern der FDF Daten in eine temporäre Datei -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Öffnen der temporären Datei und Auswertung der Daten -// Das PDF Formular enthält verschiedene Eingabefelder mit den zugehörigen Namen -// band, datum, kommentar, verleger, bearbeiter, sowie zwei Checkboxen -// zeige_verleger und zeige_bearbeiter. - -$fdf = fdf_open("test.fdf"); -$band = fdf_get_value($fdf, "band"); -echo "Das Feld Band hat den Wert '<b>$band</b>'<br />"; - -$datum = fdf_get_value($fdf, "datum"); -echo "Das Feld Datum hat den Wert '<b>$datum</b>'<br />"; - -$kommentar = fdf_get_value($fdf, "kommentar"); -echo "Das Feld Kommentar hat den Wert '<b>$kommentar</b>'<br />"; - -if (fdf_get_value($fdf, "zeige_verleger") == "On") { - $verleger = fdf_get_value($fdf, "verleger"); - echo "Das Feld Verleger hat den Wert '<b>$verleger</b>'<br />"; -} else { - echo "Verleger soll nicht angezeigt werden.<br />"; -} - -if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { - $bearbeiter = fdf_get_value($fdf, "bearbeiter"); - echo "Das Feld Bearbeiter hat den Wert '&<b>$bearbeiter</b>'<br />"; -} else { - echo "Bearbeiter soll nicht angezeigt werden.<br />"; -} -fdf_close($fdf); -?> -]]> - </programlisting> - </example> - </para> - </section> - </partintro> - -&reference.fdf.entities.functions; - - </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -170,5 +31,3 @@ vi: ts=1 sw=1 --> - - http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/book.xml +++ phpdoc-de/reference/fdf/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: bundled, external --> <book xml:id="book.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Forms Data Format &Functions;</title> <!-- {{{ preface --> <preface xml:id="intro.fdf"> &reftitle.intro; <simpara> Forms Data Format (FDF) ist ein Format zur Verarbeitung von Formularen innerhalb von PDF Dokumenten. Weiterführende Informationen zu FDF und dessen Verwendung sind unter <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> zu finden. </simpara> <simpara> Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher HTML Formulare. Die wesentlichen Unterschiede liegen in der Übertragung der Daten nach Absenden des Formulars (dies ist das eigentliche Form Data Format), sowie in dem Format des Dokuments welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne das Formular selbst zu verändern. Hierzu erzeugt man das FDF Dokument (<function>fdf_create</function>), setzt die Werte der jeweiligen Input Felder (<function>fdf_set_value</function>) und verbindet es mit dem jeweiligen PDF Formular (<function>fdf_set_file</function>). Nachdem man das FDF Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und füllt das Zielformular mit den Daten des FDF Dokuments. </simpara> <simpara> Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann mehrere Einträge der Art <literal>Fields</literal>, <literal>F</literal>, <literal>Status</literal> etc.. enthalten. Die gebräuchlichsten Einträge sind <literal>Fields</literal>, welches zu einer Anzahl von Input Feldern verweist, sowie <literal>F</literal> das den Dateinamen des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich in der FDF Dokumentation unter /F-Key oder /Status-Key. Modifikationen dieser Einträge werden mit Hilfe der Funktionen <function>fdf_set_file</function> und <function>fdf_set_status</function> vorgenommen. Felder werden u.a. mit <function>fdf_set_value</function>, <function>fdf_set_opt</function> modifiziert. </simpara> </preface> <!-- }}} --> &reference.fdf.setup; &reference.fdf.constants; &reference.fdf.examples; &reference.fdf.reference; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/constants.xml +++ phpdoc-de/reference/fdf/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: sts Status: ready --> <appendix xml:id="fdf.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>FDFValue</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFStatus</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFile</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFID</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFSetFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFClearFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFlags</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFSetF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFClrF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAS</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAction</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAA</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAPRef</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFIF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFEnter</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFExit</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFDown</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFUp</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFormat</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFValidate</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFKeystroke</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFCalculate</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFNormalAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFRolloverAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFDownAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/examples.xml +++ phpdoc-de/reference/fdf/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <chapter xml:id="fdf.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <para> Das folgende Beispiel zeigt die Auswertung der Formular Daten. <example> <title>Auswertung eines FDF_Dokuments</title> <programlisting role="php"> <![CDATA[ <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); fclose($fdffp); // Ãffnen der temporären Datei und Auswertung der Daten // Das PDF Formular enthält verschiedene Eingabefelder mit den zugehörigen Namen // band, datum, kommentar, verleger, bearbeiter, sowie zwei Checkboxen // zeige_verleger und zeige_bearbeiter. $fdf = fdf_open("test.fdf"); $band = fdf_get_value($fdf, "band"); echo "Das Feld Band hat den Wert '<b>$band</b>'<br />"; $datum = fdf_get_value($fdf, "datum"); echo "Das Feld Datum hat den Wert '<b>$datum</b>'<br />"; $kommentar = fdf_get_value($fdf, "kommentar"); echo "Das Feld Kommentar hat den Wert '<b>$kommentar</b>'<br />"; if (fdf_get_value($fdf, "zeige_verleger") == "On") { $verleger = fdf_get_value($fdf, "verleger"); echo "Das Feld Verleger hat den Wert '<b>$verleger</b>'<br />"; } else { echo "Verleger soll nicht angezeigt werden.<br />"; } if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { $bearbeiter = fdf_get_value($fdf, "bearbeiter"); echo "Das Feld Bearbeiter hat den Wert '&<b>$bearbeiter</b>'<br />"; } else { echo "Bearbeiter soll nicht angezeigt werden.<br />"; } fdf_close($fdf); ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/setup.xml +++ phpdoc-de/reference/fdf/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <chapter xml:id="fdf.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="fdf.requirements"> &reftitle.required; <para> Benötigt wird das FDF-Toolkit-SDK, welches unter <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> heruntergeladen werden kann. Ab PHP-Version 4.3.0 ist mindestens die Version 5.0 des FDF-SDKs erforderlich. Die FDF-Toolkit Bibliothek steht ausschlieÃlich vorkompiliert zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, Solaris und AIX. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.fdf.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="fdf.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="fdf.resources"> &reftitle.resources; <para> Die meisten FDF-Funktionen benötigen an erster Stelle einen <parameter>fdf</parameter> Ressource-Parameter. Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf eine geöffnete FDF-Datei. <parameter>fdf</parameter> Ressource-Parameter werden von den Funktionen <function>fdf_create</function>, <function>fdf_open</function> und <function>fdf_open_string</function> zurückgegeben. </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/reference.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/fdf/reference.xml diff -u phpdoc-de/reference/fdf/reference.xml:1.7 phpdoc-de/reference/fdf/reference.xml:1.8 --- phpdoc-de/reference/fdf/reference.xml:1.7 Thu Mar 6 06:55:57 2008 +++ phpdoc-de/reference/fdf/reference.xml Thu Mar 6 07:03:26 2008 @@ -1,154 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.13 Maintainer: sts Status: ready --> -<!-- Purpose: utilspec.nontext --> -<!-- Membership: bundled, external --> - <reference xml:id="ref.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Forms Data Format Funktionen</title> - <titleabbrev>FDF</titleabbrev> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.14 Maintainer: sts Status: ready --> +<reference xml:id="ref.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>FDF &Functions;</title> + <titleabbrev>FDF</titleabbrev> - <partintro> - <section xml:id="fdf.intro"> - &reftitle.intro; - <simpara> - Forms Data Format (FDF) ist ein Format zur Verarbeitung von - Formularen innerhalb von PDF Dokumenten. Weiterführende - Informationen zu FDF und dessen Verwendung sind unter <link - xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> zu finden. - </simpara> - <simpara> - Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher - HTML Formulare. Die wesentlichen Unterschiede liegen in der - Übertragung der Daten nach Absenden des Formulars (dies ist das - eigentliche Form Data Format), sowie in dem Format des Dokuments - welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten - ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. - Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen - PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne - das Formular selbst zu verändern. Hierzu erzeugt man das FDF - Dokument (<function>fdf_create</function>), setzt die Werte der - jeweiligen Input Felder (<function>fdf_set_value</function>) und - verbindet es mit dem jeweiligen PDF Formular - (<function>fdf_set_file</function>). Nachdem man das FDF - Dokument, mit dem passenden MimeType - <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, - erkennt das Acrobat Reader PlugIn des Browsers den MimeType und - füllt das Zielformular mit den Daten des FDF Dokuments. - </simpara> + &reference.fdf.entities.functions; - <simpara> - Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich - dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann - mehrere Einträge der Art <literal>Fields</literal>, - <literal>F</literal>, <literal>Status</literal> etc.. - enthalten. Die gebräuchlichsten Einträge sind - <literal>Fields</literal>, welches zu einer Anzahl von Input - Feldern verweist, sowie <literal>F</literal> das den Dateinamen - des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich - in der FDF Dokumentation unter /F-Key oder /Status-Key. - Modifikationen dieser Einträge werden mit Hilfe der Funktionen - <function>fdf_set_file</function> und - <function>fdf_set_status</function> vorgenommen. Felder werden - u.a. mit <function>fdf_set_value</function>, - <function>fdf_set_opt</function> modifiziert. - </simpara> - </section> +</reference> - <section xml:id="fdf.requirements"> - &reftitle.required; - <para> - Benötigt wird das FDF-Toolkit-SDK, welches unter - <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> - heruntergeladen werden kann. - Ab PHP-Version 4.3.0 ist mindestens die Version 5.0 - des FDF-SDKs erforderlich. - Die FDF-Toolkit Bibliothek steht ausschließlich vorkompiliert - zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, - Solaris und AIX. - </para> - </section> - - &reference.fdf.configure; - - <section xml:id="fdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="fdf.resources"> - &reftitle.resources; - <section xml:id="fdf.resources.fdf"> - <title>fdf</title> - <para> - Die meisten FDF-Funktionen benötigen an erster Stelle einen - <parameter>fdf</parameter> Ressource-Parameter. - Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf - eine geöffnete FDF-Datei. - <parameter>fdf</parameter> Ressource-Parameter werden von den - Funktionen <function>fdf_create</function>, - <function>fdf_open</function> und <function>fdf_open_string</function> - zurückgegeben. - </para> - </section> - </section> - - &reference.fdf.constants; - - <section xml:id="fdf.examples"> - &reftitle.examples; - <para> - Das Beispiel zeigt die Auswertung der Formular Daten. - <example> - <title>Auswertung eines FDF_Dokuments</title> - <programlisting role="php"> -<![CDATA[ -<?php -// Speichern der FDF Daten in eine temporäre Datei -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Öffnen der temporären Datei und Auswertung der Daten -// Das PDF Formular enthält verschiedene Eingabefelder mit den zugehörigen Namen -// band, datum, kommentar, verleger, bearbeiter, sowie zwei Checkboxen -// zeige_verleger und zeige_bearbeiter. - -$fdf = fdf_open("test.fdf"); -$band = fdf_get_value($fdf, "band"); -echo "Das Feld Band hat den Wert '<b>$band</b>'<br />"; - -$datum = fdf_get_value($fdf, "datum"); -echo "Das Feld Datum hat den Wert '<b>$datum</b>'<br />"; - -$kommentar = fdf_get_value($fdf, "kommentar"); -echo "Das Feld Kommentar hat den Wert '<b>$kommentar</b>'<br />"; - -if (fdf_get_value($fdf, "zeige_verleger") == "On") { - $verleger = fdf_get_value($fdf, "verleger"); - echo "Das Feld Verleger hat den Wert '<b>$verleger</b>'<br />"; -} else { - echo "Verleger soll nicht angezeigt werden.<br />"; -} - -if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { - $bearbeiter = fdf_get_value($fdf, "bearbeiter"); - echo "Das Feld Bearbeiter hat den Wert '&<b>$bearbeiter</b>'<br />"; -} else { - echo "Bearbeiter soll nicht angezeigt werden.<br />"; -} -fdf_close($fdf); -?> -]]> - </programlisting> - </example> - </para> - </section> - </partintro> - -&reference.fdf.entities.functions; - - </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -170,5 +31,3 @@ vi: ts=1 sw=1 --> - - http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/book.xml +++ phpdoc-de/reference/fdf/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: bundled, external --> <book xml:id="book.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Forms Data Format &Functions;</title> <!-- {{{ preface --> <preface xml:id="intro.fdf"> &reftitle.intro; <simpara> Forms Data Format (FDF) ist ein Format zur Verarbeitung von Formularen innerhalb von PDF Dokumenten. Weiterführende Informationen zu FDF und dessen Verwendung sind unter <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> zu finden. </simpara> <simpara> Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher HTML Formulare. Die wesentlichen Unterschiede liegen in der Übertragung der Daten nach Absenden des Formulars (dies ist das eigentliche Form Data Format), sowie in dem Format des Dokuments welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne das Formular selbst zu verändern. Hierzu erzeugt man das FDF Dokument (<function>fdf_create</function>), setzt die Werte der jeweiligen Input Felder (<function>fdf_set_value</function>) und verbindet es mit dem jeweiligen PDF Formular (<function>fdf_set_file</function>). Nachdem man das FDF Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und füllt das Zielformular mit den Daten des FDF Dokuments. </simpara> <simpara> Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann mehrere Einträge der Art <literal>Fields</literal>, <literal>F</literal>, <literal>Status</literal> etc.. enthalten. Die gebräuchlichsten Einträge sind <literal>Fields</literal>, welches zu einer Anzahl von Input Feldern verweist, sowie <literal>F</literal> das den Dateinamen des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich in der FDF Dokumentation unter /F-Key oder /Status-Key. Modifikationen dieser Einträge werden mit Hilfe der Funktionen <function>fdf_set_file</function> und <function>fdf_set_status</function> vorgenommen. Felder werden u.a. mit <function>fdf_set_value</function>, <function>fdf_set_opt</function> modifiziert. </simpara> </preface> <!-- }}} --> &reference.fdf.setup; &reference.fdf.constants; &reference.fdf.examples; &reference.fdf.reference; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/constants.xml +++ phpdoc-de/reference/fdf/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: sts Status: ready --> <appendix xml:id="fdf.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>FDFValue</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFStatus</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFile</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFID</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFSetFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFClearFf</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFlags</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFSetF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFClrF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAS</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAction</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAA</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFAPRef</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFIF</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFEnter</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFExit</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFDown</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFUp</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFFormat</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFValidate</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFKeystroke</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFCalculate</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFNormalAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFRolloverAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FDFDownAP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/examples.xml +++ phpdoc-de/reference/fdf/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <chapter xml:id="fdf.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <para> Das folgende Beispiel zeigt die Auswertung der Formular Daten. <example> <title>Auswertung eines FDF_Dokuments</title> <programlisting role="php"> <![CDATA[ <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); fclose($fdffp); // Ãffnen der temporären Datei und Auswertung der Daten // Das PDF Formular enthält verschiedene Eingabefelder mit den zugehörigen Namen // band, datum, kommentar, verleger, bearbeiter, sowie zwei Checkboxen // zeige_verleger und zeige_bearbeiter. $fdf = fdf_open("test.fdf"); $band = fdf_get_value($fdf, "band"); echo "Das Feld Band hat den Wert '<b>$band</b>'<br />"; $datum = fdf_get_value($fdf, "datum"); echo "Das Feld Datum hat den Wert '<b>$datum</b>'<br />"; $kommentar = fdf_get_value($fdf, "kommentar"); echo "Das Feld Kommentar hat den Wert '<b>$kommentar</b>'<br />"; if (fdf_get_value($fdf, "zeige_verleger") == "On") { $verleger = fdf_get_value($fdf, "verleger"); echo "Das Feld Verleger hat den Wert '<b>$verleger</b>'<br />"; } else { echo "Verleger soll nicht angezeigt werden.<br />"; } if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { $bearbeiter = fdf_get_value($fdf, "bearbeiter"); echo "Das Feld Bearbeiter hat den Wert '&<b>$bearbeiter</b>'<br />"; } else { echo "Bearbeiter soll nicht angezeigt werden.<br />"; } fdf_close($fdf); ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/fdf/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/fdf/setup.xml +++ phpdoc-de/reference/fdf/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <chapter xml:id="fdf.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="fdf.requirements"> &reftitle.required; <para> Benötigt wird das FDF-Toolkit-SDK, welches unter <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link> heruntergeladen werden kann. Ab PHP-Version 4.3.0 ist mindestens die Version 5.0 des FDF-SDKs erforderlich. Die FDF-Toolkit Bibliothek steht ausschlieÃlich vorkompiliert zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, Solaris und AIX. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.fdf.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="fdf.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="fdf.resources"> &reftitle.resources; <para> Die meisten FDF-Funktionen benötigen an erster Stelle einen <parameter>fdf</parameter> Ressource-Parameter. Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf eine geöffnete FDF-Datei. <parameter>fdf</parameter> Ressource-Parameter werden von den Funktionen <function>fdf_create</function>, <function>fdf_open</function> und <function>fdf_open_string</function> zurückgegeben. </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->