アダプティブフォーム送信アクション configuring-the-submit-action

適用先: ✔️アダプティブフォームの基盤コンポーネント。 ❌ アダプティブフォーム (コアコンポーネント. Adobeでは、コアコンポーネントを次のように使用することをお勧めします。 AEM SitesページへのアダプティブFormsの追加 または スタンドアロンのアダプティブFormsを作成する.

送信アクションは、ユーザーがアダプティブフォームの「送信」ボタンをクリックするときにトリガーされます。Forms as a Cloud Serviceでは、次の送信アクションが初期設定で提供されています。

デフォルトの送信アクションを拡張して、独自の送信アクションを作成することもできます。

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

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

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 が添付ファイルデータを格納します。

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

{fieldName}={request parameter name}

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

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

メールを送信 send-email

「メールを送信」送信アクションでは、フォームの送信が完了すると同時に、1 人または複数の受信者にメールが送信されます。生成されるメールには、事前に定義された形式のフォームデータを含めることができます。例えば、以下のテンプレートでは、顧客名、配送先住所、州名、郵便番号が、送信されたフォームデータから取得されます。

```

こんにちは ${customer_Name} さん、

以下がデフォルトの配送先住所として設定されています。
${customer_Name}、
${customer_Shipping_Address}、
${customer_State}、
${customer_ZIPCode}

よろしくお願いいたします。
WKND

```

メールには、添付ファイルとレコードのドキュメント（DoR）を含めることもできます。「レコードのドキュメントを添付」オプションを有効にするには、レコードのドキュメント（DoR）を生成するようにアダプティブフォームを設定します。このオプションを有効にして、アダプティブフォームのプロパティからレコードのドキュメントを生成できます。

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

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

さらに、フォームデータモデル（FDM）とレコードのドキュメント（DoR）を使用して、フォームの添付ファイルをデータソースに送信できます。フォームデータモデル（FDM）について詳しくは、AEM Forms のデータ統合機能を参照してください。

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

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

送信アクションは、ワークフローのペイロードの場所、またはワークフローが外部データストレージ用にマークされている場合は変数に、以下を配置します。

「AEM ワークフローを起動」送信アクションを使用する前に、AEM DS 設定サービス ​の設定に対して、以下の設定を行います。

SharePoint に送信 submit-to-sharedrive

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

「SharePoint に送信」を使用して、次の操作を実行できます。

アダプティブフォームを SharePoint ドキュメントライブラリに接続 connect-af-sharepoint-doc-library

アダプティブフォームで「SharePoint ドキュメントライブラリに送信」送信アクションを使用するには、次の手順に従います。

SharePoint ドキュメントライブラリの設定を作成 create-sharepoint-configuration

AEM Forms を Microsoft® Sharepoint ドキュメントライブラリストレージに接続するには、次の手順に従います。

アダプティブフォームの送信アクションに、この SharePoint サイト設定を使用できるようになりました。

アダプティブフォームでの SharePoint ドキュメントライブラリ設定の使用 use-sharepoint-configuartion-in-af

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

フォームを送信すると、データは指定した Microsoft® Sharepoint ドキュメントライブラリストレージに保存されます。
データを保存するフォルダー構造は /folder_name/form_name/year/month/date/submission_id/data です。

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

アダプティブフォームで「SharePoint リストに送信」送信アクションを使用するには、次の手順に従います。

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

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

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

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

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

OneDrive に送信 submit-to-onedrive

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

Microsoft OneDrive 設定の作成 create-onedrice-configuration

AEM Forms を Microsoft® OneDrive ストレージに接続するには、以下の手順に従います。

アダプティブフォームの送信アクションに、この OneDrive ストレージ設定を使用できるようになりました。

アダプティブフォームでの OneDrive 設定の使用 use-onedrive-configuartion-in-af

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

フォームを送信すると、指定した Microsoft® OneDrive ストレージにデータが保存されます。
データを保存するフォルダー構造は /folder_name/form_name/year/month/date/submission_id/data です。

Azure Blob Storage に送信 submit-to-azure-blob-storage

「Azure Blob Storage に送信」送信アクションは、アダプティブフォームを Microsoft Azure Portal に接続します。フォームデータ、ファイル、添付ファイル、またはレコードのドキュメントを、接続された Azure ストレージコンテナに送信できます。 Azure Blob Storage の送信アクションを使用するには、次の手順に従います。

Azure Blob Storage コンテナの作成 create-azure-configuration

AEM Forms を Azure ストレージコンテナに接続するには、次の手順に従います。

アダプティブフォームの送信アクションに、この Azure ストレージコンテナ設定を使用できるようになりました。

アダプティブフォームでの Azure ストレージ設定の使用 use-azure-storage-configuartion-in-af

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

フォームを送信すると、データは指定された Azure ストレージコンテナ設定に保存されます。
データを保存するフォルダー構造は /configuration_container/form_name/year/month/date/submission_id/data です。

設定の値をセットするには、AEM SDK を使用して OSGi 設定を生成し、Cloud Service インスタンスに設定をデプロイします。

Power Automate に送信 microsoft-power-automate

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

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

「Microsoft® Power Automate フローの呼び出し」送信アクションを使用して、Power Automate フローにデータを送信する

Workfront Fusion に送信 workfront-fusion

アダプティブフォームを設定して、送信時に Workfront Fusion にデータを送信できます。Workfront Fusion を使用すると、プロセスを自動化できるので、同じタスクを何度も繰り返す代わりに、新しいタスクに集中できます。シンプルなタスクと複雑なタスクの両方を自動化し、時間を節約し、プロセスの一貫した実行を実現します。

アダプティブフォームエディターでは、Workfront Fusion シナリオを呼び出す ​送信アクションを使用して、アダプティブフォームのデータまたは添付ファイルを Workfront Fusion シナリオに送信します。送信アクションを使用して取得したデータを Workfront Fusion シナリオに送信する方法について詳しくは、Adobe Workfront Fusion へのアダプティブフォームの送信を参照してください。

同期または非同期送信の使用 use-synchronous-or-asynchronous-submission

送信アクションは、同期または非同期の送信を使用できます。

同期送信：これまでの Web フォームは、同期送信用に設定されていました。同期送信では、ユーザーがフォームを送信すると、確認ページ、ありがとうページ、または送信に失敗した場合はエラーページにリダイレクトされます。「非同期送信を使用」オプションを選択して、ユーザーを Web ページにリダイレクトしたり、送信時にメッセージを表示したりできます。

非同期送信：単一ページアプリケーションなどの最新の Web エクスペリエンスが広く使用されるようになっています。こうしたアプリケーションでは、バックグラウンドでクライアントとサーバー間の通信が実行されている間、Web ページが静的な状態のままになります。非同期送信を設定することにより、アダプティブフォームでこうしたエクスペリエンスを実現できます。

アダプティブフォームでのサーバーサイドの再検証 server-side-revalidation-in-adaptive-form

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

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

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

サーバーで再実行される、アダプティブフォームのすぐに使用できる（OOTB）すべてのフィールド検証を以下に示します。

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

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

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

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

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

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

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

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

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

AEM セキュリティおよび堅牢化ガイドラインの一環として、400.jsp、404.jsp、500.jsp などのカスタムエラーページを設定します。これらのハンドラーは、フォーム送信時に 400、404 または 500 エラーが表示される場合に呼び出されます。また、これらのハンドラーは、公開ノードでこれらのエラーコードがトリガーされる場合にも呼び出されます。他の HTTP エラーコード用の JSP ページを作成することもできます。

フォームデータモデル（FDM）またはスキーマベースのアダプティブフォームを、スキーマに準拠した XML データや JSON データを使用して事前入力する、つまりデータが <afData>、<afBoundData>、</afUnboundData> のタグを含まない場合、アダプティブフォームの連結されていないフィールドのデータは失われます。スキーマには、XML スキーマ、JSON スキーマ、フォームデータモデル（FDM）を使用できます。境界なしのフィールドは、bindref プロパティを持たないアダプティブフォームフィールドです。