We.GovおよびWe.Financeリファレンスサイトのセットアップと設定

デモパッケージの詳細

インストールの前提条件

このパッケージは​AEM Forms6.4 OSGI Author​向けに作成され、テスト済みなので、次のプラットフォームバージョンでサポートされています。

AEMバージョン	AEM Formsパッケージ版	ステータス
6.4	5.0.86	サポート対象
6.5	6.0.80	サポート対象
6.5.3	6.0.122	サポート対象

このパッケージには、次のプラットフォームバージョンをサポートするクラウド設定が含まれています。

クラウドプロバイダー	サービスのバージョン	ステータス
Adobe Sign	v5 API	サポート対象
Microsoft Dynamics 365	1710 (9.1.0.3020)	サポート対象
Adobe Analytics	v1.4 Rest API	サポート対象

パッケージのインストールに関する考慮事項：

• パッケージは、クリーンサーバーにインストールされ、他のデモパッケージや古いデモパッケージバージョンが含まれていないことが想定されます。
• パッケージはOSGIサーバーにインストールされ、作成者モードで実行されている必要があります

このパッケージに含まれる内容

AEM FormsWe.Govデモパッケージ (we-gov-forms.pkg.all-<version>.zip)は、他の複数のサブパッケージやサービスを含むパッケージとして提供されます。 パッケージには、次のモジュールが含まれます。

• we-gov-forms.pkg.all-<version>.zip - 完全なデモパッケージ

  • we-gov-forms.ui.apps-<version>.zip — すべてのコンポーネント、クライアントライブラリ、サンプルユーザー、ワークフローモデルなどが含まれます。

    • we-gov-forms.core-<version>.jar — すべてのOSGIサービス、カスタムワークフロー手順の実装などを 含みます。

    • we-gov-forms.derby<version>.jar — すべてのOSGIサービス、データベーススキーマなどを 含みます。

    • core.wcm.components.all-2.0.4.zip — サンプルWCMコンポーネントの 収集

    • grid-aem.ui.apps-1.0-SNAPSHOT.zip - AEM Sitesグリッドレイアウトパッケージ（サイトページ列管理用）

  • we-gov-forms.ui.content-<version>.zip - コンテンツ、ページ、画像、フォーム、インタラクティブな通信アセットなどをすべて含みます。

  • we-gov-forms.ui.analytics-<version>.zip — リポジトリに格納されるすべてのWeb.GovForms分析データが 含まれます。

  • we-gov-forms.config.public-<version>.zip — フォームデータモデルやサービスバインディングの問題を回避するために、プレースホルダークラウド設定を含むすべてのデフォルト設定ノードを 含みます。

このパッケージに含まれるアセットは次のとおりです。

• 編集可能なテンプレートを含むAEMサイトページ
• AEM Forms適応Forms
• AEM Forms・インタラクティブ・コミュニケーション(印刷およびWebチャネル)
• AEM FormsXDPレコードドキュメント
• AEM FormsMSダイナミクスFormsデータモデル
• Adobe Sign統合
• AEMワークフローモデル
• AEM Assetsサンプル画像
• Apache Derbyデータベースのサンプル（メモリ内）
• Apache Derbyデータソース（フォームデータモデルで使用）

デモパッケージのインストール

この節では、デモパッケージのインストールについて説明します。

ソフトウェア配布から

1. ソフトウェア配布を開きます。 ソフトウェアディストリビューションにログインするには、Adobe ID が必要です。

2. ヘッダーメニューにある​Adobe Experience Manager​をタップします。

3. 「フィルター」セクションで、

   1. 「ソリューション」ドロップダウンリストから「Forms」を選択します。
   2. パッケージのバージョンとタイプを選択します。 また、「ダウンロードを検索」オプションを使用して、結果をフィルターすることもできます。

4. we-gov-forms.pkg.all-<version>.zip​パッケージ名をタップし、「EULA条件に同意する」を選択して、「ダウンロード」をタップします。

5. Package Managerを開き、「パッケージをアップロード」をクリックして、パッケージをアップロードします。

