データソースの設定

AEM Forms のデータ統合機能により、複数の異なるデータソースを設定して接続することができます。以下のタイプがサポートされています。これらのタイプは、すぐに使用することができます。ただし、これらの機能を少しカスタマイズするだけで、他のデータソースを統合することもできます。

  • リレーショナルデータベース - MySQL、Microsoft SQL Server、IBM DB2、Oracle RDBMS
  • AEM ユーザープロファイル
  • RESTful Web サービス
  • SOAP ベース Web サービス
  • OData サービス

データ統合では、OAuth2.0、基本認証、およびAPIキーの認証タイプをすぐに使用でき、Webサービスにアクセスするためのカスタム認証を実装できます。 RESTful サービス、SOAP ベースサービス、OData サービスは AEM クラウドサービスで設定し、リレーショナルデータベース用の JDBC と AEM ユーザープロファイル用のコネクターは、AEM Web コンソールで設定します。

リレーショナルデータベースの設定

AEM Web Console Configuration を使用してリレーショナルデータベースを設定することができます。次の操作を実行します。

  1. AEM Webコンソール(https://server:host/system/console/configMgr)に移動します。

  2. Apache Sling Connection Pooled DataSource」という設定を探し、その設定をタップして編集モードで開きます。

  3. 設定ダイアログで、設定するデータベースの詳細を指定します。例えば、以下のような詳細を指定します。

    • データソースの名前
    • データソース名が保管されるデータソースサービスプロパティ
    • JDBC ドライバーの Java クラス名
    • JDBC 接続 URI
    • JDBC ドライバーとの接続を確立するためのユーザー名とパスワード
    メモ

    データソースを設定する前に、パスワードなどの機密情報を必ず暗号化してください。暗号化するには、以下の手順を実行します。

    1. https://'[server]:[port]'/system/console/cryptoに移動します。
    2. プレーンテキスト」フィールドで、暗号化するパスワードまたは任意の文字列を指定し、Protect​をタップします。

    暗号化されたテキストは、設定で指定できる「保護されたテキスト」フィールドに表示されます。

  4. プールからオブジェクトを取得するときにそのオブジェクトを検証する場合は「Test on Borrow」を有効にし、プールにオブジェクトを返すときにそのオブジェクトを検証する場合は「Test on Return」を有効にします。

  5. 検証クエリ」フィールドで SQL SELECT クエリを指定して、プールからの接続を検証します。このクエリでは、1 行以上の行が返される必要があります。使用しているデータベースに応じて、以下のいずれかを指定します。

    • SELECT 1 (MySQLおよびMS SQL)
    • SELECT 1 from dual(Oracle の場合)
  6. 保存」をタップして設定を保存します。

AEM ユーザープロファイルの設定

AEM Web コンソールでユーザープロファイルコネクター設定を使用して、AEM のユーザープロファイルを設定することができます。次の操作を実行します。

  1. AEM Webコンソール(https://'[server]:[port]'system/console/configMgr)に移動します。

  2. 「AEM Formsデータ統合 — ユーザープロファイルコネクタ設定」を探し、をタップして設定を編集モードで開きます。

  3. ユーザープロファイルコネクター設定ダイアログで、ユーザープロファイルプロパティの追加、削除、更新を行うことができます。ここで指定したプロパティは、フォームデータモデルで使用することができます。次の形式を使用して、ユーザープロファイルのプロパティを指定します。

    name=[property_name_with_location_in_user_profile],type=[property_type]

    例:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    メモ

    上記の例の​**​***​は、CRXDE構造のAEMユーザープロファイルのprofile/empLocation/ノード下のすべてのノードを表します。 つまり、フォームデータモデルは、profile/empLocation/ノード下の任意のノードに存在するタイプstringcityプロパティにアクセスできます。 ただし、指定されたプロパティが存在するノードの構造が統一されている必要があります。

  4. 保存」をタップして設定を保存します。

クラウドサービス設定用フォルダーの構成

メモ

RESTful、SOAP、ODataサービス用のクラウドサービスを設定するには、クラウドサービスフォルダーの設定が必要です。

AEMのすべてのクラウドサービス設定は、AEMリポジトリの/confフォルダーに統合されます。 デフォルトの場合、conf フォルダーには global フォルダーが含まれています。このフォルダーで、クラウドサービスの設定を作成することができます。ただし、このフォルダーを手動でクラウド設定用に有効にする必要があります。追加のフォルダーを conf フォルダー内に作成して、クラウドサービスの作成と編集を行うこともできます。

クラウドサービス設定用のフォルダーを構成するには、以下の手順を実行します。

  1. ツール/一般/設定ブラウザー​に移動します。

  2. 以下の手順を実行して、global フォルダーをクラウド設定用に有効にします。クラウドサービス設定用に別のフォルダーを作成する場合は、この手順をスキップしてください。

    1. 設定ブラウザー​で、「global」フォルダーを選択して「プロパティ」をタップします。

    2. 設定プロパティ​ダイアログで、「クラウド設定」を有効にします。

    3. 保存して閉じる」をタップして設定内容を保存し、ダイアログを閉じます。

  3. 設定ブラウザー​で「作成」をタップします。

  4. 設定を作成​ダイアログでフォルダーのタイトルを指定し、「クラウド設定」を有効にします。

  5. 作成」をタップして、クラウドサービス設定用に有効なフォルダーを作成します。

RESTful Web サービスの設定

RESTful Webサービスは、Swagger定義ファイルのJSON形式またはYAML形式のSwagger仕様を使用して記述できます。 AEMクラウドサービスでRESTful Webサービスを設定するには、ファイルシステムにSwaggerファイルが存在するか、ファイルがホストされているURLが存在することを確認してください。

RESTful サービスを設定するには、以下の手順を実行します。

  1. ツール/クラウドサービス/データソース​に移動します。クラウド設定を作成するフォルダーをタップして選択します。

    クラウドサービス設定用のフォルダーの作成と設定について詳しくは、クラウドサービス設定用のフォルダーの設定を参照してください。

  2. 作成」をタップして、データソース設定を作成ウィザード​を開きます。 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「RESTful サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

  3. 以下に示す RESTful サービスの詳細情報を指定します。

    • 「Swagger Source」ドロップダウンから「URL」または「File」を選択し、Swagger URLをSwagger定義ファイルに指定するか、ローカルファイルシステムからSwaggerファイルをアップロードします。

    • Swagger Source入力に基づいて、次のフィールドに値が事前に入力されます。

      • スキーム:REST APIで使用される転送プロトコルです。 ドロップダウンリストに表示されるスキームの種類の数は、Swaggerソースで定義されているスキームによって異なります。

      • ホスト:REST APIを提供するホストのドメイン名またはIPアドレス。 このフィールドは必須です。

      • 基本パス:すべてのAPIパスのURLプレフィックス。 これはオプションのフィールドです。\

        必要に応じて、これらのフィールドの事前入力された値を編集します。

    • 認証の種類(「なし」、「OAuth2.0」、「基本認証」、「APIキー」、「カスタム認証」、「相互認証」)を選択してRESTfulサービスにアクセスし、認証の詳細を入力します。

    認証タイプとして​APIキー​を選択した場合は、APIキーの値を指定します。 APIキーは、リクエストヘッダーまたはクエリパラメーターとして送信できます。 「場所」ドロップダウンリストから次のオプションの1つを選択し、それに応じて「パラメーター名」フィールドにヘッダーまたはクエリパラメーターの名前を指定します。

    認証の種類として「相互認証」を選択した場合は、「RESTfulおよびSOAP Webサービスの証明書ベースの相互認証」を参照してください。

  4. 作成」をタップして、RESTful サービス用のクラウド設定を作成します。

フォームデータモデルHTTPクライアント構成によるパフォーマンスの最適化

Experience Manager Forms フォームデータモデルを使用します。次の手順を実行して、フォームデータモデルのHTTPクライアントを設定します。

  1. Experience Manager Forms作成者インスタンスに管理者としてログインし、Experience Manager Webコンソールバンドルに移動します。 デフォルトのURLはhttps://localhost:4502/system/console/configMgrです。

  2. Form Data Model Http Client Configuration for REST data source」をタップします。

  3. Form Data Model Http Client Configuration for REST data sourceダイアログで、次の操作を行います。

    • 「Connection limit in total」フィールドに、フォームデータモデルとRESTful Webサービスとの間で許可される最大接続数を指定します。 デフォルト値は20接続です。

    • Connection limit on per route basis」フィールドに、各ルートに対して許可される最大接続数を指定します。 デフォルト値は2接続です。

    • キープアライブ」フィールドに、永続的なHTTP接続が有効な状態で維持される期間を指定します。 デフォルト値は 15 秒です。

    • Experience Manager Formsサーバーが接続の確立を待機する時間を​「接続タイムアウト」フィールドに指定します。 デフォルト値は 10 秒です。

    • Socket timeout​フィールドで、2つのデータパケット間で無操作状態が発生する最大時間を指定します。 デフォルト値は 30 秒です。

SOAP Web サービスの設定

SOAP ベースの Web サービスは、Web Services Description Language(WSDL)の仕様に従って記述します。AEM クラウドサービスで SOAP ベースの Web サービスを設定するには、その Web サービスの WSDL URL を確認して、以下の手順を実行します。

  1. ツール/クラウドサービス/データソース​に移動します。クラウド設定を作成するフォルダーをタップして選択します。

    クラウドサービス設定用のフォルダーの作成と設定について詳しくは、クラウドサービス設定用のフォルダーの設定を参照してください。

  2. 作成」をタップして、データソース設定を作成ウィザード​を開きます。 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「SOAP Web サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

  3. 以下に示す SOAP Web サービスの詳細情報を指定します。

    • Web サービスの WSDL URL を指定します。

    • サービスエンドポイント. WSDLで指定されているサービスエンドポイントを上書きするには、このフィールドの値を指定します。

    • 認証の種類(「なし」、「OAuth2.0」、「基本認証」、「カスタム認証」、「X509トークン」、「相互認証」)を選択してSOAPサービスにアクセスし、認証の詳細を入力します。

      認証の種類として​X509トークン​を選択した場合は、X509証明書を設定します。 詳しくは、証明書の設定を参照してください。
      Key Alias​フィールドに、X509証明書のKeyStoreエイリアスを指定します。 認証要求が有効なまでの時間を秒単位で指定します。この時間を​Time To Live​フィールドに入力します。 オプションで、メッセージの本文ヘッダーとタイムスタンプヘッダー、またはその両方に署名する場合に選択します。

      認証の種類として「相互認証」を選択した場合は、「RESTfulおよびSOAP Webサービスの証明書ベースの相互認証」を参照してください。

  4. 作成」をタップして、SOAP Web サービス用のクラウド設定を作成します。

OData サービスの設定

OData サービスは、そのサービスのルート URL によって識別されます。AEM クラウドサービスで OData サービスを設定するには、そのサービスのルート URL を確認して、以下の手順を実行します。

メモ

オンライン環境またはオンプレミス環境で Microsoft Dynamics 365 を設定する詳しい手順については、「Microsoft Dynamics OData 設定」を参照してください。

  1. ツール/クラウドサービス/データソース​に移動します。クラウド設定を作成するフォルダーをタップして選択します。

    クラウドサービス設定用のフォルダーの作成と設定について詳しくは、クラウドサービス設定用のフォルダーの設定を参照してください。

  2. 作成」をタップして、データソース設定を作成ウィザード​を開きます。 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「OData サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

  3. 以下に示す OData サービスの詳細情報を指定します。

    • 設定する OData サービスのルート URL を指定します。
    • 認証の種類(「なし」、「OAuth2.0」、「基本認証」、「カスタム認証」)を選択してODataサービスにアクセスし、認証の詳細を入力します。
    メモ

    OData エンドポイントをサービスルートとして使用して Microsoft Dynamics サービスに接続する場合は、OAuth 2.0 認証を選択する必要があります。

  4. 作成」をタップして、ODataサービスのクラウド設定を作成します。

RESTfulおよびSOAP Webサービス用の証明書ベースの相互認証

フォームデータモデルの相互認証を有効にする場合、データを共有する前に、データソースとフォームデータモデルを実行するAEMサーバーの両方がお互いのIDを認証します。 RESTおよびSOAPベースの接続(データソース)に対して相互認証を使用できます。 AEM Forms環境でフォームデータモデルの相互認証を設定するには:

  1. 秘密鍵(証明書)をAEM Formsサーバーにアップロードします。 秘密鍵をアップロードするには:
    1. AEM Formsサーバーに管理者としてログインします。
    2. ツール > セキュリティ > ユーザー​に移動します。 fd-cloudserviceユーザーを選択し、プロパティ​をタップします。
    3. キーストア」タブを開き、「Private Key from KeyStore file」オプションを展開し、KeyStore Fileをアップロードし、エイリアスとパスワードを指定して、「送信」をタップします。 証明書がアップロードされます。 秘密鍵のエイリアスは証明書で記述され、証明書の作成時に設定されます。
  2. 信頼証明書をグローバルTrust Storeにアップロードします。 証明書をアップロードするには:
    1. ツール > セキュリティ > Trust Store​に移動します。
    2. 追加証明書をCERファイルから」オプションを展開し、「証明書ファイルを選択」をタップして、証明書をアップロードし、「送信」をタップします。
  3. SOAPまたはRESTfulWebサービスをデータソースとして設定し、認証の種類として​相互認証​を選択します。 fd-cloudserviceユーザーに対して複数の自己署名証明書を設定する場合は、証明書のキーエイリアス名を指定します。

次の手順

上記の手順により、データソースが設定されました。次に、フォームデータモデルを作成します。データソースが設定されていないフォームデータモデルが既に作成されている場合は、上記の手順で設定したデータソースにそのフォームデータモデルを関連付けます。詳しくは、フォームデータモデルの作成を参照してください。

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now