ドキュメントAEM as a Cloud Serviceユーザーガイド

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

Last update: Wed Jan 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用対象：
  • Experience Manager as a Cloud Service

作成対象：

  • 初心者
  • ユーザー
  • 開発者
バージョン
記事リンク
AEM 6.5
ここをクリックしてください
AEM as a Cloud Service
この記事

データ統合

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

  • リレーショナルデータベース - MySQL、Microsoft® SQL Server、IBM® DB2®、postgreSQL、Azure SQL および Oracle RDBMS
  • RESTful Web サービス
  • SOAP ベースの web サービス
  • OData サービス（バージョン 4.0）
  • Microsoft® Dynamics
  • Salesforce
  • Microsoft® Azure Blob Storage

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

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

前提条件

Experience Manager web コンソール設定を使用してリレーショナルデータベースを設定する前に、次の操作が必須です。

リレーショナルデータベースを設定する手順

Experience Manager web コンソールの設定を使用して、リレーショナルデータベースを設定することができます。次の手順を実行します。

手順 1:AEM as a Cloud Service Git リポジトリのクローン

  1. コマンドラインを開き、AEM as a Cloud Service リポジトリを保存するディレクトリ（例：/cloud-service-repository/）を選択します。

  2. 次のコマンドを実行して、リポジトリのクローンを作成します。

    code language-none 
    git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/

    この情報はどこにありますか？

    これらの詳細を見つける手順について詳しくは、Adobe Experience League の記事「Git へのアクセス」を参照してください。

    コマンドが正常に完了すると、ローカルディレクトリに新しいフォルダーが作成されます。このフォルダーの名前は、アプリケーションに合わせて指定します。

手順 2：設定フォルダーに移動する

  1. エディターでリポジトリフォルダーを開きます。

  2. <application folder> 内の次のディレクトリに移動します。このディレクトリには、JDBC プールの OSGi 設定を配置する必要があります。

    code language-bash 
    cd ui.config/src/jcr_root/apps/<application folder>/osgiconfig/config/

手順 3:MySQL 接続設定ファイルを作成する

  1. 次のファイルを作成します。

    code language-bash 
    com.day.commons.datasource.jdbcpool.JdbcPoolService~<application folder>-mysql.cfg.json

  2. 次のコード行を追加します。

{
  "jdbc.driver.class": "com.mysql.cj.jdbc.Driver",
  "jdbc.connection.uri": "jdbc:mysql://<hostname>:<port>/<database>?useSSL=false",
  "jdbc.username": "<your-db-username>",
  "jdbc.password": "<your-db-password>",
  "datasource.name": "<application folder>-mysql",
  "datasource.svc.prop.name": "<application folder>-mysql"
}

<application folder>、<hostname>、<database>、<your-db-username>、<your-db-password> などのプレースホルダーを実際の値に置き換えます。

手順 4：変更をコミットしてプッシュする

ターミナルを開き、次のコマンドを実行します。

git add .
git commit -m "<commit message>"
git push

手順 5:Cloud Manager パイプラインを使用して変更をデプロイする

  1. AEM Cloud Manager にログインします。
  2. プロジェクトに移動し、パイプラインを実行して変更をデプロイします。
NOTE
詳しくは、JDBC DataSourcePool を使用した SQL 接続を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

RESTful web サービスは、Swagger の仕様に従い、JSON 形式または YAML 形式で Swagger 定義ファイルまたはサービスエンドポイント内に記述することができます。

NOTE
Experience Manager as a Cloud Service で RESTful web サービスを設定するには、ファイルシステムまたはファイルがホストされている URL に Swagger ファイル（Swagger Version 2.0）Swagger ファイル（Swagger Version 3.0）が存在しているか、Swagger ファイルがホストされる URL を指定する必要があります。

Open API 仕様バージョン 2.0 用の RESTful サービスの設定 configure-restful-services-open-api-2.0

  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 つを選択し、それに応じて「パラメーター名」フィールドにヘッダーまたはクエリパラメーターの名前を指定します。

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

Open API 仕様バージョン 3.0 用の RESTful サービスの設定 configure-restful-services-open-api-3.0

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

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

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

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

    • 「Swagger ソース」ドロップダウンで「URL」または「ファイル」を選択します。「URL」を選択した場合は、​ Swagger 定義ファイルに対する Swagger 3.0 URL を指定し、「ファイル」を選択した場合は、ローカルのファイルシステムから Swagger ファイルをアップロードします。
    • ​ Swagger ソース入力に基づいて、ターゲットサーバとの接続情報が表示されます。
    • RESTful サービスにアクセスするための認証タイプ（なし、OAuth2.0（認証コード、クライアント資格情報）、基本認証、API キー認証、カスタム認証）を選択し、その選択内容に応じて認証の詳細を指定します。

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

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

