AEM Forms リファレンスサイトのセットアップおよび設定

AEM Forms のリファレンスサイトでは、金融サービス業界や各種行政機関が AEM Forms をどのように使用して、複雑なトランザクションを、場所、時間、デバイスを問わないシンプルで魅力的なデジタルサービスに変換しているかについて紹介しています。

We.Finance と We.Gov のリファレンスサイトでは、実生活における使用例が紹介されています。最初の操作から通信やトランザクションの管理に至るまで、既存の顧客や見込み顧客に対して、カスタマイズされたコスト効率の高い方法でサービスを提供しています。

AEM Forms のリファレンスサイトでは、以下に示す AEM Forms の主要な機能を参照することができます。

  • 魅力的でレスポンシブなアダプティブフォームとインタラクティブ通信のオーサリングエクスペリエンスを簡素化。
  • インタラクティブ通信:デバイスの設定やレイアウトに合わせて、インタラクティブでパーソナライズされたレスポンシブな顧客通信を作成します。
  • データを統合して各種のデータソースに接続し、データをフォームに事前に取り込み、フォームデータモデル経由でフォームを送信。
  • ビジネスの各種プロセスとワークフローを自動化するためのフォームワークフロー。
  • 高度なユーザーデータ管理および処理機能。
  • アダプティブフォームに安全に署名して送信するための Adobe Sign との統合。
  • ターゲットを設定したレコメンデーションを提供し、フォームからの ROI を最大化する A/B テストを実行するための Adobe Target との統合。
  • フォームとキャンペーンのパフォーマンスを計測し、十分な情報を得た上で意志決定を行うための Adobe Analytics との統合。
  • フォーム入力の操作性が向上。

リファレンスサイトには、独自のアセットを作成するためのテンプレートとして使用可能なアセットが用意されています。これらのアセットは、繰り返し使用することができます。

  • アダプティブフォームに安全に署名して送信するための Adobe Sign との統合。

  • アダプティブフォームに安全に署名して送信するための Adobe Sign との統合。

リファレンスサイトの設定手順と前提条件

リファレンスサイトを設定する前に、次の点を確認してください。

  • AEM essentials

    AEM QuickStart、AEM Formsアドオンパッケージおよびリファレンスサイトパッケージ。 アドオンおよびリファレンスサイトパッケージの詳細については、AEM Formsリリースを参照してください。

  • SMTP サービス 任意の SMTP サービスを使用することができます。

  • Adobe Sign開発者アカウントとAdobe Sign APIアプリケーション

    デジタル署名機能を使用するには、Adobe Sign開発者アカウントが必要です。 詳しくは、「Adobe Sign」を参照してください。

  • AEM Formsと統合するMicrosoft Dynamics 365の実行中のインスタンス。 リファレンスサイトを実行するには、サンプルデータをMicrosoft Dynamicsインスタンスに読み込み、リファレンスサイトで使用するインタラクティブ通信を事前に入力します。

  • Formsアドオンパッケージを含むAEM 6.4の実行インスタンス。 詳しくは、「AEM Forms のインストールと設定」を参照してください。

リファレンスサイトのセットアップと構成を行うには、以下の手順を実行します。以下に記載されているとおりの順序で実行することをお勧めします。

ステップ の設定 備考
AEM Forms のインストールと設定 オーサーインスタンスとパブリッシュインスタンス AEM Forms のオーサーインスタンスとパブリッシュインスタンスをインストールして設定を行います。
SSL の設定 オーサーインスタンスとパブリッシュインスタンス
Adobe Sign とのセキュアな通信を行うために、SSL 経由の HTTP を有効にします。

Day CQ Link Externalizer の設定

オーサーインスタンスとパブリッシュインスタンス

リファレンスサイトの使用例では、異なるトランザクションの電子メールを配信しています。この設定は、電子メールでニュースレターを配信する場合に必要になります。この設定により、URL と画像でパブリッシュインスタンスが参照されるようになります。