6. パッケージを選択し、「インストール」をクリックします。

   

7. インストールプロセスを完了できるようにします。

8. https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled​に移動し、インストールが正常に完了したことを確認します。

ローカルZIPファイルから

1. we-gov-forms.pkg.all-<version>.zip​ファイルをダウンロードして探します。

2. https://<aemserver>:<port>/crx/packmgr/index.jsp​に移動します。

3. 「パッケージをアップロード」オプションを選択します。

   

4. ファイルブラウザーを使用して、ダウンロードしたZIPファイルに移動し、選択します。

5. 「開く」をクリックしてアップロードします。

6. アップロードが完了したら、「インストール」オプションを選択してパッケージをインストールします。

   

7. インストールプロセスを完了できるようにします。

8. https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled​に移動し、インストールが正常に完了したことを確認します。

新しいパッケージバージョンのインストール

新しいパッケージバージョンをインストールするには、4.1および4.2で定義されている手順に従います。新しいパッケージバージョンをインストールし、別の古いパッケージを既にインストールすることは可能ですが、最初に古いパッケージバージョンをアンインストールすることをお勧めします。 これを行うには、次の手順に従います。

1. https://<aemserver>:<port>/crx/packmgr/index.jsp​に移動します。

2. 古い​we-gov-forms.pkg.all-<version>.zip​ファイルを探します。

3. 「詳細」オプションを選択します。

4. ドロップダウンで[アンインストール]オプションを選択します。

   

5. 確認の上で、もう一度「Uninstall」（アンインストール）を選択し、アンインストールプロセスを完了させます。

デモパッケージ構成

この節では、プレゼンテーション前のデモパッケージのデプロイメント完了後の設定の詳細と手順について説明します。

架空のユーザー設定

1. https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html​に移動します。

2. 以下のタスクを実行するには、管理者としてログインします。

3. ページの最後まで下にスクロールすると、すべてのユーザーグループが読み込まれます。

4. 「workflow」を検索します。

5. 「workflow-users」グループを選択し、「Properties」をクリックします。

6. 「メンバー」タブに移動します。

7. 「ユーザーまたはグループを選択」フィールドに​wegov​と入力します。

8. 「We.GovFormsユーザー」のドロップダウンから選択します。

   

9. メニューバーの「保存して閉じる」をクリックします。

10. 手順2 ～ 7を繰り返して、「analytics」を検索し、「Analytics管理者」グループを選択して、「We.GovFormsユーザー」グループをメンバーとして追加します。

11. 手順2 ～ 7を繰り返して、「forms users」を検索し、「forms-power-users」グループを選択して、「We.GovFormsユーザー」グループをメンバーとして追加します。

12. 手順2 ～ 7を繰り返して、「forms-users」を検索し、「forms-users」グループを選択して、次に「We.Gov Users」グループをメンバーとして追加します。

電子メールサーバーの設定

1. セットアップドキュメント電子メール通知の設定を確認

2. このタスクを実行するには、管理者としてログインします。

3. https://<aemserver>:<port>/system/console/configMgr​に移動します。

4. 設定する​Day CQ Mail Service​サービスを探してクリックします。

   

5. 任意のSMTPサーバーに接続するようにサービスを設定します。

   1. SMTP Server hostname:例：(smtp.gmail.com)
   2. サーバーポート:例：SSLを使用したgmailの場合は(465)
   3. SMTP User: demo@ <companyname> .com
   4. "送信者"アドレス:aemformsdemo@adobe.com

   

6. 「保存」をクリックして設定を保存します。

（オプション）AEM SSL設定

この節では、Adobe Signクラウドの設定を行うためのAEMインスタンスでのSSLの設定について詳しく説明します。

参照:

1. デフォルトの SSL

備考:

1. https://<aemserver>:<port>/aem/inboxに移動します。ここで、前述の「ドキュメントの参照」リンクで説明されているプロセスを完了できます。

2. we-gov-forms.pkg.all-[version].zipパッケージには、サンプルのSSLキーと証明書が含まれており、この証明書はパッケージの一部であるwe-gov-forms.pkg.all-[version].zip/sslフォルダーを展開するとアクセスできます。

