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 SignAPIアプリケーション

    デジタル署名機能を使用するには、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 のインストールと設定

OSGiでのAEM Formsのインストールと設定の説明に従って、AEM Formsをインストールし、展開します。

メモ

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

SSL の設定

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

注意

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

Day CQ Link Externalizer の設定

AEMでは、Externalizer​はOSGIサービスで、リソースパス(例えば、/path/to/my/page)を外部URLと絶対URL(例えば、https://www.mycompany.com/path/to/my/page)に変換します。 詳しくは、「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 FormsOSGi用に設定する場合は、処理サーバーの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. We.Finance Customers.csv、We.Finance Auto Insurance Renewals.csvhome mortgage​の各データファイルを、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/データソース/グローバル​に移動します。 Refersite Dynamics Integration​アイコンをタップし、プロパティ​をタップします。
  2. Microsoft Azure Active Directory のアカウントに移動します。登録済みアプリケーションの「応答 URL」設定に、コピーしたクラウドサービス設定の URL を追加します。設定を保存します。
  3. 「認証の設定」タブで、Microsoft Dynamicsインスタンスの​サービスルートクライアントIDクライアントシークレットリソースURL​を指定します。 「OAuthに接続」をクリックして、Microsoft Dynamicsログインページにリダイレクトします。
  4. ログイン情報を入力します。ログインすると、AEM Formsクラウドサービス設定ページにリダイレクトされます。 「保存して閉じる」をクリックします。クラウドサービスの設定が保存されます。
  5. Forms/データ統合/We.Finance​に移動します。 「自動保険(ダイナミクス)」を選択し、「編集」をクリックします。 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 Configurationコンソールに移動します。

  2. Adobe Sign構成サービス​を探してタップし、構成用に開きます。

  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 SignAPIアプリケーションの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 Configurationコンソールに移動します。
  2. Forms共通構成サービス​を探してタップし、構成用に開きます。
  3. すべてのユーザー​に対して​許可​フィールドを設定します。
  4. 保存」をタップします。

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

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

  1. https://[server]:[port]/crx/de/index.jspのCRXDEに移動します。
  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はアダプティブフォームのレポートの生成やパフォーマンスの分析に役立ちますが、パーソナライズされたエクスペリエンスの提供や、アダプティブフォームのA/Bテストの実施に役立ちます。

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

Adobe Analytics の設定

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

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

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

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

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

    • Webコンソール設定​ページで、AEM Forms解析設定​を探してクリックします。
    • [AEM Forms解析設定]ダイアログの[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ターゲット設定が利用可能です。 クリックして設定を開きます。設定ページで「編集」をクリックします。構成の​コンポーネントを編集​ダイアログが開きます。

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

  5. Adobe Target に接続」をクリックします。ターゲットアカウントが正しく設定されたら、「OK」をクリックします。 パッケージ化された構成にターゲットフレームワークがあることがわかります。

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

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

  8. ターゲットフレームワークを選択します。

  9. Target URLs」フィールドに、AEM Forms への URL を指定します。次に例を示します。https://<ホスト名>:<ポート>

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

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

次の手順

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

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now