Day CQ 電子メールサービスを設定する オーサーインスタンスとパブリッシュインスタンス 電子メールによる通信を行う場合は、この設定が必要になります。
デフォルトの XSS 設定の上書き 公開 xssセキュリティによってブロックされている$、{、}文字を上書きするために使用します。
AEM DS の設定 作成者 パブリッシュインスタンスでのフォーム送信と、オーサーインスタンスでのプロセスワークフローについて、AEM DS を設定します。
リファレンスサイトパッケージのデプロイメント 作成者 AEM Forms のオーサーインスタンスに、リファレンスサイトパッケージをデプロイします。
サンプルデータを Microsoft Dynamics に読み込む オーサーインスタンスとパブリッシュインスタンス クレジットカード申し込み、住宅ローン申し込み、住宅保険申し込みのチュートリアル用のサンプルデータをインポートします。
OAuth クラウドサービスを Microsoft Dynamics 用に設定する オーサーインスタンスとパブリッシュインスタンス AEM FormsでOAuthクラウドサービスを設定して、AEM FormsとMicrosoft Dynamics間の通信を有効にします。
Adobe Sign スケジューラーの設定 オーサーインスタンスとパブリッシュインスタンス
ステータスを 2 秒間隔で確認するようにスケジューラーの設定を変更します。
リファレンスサイトの Adobe Sign クラウドサービスの設定 オーサーインスタンスとパブリッシュインスタンス
リファレンスサイトパッケージに付属している設定を、有効な資格情報で設定し直す必要があります。
匿名ユーザー用のフォーム共通設定サービスの構成 公開 この設定により、匿名ユーザーに対して送信、署名、レコードのドキュメントを生成できます。
フォームデータモデルに対する REST サービス Swagger ファイルの修正 オーサーインスタンスとパブリッシュインスタンス
現在の環境に合わせてサービスを修正します。

AEM Forms のインストールと設定

OSGiへのAEM Formsのインストールと設定」の説明に従って、AEM Formsをインストールしてデプロイします。

メモ

複数のパブリッシュインスタンスが存在する場合や、オーサーインスタンスとパブリッシュインスタンスが異なるマシン上に存在する場合は、複製エージェントと逆複製エージェントを設定してください。

SSL の設定

Adobe Sign サーバーとの通信を行うには、SSL を設定する必要があります。詳細な手順については、HTTP over SSLの有効化を参照してください。

注意

/etc/mapフォルダーで強制SSLを設定しないでください。

Day CQ Link Externalizer の設定