RESTful サービス Open API 仕様バージョン 3.0 でサポートされていない操作の一部は次のとおりです。

  • コールバック
  • oneof/anyof
  • リモート参照
  • リンク
  • 1 回の操作に対する異なる MIME タイプの異なるリクエスト本文

詳しくは、OpenAPI 3.0 仕様を参照してください。

サービスエンドポイントを使用した RESTful サービスの設定 configure-restful-services-service-endpoint

サービスエンドポイント機能は早期導入プログラムの対象であり、コアコンポーネントにのみ適用されます。早期導入プログラムに登録し、機能へのアクセスをリクエストするには、公式メール ID から aem-forms-ea@adobe.com にメールを送信してください。

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

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

  2. 「作成」を選択して、データソース設定を作成ウィザード​を開きます。

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

  4. 次のページで、RESTful サービスドロップダウン​から「サービスエンドポイント」を選択します。

    サービスエンドポイント

  5. サービス エンドポイント URL を指定します。

    note note
    NOTE
    デフォルトでは、メソッドタイプは POST です。

    1. ドロップダウンリストから選択するコンテンツタイプの 1 つを選択します。コンテンツタイプは、マルチパートフォームデータ、JSON、URL エンコード（キーと値のペア）です。

  6. 次に、ドロップダウンリストから「OAuth 2.0」、「基本認証」、「API キー」、「カスタム認証」などの認証タイプのいずれかを選択します。
    サービスエンドポイント認証タイプ

  7. 「作成」をクリックします。

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

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

REST データソース設定のフォームデータモデル HTTP クライアント設定​の次のプロパティを設定し、正規表現を指定します。

  • http.connection.max.per.route プロパティを使用して、フォームデータモデル（FDM）と RESTful web サービス間で許可される最大接続数を設定します。デフォルト値は 20 接続です。

  • http.connection.max プロパティを使用して、各ルートに許可される最大接続数を指定します。デフォルト値は 40 接続です。

  • http.connection.keep.alive.duration プロパティを使用して、永続的な HTTP 接続が有効に保たれる期間を指定します。デフォルト値は 15 秒です。

  • http.connection.timeout プロパティを使用して、Experience Manager Forms 接続が確立するまでのサーバーの待機時間を指定します。デフォルト値は 10 秒です。

  • http.socket.timeout プロパティを使用して、2 つのデータパケット間の無操作状態の最大期間を指定します。デフォルト値は 30 秒です。

以下の JSON ファイルにサンプルが表示されています。

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}

  1. 「REST データソース用フォームデータモデル HTTP クライアント設定」を選択します。

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

    • 「接続制限（合計）」フィールドに、フォームデータモデル（FDM）と 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）の仕様に従って記述します。Experience Manager Forms RPC-style WSDL モデルをサポートしていません。

Experience Manager as a Cloud Service で SOAP ベースの web サービスを設定するには、その web サービスの WSDL URL を確認して、以下の手順を実行します。

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

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

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

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

    • Web サービスの WSDL URL。

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

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

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

SOAP Web サービス WSDL でのインポート文の使用を有効にする enable-import-statements

SOAP Web サービス WSDL のインポート文として許可される絶対 URL のフィルターとして機能する正規表現を指定できます。デフォルトでは、このフィールドに値はありません。その結果、Experience Manager は WSDL で使用可能なすべてのインポート文をブロックします。このフィールドの値として .* を指定すると、Experience Manager はすべてのインポート文を許可します。

フォームデータモデル SOAP Web サービスインポート許可リスト​の設定の importAllowlistPattern プロパティを設定して、正規表現を指定します。以下の JSON ファイルにサンプルが表示されています。

{
  "importAllowlistPattern": ".*"
}

設定の値をセットするには、AEM SDK を使用して OSGi 設定を生成し、Cloud Service インスタンスに設定をデプロイします。

OData サービスの設定 config-odata

OData サービスは、そのサービスのルート URL によって識別されます。Experience Manager as a Cloud Service で OData サービスを設定するには、そのサービスのルート URL を確認して、以下の手順を実行します。

NOTE
フォームデータモデル（FDM）は OData バージョン 4 をサポートします。
オンライン環境またはオンプレミス環境で Microsoft®® Dynamics 365 を設定する詳しい手順については、Microsoft® Dynamics OData 設定を参照してください。

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

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

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

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

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

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

    note note
    NOTE
    OData エンドポイントをサービスルートとして使用して Microsoft®® Dynamics サービスに接続する場合は、OAuth 2.0 認証タイプを選択します。

  4. 「作成」を選択して、OData サービス用のクラウド設定を作成します。

次の手順 next-steps

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab