データソースの設定

ここでは、各種のデータソースを設定し、それらのデータソースを使用してフォームデータモデルを作成する方法について説明します。

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. Go to AEM web console at 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. プレーンテキスト」フィールドに暗号化する文字列(パスワードなど)を入力して「保護」をクリックします。

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

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

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

    • SELECT 1 (MySQLおよびMS SQL)
    • SELECT 1 from dual(Oracle の場合)
  6. Tap Save to save the configuration.

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

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

  1. Go to AEM web console at https://[server]:[host]/system/console/configMgr.

  2. Look for AEM Forms Data Integrations - User Profile Connector Configuration and tap to open the configuration in edit mode.

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

    name=[property_name_with_location_in_user_profile],type=[property_type]

    例:

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

    The * in the above example denotes all nodes under the profile/empLocation/ node in AEM user profile in CRXDE structure. It means that the form data model can access the city property of type string present in any node under the profile/empLocation/ node. ただし、指定されたプロパティが存在するノードの構造が統一されている必要があります。

  4. Tap Save to save the configuration.

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

メモ

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

All cloud service configurations in AEM are consolidated in the /conf folder in AEM repository. デフォルトの場合、conf フォルダーには global フォルダーが含まれています。このフォルダーで、クラウドサービスの設定を作成することができます。ただし、このフォルダーを手動でクラウド設定用に有効にする必要があります。追加のフォルダーを conf フォルダー内に作成して、クラウドサービスの作成と編集を行うこともできます。

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

  1. Go to Tools > General > Configuration Browser.

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

    1. 設定ブラウザー​で、「global」フォルダーを選択して「プロパティ」をタップします。
    2. 設定プロパティ​ダイアログで、「クラウド設定」を有効にします。
    3. 保存して閉じる」をタップして設定内容を保存し、ダイアログを閉じます。
  3. 設定ブラウザー​で「作成」をタップします。

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

  5. Tap Create to create the folder enabled for cloud service configurations.

RESTful Web サービスの設定

RESTful web service can be described using Swagger specifications in JSON or YAML format in a Swagger definition file. AEM クラウドサービスで RESTful Web サービスを設定するには、ファイルシステム内に Swagger ファイルが存在しているか、Swagger ファイルがホストされる URL を指定する必要があります。

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

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

    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.

  2. Tap Create to open the Create Data Source Configuration dialog. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「RESTful サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

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

    • 「Swagger ソース」ドロップダウンで「URL」または「ファイル」を選択します。「URL」を選択した場合は、Swagger 定義ファイルに対する Swagger の URL を指定し、「ファイル」を選択した場合は、ローカルのファイルシステムから Swagger ファイルをアップロードします。
    • 認証の種類(「なし」、「OAuth2.0」、「基本認証」、「APIキー」、「カスタム認証」)を選択してRESTfulサービスにアクセスし、認証の詳細を指定します。
  4. 作成」をタップして、RESTful サービス用のクラウド設定を作成します。

SOAP Web サービスの設定

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

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

    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.

  2. Tap Create to open the Create Data Source Configuration dialog. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「SOAP Web サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

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

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

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

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

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

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

OData サービスの設定

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

メモ

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

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

    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.

  2. Tap Create to open the Create Data Source Configuration dialog. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「OData サービス」を選択します。必要な場合は、設定のサムネイル画像を選択して「次へ」をタップします。

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

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

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

  4. Tap Create to create the cloud configuration for the OData service.

次の手順

上記の手順により、データソースが設定されました。次に、フォームデータモデルを作成します。データソースが設定されていないフォームデータモデルが既に作成されている場合は、上記の手順で設定したデータソースにそのフォームデータモデルを関連付けます。See Create form data model for details.

このページ