3. SSL証明書とキーの詳細：

   1. "CN=localhost"に発行される
   2. 10年間の有効性
   3. password「password」のパスワード値

4. 秘密鍵は​localhostprivate.der​です。

5. 証明書は​localhost.crt​です。

6. 「Next」をクリックします。

7. HTTPSホスト名は、localhost​に設定する必要があります。

8. ポートは、システムが公開したポートに設定する必要があります。

（オプション）Adobe Signクラウドの設定

この節では、Adobe Signクラウドの設定の詳細と手順について説明します。

参照:

1. Adobe Sign を AEM Forms に統合する

クラウド設定

1. 前提条件を確認します。 必要なSSL設定については、AEM SSL設定を参照してください。

2. 次の URL に移動します。

   https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov

   メモ

   AEMサーバーへのアクセスに使用するURLは、Adobe SignのOAuthリダイレクトURIで設定されたURLと一致し、設定の問題(例：https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html)

3. 「We.govAdobe Sign」設定を選択します。

4. 「プロパティ」をクリックします。

5. 「設定」タブに移動します。

6. 認証URLを入力します。例：https://secure.na1.echosign.com/public/oauth

7. 設定済みのAdobe Signインスタンスから、設定済みのクライアントIDとクライアントシークレットを指定します。

8. [Adobe Signに接続]をクリックします。

9. 接続が完了したら、「保存して閉じる」をクリックして統合を完了します。

（オプション） MS Dynamicsクラウド構成

この節では、MS Dynamics Cloudの構成の詳細と手順を説明します。

参照:

1. Microsoft Dynamics OData の設定
2. Microsoft Dynamics forAEM Formsの構成

MS Dynamics ODataクラウドサービス

1. 次の URL に移動します。

   https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov

   1. MS Dynamicsアプリケーション登録で構成されたのと同じリダイレクトURLを使用してサーバーにアクセスしていることを確認してください。

2. "Microsoft Dynamics ODataCloud Service"構成を選択します。

3. 「プロパティ」をクリックします。

   

4. 「認証の設定」タブに移動します。

5. 次の詳細を入力します。

   1. サービスルート： 例：https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

   2. 認証の種類： OAuth 2.0

   3. 認証の設定 (この情報を収集するには、 MS Dynamicsクラウド構成 設定を参照してください):

      1. クライアントID -アプリケーション IDとも呼ばれる
      2. クライアントの秘密鍵
      3. OAuth URL — 例：https://login.windows.net/common/oauth2/authorize
      4. 更新トークンURL — 例：https://login.windows.net/common/oauth2/token
      5. アクセストークンURL — 例：https://login.windows.net/common/oauth2/token
      6. 認証スコープ — openid
      7. 認証ヘッダー — 承認ベアラー
      8. リソース — 例：https://msdynamicsserver.api.crm3.dynamics.com

   4. 「OAuthに接続」をクリックします。

6. 認証が成功したら、「保存して閉じる」をクリックして統合を完了します。

MS Dynamicsクラウド構成設定

この節で説明する手順は、MS Dynamics CloudインスタンスからクライアントID、クライアントシークレット、および詳細を見つけるのに役立ちます。

1. https://portal.azure.com/に移動し、ログインします。

2. 左側のメニューから「All Services」を選択します。

3. 「アプリの登録」を検索または移動します。

4. 既存の申込み登録を作成または選択します。

5. AEMクラウド設定のOAuth クライアントID​として使用する​アプリケーション ID​をコピーします

6. 「設定」または「マニフェスト」をクリックして、返信URLを設定します。

   1. このURLは、ODataサービスを設定する際に、AEMサーバーへのアクセスに使用されるURLと一致する必要があります。

7. 設定表示で、「キー」をクリックして表示が新しいキーを作成します(これはAEMのクライアントシークレットとして使用されます)。

   1. 後でAzureまたはAEMで表示できないので、キーのコピーを保存してください。

8. リソースURL/サービスルートURLを見つけるには、MS Dynamicsインスタンスダッシュボードに移動します。

