ネイティブ Linux C ABI フォームインターチェンジ
既存のバージョン付き hpdf_document_execute_json_v1 エントリーポイントと hpdf_operation_v1 レコードを使って、スカラーおよび有界なリッチ AcroForm 値を FDF / XFDF としてエクスポートまたはインポートします
ABI バージョン、エクスポートシンボル、コールバックレコードのレイアウトは変更されません
| 操作 | InputIO | OutputIO | ResultIO |
|---|---|---|---|
forms.export | 省略可能な PDF 入力。なければ読み込み済みドキュメントを使います | 実際の FDF / XFDF バイト | JSON 形式、メディアタイプ、フィールド数、出力バイト数 |
forms.import | FDF / XFDF バイトが必須。宛先 PDF は既に読み込まれている必要があります | 準備済みの更新 PDF バイト | JSON 形式、メディアタイプ、フィールド数、変更フィールド数 |
どちらの操作でも format は fdf か xfdf のちょうどいずれかであることが必要で、schemaVersion は 1 を設定します
{"schemaVersion":1,"type":"forms.export","format":"xfdf"}
{"schemaVersion":1,"type":"forms.import","format":"fdf","fontFamily":"DejaVu Sans","fontSize":12}サポートされる値には、ネストした Unicode テキストフィールド、チェックボックスとラジオのエクスポート状態、スカラー選択、複数選択があります。UTF-8 と BOM 付き UTF-16 の XFDF を受け付けます
FDF の RV と XFDF の value-richtext は inline-xhtml-v1 リッチプロファイルを使い、fontFamily によって実際の regular・bold・italic・bold-italic フォントプログラムを選択します
署名フィールドとプッシュボタンは名前だけが表現され、値はインポートされません。入力済みの署名と既存のボタン動作は保持されます
インポートは本物の外観を再生成し、認証済み AES R5/R6 暗号化、読み取り専用フィールド、DocMDP 権限、FieldMDP ロックを保持します
省略可能な signaturePolicy は、requireCAdES、requireTimestamp、requireTimestampRevocation、既存のトラストファイルまたは PEM 設定、署名オプションスキーマに沿った revocationInfo を受け付けます
明示的な署名付き失効ポリシーは、RFC 3161 ドキュメントタイムスタンプ内のものを含め、実際に埋め込まれた署名属性を検証します。外部から与えられたステータスバイトで、欠落している必須属性を置き換えることはできません
省略可能な formDataLimits は、正の整数の maxBytes、maxFields、maxObjects、maxDepth、maxValues、maxValueCodeUnits、maxTotalCodeUnits 設定を含み、ネイティブのデフォルトと操作容量によって上限が制限されます
既存の limits.memoryBytes、outputBytes、resultBytes も準備と公開を追加で制約します。インターチェンジ上限を使い切ると HPDF_STATUS_BUDGET_EXCEEDED が返ります
コールバックは呼び出しスレッド上で同期実行され、読み書きの部分完了を返すことがあります。キャンセルは、フォーム入力の読み取り、解析、外観の準備、結果の公開の間に観測されます
読み込み済みの宛先ハンドルがコミットするのは、更新 PDF と JSON 結果の各コールバックが成功した後です。コールバックのエラーやキャンセルでは以前の状態が保たれますが、呼び出し側所有のシンクが既に受け取ったバイトは呼び出し側の責任のままです
注釈 XFDF 操作は、popup/返信参照や埋め込みファイル・サウンドストリームを備えた別個の追加プロファイルを使います
任意の CSS レイアウト、埋め込み FDF ファイル、任意のアクション、インクリメンタル FDF リビジョン交換は、フォームデータプロファイルの対象外です