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とMicrosoft Dynamics 間の通信を有効にするように、AEM Formsで OAuth クラウドサービスを設定します。
Adobe Sign スケジューラーの設定 オーサーとパブリッシュ
ステータスを 2 秒間隔で確認するようにスケジューラーの設定を変更します。
リファレンスサイトの Adobe Sign クラウドサービスの設定 オーサーとパブリッシュ
リファレンスサイトパッケージに付属している設定を、有効な資格情報で設定し直す必要があります。
匿名ユーザー用のフォーム共通設定サービスの構成 公開 この設定により、匿名ユーザーに対して送信、署名、レコードのドキュメントを生成できます。
フォームデータモデルに対する REST サービス Swagger ファイルの修正 オーサーとパブリッシュ
現在の環境に合わせてサービスを修正します。

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

AEM Formsのインストールとデプロイ ( OSGi へのAEM Formsのインストールと設定.

メモ

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

SSL の設定

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

注意

SSL の強制を設定しない /etc/map フォルダー。

Day CQ Link Externalizer の設定

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

注意

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

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

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

  1. OSGi 設定 (https://<) に移動します。hostname>:<ポート >/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>:<ポート >/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 を指定します。

注意

入れない /lc (AEM Forms OSGi 用に設定する場合 )

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

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

パッケージの使用方法について詳しくは、 パッケージの操作方法.

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

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

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

(オプション)サンプルデータをMicrosoft Dynamics にインポートする

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

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

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

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

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

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

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

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

    • 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 インスタンスで、以下の操作を実行します。

    • に移動します。 セールス/We.Finance のお客様 をクリックし、 インポート.
    • に移動します。 営業 > We.Finance 自動保険 をクリックし、 インポート.
    • に移動します。 セールス > We.Finance 社の住宅ローン をクリックし、 インポート.

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

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

  1. AEMオーサーインスタンスで、に移動します。 ツール/Cloud Services/データソース/グローバル. タップ リファレンスサイトの Dynamics 統合 アイコンとタップ プロパティ.
  2. Microsoft Azure Active Directory のアカウントに移動します。登録済みアプリケーションの「応答 URL」設定に、コピーしたクラウドサービス設定の URL を追加します。設定を保存します。
  3. 「認証設定」タブで、次の情報を指定します。 サービスルート, クライアント ID, クライアント秘密鍵、および リソース URL (Microsoft Dynamics インスタンス用 ) クリック OAuth に接続 Microsoft Dynamics のログインページにリダイレクトされる
  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. AEM Web Configuration コンソール ( ) に移動します。 https://[server]:[host]/system/console/configMgr.

  2. 検索とタップ Adobe Sign Configuration Service をクリックして、設定用に開きます。

  3. 設定 ステータス更新スケジューラの式 as 0 0/2 ***?.

    メモ

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

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

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

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

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

    注意

    https://[ホスト]:[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. AEM Web Configuration コンソール ( ) に移動します。 https://[server]:[port]/system/console/configMgr.
  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 > データソース > global. 選択 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/レガシー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://< に移動します。ホスト>:<ポート>/system/console/configMgr を開き、以下の手順を実行します。

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

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

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

Target の設定

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

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

  1. jvm 引数でオーサークイックスタートを開始します。 -Dabtesting.enabled=true :サーバー上で A/B テストを有効にします。

    注意: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>:<ポート>/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>:<ポート>.

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

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

次の手順

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

このページ