REST エンドポイントへの送信アクションのアダプティブフォームを設定する

基盤コンポーネント

基盤コンポーネントに基づくアダプティブフォーム用に Swagger Open API 仕様に基づいた送信アクションを設定するには、以下を行います。

1. 編集用にアダプティブフォームを開き、アダプティブフォームのコンテナプロパティの「送信」セクションに移動します。

2. 送信アクション ​ドロップダウンリストから、「REST エンドポイントへの送信」を選択します。

   

   内部サーバーにデータを POST 送信するには、リソースのパスを指定します。データは、リソースのパスに POST されます。例えば、/content/restEndPoint のようになります。このような POST リクエストには、送信リクエストの認証情報が使用されます。
   このオプションを使用すると、ターゲット REST エンドポイントを直接入力できます。
   外部サーバーにデータを 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 のようになります。他のサーバーにデータを送信するには、絶対パスを使用します。

3. 「完了」をクリックします。

コアコンポーネント

コアコンポーネントに基づくアダプティブフォームに対して Swagger Open API 仕様に基づいた送信アクションを設定するには、以下を行います。

1. コンテンツブラウザーを開き、アダプティブフォームの​ ガイドコンテナ ​コンポーネントを選択します。

2. ガイドコンテナプロパティ アイコンをクリックします。 アダプティブフォームコンテナダイアログボックスが開きます。

3. 「送信」タブをクリックします。

4. 送信アクション ​ドロップダウンリストから、「REST エンドポイントへの送信」を選択します。

   

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

   REST エンドポイントを指定する方法は 2 つあります。

   accordion
   URL
   このオプションを使用すると、ターゲット REST エンドポイントを直接入力できます。

外部サーバーにデータを 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 のようになります。他のサーバーにデータを送信するには、絶対パスを使用します。

+++

accordion
設定
このオプションを使用すると、AEM設定ブラウザーを介して管理される、事前定義済みの HTTP 設定を追加できます。 サービス REST エンドポイント認証タイプおよびコンテンツタイプ用に作成した設定を選択できます。 認証タイプとコンテンツタイプについて詳しくは、 データソースの設定を参照してください。

1. 「完了」をクリックします。

ユニバーサルエディター

ユニバーサルエディターで作成されたアダプティブフォームに対して、Swagger Open API 仕様に基づいた送信アクションを設定するには、次を行います。

1. アダプティブフォームを編集用に開きます。

2. エディターで フォームプロパティを編集 拡張機能をクリックします。
   フォームのプロパティ ダイアログが表示されます。

   note note
   NOTE
   ユニバーサルエディターインターフェイスに フォームプロパティを編集 アイコンが表示されない場合は、Extension Managerで フォームプロパティを編集 拡張機能を有効にします。 ユニバーサルエディターで拡張機能を有効または無効にする方法については 🔗Extension Manager機能のハイライト } の記事を参照してください。

   1. 「**送信**」タブをクリックし、「**Rest エンドポイントに送信**」送信アクションを選択します。

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

   REST エンドポイントを指定する方法は 2 つあります。

   accordion
   URL
   このオプションを使用すると、ターゲット REST エンドポイントを直接入力できます。

外部サーバーにデータを 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 のようになります。他のサーバーにデータを送信するには、絶対パスを使用します。

+++

accordion
設定
このオプションを使用すると、AEM設定ブラウザーを介して管理される、事前定義済みの HTTP 設定を追加できます。 サービス REST エンドポイント認証タイプおよびコンテンツタイプ用に作成した設定を選択できます。 認証タイプとコンテンツタイプについて詳しくは、 データソースの設定を参照してください。

1. 保存して閉じる をクリックします。