XVIII. Forms Data Format 関数

Forms Data Format (FDF) は、PDFドキュメント内部のフォームを処理する ためのフォーマットです。 FDFの詳細および一般的な用途については、http://partners.adobe.com/asn/developer/acrosdk/forms.html にあるドキュメントを参照下さい。

注意: 現在、Adobe は Linux 用 libc5 互換版のみを提供しています。 glibc2 でテストを行うとセグメント例外を生じます。 動作させることができた場合は、このページにコメントして下さい。

注意: fdftk サポートを有効にして php の configure を行う際に問題を発生した 場合、ヘッダーファイル FdfTk.h およびライブラリ libFdfTk.so が 正しい場所にあるかどうかを確認して下さい。これらは、それぞれ fdftk-dir/include および fdftk-dir/lib にある必要があります。 FdfTk の配布ファイルを単に解凍しただけだとしたら、このように はなりません。

FDFの基本的な考えは、HTMLフォームに似ています。 基本的な違いは、投稿ボタンが押された際に フォームに埋められたデータをサーバーに送信する方法の フォーマット(これがForm Data Format そのものです)および フォームのフォーマット自体(これは Portable Document Format、PDFです) です。FDFデータの処理は、fdf関数に提供された機能の一つです。 しかし機能は他にもあります。 既存のPDFフォームを用いてフォーム自体を修正せずに入力フィールドのデータを 入力させることもあるかと思われます、 このような場合、FDFドキュメント を作成(fdf_create)、 各入力フィールドの値を設定(fdf_set_value)、 PDFフォームとそれを関連付け(fdf_set_file)ます。 最後にブラウザに MIME型 application/vnd.fdf で送信する必要があります。 ブラウザの Acrobat Reader プラグイン がこの MIME 型を認識し、 関連する PDF フォームを読み込み、FDF ドキュメントからのデータを 書き込みます。

次の例でフォームデータの評価に関して説明します。

例 1. FDF ドキュメントの評価


<?php
// Save the FDF データをテンポラリファイルに保存します。
$fdffp = fopen("test.fdf", "w");
fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA));
fclose($fdffp);

// テンポラリファイルをオープンし、データを評価します。
// PDF フォームは、volume, date, comment, publisher, preparer という名前の
//テキスト入力フィールドと show_publisher および show_preparer
// というチェックボックスを有します。
$fdf = fdf_open("test.fdf");
$volume = fdf_get_value($fdf, "volume");
echo "volume フィールドは次の値を有します。 '<B>$volume</B>'<BR>";

$date = fdf_get_value($fdf, "date");
echo "date フィールドは次の値を有します。 '<B>$date</B>'<BR>";

$comment = fdf_get_value($fdf, "comment");
echo "comment フィールドは次の値を有します。 '<B>$comment</B>'<BR>";

if(fdf_get_value($fdf, "show_publisher") == "On") {
  $publisher = fdf_get_value($fdf, "publisher");
  echo "publisher フィールドは次の値を有します。 '<B>$publisher</B>'<BR>";
} else
  echo "publisher は、表示されません。<BR>";

if(fdf_get_value($fdf, "show_preparer") == "On") {
  $preparer = fdf_get_value($fdf, "preparer");
  echo "preparer フィールドは次の値を有します。  '<B>$preparer</B>'<BR>";
} else
  echo "preparer は、表示されません。<BR>";
fdf_close($fdf);
?>
     
目次
fdf_open ? FDF ドキュメントをオープンする
fdf_close ? FDF ドキュメントを閉じる
fdf_create ? 新規 FDF ドキュメントを作成する
fdf_save ? FDF ドキュメントを保存する
fdf_get_value ? フィールドの値を得る
fdf_set_value ? フィールドの値を設定する
fdf_next_field_name ? 次のフィールド名を得る
fdf_set_ap ? フィールドの外観を設定する
fdf_set_status ? /STATUS キーの値を設定する
fdf_get_status ? /STATUS キーの値を得る
fdf_set_file ? /F キーの値を設定する
fdf_get_file ? /F キーの値を得る