9. 上部ナビゲーションバーで、「Sales」をクリックするか、独自のインスタンスタイプをクリックし、「Select Settings」をクリックします。

10. 右下の「カスタマイズ」と「開発者向けリソース」をクリックします。

11. サービスルートURLは次のとおりです。例：

    https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

12. 更新とアクセストークンURLの詳細は、次を参照してください。

    https://docs.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app

Formsデータモデル（ダイナミクス）のテスト

クラウドの設定が完了したら、フォームデータモデルをテストする必要があります。

1. に移動します。

   https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

2. 「Web.gov Microsoft Dynamics CRM FDM」を選択し、「プロパティ」を選択します。

   

3. 「ソースを更新」タブに移動します。

4. 「Context-Aware Configuration」が「/conf/we-gov」に設定され、設定済みのデータソースが「ms-dynamics-odata-cloud-service」であることを確認します。

   

5. フォームデータモデルを編集します。

6. サービスをテストし、設定済みのデータソースに正常に接続できることを確認します。

   メモ

   サービスをテストした後、「キャンセル」をクリックして、意図しない変更がフォームデータモデルに反映されないことを確認します。

   メモ

   データ・ソースがFDMに正常にバインドするには、AEMサーバーの再起動が必要であったと報告されています。

Formsデータモデル(Derby)のテスト

クラウドの設定が完了したら、formsデータモデルをテストすることができます。

1. https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov​に移動します。

2. Web.gov登録FDM​を選択し、プロパティ​を選択します。

   

3. 「ソースを更新」タブに移動します。

4. Context-Aware Configuration​が/conf/we-govに設定されていて、設定済みのデータソースが​We.Gov Derby DS​であることを確認してください。

   

5. 「保存して閉じる」をクリックします。

6. サー ビスをテストし、設定済みのデータソースに正常に接続できることを確認します

   • 接続をテストするには、HOMEMORTGAGEACCOUNT​を選択し、getサービスを提供します。 サービスおよびシステム管理者は、取得中のデータを確認できます。

Adobe Analytics構成（オプション）

この節では、Adobe Analytics Cloud設定の詳細と説明を説明します。

参照:

• Adobe Analytics との統合

• Adobe Analytics への接続とフレームワークの作成

• ページ分析データの表示

• Analytics とレポートの設定

• AEM Forms の分析レポートの確認方法と詳細

Adobe Analyticsクラウドサービスの設定

このパッケージは、Adobe Analyticsに接続するように事前に設定されています。 この設定を更新するために、次の手順を実行します。

1. https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html​に移動します。

2. 「Adobe Analytics」セクションを探し、「設定を表示」リンクを選択します。

3. 「We.GovAdobe Analytics（Analytics設定）」設定を選択します。

   

4. 「Edit」ボタンをクリックして、Adobe Analytics設定を更新します（Shared Secretを指定する必要があります）。 「Analyticsに接続」をクリックして接続し、「OK」をクリックして完了します。

   

5. フレームワーク設定を更新する場合は、同じページで「Web.GovAdobe Analyticsフレームワーク（Analyticsフレームワーク）」をクリックします(オーサリングを有効にするには、「AEMオーサリングを有効にする」を参照)。

Adobe Analyticsユーザー資格情報の検索

Adobe Analyticsアカウントのユーザー資格情報を見つけるには、アカウント管理者が次のタスクを実行する必要があります。

1. Adobe Experience Cloudポータルに移動します。
   • 管理者の資格情報を使用してログインします
2. メインダッシュボードでAdobe Analyticsアイコンを選択します。
   
3. 「管理者」タブに移動し、「ユーザー管理（レガシー）」項目を選択します
   
4. 「ユーザー」タブを選択します。
   
5. ユーザーのリストから目的のユーザーを選択します。
6. ページの下部までスクロールすると、ユーザー認証情報がページの下部に表示されます。
   
7. ユーザー名と共有暗号鍵の情報は、権限ボックスの右側に表示されます。
8. ユーザ名には名前の中にコロンが含まれることに注意してください。コロンの左にある情報はすべてユーザ名で、コロンの右にある情報はすべて会社名です。
   • 次に例を示します。ユーザー名：会社名

