「processFormSubmission」操作

クライアントによって送信されたフォームから Forms サービスへのコンテンツを処理します。この操作では、ユーザーがクリックしたボタンなど、送信されたフォームの処理状態を判断できます。操作の完了によって、次のいずれかの結果になります。

  • フォームでの処理が完了していない場合、Forms サービスに送信されたのと同じコンテンツタイプ。

  • XML データまたは PDF データ

    この操作に渡されたフォームのコンテンツタイプがサポートされていない場合、処理が発生せず、データが返されます。「processFormSubmission」操作を使用して、送信されたフォームからデータを取得して処理します。

    例えば、ユーザーが 「送信」ボタンをクリックしてデータを抽出し、送信したフォームからのプロセス変数に保存するかどうかを判断する必要があります。「processFormSubmission」操作を使用して、ユーザーが操作の実行の完了後に Action プロパティから値を取得して、「送信」ボタンをクリックしたかどうかを確認します。また、この操作を使用して、Output XML プロパティから XML データを抽出してプロセス変数に保存します。

    General プロパティグループと Route Evaluation プロパティグループについて詳しくは、共通の操作プロパティを参照してください。

Input プロパティ

送信するフォームデータを指定するためのプロパティ。

送信されたフォームデータ

Forms サービスに送信されるコンテンツを表す document 値。

リテラル値を指定する場合は、省略記号ボタン をクリックして、Select Asset ダイアログボックスを開きます

Environment Variables

含めることのできる共通の環境変数は Accept-Language、CONTENT_LENGTH、CONTENT_TYPE、HTTP_FS_REQUEST、および SERVER_NAME です。環境変数は、サーバー側のスクリプトまたはクライアントアプリケーションの CGI スクリプトの情報を通信するために役立ちます。例えば、CONTENT_TYPE 環境変数を指定して、送信できるコンテンツのタイプを指定できます。

User Agent

Web ブラウザーなどのクライアントアプリケーションについての情報を提供する string 値。USER_AGENT がこの操作で Environment Variables プロパティの値として指定される場合、このプロパティで指定される値で上書きされます。デフォルト値は Mozilla/3.* です。

リテラル値を指定する場合、次のいずれかの値を選択します。

  • Use Server Default:(デフォルト)Mozilla/3.* を使用します。「User Agent」設定はサーバー上で設定できません。

  • Internet Explorer 6.0:ターゲットアプリケーションは Microsoft Internet Explorer 6.0 です。

  • Mozilla Firefox 2.0:ターゲットアプリケーションは Mozilla Firefox 2.0 です。

  • Mozilla Firefox 3.0:ターゲットアプリケーションは Mozilla Firefox 3.0 です。

  • Use Custom Value:このオプションを選択した後、ターゲットデバイス上のクライアントアプリケーションを入力します。例えば、Microsoft Internet Explorer 7.0 の場合は "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1)" と入力します。

Form Submission Options プロパティ

フォームを送信するためのプロパティを設定するプロパティ。

Submission options

No Styles:インラインまたは内部スタイル設定の CSS を使用します。

Output プロパティ

フォームデータ送信の結果を保存するためのプロパティ。

Process Form Submission Result Document

フォーム送信の処理結果を保存するプロセスデータモデル内の場所。データタイプは document です。

その他の Outputプロパティ

フォーム送信の処理から追加情報を保存するためのプロパティ。

Clicked Button

ユーザーが最後にクリックしたボタンを保存するプロセスデータモデル内の場所。値は XFA Scripting Object Model(SOM)式です。データタイプは document です。

Output XML

XML データまたは HTML データを保存するプロセスデータモデル内の場所。結果は、取得できる整形式の XML として保存されます。データタイプは document です。

Validation Errors List

UTF8 でエンコードされた XML として取得される検証エラーのリストを保存するためのプロセスデータモデル内の場所。データタイプは document です。

Action

フォームの送信に関連づけられた処理状態を保存するためのプロセスデータモデル内の場所。データタイプは short です。次の値のいずれかが返されます。

  • 0:フォームは「Submit」状態で、検証済みの XML データを処理できるようになります。

  • 1:フォームは「Calculate」状態で、計算結果を Web ブラウザーに書き込む必要があります。

  • 2:フォームは「Validate」状態で、計算と検証を Web ブラウザーに書き込む必要があります。

  • 3:フォームは「Next」状態で、現在のページが Web ブラウザーに書き込む必要のある結果で変更されます。HTML フォームに対してのみ有効。

  • 4:フォームは「Previous」状態で、現在のページが Web ブラウザーに書き込む必要のある結果で変更されます。HTML フォームに対してのみ有効。

Attachments

フォームの送信で投稿される添付ファイルのリストを保存するためのプロセスデータモデル内の場所。データタイプは document 値の list です。

リストからの値の取得について詳しくは、データコレクション内のデータへのアクセスを参照してください。

Forms Result

すべての出力結果を組み合わせられた複雑な値で保存するためのプロセスデータモデル内の場所。データタイプは FormsResult です。

Exceptions プロパティ

この操作によって、フォーム送信要求の処理中にエラーが発生した場合に ProcessFormSubmissionException 例外がスローされます。