Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

フォーム送信アクション(SubmitForm action)

SubmitForm actionは、ユーザーの操作によって起動されると、PDFドキュメントからフォームフィールドのデータを指定されたWebサーバーまたは電子メールアドレスに送信するインタラクティブなPDF機能です。

カテゴリ: Forms & Interactivity
キーワード: submitform action, フォーム送信アクション

概要

SubmitForm actionは、ユーザーの操作によって起動されると、PDFドキュメントからフォームフィールドのデータを指定されたWebサーバーまたは電子メールアドレスに送信するインタラクティブなPDF機能です。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、このアクションタイプは、FDF(Forms Data Format)、XFDFXML Forms Data Format)、HTML、PDFなどの形式でフォームデータをパッケージ化することにより、PDFフォームをWebベースのワークフローやバックエンドシステムと統合することを可能にします。SubmitForm actionは通常、ユーザーが入力完了したフォームデータを指定されたURLに送信するために使用するボタンウィジェットやその他のフォームコントロールに関連付けられます。

定義

SubmitForm actionは、PDF仕様で利用可能ないくつかのアクションタイプの1つであり、特にフォームフィールドの値を外部の宛先にエクスポートおよび送信する処理を担当します。フォームデータをクリアするResetForm actionや、データをフォームに取り込むImportData actionとは異なり、SubmitForm actionはPDFドキュメントからデータを外部に送出します。このアクションはPDFのアクション辞書内で定義され、送信URL、使用するデータ形式、送信に含めるまたは除外するフィールドを指定するパラメータが含まれます。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) によると、開発者はSubmitForm actionを設定して、すべてのフィールド、現在表示されているフィールドのみ、または包含・除外リストに基づく特定のフィールドのサブセットを送信できます。アプリケーションの要件に応じて、PDFドキュメント全体またはフォームデータのみを送信するようにアクションを設定できます。

重要性

SubmitForm actionは、エンタープライズワークフロー、データ収集システム、自動化されたビジネスプロセスに参加するインタラクティブなPDFフォームを作成する上で不可欠です。PDFフォームをWebアプリケーションに統合するWeb開発者にとって、SubmitForm actionは、独自のプラグインやカスタムの解析ロジックを必要とせずにユーザー入力を取得するための標準化されたメカニズムを提供します。ドキュメント管理システムを構築するJava開発者は、SubmitForm actionが生成する予測可能なデータ形式の恩恵を受け、サーバーサイドでの処理とデータベース統合を簡潔に実現できます。プログラムによってフォームデータを送信する機能は、支援技術を使用するユーザーが標準的なインタラクションパターンを通じてフォームに入力し送信できるようにすることで、 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) で概説されているアクセシビリティ要件をサポートします。IT専門家にとって、SubmitForm actionは、PDFドキュメントに固有の移植性とセキュリティ機能を維持しながら、集中的なデータ収集と処理を可能にします。

仕組み

ユーザーがSubmitForm actionに関連付けられたウィジェットまたはコントロールを起動すると、PDFビューアまたはプロセッサは指定されたフォームフィールドから現在の値を収集し、アクションの設定パラメータに従ってそれらをパッケージ化します。アクション辞書には、送信先を指定するURL項目が含まれており、これはHTTP/HTTPSエンドポイント、FTPロケーション、または電子メール送信用のmailto URLにすることができます。アクション辞書のFlags項目は、様々な送信動作を制御します:指定されたフィールドを含めるか除外するか、フィールド値をHTML GETまたはPOSTデータとしてエクスポートするか、PDFドキュメント全体を送信するか、日付を標準形式に変換するかなどです。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で指定されているように、送信形式によってデータのエンコード方法が決まります。FDFおよびXFDF形式は、ラウンドトリップに最適化された構造化形式でフィールド名と値を保持し、HTML形式はWebサーバー処理に適したフォームパラメータとしてデータを構造化します。PDFプロセッサはネットワーク送信を処理し、ビューアの実装とセキュリティ設定に応じて、外部URLにデータを送信する前にユーザーに確認を求める場合があります。送信の成功または失敗は、レスポンス処理を行うための追加のJavaScriptアクションが設定されていない限り、通常、PDF内で自動的なフィードバックを引き起こしません。

関連用語

  • Form Field – ユーザー入力を受け付けるPDF内のインタラクティブ要素で、その値がSubmitForm actionによって収集されます
  • Action Dictionary – SubmitForm actionのようなアクションのタイプとパラメータを定義するPDFデータ構造
  • FDF(Forms Data Format) – PDFフォームデータをドキュメントとシステム間で交換するために特別に設計された軽量ファイル形式
  • ResetForm Action – フォームフィールドの値をクリアするアクションタイプで、フォーム管理におけるSubmitForm actionの対となる機能
  • AcroForm – SubmitForm actionを含むインタラクティブフォームフィールドとそれに関連するアクションを定義するPDFフォームアーキテクチャ

出典

(N.A.) (2020)
(N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html
(N.A.) (2014)
(N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html