Adobe Analyticsでのユーザー認証のセットアップ

管理者は、次の操作を実行して、ユーザーにAEM Analyticsの権限を与えることができます。

1. Adobe Admin Consoleに移動します。

2. 管理コンソールに表示されるAnalyticsインスタンスをクリックします。

   • これは、管理ページのメインページにあります。

3. 「Analyticsフル管理者アクセス」を選択します。

4. プロファイル追加のユーザー。

   

5. ユーザーIDがプロファイルにマップされたら、「権限」タブをクリックします。

6. すべての権限がプロファイルにマップされていることを確認します。

   

7. ユーザーのログイン機能に対して権限がマッピングされると、数時間かかる場合があります。

Adobe Analyticsレポート

表示Adobe Analyticsサイトレポート

1. https://<aemserver>:<port>/sites.html/content​に移動します。

2. 「AEM FormsWe.Govサイト」を選択して、サイトページを表示します。

3. サイトページ（ホームなど）の1つを選択し、「Analytics &Recommendations」を選択します。

   

4. このページには、AEM Sites・ページに関連するAdobe Analyticsから取得した情報が表示されます(注意：設計上、この情報はAdobe Analyticsから定期的に更新され、リアルタイムでは表示されません)。

   

5. ページ表示ページ（手順3.でアクセス）に戻ると、「リスト表示」の表示項目の表示設定を変更して、ページ表示情報を表示することもできます。

6. [表示]ドロップダウンメニューを見つけ、[リスト表示]を選択します。

   

7. 同じメニューで「表示設定」を選択し、「Analytics」セクションから表示する列を選択します。

   

8. 「更新」をクリックして、新しい列を利用可能にします。

   

表示Adobe Analyticsフォームレポート

1. に移動します。

   https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms

2. 「Enrollment Application For Health Benefits」アダプティブフォームを選択し、「Analytics Report」オプションを選択します。

   

3. ページが読み込まれるのを待ち、Analyticsレポートデータを表示します。

   

Adobe自動Forms構成有効化

AdobeFormsとの間でAEM Formsのインストールと設定を行うには、コンバージョンツールのユーザは次の作業を行う必要があります。

1. Adobe I/Oへのアクセス。

2. AdobeFormsコンバージョンサービスとの統合を作成する権限です。

3. AdobeAEM 6.5の最新のサービスパックは、作成者として実行されています。

詳細な手順を読む前に、次の点を確認してください。

• 自動フォーム変換サービスの設定

IMS設定パート1の作成

フォーム変換ツールと正しく通信できるようにサービスを設定するには、ユーザーがIdentity Managementシステム(IMS)サービスをAdobe I/Oに登録できるように設定する必要があります。

1. https://<aemserver>:<port>に移動し、「Adobeエクスペリエンス」をクリックします。
   左上のマネージャー/ツール/セキュリティ/AdobeIMS設定

2. 「作成」をクリックします。

3. 下の画像のアクションを実行します。

   

4. 証明書は必ずダウンロードしてください。

5. 残りの構成は実行しないでください。「Adobe I/Oでの統合の作成」の節を参照してください。

Adobe I/Oでの統合の作成

統合を作成するには、Adobe管理者に問い合わせない場合は、システムドメイン内で統合を作成できる権限があることを確認してください。

1. Adobe I/Oコンソールに移動します。

2. 「統合を作成」をクリックします。

3. 「APIへのアクセス」を選択します。

4. 正しいグループ(右上のドロップダウンリスト)に属していることを確認します。

5. 「Experience Cloud」セクションで、「Formsコンバージョンツール」を選択します。

6. 「続行」をクリックします。

7. 統合の名前と説明を入力します。

8. セクション2.1の公開鍵を使用すると、鍵の統合内に配置されます。

9. automated forms conversionのプロファイルを選択します。

   

IMS設定パート2の作成

これで、統合を作成したので、IMS設定のインストールを完了できます。

