アダプティブフォーム送信アクション

最終更新日： 2025年5月7日
  • 適用対象：
  • Experience Manager as a Cloud Service

作成対象：

  • ユーザー
  • 開発者
バージョン記事リンク
AEM 6.5ここをクリックしてください
AEM as a Cloud Service（コアコンポーネント）ここをクリックしてください
AEM as a Cloud Service（基盤コンポーネント）この記事

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

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

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

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

送信アクションの設定

REST エンドポイントへの送信

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 フィールドからコピーされた値を持つパラメーターとして、次のアクションに向けて渡されます。

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

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

メモ
フィールドを REST URL 内のパラメーターとして渡すためには、すべてのフィールドが異なる要素名を持っている必要があります。これは、異なるパネルに置かれているフィールドにも適用されます。

メールを送信

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

```

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

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

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

```
メモ
  • フィールドがアダプティブフォームの異なるパネルに配置されている場合でも、すべてのフォームフィールドは異なる要素名を持っている必要があります。
  • AEM as a Cloud Service では、送信メールを暗号化する必要があります。デフォルトでは、送信メールは無効になっています。有効にするには、アクセスのリクエストにサポートチケットを送信します。

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

フォームデータモデル（FDM）を使用して送信

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

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

AEM ワークフローを起動

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

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

  • データファイル：アダプティブフォームに送信されたデータを含みます。「データファイルパス」オプションを使用して、ファイル名とペイロードを基準とするファイルのパスを指定できます。例えば、/addresschange/data.xml パスは、addresschange という名前のフォルダーを作成し、ペイロードを基準に配置します。フォルダー階層を作成せずに、data.xml のみを指定して、送信されたデータのみを送信することもできます。ワークフローが外部データストレージ用にマークされている場合は、「変数」オプションを使用し、ワークフローモデルで使用可能な変数のリストから変数を選択します。

  • 添付ファイル：「添付ファイルのパス」オプションを使用して、アダプティブフォームにアップロードされた添付ファイルの保存先となるフォルダー名を指定できます。フォルダーがペイロードを基準に作成されます。ワークフローが外部データストレージ用にマークされている場合は、「変数」オプションを使用し、ワークフローモデルで使用可能な変数のリストから変数を選択します。

  • レコードのドキュメント：アダプティブフォーム用に生成されたレコードのドキュメントを含みます。「レコードのドキュメントパス」オプションを使用して、レコードのドキュメントファイル名と、ペイロードを基準にファイルのパスを指定できます。例えば、/addresschange/DoR.pdf パスは、ペイロードを基準に addresschange という名前のフォルダーを作成し、ペイロードを基準に DoR.pdf を配置します。DoR.pdf のみを指定して、フォルダー階層を作成せずに、レコードのドキュメントのみを保存することもできます。ワークフローが外部データストレージ用にマークされている場合は、「変数」オプションを使用し、ワークフローモデルで使用可能な変数のリストから変数を選択します。

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

  • 処理サーバー URL：処理サーバーは、Forms または AEM ワークフローがトリガーされるサーバーです。これは、AEM オーサーインスタンスまたは別のサーバーの URL と同じです。

  • 処理サーバーのユーザー名：ワークフローユーザーのユーザー名

  • 処理サーバーのパスワード：ワークフローユーザーのパスワード

SharePoint に送信

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

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

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

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

  1. SharePoint ドキュメントライブラリ設定の作成：AEM フォームを Microsoft Sharepoint ストレージに接続します。
  2. アダプティブフォームでの「SharePoint に送信」送信アクションの使用：アダプティブフォームを設定済みの Microsoft® SharePoint に接続します。

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

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

  1. AEM Forms オーサー ​インスタンス／ツール／Cloud Services／Microsoft® SharePoint に移動します。

  2. Microsoft® SharePoint を選択すると、SharePoint ブラウザー ​にリダイレクトされます。

  3. 設定コンテナ ​を選択します。設定は、選択した設定コンテナに保存されます。

  4. クリック 作成 > SharePoint Document Library 」をドロップダウンリストから選択します。 SharePoint 設定ウィザードが表示されます。

    SharePoint の設定

  5. 「タイトル」、「クライアント ID」、「クライアント秘密鍵」および「OAuth URL」を指定します。OAuth URL のクライアント ID、クライアントの秘密鍵、テナント ID を取得する方法について詳しくは、Microsoft® のドキュメントを参照してください。

    • アプリの Client ID と Client Secret は Microsoft® Azure Portal から取得できます。
    • Microsoft® Azure Portal で、リダイレクト URI を https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html として追加します。[author-instance] をオーサーインスタンスの URL に置き換えます。
    • API 権限 offline_access および Sites.Manage.All を追加して、読み取り／書き込み権限を付与します。
    • OAuth URL https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize を使用します。<tenant-id> を Microsoft® Azure Portal のアプリの tenant-id に置き換えます。
    メモ
    クライアント秘密鍵 ​フィールドは、Azure Active Directory アプリケーションの設定に応じて、必須またはオプションになります。アプリケーションでクライアント秘密鍵を使用するように設定されている場合は、クライアントの秘密鍵を指定する必要があります。

  6. 「接続」をクリックします。接続に成功した場合、Connection Successful のメッセージが表示されます。

  7. SharePoint サイト／ドキュメントライブラリ／SharePoint フォルダー ​を選択して、データを保存します。

    メモ
    • デフォルトでは、forms-ootb-storage-adaptive-forms-submission は選択した SharePoint サイトに存在します。
    • 選択した SharePoint サイトの Documents ライブラリにまだ存在しない場合は、「フォルダーを作成」をクリックして、フォルダーを forms-ootb-storage-adaptive-forms-submission として作成します。

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