データソースの設定 configure-data-sources

バージョン
記事リンク
AEM as a Cloud Service
ここをクリックしてください
AEM 6.5
この記事

データ統合

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

  • リレーショナルデータベース — MySQL、Microsoft SQL Server、IBM DB2、OracleRDBMS、postgreSQL、Sybase
  • AEM ユーザープロファイル
  • RESTful Web サービス
  • SOAP ベースの web サービス
  • OData サービス

データ統合では、すぐに使用できる認証タイプとして、OAuth2.0(認証コードクライアント資格情報)、基本認証、API キー認証がサポートされています。また、web サービスにアクセスするためのカスタムの認証タイプを実装することもできます。RESTful サービス、SOAP ベースサービス、OData サービスは AEM クラウドサービスで設定し、リレーショナルデータベース用の JDBC と AEM ユーザープロファイル用のコネクターは、AEM Web コンソールで設定します。

リレーショナルデータベースの設定 configure-relational-database

AEM web コンソールの設定を使用して、リレーショナルデータベースを設定することができます。以下の操作を実行します。

  1. AEM web コンソール(https://server:host/system/console/configMgr)にアクセスします。

  2. Apache Sling Connection Pooled DataSource 設定を検索します。「 」を選択して、設定を編集モードで開きます。

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

    • データソースの名前
    • データソース名を保存するデータソースサービスプロパティ
    • JDBC ドライバーの Java クラス名
    • JDBC 接続 URI
    • JDBC ドライバーとの接続を確立するためのユーザー名とパスワード
    note note
    NOTE
    データソースを設定する前に、パスワードなどの機密情報を必ず暗号化してください。暗号化するには、以下の手順を実行します。
    1. https://'[server]:[port]'/system/console/crypto に移動します。
    2. Adobe Analytics の プレーンテキスト フィールドで、暗号化するパスワードまたは任意の文字列を指定し、 Protect.
    暗号化されたテキストが「保護されたテキスト」フィールドに表示されます。このテキストを設定内で指定できます。
  4. Test on Borrow ​または「Test on Return」を有効にして、オブジェクトがプールから借用またはプールに返される前に検証されることを指定します。

  5. 検証クエリ」フィールドの SQL SELECT クエリを指定して、プールからの接続を検証します。クエリは、少なくとも 1 つのレコードを返す必要があります。データベースに応じて、次のいずれかを指定します。

    • SELECT 1(MySQL または MS SQL の場合)
    • SELECT 1 from dual(Oracle の場合)
  6. 保存」をクリックして、設定を保存します。

    note note
    NOTE
    Forms データモデルにリレーショナルデータベースの予約済みキーワードであるオブジェクトが含まれている場合、データの追加、更新または取得に関する問題が発生する可能性があります。そのため、そのようなオブジェクトはフォームデータモデルで使用しないようにしてください。

AEM ユーザープロファイルを設定 configure-aem-user-profile

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

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

  2. を探す AEM Forms Data Integrations - User Profile Connector の設定 「 」を選択して、設定を編集モードで開きます。

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

    name=[property_name_with_location_in_user_profile],type=[property_type]

    例:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    note note
    NOTE
    上記の「*」は、CRXDE 構造における AEM ユーザープロファイル内の profile/empLocation/ ノードに属するすべてのノードを表しています。この場合、profile/empLocation/ ノード配下のいずれかのノード内に存在する string タイプの city プロパティに、フォームデータモデルからアクセスすることができます。ただし、指定されたプロパティが存在するノードの構造が統一されている必要があります。
  4. 保存」をクリックして、設定を保存します。

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

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

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

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

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

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

    1. Adobe Analytics の 設定ブラウザー ​を選択し、 global フォルダーと選択 プロパティ.

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

    3. 選択 保存して閉じる 設定を保存し、ダイアログを終了します。

  3. Adobe Analytics の 設定ブラウザー ​を選択します。 作成.

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

  5. 選択 作成 をクラウドサービス設定に対して有効なフォルダーを作成します。

RESTful Web サービスの設定 configure-restful-web-services

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

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

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

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

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

  3. RESTful サービスの次の詳細を指定します。

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

    • Swagger ソース入力にもとづいて、以下のフィールドに値が事前入力されます。

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

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

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

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

    • RESTful サービスにアクセスするための認証タイプ(なし、OAuth2.0(認証コードクライアント資格情報)、基本認証、API キー認証、カスタム認証、相互認証)を選択し、その選択内容に応じて認証の詳細を指定します。

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

    認証タイプとして「相互認証」を選択する場合は、RESTful web サービスと SOAP web サービスの証明書ベースの相互認証を参照してください。

  4. 選択 作成 をクリックして、RESTful サービスのクラウド設定を作成します。

パフォーマンスを最適化するためのフォームデータモデル HTTP クライアント設定 fdm-http-client-configuration

データソースとして RESTful web サービスと統合する場合の Experience Manager Forms フォームデータモデルには、パフォーマンス最適化のための HTTP クライアント設定が含まれています。
フォームデータモデルの HTTP クライアントを設定するには、以下の手順を実行します。

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

  2. 選択 REST データソース用のフォームデータモデル Http クライアント設定.

  3. REST データソース用フォームデータモデル Http クライアント設定ダイアログで、

    • 接続制限(合計) ​フィールドに、フォームデータモデルと RESTful web サービス間の接続許可数の上限を指定します。デフォルト値は 20 接続です。

    • ルートごとの接続制限 ​フィールドで、各ルートに許可される最大接続数を指定します。デフォルト値は 2 接続です。

    • Keep Alive フィールドで、持続的な HTTP 接続を維持する期間を指定します。デフォルト値は 15 秒です。

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

    • ソケットタイムアウト ​フィールドに、2 つのデータパケット間の非アクティブの最大時間を指定します。デフォルト値は 30 秒です。

SOAP Web サービスの設定 configure-soap-web-services

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

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

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

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

  3. SOAP web サービスに対して次の情報を指定します。

    • Web サービスの WSDL URL。

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

    • SOAP サービスにアクセスするための認証タイプ(なし、OAuth2.0(認証コードクライアント資格情報)、基本認証、API キー認証、カスタム認証、X509 トークン、相互認証)を選択し、その選択内容に応じて認証の詳細を指定します。

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

      認証タイプとして​ 相互認証 ​を選択した場合は、RESTful web サービスおよび SOAP web サービスの証明書ベースの相互認証を参照してください。

  4. 選択 作成 をクリックして、SOAP web サービスのクラウド設定を作成します。

OData サービスの設定 config-odata

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

NOTE
フォームデータモデルがサポートする OData バージョン 4
オンライン環境またはオンプレミス環境で Microsoft Dynamics 365 を設定する詳しい手順については、Microsoft Dynamics OData 設定を参照してください。
  1. ツール/Cloud Services/データソース ​に移動します。クラウド設定を作成するフォルダーを選択します。

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

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

  3. OData サービスの次の詳細を指定します。

    • 設定する OData サービスのサービスルート URL。
    • OData サービスにアクセスするための認証タイプ(なし、OAuth2.0(認証コードクライアント資格情報)、基本認証、カスタム認証)を選択し、その選択内容に応じて認証の詳細を指定します。
    note note
    NOTE
    OData エンドポイントをサービスルートとして使用してMicrosoft Dynamics サービスに接続するには、OAuth 2.0 認証タイプを選択します。
  4. 選択 作成 をクリックして、OData サービスのクラウド設定を作成します。

RESTful web サービスと SOAP web サービスの証明書ベースの相互認証 mutual-authentication

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

  1. 秘密鍵(証明書)を AEM Forms サーバーにアップロードします。秘密鍵をアップロードするには:

    1. AEM Forms サーバーに管理者としてログインします。
    2. ツールセキュリティユーザー ​に移動します。を選択します。 fd-cloudservice ユーザーと選択 プロパティ.
    3. を開きます。 キーストア タブ、展開 秘密鍵をキーストアファイルから追加 オプション、キーストアファイルをアップロード、エイリアス、パスワードを指定、および 送信. 証明書がアップロードされます。秘密鍵のエイリアスは、証明書に指定され、証明書の作成時に設定されます。
  2. Global Trust Store に信頼する証明書をアップロードします。証明書をアップロードするには:

    1. ツールセキュリティTrust Store に移動します。
    2. を展開します。 CER ファイルから証明書を追加 オプション、選択 証明書ファイルを選択、証明書をアップロードし、「 送信.
  3. データソースとして SOAP または RESTful web サービスを設定し、認証タイプとして「相互認証」を設定します。fd-cloudservice ユーザーに複数の自己署名証明書を設定する場合は、証明書のキーエイリアス名を指定します。

次の手順 next-steps

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2