送信アクションの設定 configuring-the-submit-action

アダプティブフォームの新規作成または AEM Sites ページへのアダプティブフォームの追加には、最新の拡張可能なデータキャプチャコアコンポーネントを使用することをお勧めします。これらのコンポーネントは、アダプティブフォームの作成における大幅な進歩を表し、ユーザーエクスペリエンスの向上を実現します。この記事では、基盤コンポーネントを使用してアダプティブフォームを作成する古い方法について説明します。

送信アクションの概要 introduction-to-submit-actions

送信アクションは、ユーザーがアダプティブフォームの「送信」ボタンをクリックしたときにトリガーされます。アダプティブフォームでの送信アクションを設定することができます。アダプティブフォームには、すぐに使用できる送信アクションがいくつか用意されています。デフォルトの送信アクションをコピーし、拡張することにより、独自の送信アクションを作成できます。ただし、要件に応じて、送信したフォームのデータを処理する独自の送信アクションを書いて登録できます。送信アクションは、同期または非同期の送信を使用できます。

サイドバーにある「アダプティブフォームコンテナ」プロパティの「送信」セクションで、送信アクションを設定できます。

送信アクションの設定

アダプティブフォームで使用可能なデフォルトの送信アクションは次のとおりです。

アダプティブフォームがユースケースを実現するように、カスタム送信アクションを作成できます。詳しくは、「アダプティブフォーム向けのカスタム送信アクションの作成」を参照してください。

REST エンドポイントへの送信 submit-to-rest-endpoint

「REST エンドポイントへの送信」オプションでは、フォームに記入されたデータが、HTTP GET リクエストの一環として設定済みの確認ページに渡されます。リクエストにフィールド名を追加できます。リクエストのフォーマットを以下に示します。

{fieldName}={request parameter name}

以下の画像に示すとおり、param1 と param2 が、textbox フィールドと numericbox フィールドからコピーした値を持つパラメーターとして次のアクションに向けて渡されます。

また、POST リクエストを有効にする ​ことで、リクエストを投稿するための URL を指定することもできます。フォームをホストする Experience Manager サーバーにデータを送信するには、Experience Manager サーバーのルートパスに対応する相対パスを使用します。例えば、/content/forms/af/SampleForm.html のようにします。他のサーバーにデータを送信するには、絶対パスを使用します。

REST エンドポイント送信アクションの設定

送信されたデータをリソースまたは外部の REST エンドポイントに投稿 post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

REST エンドポイントへの送信 ​アクションを使用して、送信されたデータを REST URL に POST できます。URL は、内部（フォームがレンダリングされるサーバー）または外部サーバーのどちらのものでも使用できます。

内部サーバーにデータを POST 送信するには、リソースのパスを指定します。データは、リソースのパスに POST されます。例えば、/content/restEndPoint です。このような POST リクエストには、送信リクエストの認証情報が使用されます。

外部サーバーにデータを POST 送信するには、URL を指定します。URL の形式は、https://host:port/path_to_rest_end_point です。POST リクエストを匿名で処理するためのパスを設定してください。

上の例で、ユーザーが textbox に入力した情報は、パラメーター param1 を使用して取得されます。param1 を使用して取得されるデータを POST するための構文を以下に示します。

String data=request.getParameter("param1");

同様に、XML データと添付ファイルの POST に使用するパラメーターは、dataXml および attachments です。

例えば、この 2 つのパラメーターをスクリプト中で使用して、REST エンドポイントに送信されたデータを解析できます。データを格納および解析するための構文を以下に示します。

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

この例では、data が XML データを格納し、att が添付ファイルデータを格納します。

メールを送信 send-email

「メールを送信」送信アクションでは、フォームの送信が完了すると同時に、1 人または複数の受信者にメールが送信されます。生成されるメールには、事前に定義された形式のフォームデータを含めることができます。

メールで PDF を送信 send-pdf-via-email

