データソースの設定 configure-data-sources
様々なタイプのデータソースを設定し、を活用してフォームデータモデルを作成する方法を説明します。
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 コンソールで設定します。
リレーショナルデータベースの設定 configure-relational-database
リレーショナル・データベースは、AEM Web コンソール構成を使用して構成できます。 以下の操作を実行します。
-
AEM web コンソール(
https://[server]:[host]/system/console/configMgr
)にアクセスします。 -
を探す Apache Sling 接続プールに入れられたデータソース 設定。 その設定をタップして編集モードで開きます。
-
設定ダイアログで、設定するデータベースの詳細を指定します。例えば、以下のような詳細を指定します。
- データソースの名前
- データソース名を保存するデータソースサービスプロパティ
- JDBC ドライバーの Java クラス名
- JDBC 接続 URI
- JDBC ドライバとの接続を確立するためのユーザー名とパスワード
note note NOTE データソースを設定する前に、パスワードなどの機密情報を必ず暗号化してください。 暗号化するには: https://[server]:[port]/system/console/crypto
にアクセスします。- 内 プレーンテキスト フィールドで、暗号化するパスワードまたは任意の文字列を指定し、「 Protect.
暗号化されたテキストが「保護されたテキスト」フィールドに表示されます。このテキストを設定内で指定できます。 -
有効にする 借りてテスト または リターンテスト を指定して、オブジェクトをプールから借りる前またはプールに返す前に、オブジェクトを検証するように指定します。
-
SQL SELECT クエリを 検証クエリ プールからの接続を検証するフィールド。 クエリは、少なくとも 1 つの行を返す必要があります。 データベースに応じて、次のいずれかを指定します。
- SELECT 1(MySQL または MS SQL の場合)
- SELECT 1 from dual(Oracle の場合)
-
「保存」をタップして、設定内容を保存します。
AEMユーザープロファイルの設定 configure-aem-user-profile
AEM Web コンソールのユーザープロファイルコネクタ設定を使用して、AEMユーザープロファイルを設定できます。 以下の操作を実行します。
-
AEM web コンソール(
https://[server]:[host]/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
note note NOTE この * 上記の例では、 profile/empLocation/
CRXDE 構造のAEMユーザープロファイルのノード。 この場合、profile/empLocation/
ノード配下のいずれかのノード内に存在するstring
タイプのcity
プロパティに、フォームデータモデルからアクセスすることができます。ただし、指定されたプロパティが存在するノードの構造が統一されている必要があります。 -
「保存」をタップして、設定内容を保存します。
クラウドサービス設定用フォルダーの構成 cloud-folder
AEM におけるすべてのクラウドサービス設定は、AEM リポジトリの /conf
フォルダー内に保存されます。デフォルトの場合、conf
フォルダーには global
フォルダーが含まれています。このフォルダーで、クラウドサービスの設定を作成できます。ただし、このフォルダーを手動でクラウド設定用に有効にする必要があります。追加のフォルダーを conf
フォルダー内に作成して、クラウドサービスの作成と編集を行うこともできます。
クラウドサービス設定用のフォルダーを構成するには、以下の手順を実行します。
-
ツール/一般/設定ブラウザー に移動します。
- 詳しくは、設定ブラウザーのドキュメントを参照してください。
-
以下の手順を実行して、global フォルダーをクラウド設定用に有効にします。クラウドサービス設定用に別のフォルダーを作成する場合は、この手順をスキップしてください。
- 設定ブラウザー で、「
global
」フォルダーを選択して「プロパティ」をタップします。 - 内 設定プロパティ ダイアログ、有効 クラウド設定.
- 「保存して閉じる」をタップして設定内容を保存し、ダイアログを閉じます。
- 設定ブラウザー で、「
-
内 設定ブラウザー をタップします。 作成.
-
内 設定を作成 ダイアログで、フォルダーのタイトルを指定し、有効にします クラウド設定.
-
「作成」をタップします。これで、クラウドサービス設定が有効になったフォルダーが作成されました。
RESTful Web サービスの設定 configure-restful-web-services
RESTful web サービスは、Swagger の仕様に従い、JSON 形式または YAML 形式で Swagger 定義ファイル内に記述することができます。AEM クラウドサービスで RESTful Web サービスを設定するには、ファイルシステム上に Swagger ファイルが存在するか、ファイルがホストされている URL が存在していることを確認します。
RESTful サービスを設定するには、以下の手順を実行します。
-
ツール/Cloud Services/データソース に移動します。クラウド設定の作成対象となるフォルダーをタップして選択します。
クラウドサービス設定用フォルダーの作成方法と構成方法については、「クラウドサービス設定用フォルダーの構成」を参照してください。
-
タップ 作成 開く データソース設定を作成ダイアログ. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「RESTful サービス」を選択します。必要な場合は、設定のサムネール画像を選択して「次へ」をタップします。
-
RESTful サービスの次の詳細を指定します。
- 「Swagger Source」ドロップダウンから「URL」または「File」を選択し、Swagger URL を Swagger 定義ファイルに指定するか、ローカルファイルシステムから Swagger ファイルをアップロードします。
- RESTful サービスにアクセスするための認証タイプ(「なし」、「OAuth2.0 認証」、「基本認証」、「API キー認証」、「カスタム認証」)を選択し、その選択内容に応じて認証の詳細を指定します。
-
「作成」をタップして、RESTful サービス用のクラウド設定を作成します。
SOAP Web サービスの設定 configure-soap-web-services
SOAP ベースの web サービスは、Web Services Description Language(WSDL)の仕様に従って記述します。AEM クラウドサービスで SOAP ベースの Web サービスを設定するには、Web サービスの WSDL URL があることを確認し、次の手順を実行します。
-
ツール/Cloud Services/データソース に移動します。クラウド設定の作成対象となるフォルダーをタップして選択します。
クラウドサービス設定用フォルダーの作成方法と構成方法については、「クラウドサービス設定用フォルダーの構成」を参照してください。
-
タップ 作成 開く データソース設定を作成ダイアログ. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「SOAP Web サービス」を選択します。必要な場合は、設定のサムネール画像を選択して「次へ」をタップします。
-
SOAP Web サービスに対して次の情報を指定します。
-
Web サービスの WSDL URL。
-
サービスエンドポイント。WSDL で指定されているサービスエンドポイントを上書きするには、このフィールドの値を指定します。
-
SOAP サービスにアクセスするための認証の種類(「なし」、「OAuth2.0」、「基本認証」、「カスタム認証」、「X509 トークン」)を選択し、認証の詳細を指定します。
認証の種類として X509 トークンを選択した場合は、X509 証明書を設定します。詳しくは、証明書の設定を参照してください。
X509 証明書のキーストアエイリアスを キーエイリアス フィールドに指定します。有効期間 フィールドに、認証リクエストが有効なままになるまでの時間(秒)を指定します。オプションで、メッセージの本文、タイムスタンプヘッダーまたはその両方に署名することを選択します。
-
-
「作成」をタップして、SOAP web サービス用のクラウド設定を作成します。
OData サービスの設定 config-odata
OData サービスは、そのサービスのルート URL によって識別されます。AEM クラウドサービスで OData サービスを設定するには、そのサービスのサービスルート URL があることを確認し、次の手順を実行します。
-
ツール/Cloud Services/データソース に移動します。クラウド設定の作成対象となるフォルダーをタップして選択します。
クラウドサービス設定用フォルダーの作成方法と構成方法については、「クラウドサービス設定用フォルダーの構成」を参照してください。
-
タップ 作成 開く データソース設定を作成ダイアログ. 設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「OData サービス」を選択します。必要な場合は、設定のサムネール画像を選択して「次へ」をタップします。
-
OData サービスの次の詳細を指定します。
- 設定する OData サービスのサービスルート URL。
- OData サービスにアクセスするための認証タイプ(なし、OAuth2.0 認証、基本認証、カスタム認証)を選択し、その選択内容に応じて認証の詳細を指定します。
note note NOTE OData エンドポイントをサービスルートとして使用して Microsoft Dynamics サービスに接続する場合は、OAuth 2.0 認証を選択する必要があります。 -
「作成」をタップして、OData サービス用のクラウド設定を作成します。
次の手順 next-steps
上記の手順により、データソースが設定されました。次に、フォームデータモデルを作成するか、データソースのないフォームデータモデルを既に作成している場合は、設定したデータソースに関連付けることができます。 詳しくは、「フォームデータモデルの作成」を参照してください。