AEMの​Externalizer​は、事前に設定されたDNSでパスを接頭辞として付け、リソースパス(例えば、/path/to/my/page)を外部および絶対URL(例えば、https://www.mycompany.com/path/to/my/page)にプログラムで変換できるOSGIサービスです。 詳しくは、「URL の外部化」を参照してください。

注意

SSL で自己署名証明書を使用する場合は、HTTPS URL を外部化しないでください。

また、ローカルサーバーの場合は、サーバーのホスト名ではなく localhost を使用してください。

オーサーインスタンスとパブリッシュインスタンスの両方で、以下の手順を実行します。

  1. OSGi設定(https://<hostname>:port>/system/console/configMgr)に移動します。

  2. Day CQ Link Externalizer​設定を探してタップします。

    設定を編集するための Day CQ Link Externalizer ダイアログが表示されます。

  3. Day CQ Link Externalizer ダイアログの「ドメイン」フィールドで、以下の操作を実行します。

    • オーサーインスタンスで、外部システムからアクセス可能な発行 URL を指定します。例えば、ホスト名や発行用の Web サーバーを指定します。
    • パブリッシュインスタンスで、オーサー URL と発行 URL の両方を指定します。
  4. オーサーインスタンスとパブリッシュインスタンスの両方で、「ドメイン」フィールドにローカルサーバーの URL が指定されていることを確認します。

  5. 保存」をタップします。すべてのサービスが再開されるまで待ちます。

Day CQ 電子メールサービスの設定

リファレンスサイトの実装では、ユーザーがフォームに入力して送信した場合に電子メールをサンプルユーザーに送信する必要があります。Day CQ 電子メールサービスを設定して SMTP サービスの詳細を指定することにより、顧客に対して電子メールを自動的に送信することができます。詳しくは、「電子メール通知の設定」を参照してください。

パブリッシュインスタンスで以下の手順を実行して、電子メールサービスを設定します。

  1. OSGi設定(https://<hostname>:port>/system/console/configMgr)に移動します。
  2. Day CQ Mail Service」を探してタップし、設定用に開きます。
  3. SMTP サーバーのホスト名とポートの値を入力します。
  4. 保存」をタップします。
メモ

社内の SMTP サービスを使用することも、Gmail などのパブリックサービスを使用することもできます。SMTP サービスの設定方法については、SMTP サービスのマニュアルを参照してください。

デフォルトの XSS 設定の上書き

We.Finance リファレンスサイトの電子メールテンプレートには、電子メール内で使用するカスタマイズされた各種リンクが用意されています。これらのリンクには、${placeholder}というプレースホルダーがあります。 プレースホルダーは、電子メールの送信前に実際の値に置き換えられます。AEM のデフォルトの XSS 保護設定では、HTML コンテンツ内の URL に波括弧({ })を使用できません。ただし、パブリッシュインスタンスで以下の手順を実行することにより、デフォルトの設定を上書きすることができます。

  1. /libs/cq/xssprotection/config.xml/apps/cq/xssprotection/config.xml にコピーします。

  2. 次を開きます: /apps/cq/xssprotection/config.xml.

  3. common-regexpsセクションで、onsiteURLエントリを次のように変更し、ファイルを保存します。

    <regexp name="onsiteURL" value="([\p{L}\p{N}\\\.\#@\$\{\}%\+&;\-_~,\?=/!\*\(\)]*|\#(\w)+)"/>

メモ

中括弧({ })は、HTMLコンテンツのURLに使用できる文字として含まれます。

SMTP サーバーを設定したら、Sarah Rose のペルソナを使ってフォームに入力し、下書きとして保存します。下書きとして保存する場合、電子メールを使用してその下書きを受信するオプションがあります。「電子メールを送信」ボタンをタップして、アプリケーションのドラフトのリンクが記載された電子メールを受信すれば、電子メールが正しく設定されています。Sarah の資格情報を使用してログインし、下書きを参照できることを確認してください。

AEM DS の設定

リファレンスサイトの使用例では、電子メール通信用のパブリッシュインスタンスにAEM DSサービスの設定が必要です。 パブリッシュインスタンスでAEM DSサービスを設定する詳細な手順については、「AEM DSの設定」を参照してください。

AEM Formsリファレンスサイトの場合、AEM DS Settings Serviceで、処理サーバーのURLではなく、パブリッシュサーバーのURLを指定します。

注意

AEM Forms OSGi用に設定する場合は、処理サーバーのURLに/lcを入れないでください。

リファレンスサイトパッケージのデプロイメント

ソフトウェアディストリビューションを使用して、以下のリファレンスサイトパッケージをインストールします。

パッケージの使用方法について詳しくは、パッケージの使用方法を参照してください。

パッケージをインストールして、オーサーインスタンスとパブリッシュインスタンスを開始したら、ブラウザーで以下の URL にアクセスします。

  • https://[server]:[port]/wegov
  • https://[server]:[port]/wefinance

インストールが正常に完了すると、We.Gov と We.Finance のリファレンスサイトのランディングページにアクセスできるようになります。

(オプション)サンプルデータをMicrosoft Dynamicsに読み込む

住宅ローン申し込みと自動保険申し込みリファレンスサイトは、Microsoft Dynamicsのレコードを使用するように構成されています。 リファレンスサイトパッケージでは、Microsoft Dynamicsに読み込んでリファレンスサイトを実行できるカスタムエンティティとサンプルレコードがインストールされます。 サンプルデータを移行して設定するには、次の手順を実行します。

自動保険申し込みのカスタムエンティティをインポートする手順は、次のとおりです。

  1. AEMオーサーインスタンスのhttps://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/WeFinanceAutoInsurance_1_0.zipから​WeFinanceAutoInsurance_1_0.zip​ソリューションパッケージをダウンロードします。
  2. Microsoft Dynamicsインスタンスで、設定​メニューの​ソリューション​に移動し、読み込み​をクリックします。 パッケージを選択してインポートします。

自動保険申し込みのカスタムエンティティをインポートする手順は、次のとおりです。

  1. https://[author]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/AEMFormsFSIRefsite_1_0.zipから​AEMFormsFSIRefsite_1_0.zip​パッケージをダウンロードします。 パッケージを選択してインポートします。

  2. Microsoft Dynamicsインスタンスで、設定​メニューの​ソリューション​に移動し、読み込み​をクリックします。 パッケージを選択してインポートします。

顧客および保険契約レコードをインポートする手順は、次のとおりです。

  1. AEMオーサーインスタンスの次の場所から、 We.Finance Customers.csv 、 We.Finance Auto Insurance Renewals.csv 、および​住宅ローン​のデータファイルをダウンロードします。

    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Customers.csv
    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Auto Insurance Renewals.csv
    • https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/Sarah%20Rose%20Contact.csv
  2. Microsoft Dynamicsインスタンスで、次の操作を行います。

    • Sales/We.Financeのお客様​に移動し、​をインポート」をクリックします。
    • Sales/We.Finance Auto Insurance​に移動し、「Import」をクリックします。
    • Sales/We.Finance Home Mortgage​に移動し、「Import」をクリックします。

OAuth クラウドサービスを Microsoft Dynamics 用に設定する

AEM FormsでOAuthクラウドサービスを設定して、AEM FormsとMicrosoft Dynamics間の通信を有効にします。 次の手順を実行して、AEMオーサーインスタンスとパブリッシュCloud ServiceでOAuthインスタンスを設定します。

  1. AEMオーサーインスタンスで、ツール/Cloud Services/データソース/グローバル​に移動します。 Refsite Dynamics Integration​アイコンをタップし、「プロパティ」​をタップします。
  2. Microsoft Azure Active Directory のアカウントに移動します。登録済みアプリケーションの「応答 URL」設定に、コピーしたクラウドサービス設定の URL を追加します。設定を保存します。
  3. 「認証設定」タブで、Microsoft Dynamicsインスタンスの「サービスルート」、「クライアントID」、「クライアントの秘密鍵」、「リソースURL」を指定します。 Microsoft Dynamicsのログインページにリダイレクトする「OAuth​に接続」をクリックします。
  4. ログイン情報を入力します。ログインすると、AEM Forms Cloud Service設定ページにリダイレクトされます。 「保存して閉じる」をクリックします。クラウドサービスの設定が保存されます。
  5. Forms/データ統合/We.Finance​に移動します。 [自動保険(Dynamics)]を選択し、[編集]をクリックします。 Microsoft Dynamicsエンティティは、「データソース」タブに表示されます。 すべてのエンティティがMicrosoft Dynamicsから取得され、「データソース」タブに表示されるまで待ちます。
  6. AutoInsuranceRenewalエンティティ​を選択し、「モデルオブジェクトをテスト」をクリックします。 入力リクエストセクションで、顧客IDの値を「900001」と指定し、「テスト」をクリックします。 「出力」セクションには、顧客ID 900001のMicrosoft Dynamicsから取得されたレコードが表示されます。
  7. 入力リクエストセクションで、顧客IDの値を「900001」と指定し、「テスト」をクリックします。 「出力」セクションには、顧客ID 900001のMicrosoft Dynamicsから取得されたレコードが表示されます。
  8. パブリッシュインスタンスで手順1 ~ 6を繰り返します。

Adobe Sign スケジューラーの設定

オーサーインスタンスとパブリッシュインスタンスの両方で以下の手順を実行します。

  1. https://[server]:[host]/system/console/configMgrのAEM Web設定コンソールに移動します。

  2. Adobe Sign Configuration Service​を探してタップし、設定用に開きます。

  3. ステータス更新スケジューラーの式​を​0 0/2 &ast;として設定します。&ast;&ast;?.

    メモ

    上記のようにスケジューラーを設定すると、Adobe Sign サービスのステータスが 2 分間隔で確認されます。

  4. 保存」をタップします。

リファレンスサイトの Adobe Sign クラウドサービスの設定

オーサーインスタンスとパブリッシュインスタンスの両方で以下の手順を実行します。

  1. ツール/Cloud Services/Adobe Sign/グローバル​に移動します。 「AEM Formsリファレンスサイトの署名」を選択し、「プロパティ」をタップします。

    注意

    https://[host]:[ssl_port]/mnt/overlay/adobesign/cloudservices/adobesign/properties.html URLがAdobe Sign APIアプリケーションのOAuth設定のリダイレクトURLリストに追加されていることを確認します。

  2. クライアント ID と、Adobe Sign アプリケーション OAuth 設定の秘密鍵を指定します。

  3. (オプション)「添付ファイルにもAdobe Signを有効にする」オプションを選択し、「Adobe Signに接続」をタップします。 この操作により、アダプティブフォームの添付ファイルが、署名用に送信された対応する Adobe Sign ドキュメントに添付されます。

  4. Adobe Signに接続」をタップし、Adobe Signの資格情報を使用してログインします。

フォーム共通設定サービスの構成

匿名ユーザーによるアクセスを許可するには、パブリッシュインスタンス上で以下の手順を実行します。

  1. https://[server]:[port]/system/console/configMgrのAEM Web設定コンソールに移動します。
  2. Forms Common Configuration Service​を探してタップし、設定用に開きます。
  3. すべてのユーザー​に対して​許可​フィールドを設定します。
  4. 保存」をタップします。

フォームデータモデルに対する REST サービスの修正

オーサーインスタンスとパブリッシュインスタンスの両方で以下の手順を実行します。

  1. CRXDE(https://[server]:[port]/crx/de/index.jsp)に移動します。
  2. /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile​に移動し、swaggerファイルを開きます。
  3. 環境に応じてホストとポートの設定を更新します。
  4. 設定を保存します。
  5. オーサーインスタンスのみツール/Cloud Services/データソース/グローバル​に移動します。 roi-rest​を選択し、プロパティ​をタップします。 「認証設定」をタップし、「認証の種類」を「基本認証」に設定します。 サービスにアクセスするユーザー名とパスワードとしてadmin/ adminを指定します。 「保存して閉じる」をタップします。

Marketing Cloudとの統合

AEM FormsをAdobe AnalyticsおよびAdobe Targetと統合できます。 Adobe Analyticsは、アダプティブフォームのレポートを生成し、パフォーマンスを分析するのに役立ちますが、Adobe Targetは、パーソナライズされたエクスペリエンスを提供し、アダプティブフォームのA/Bテストを実行するのに役立ちます。

AEM FormsでAdobe AnalyticsとAdobe Targetを設定するには、次の手順を実行します。

Adobe Analytics の設定

AEM Forms を Adobe Analytics に統合することで、フォームやドキュメントに顧客がどう対応するか監視および分析できます。問題のある領域を特定して修正し、コンバージョン率を上げるのに役立ちます。

この機能をリファレンスサイトで使用するには、「分析とレポートの設定」の手順に従って、Analytics アカウントを設定します。

レポートを生成するために、シードデータはリファレンスサイトにバンドルされます。 シードデータを使用する前に、次の操作を行います。

  1. We.FinanceとWe.Govの分析設定がAEMクラウドサービスで使用可能であることを確認します。 クラウドサービスは、次のいずれかの方法で検索できます。

    • ツール/Cloud Services/従来のCloud Services​に移動するか、https://<host>:<port>/libs/cq/core/content/tools/cloudservices.htmlを参照します。
    • Cloud Services​ページの​Adobe Analytics​セクションで、Show Configurationsをクリックします。 We.FinanceおよびWe.Govの設定を使用できます。 クリックして設定を開きます。設定ページで「編集」をクリックします。有効な会社名、ユーザー名、共有暗号鍵(パスワード)およびデータセンターを入力し、「Analyticsに接続」をクリックします。 接続に成功したダイアログが表示されたら、設定ダイアログで「OK」をクリックします。 Analyticsとレポートの設定の説明に従って、Analytics設定の下でフレームワークを設定します。
  2. https://<host:<port/system/console/configMgrに移動し、次の操作を行います。

    • Webコンソール設定​ページで、AEM Forms Analytics設定​を探してクリックします。
    • AEM Forms Analytics設定ダイアログの「SiteCatalystフレームワーク」フィールドで、we-finance(we-finance)またはwe-gov(we-gov)を選択します。
    • 保存」をクリックして、ページを更新します。
  3. https://<host>:<port>/aem/formsのForms Managerに移動し、次の操作を行います。

    • We.FinanceフォルダーまたはWe.Govフォルダーを開き、レポートを表示するフォームを選択します。
    • アクションツールバーの「 Analyticsを有効にする」をクリックします。 フォームの分析を有効にしたら、「Analytics レポート」をクリックします。空白のレポートが生成されたことを確認できます。空のレポートが生成されたら、デモ用に分析レポートを生成するために、リファレンスサイトパッケージに付属のシードデータを提供する必要があります。

    リファレンスサイトは、クレジットカード、住宅ローン、チャイルドサポートの使用例に関するシードデータを含む分析レポートを提供します。 シードデータの設定については、We.FinanceリファレンスサイトのチュートリアルおよびWe.Govリファレンスサイトのチュートリアルを参照してください。

Target の設定

リファレンスサイトでは、アダプティブドキュメントにターゲットを設定し、パーソナライズしたコンテンツを含めるための AEM Forms と Adobe Target の統合を紹介しています。さらに、アダプティブフォームの A/B テストを作成することもできます。

リファレンスサイトで統合を利用するには、AEM で次のように Target を設定します。

  1. サーバーでA/Bテストを有効にするには、jvm引数-Dabtesting.enabled=trueでオーサークイックスタートを起動します。

    注意:AEMインスタンスがJBoss(自動インストールからサービスとして開始)上で動作している場合は、ファイルの次のエントリにパラメー -Dabtesting.enabled=true ターを追加 jboss\bin\standalone.conf.bat します。

    set "JAVA_OPTS=%JAVA_OPTS% -Dadobeidp.serverName=server1 -Dfile.encoding=utf8 -Djava.net.preferIPv4Stack=true -Dabtesting.enabled=true"

  2. https://<hostname:<port>/libs/cq/core/content/tools/cloudservices.htmlにアクセスします。

  3. Adobe Target」セクションで、「設定を表示」をクリックします。 We.Finance Target設定を使用できます。 クリックして設定を開きます。設定ページで「編集」をクリックします。設定の​コンポーネントを編集​ダイアログが開きます。

  4. Target アカウントに関連付けるクライアントコード、電子メール、パスワードを指定します。APIタイプとして​REST​を選択します。

  5. Adobe Target に接続」をクリックします。Targetアカウントが正常に設定されたら、「OK」をクリックします。 パッケージ化された設定にTargetフレームワークが含まれていることを確認できます。

  6. https://<hostname>:<port/system/console/configMgrに移動します。

  7. AEM Forms Target の設定」をクリックします。

  8. Targetフレームワークを選択します。

  9. Target URLs」フィールドに、AEM Forms への URL を指定します。例:https://<hostname>:<port>.

  10. 保存」をクリックします。

クレジットカード申し込みと住宅ローン申し込みの使用例では、デモ用にA/Bテストを実行し、レポートを表示する方法を示しています。 チュートリアルについては、We.Financeリファレンスサイトのチュートリアルを参照してください。

次の手順

これで、リファレンスサイトを利用するための設定がすべて完了しました。リファレンスサイトのワークフローと手順についての詳細は以下を参照してください。

このページ