「メールで PDF を送信」送信アクションでは、フォームの送信が完了すると同時に、1 人または複数の受信者にフォームデータを含む PDF が添付されたメールが送信されます。

Forms ワークフローを起動 invoke-a-forms-workflow

「Forms Workflow への送信」送信オプションでは、データ XML および添付ファイル（存在する場合に）が既存の Adobe LiveCycle プロセスまたは JEE での AEM Forms プロセスに送信されます。

送信アクション「Forms Workflow への送信」の設定方法について詳しくは、「フォームワークフローを使用したフォームデータの送信および処理」参照してください。

フォームデータモデルを使用して送信 submit-using-form-data-model

「フォームデータモデルを使用して送信」送信アクションでは、フォームデータモデルの特定のデータモデルオブジェクトで送信したアダプティブフォームデータをデータソースに書き込みます。送信アクションの設定時に、送信されたデータをデータソースに書き戻すデータモデルオブジェクトを選択できます。

さらに、フォームデータモデルとレコードのドキュメント（DoR）を使用して、フォーム添付ファイルをデータソースに送信できます。

フォームデータモデルについて詳しくは、「AEM Forms のデータ統合機能」を参照してください。

フォームポータル送信アクション forms-portal-submit-action

「フォームポータル送信アクション」オプションでは、フォームデータが AEM Forms ポータルで使用できるようになります。

フォームポータルと送信アクションについて詳しくは、ドラフトと送信コンポーネントを参照してください。

AEM ワークフローを起動 invoke-an-aem-workflow

「AEM ワークフローを起動」送信アクションは、アダプティブフォームを AEM ワークフローと関連付けます。フォームが送信されると、関連するワークフローがオーサーインスタンスで自動的に起動します。データファイル、添付ファイル、レコードのドキュメントは、相対するフォルダーや、ワークフローのペイロードの場所または変数に保存できます。ワークフローが外部データストレージ用にマークされている場合、ペイロードオプションではなく変数オプションが使用可能になります。ワークフローモデルで使用できる変数のリストから選択できます。ワークフローの作成時ではなく、後の段階で外部データストレージの対象としてワークフローがマークされている場合は、必要な変数設定が適切に行われていることを確認します。

「AEM ワークフローを起動」送信アクションを使用する前に、Experience Manager DS の設定を行います。AEM ワークフローの作成について詳しくは、「OSGi 上の Forms 中心のワークフロー」を参照してください。

送信アクションは、ワークフローのペイロードの場所に以下を配置します。ただし、ワークフローモデルが外部データストレージ用にマークされている場合は「変数」オプションのみが表示され、ペイロードオプションは表示されないことに注意してください。

Power Automate に送信 microsoft-power-automate

送信時に Microsoft® Power Automate のクラウドフローを実行するように、アダプティブフォームを設定できます。設定済みのアダプティブフォームは、キャプチャされたデータ、添付ファイルおよびレコードのドキュメントを Power Automate クラウドフローに送信して処理します。 Microsoft® Power Automate の機能を活用して、キャプチャされたデータを中心にビジネスロジックを構築し、顧客のワークフローを自動化しながら、カスタムのデータキャプチャエクスペリエンスを構築するのに役立ちます。アダプティブフォームを Microsoft® Power Automated と統合した後に実行できる操作の例を以下に示します。

アダプティブフォームエディターには Microsoft Power Automate フローの呼び出し ​送信アクションが用意されており、アダプティブフォームのデータ、添付ファイル、レコードのドキュメントを Power Automate クラウドのフローに送信できます。キャプチャしたデータを送信アクションを使用して Microsoft® Power Automate に送信するには、AEM Forms インスタンスを Microsoft® Power Automate に接続します。

正しく設定したら、Microsoft® Power Automateフローの呼び出し送信アクションを使用して、Power Automate フローにデータを送信します。

Microsoft® SharePoint リストに送信 submit-to-sharedrive

「SharePoint に送信」送信アクションは、アダプティブフォームと Microsoft® SharePoint ストレージを接続します。フォームデータファイル、添付ファイルまたはレコードのドキュメントを、接続された Microsoft® SharePoint ストレージに送信できます。