1. 接続の詳細を公開するには、Adobe I/O内の統合をクリックします。

2. AEM内でIMS設定に移動します（ツール/セキュリティ/IMS）。

3. IMS設定画面で「次へ」をクリックします。

4. 認証サーバー（スクリーンショットに表示されている値）を入力します。

5. APIキーを入力します。

6. クライアントシークレットを入力します(表示するには、Adobe I/Oの統合で「公開」をクリックする必要があります)。

7. Adobe I/Oの「JWT」タブをクリックして、JWTペイロードを取得し、IMS設定のペイロードに貼り付けます。

   

8. 作成したIMS設定をクリックして「ヘルスチェック」を選択すると、次の結果が表示されます。

   

クラウドの設定（Web.Gov AFC実稼働環境）

IMSの設定が完了したら、AEMでクラウドの設定を確認します。 設定が存在しない場合は、次の手順を実行してAEMでクラウド設定を作成します。

1. ブラウザーを開き、システムURL https://<domain_name>:<system_port>に移動します。

2. 画面の左上隅にあるAdobe Experience Manager/ツール/Cloud Services/Forms会話の自動設定をクリックします。

3. 設定を配置する設定フォルダを選択します。

4. 「作成」をクリックします。

5. 下のスクリーンショットに情報を入力してください。

   

6. 設定にタイトルと名前を指定します。

7. システムのサービスURLは、https://aemformsconversion.adobe.io/に設定されます。

8. テンプレートURL /conf/we-gov/settings/wcm/templates/we-gov-flamingo-template。

9. テーマURL:/content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme

10. 「Next」をクリックします。

11. この設定では、2つのチェックボックスの値を空のままにしました。

    • これらのオプションの詳細については、クラウドサービスの設定を参照してください。

クラウドの設定（Web.Finance AFC実稼働環境）

IMSの設定が完了したら、AEMでクラウド設定を作成できます。

1. ブラウザーを開き、システムURL https://<domain_name>:<system_port>に移動します。

2. 画面の左上隅にあるAdobe Experience Manager/ツール/Cloud Services/Forms会話の自動設定をクリックします。

3. 設定を配置する設定フォルダを選択します。

4. 「作成」をクリックします。

5. 下のスクリーンショットに情報を入力してください。

   

6. 設定にタイトルと名前を指定します。

7. システムのサービスURLはhttps://aemformsconversion.adobe.io/に設定されます。

8. テンプレートURL:/conf/we-finance/settings/wcm/templates/we-finance-adaptive-form

9. テーマURL:/content/dam/formsanddocuments-テーマ/adobe-finance-forms-テーマ/we-finance-theme

10. 「Next」をクリックします。

11. この設定では、2つのチェックボックスの値を空のままにしました。

    • これらのオプションの詳細については、クラウドサービスの設定を参照してください。

フォーム変換（Web.Gov登録申込）のテスト

設定が完了すると、ユーザーはPDFドキュメントをアップロードしてテストできます。

1. AEMシステムhttps://<ドメイン名>:<システムポート>に移動します。

2. Forms/Forms&ドキュメント/AEM FormsWe.govForms/AFCをクリックします。

3. Web.Gov Enrollment Application PDFを選択します。

4. 右上隅の「開始自動コンバージョン」ボタンをクリックします。

5. 次に示すように、このオプションが表示されます。

   

6. ボタンを選択すると、次のオプションが表示されます

   • We.Gov AFC Production​の構成をユーザーが選択していることを確認します。

   

   

7. 使用するすべての開始を設定したら、「オプションの変換」を選択します。

8. 変換プロセスが始まると、次の画面が表示されます。

   

9. 変換が完了すると、次の画面が表示されます。

   

   Output​フォルダーをクリックして、生成されたアダプティブフォームを表示します。

既知の問題とメモ

automated forms conversionサービスには、特定のベストプラクティス、既知の複雑なパターン、既知の問題が含まれます。 AEM FormsAutomated forms conversionサービスの使用を開始する前に、これらを確認してください。

