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

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

Apache Sling Connection Pooled DataSource 設定を検索します。その設定を選択して編集モードで開きます。

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

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

「Test on Borrow ​または「Test on Return」を有効にして、オブジェクトがプールから借用またはプールに返される前に検証されることを指定します。

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

• SELECT 1（MySQL または MS SQL の場合）
• SELECT 1 from dual（Oracle の場合）

「保存」を選択して、設定を保存します。

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

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

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

name=[property_name_with_location_in_user_profile],type=[property_type]

例：

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

「保存」を選択して、設定を保存します。

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

• 詳しくは、設定ブラウザーのドキュメントを参照してください。

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

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

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

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

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

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

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

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

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

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

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 サービスの証明書ベースの相互認証を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

• Web サービスの WSDL URL。

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

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

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

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

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

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

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

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

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

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

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

秘密鍵（証明書）を AEM Forms サーバーにアップロードします。秘密鍵をアップロードするには：

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

Global Trust Store に信頼する証明書をアップロードします。証明書をアップロードするには：

1. ツール／セキュリティ／Trust Store に移動します。
2. 「CER ファイルから証明書を追加」オプションを展開し、「証明書ファイルを選択」を選択し、証明書をアップロードして、「送信」を選択します。

データソースとして SOAP または RESTful web サービスを設定し、認証タイプとして「相互認証」を設定します。fd-cloudservice ユーザーに複数の自己署名証明書を設定する場合は、証明書のキーエイリアス名を指定します。