アダプティブフォームを Microsoft® SharePoint リストに接続 connect-af-sharepoint-list

アダプティブフォームを Microsoft® SharePoint リストに接続するには：

SharePoint リスト設定を作成 create-sharepoint-list-configuration

AEM Forms を Microsoft® Sharepoint リストに接続するには、次の手順に従います。

アダプティブフォームで「フォームデータモデルを使用して送信」を使用 use-submit-using-fdm

作成した SharePoint リスト設定をアダプティブフォーム内で使用すると、データや生成済みのレコードのドキュメントを SharePoint リストに保存できます。アダプティブフォームで SharePoint リストストレージ設定を使用するには、次の手順を実行します。

フォームを送信すると、データは指定した Microsoft® Sharepoint リストストレージに保存されます。

アダプティブフォームにおけるサーバー側の再検証 server-side-revalidation-in-adaptive-form

通常、どのようなオンラインデータ取得システムでも、ビジネスルールを適用するために、開発者はクライアントサイドに何らかの JavaScript 検証を配置します。しかし、最新のブラウザーでは、エンドユーザーが Web Browser DevTools Console などの様々な手法を使用してこれらの検証を回避し、手動で送信を行える方法が存在します。このような手法は、アダプティブフォームにも有効です。フォーム開発者は、多様な検証ロジックを作成できますが、エンドユーザーは、これらの検証ロジックを回避し、無効なデータをサーバーに送信できます。無効なデータは、フォーム作成者が適用したビジネスルールを破ることになります。

サーバーサイドの再検証機能は、アダプティブフォーム作成者がアダプティブフォームのデザイン中に指定した検証を、サーバー上でも実行するための機能です。これは、フォームの検証で表されるデータ送信の漏洩やビジネスルール違反の可能性を阻止します。

サーバー側で検証されるもの what-to-validate-on-server-br

アダプティブフォームの標準のフィールド検証のうち、サーバーで再実行されるものは次のとおりです。

サーバー側検証の有効化 enabling-server-side-validation-br

サイドバーにある「アダプティブフォームコンテナ」の「サーバー側で再検証」を使用して、現在のフォームのサーバーサイド検証を有効または無効にします。

サーバーサイド検証の有効化

エンドユーザーがこれらの検証を回避してフォームを送信した場合、サーバーが再度検証を行います。サーバーサイドでの検証が失敗した場合、送信処理が中止されます。エンドユーザーには、元のフォームが再度表示されます。取得されたデータおよび送信されたデータは、エラーとしてユーザーに表示されます。

検証式でのカスタム関数のサポート supporting-custom-functions-in-validation-expressions-br

複雑な検証ルールがある場合、正確な検証スクリプトがカスタム関数の中に存在し、作成者がこれらのカスタム関数をフィールド検証式から呼び出すことがあります。このカスタム関数ライブラリをサーバーサイド検証中に認識させ、利用可能にするために、フォーム作成者は、「アダプティブフォームコンテナ」プロパティの「基本」タブで、AEM クライアントライブラリの名前を設定できます（下記画像を参照）。

検証式でのカスタム関数のサポート

作成者は、アダプティブフォームごとにカスタム JavaScript ライブラリを設定できます。ライブラリには、jQuery および underscore.js サードパーティライブラリに依存する、再利用可能な関数のみを保持します。

送信アクションに対するエラー処理 error-handling-on-submit-action

Experience Manager セキュリティおよび堅牢化ガイドラインの一部として、404.jsp や 500.jsp などのカスタムエラーページを設定してください。これらのハンドラーは、フォーム送信時に 404 または 500 エラーが表示される場合に呼び出されます。また、これらのハンドラーは、パブリッシュノードでこれらのエラーコードがトリガーされるときにも呼び出されます。

詳しくは、「エラーハンドラーによって表示されるページのカスタマイズ」を参照してください。