1. 変換後にフォームをFDMに連結する場合は、データ連結を有効にせずに「アダプティブフォームを生成」を生成します。

2. テンプレートフォルダーでjcr:read for everyone権限が有効になっていることを確認してください。有効になっていない場合、サービスユーザーはリポジトリからテンプレートを読み取れなくなり、変換は失敗します。

デモパッケージのカスタマイズ

この節では、デモのカスタマイズ手順について説明します。

テンプレートのカスタマイズ

編集可能なテンプレートは次の場所にあります。

https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov

これらのテンプレートには、AEMサイト、アダプティブフォーム、およびインタラクティブコミュニケーションの各テンプレートが含まれ、以下の場所にあるコンポーネントを使用して作成およびアセンブルされます。

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components

スタイルシステム

このサイトにはクライアントライブラリも含まれ、その1つがBootstrap4 ( https://getbootstrap.com/ )を読み込みます。 このクライアントライブラリは、

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap

このパッケージに含まれる編集可能なテンプレートには、Bootstrap4のCSSクラスを使用してページネーションやスタイルなどを設定するテンプレート/ページポリシーもあらかじめ設定されています。 テンプレートポリシーに追加されていないクラスもありますが、Bootstrap4でサポートされているクラスはすべてポリシーに追加できます。 使用可能なクラスのリストについては、「はじめに」ページを参照してください。

https://getbootstrap.com/docs/4.1/getting-started/introduction/

このパッケージに含まれるテンプレートは、次のスタイルシステムもサポートします。

スタイルシステム

テンプレートロゴ

プロジェクトDAMアセットにはWe.Govロゴや画像も含まれます。 これらのアセットは、次の場所で使用できます。

https://<aemserver>:<port>/assets.html/content/dam/we-gov

ページおよびフォームテンプレートを編集する場合、ナビゲーションとフッターのコンポーネントを編集してブランドロゴを更新することを選択できます。 次のコンポーネントは、ロゴの更新に使用できる設定可能なブランドとロゴのダイアログをオファーします。

詳しくは、「ページコンテンツの編集」を参照してください。

ページのコンテンツの編集

サイトページのカスタマイズ

すべてのサイトページは次の場所から利用できます。https://<aemserver>:<port>/sites.html/content/we-gov

これらのサイトページでは、AEM Gridパッケージを使用して、いくつかのコンポーネントのレイアウトを制御します。

スタイルシステム

このパッケージに含まれるページは、次のスタイルシステムもサポートします。

スタイルシステム

サポートされるスタイルに関するドキュメントについては、テンプレートのカスタマイズスタイルシステムを参照してください。

アダプティブフォームのカスタマイズ

すべてのアダプティブフォームは、次の場所から利用できます。

https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms

これらのフォームは、特定の用途に合わせてカスタマイズできます。 フォームが正しく機能し続けるように、特定のフィールドと送信ロジックを変更しないでください。 これには以下が含まれます。

登録申請（健康保険給付）:

• contact_id — 送信中にMS Dynamicsの連絡先IDを受け取るために使用される非表示フィールド
• 送信 — 送信ボタンのロジックに、コールバックをサポートするためのカスタマイズが必要。 カスタマイズはドキュメントに記載されていますが、Formsデータモデルを使用してMS Dynamicsに対してPOSTとGETの両方の操作を実行する際に、フォームを送信するために大きなスクリプトが必要でした。
• [ルートパネル — 初期化]イベントは、AEM Inbox Granite UIコンポーネントを変更できないため、できる限り押し付けがましい方法でAEM InboxにMS Dynamicsボタンを追加するために使用します。

アダプティブフォームのスタイル設定

アダプティブフォームは、スタイルエディターまたはテーマエディターを使用してスタイルを設定することもできます。

• アダプティブフォームコンポーネントのインラインスタイリング
• テーマを作成して使用する

ワークフローのカスタマイズ

登録アダプティブフォームは、処理のためにOSGIワークフローに送信されます。 このワークフローは、https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html​にあります。

一部の制限により、このワークフローにはいくつかのスクリプトとカスタムOSGIワークフロープロセスステップが含まれています。 これらのワークフロー手順は一般的な手順として作成されたもので、設定ダイアログでは作成されていません。 現時点では、ワークフロー手順の設定はプロセスの引数に依存します。

すべてのワークフロー手順のJavaコードは、we-gov-forms.core-<version>.jar​バンドルに含まれています。

デモに関する考慮事項と既知の問題

この節では、デモ機能と、デモプロセスの過程で特別な考慮が必要となる場合がある設計上の意思決定に関する情報を説明します。

デモに関する考慮事項

• AGRS-159に従って、登録アダプティブフォームで使用される連絡先の名前（最初、中間、最後）が一意であることを確認します。
• 登録アダプティブフォームは、フォームの電子メールフィールドに指定された電子メールにAdobe Sign電子メールを送信します。 その電子メールアドレスは、Adobe Signクラウド設定の設定に使用した電子メールと同じ電子メールアドレスにすることはできません。

既知の問題

• (AGRS-120)サイトナビゲーションコンポーネントは、現在、2レベル以上の深さの入れ子ページをサポートしていません。
• (AGRS-159)現在のMS Dynamics FDMは、最初に2つの操作を実行し、登録アダプティブフォームデータをDynamicsにPOSTし、次に連絡先IDを取得するためにユーザーレコードを取得する必要があります。 現在の状態では、同じ名前を持つ2人以上のユーザーがDynamicsに存在し、登録アダプティブフォームでの送信が許可されない場合、連絡先IDの取得は失敗します。

アクセシビリティテストの設定

上でのアクセシビリティテストChrome追加の有効化

最初にアクセシビリティテストを実行するには、Chromeプラグインをインストールする必要があります。このプラグインはここにあります。

インストールが完了したら、テストするページをChromeブラウザーに読み込みます(注意：複数のタブを開くとスコアに影響する場合があるので、タブを1つだけ開くことをお勧めします)。 ページが読み込まれたら、
ページの​を右クリックし、「監査」タブを選択します。 開発者は、アクセシビリティプラグインによって実行される監査のタイプを選択できます。 必要なオプションをすべて選択すると、「レポートを生成」ボタンを選択できます。 これにより、全体的なアクセシビリティの評価と、全体的なアクセシビリティの評価を高めるために使用できる要素を示すPDFドキュメントが生成されます。

レポートの実行後は、次の項目が表示されます。

ユーザーの前に表示される数は、獲得したアクセシビリティの評価全体です。 スコアの後でこの値がどのように計算されたかについても説明します。

これを書き出す場合は、画面の右側の3つのボタンをクリックして、プラグインのオファーを追加するオプションを選択できます。

ウルタマリンテーマ

Adobeが管理する、公に提供されるUltramarineテーマは、
we-gov-forms.pkg.all-<version>.zipインストール可能なZIPファイル。 CRXを使用してこのパッケージをインストールします。

Package Managerを使用すると、Forms > テーマ > リファレンステーマ > ウルトラマリンアクセス可能​に移動して、AEM Formsのウルトラマリンテーマにアクセスできます。

設定オプション

ユーザーは、次のような様々なワークフローサービスオプションを設定できます。

1. Microsoft Dynamicsエントリ
2. Adobe Sign
3. AEMカスタムコミュニケーション管理
4. Adobe Analytics

ワークフローユーザーがワークフロー内で有効になるように設定するには、次のタスクを実行する必要があります。

1. https://'[server]:[port]'/system/console/configMgrに移動します。

2. WeGov Configurations​を探します。

3. サービス定義を開き、選択したサービスをワークフロー内で呼び出せるようにします。

   メモ

   ユーザーがConfiguration Managerページ内でサービスを有効にしたので、要求された外部サービスと通信するために、ユーザーは引き続きサービス設定を行う必要があります。

   

4. 設定を保存するには、「保存」ボタンをクリックします。

次の手順

これで、Web.Govリファレンスサイトを参照する設定が完了しました。 We.Govリファレンスサイトのワークフローと手順について詳しくは、We.Govリファレンスサイトのチュートリアルを参照してください。