We.Gov および We.Finance リファレンスサイトのセットアップと設定 set-up-and-configure-we-gov-reference-site
デモパッケージの詳細 demo-package-details
インストールの前提条件 installation-prerequisites
このパッケージは、AEM Forms 6.4 OSGI オーサー のために作成され、テスト済みで、次のプラットフォームバージョンでサポートされています。
このパッケージには、次のプラットフォームバージョンをサポートするクラウド設定が含まれています。
パッケージのインストールに関する考慮事項:
- パッケージは、他のデモパッケージや古いデモパッケージバージョンがない、クリーンなサーバーにインストールします。
- パッケージは、オーサーモードで実行されている OSGi サーバーにインストールします。
このパッケージに含まれる機能 what-does-this-package-include
AEM Forms We.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 - Sites ページ列コントロール用の AEM Sites グリッドレイアウトパッケージ
-
-
we-gov-forms.ui.content-<version>.zip - すべてのコンテンツ、ページ、画像、フォーム、インタラクティブ通信アセットなどが含まれます。
-
we-gov-forms.ui.analytics-<version>.zip - リポジトリ内に保存するすべての We.Gov Forms Analytics データが含まれます。
-
we-gov-forms.config.public-<version>.zip - フォームのデータモデルやサービスの連結の問題を回避するために役立つ、プレースホルダークラウド設定を含むすべてのデフォルト設定ノードが含まれます。
-
このパッケージのアセットには、次のものが含まれます。
- 編集可能なテンプレートを使用したAEM Site Pages
- AEM Forms Adaptive Forms
- AEM Forms Interactive Communications(印刷と web チャンネル)
- AEM Forms XDP Document of Record
- AEM Forms MS Dynamics Forms データモデル
- Adobe Sign との統合
- AEM ワークフローモデル
- AEM Assets サンプル画像
- サンプル(メモリ内)Apache Derby データベース
- Apache Derby データソース(フォームデータモデルで使用)
デモパッケージのインストール demo-package-installation
この節では、デモパッケージのインストールについて説明します。
ソフトウェア配布から from-software-distribution
-
ソフトウェア配布を開きます。ソフトウェア配布にログインするには、Adobe ID が必要です。
-
ヘッダーメニューで「Adobe Experience Manager」を選択します。
-
「フィルター」セクションで、
- 「ソリューション」ドロップダウンリストから「Forms」を選択します。
- パッケージのバージョンとタイプを選択します。また、「ダウンロードを検索」オプションを使用して結果をフィルターすることもできます。
-
we-gov-forms.pkg.all-<version>.zip パッケージ名を選択し、「EULA 条項に同意」を選択して、「ダウンロード」を選択します。
-
パッケージマネージャーを開き「パッケージをアップロード」をクリックしてパッケージをアップロードします。
-
パッケージを選択して、「インストール」をクリックします。
-
インストールプロセスを完了させます。
-
https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled に移動して、インストールが正常に完了したことを確認します。
ローカル ZIP ファイルから from-a-local-zip-file
-
we-gov-forms.pkg.all-<version>.zip ファイルをダウンロードして見つけます。
-
https://<aemserver>:<port>/crx/packmgr/index.jsp に移動します。
-
「パッケージをアップロード」オプションを選択します。
-
ファイルブラウザーを使用して、ダウンロードした ZIP ファイルに移動して選択します。
-
「開く」をクリックしてアップロードします。
-
アップロードが完了したら、「インストール」オプションを選択してパッケージをインストールします。
-
インストールプロセスを完了させます。
-
https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled に移動して、インストールが正常に完了したことを確認します。
新しいパッケージバージョンのインストール installing-new-package-versions
新しいパッケージバージョンをインストールするには、4.1 と 4.2 で定義されている手順に従います。別の古いパッケージがすでにインストールされていても新しいパッケージバージョンをインストールできますが、最初に古いパッケージバージョンをアンインストールすることをお勧めします。古いパッケージバージョンをアンインストールするには、次の手順に従います。
-
https://<aemserver>:<port>/crx/packmgr/index.jsp に移動します。
-
古い we-gov-forms.pkg.all-<version>.zip ファイルを見つけます。
-
「その他」オプションを選択します。
-
ドロップダウンから「アンインストール」オプションを選択します。
-
確認後、「アンインストール」を再度選択し、アンインストール処理を完了させます。
デモパッケージの設定 demo-package-configuration
この節では、プレゼンテーション前のデモパッケージのデプロイ後の設定の詳細と手順について説明します。
架空のユーザー設定 fictional-user-configuration
-
https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html に移動します。
-
以下のタスクを実行するには、管理者としてログインします。
-
ページの末尾まで下にスクロールし、すべてのユーザーグループを読み込みます。
-
「ワークフロー」を検索します。
-
「workflow-users」グループを選択して、「プロパティ」をクリックします。
-
「メンバー」タブに移動します。
-
「ユーザーまたはグループを選択」フィールドで、wegov と入力します。
-
ドロップダウンから「We.Gov Forms ユーザー」を選択します。
-
メニューバーの「保存して閉じる」をクリックします。
-
手順 2~7 を繰り返し、「分析」を検索し、「Analytics 管理者」グループを選択し、「We.Gov Forms Users」グループをメンバーとして追加します。
-
手順 2~7 を繰り返し、「フォームユーザー」を検索し、「forms-power-users」グループを選択し、「We.Gov Forms Users」グループをメンバーとして追加します。
-
手順 2~7 を繰り返し、「forms-users」を検索し、「forms-users」グループを選択し、今回は「We.Gov Users」グループをメンバーとして追加します。
メールサーバーの設定 email-server-configuration
-
設定ドキュメントの確認 メール通知の設定
-
このタスクを実行するには、管理者としてログインします。
-
https://<aemserver>:<port>/system/console/configMgr に移動します。
-
Day CQ Mail Service サービスを探して、設定します。
-
任意の SMTP サーバーに接続するようにサービスを設定します。
- SMTP サーバーのホスト名:例(smtp.gmail.com)
- サーバーポート:SSL を使用した gmail の例 - 465
- SMTP ユーザー: demo@ <companyname> .com
- 「差出人」のアドレス:aemformsdemo@adobe.com
-
「保存」をクリックして、設定を保存します。
(オプション)AEM SSL 設定 aemsslconfig
この節では、AEM インスタンスで SSL を設定して、Adobe Sign クラウドを設定できるようにする方法について詳しく説明します。
参照:
メモ:
-
https://<aemserver>:<port>/aem/inbox に移動すると、上記の参照ドキュメントリンクで説明されているプロセスを完了できます。
-
we-gov-forms.pkg.all-[version].zip
パッケージには、パッケージの一部であるwe-gov-forms.pkg.all-[version].zip/ssl
フォルダーを抽出することでアクセスできるサンプル SS キーと証明書が含まれています。 -
SSL 証明書およびキーの詳細:
- 「CN=localhost」に対して公開
- 10 年の有効性
- 「password」のパスワード値
-
秘密鍵は localhostprivate.der。
-
証明書は localhost.crt。
-
「次へ」をクリックします。
-
HTTPS Hostname は localhost に設定する必要があります。
-
ポートは、システムが公開しているポートに設定する必要があります。
(オプション)Adobe Sign クラウド設定 adobe-sign-cloud-configuration
この節では、Adobe Sign クラウド設定の詳細と手順について説明します。
参照:
クラウド設定 cloud-configuration
-
前提条件を確認します。必要な SSL 設定について詳しくは、AEM SSL 設定を参照してください。
-
次の URL に移動します。
https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
note note NOTE 設定の問題を回避するために、AEM サーバーにアクセスするために使用する URL は、Adobe Sign OAuth リダイレクト URI で設定された URL と一致させる必要があります(https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html など)。 -
「We.gov Adobe Sign」設定を選択します。
-
「プロパティ」をクリックします。
-
「設定」タブに移動します。
-
OAuth URL を入力します(https://secure.na1.echosign.com/public/oauth など)。
-
設定した Adobe Sign インスタンスから、設定したクライアント ID とクライアント秘密鍵を指定します。
-
「Adobe Sign に接続」をクリックします。
-
接続に成功したら、「保存して閉じる」をクリックして統合を完了します。
(オプション) MS Dynamics クラウド設定 ms-dynamics-cloud-configuration
この節では、MS Dynamics クラウド設定の詳細と手順について説明します。
参照:
MS Dynamics OData クラウドサービス ms-dynamics-odata-cloud-service
-
次の URL に移動します。
https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
- MS Dynamics アプリケーションの登録で設定したリダイレクト URL と同じ URL を使用してサーバーにアクセスしていることを確認してください。
-
「Microsoft Dynamics OData クラウドサービス」設定を選択します。
-
「プロパティ」をクリックします。
-
「認証設定」タブに移動します。
-
以下の詳細を入力します。
-
サービスルート: 例えば、
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
-
認証タイプ: OAuth 2.0
-
認証設定(この情報を収集するには MS® Dynamics クラウド設定を参照してください):
- クライアント ID - アプリケーション ID とも呼ばれます
- クライアントの秘密鍵
- OAuth URL - 例えば、https://login.microsoftonline.com/common/oauth2/authorize
- リフレッシュトークン URL - 例えば、https://login.windows.net/common/oauth2/token
- アクセストークン URL - 例えば、https://login.windows.net/common/oauth2/token
- 認証範囲 - openid
- 認証ヘッダー - 認証ベアラ
- リソース - 例えば、
https://msdynamicsserver.api.crm3.dynamics.com
-
「OAuth に接続」をクリックします。
-
-
認証が成功したら、「保存して閉じる」をクリックして統合を完了します。
MS Dynamics クラウド設定 dynamicsconfig
この節で説明する手順は、MS Dynamics Cloud インスタンスからクライアント ID、クライアント秘密鍵、詳細を見つけるのに役立ちます。
-
https://portal.azure.com/ に移動し、ログインします。
-
左側のメニューから「すべてのサービス」を選択します。
-
「アプリ登録」を検索するか、「アプリ登録」に移動します。
-
既存のアプリケーション登録を作成するか、選択します。
-
アプリケーション ID を AEM クラウド設定の OAuth として使用される クライアント ID にコピーします。
-
「設定」または「マニフェスト」をクリックして、返信 URL を設定します。
- この URL は、OData サービスの設定時に AEM サーバーにアクセスするために使用される URL と一致させる必要があります。
-
設定ビューで「キー」をクリックして、新しいキーの作成を表示します(これは AEM のクライアント秘密鍵として使用されます)。
- 後で Azure や AEM で表示できないため、キーのコピーを保持してください。
-
リソース URL/サービスルート URL を探すには、MS Dynamics インスタンスダッシュボードに移動します。
-
上部のナビゲーションバーで、「Sales」または独自のインスタンスタイプをクリックし、「設定を選択」をクリックします。
-
右下の「カスタマイズ」と「デベロッパー向けリソース」をクリックします。
-
そのサービスのルート URL が表示されます。例:
*
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
-
更新およびアクセストークン URL の詳細は、次の場所で確認できます。
https://learn.microsoft.com/ja-jp/rest/api/datacatalog/authenticate-a-client-app
フォームデータモデル(Dynamics)のテスト testing-the-form-data-model
クラウド設定が完了したら、フォームデータモデルをテストする必要があります。
-
次に移動します。
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
-
「We.gov Microsoft Dynamics CRM FDM」を選択し、「プロパティ」を選択します。
-
「ソースを更新」タブに移動します。
-
「Context-Aware Configuration」が「/conf/we-gov」に設定され、設定済みのデータソースが「ms-dynamics-odata-cloud-service」になっていることを確認します。
-
フォームデータモデルを編集します。
-
サービスをテストし、設定済みのデータソースに正常に接続できることを確認します。
note note NOTE サービスをテストしたら、キャンセル をクリックし、不本意の変更がフォームデータモデルに反映されないようにします。 note note NOTE データソースが FDM に正常にバインドされるには、AEM サーバーの再起動が必要であることが報告されています。 note note NOTE 「Ctrl + C」コマンドを使用して SDK を再起動することをお勧めします。 Java プロセスの停止など、別の方法を使用して AEM SDK を再起動すると、AEM 開発環境で不整合が生じる場合があります。
フォームデータモデル(Derby)のテスト test-fdm-derby
クラウド設定が完了したら、フォームデータモデルをテストする必要があります。
-
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov に移動します。
-
We.gov 登録 FDM を選択し、プロパティ を選択します。
-
「ソースを更新」タブに移動します。
-
コンテキスト対応の設定 が
/conf/we-gov
に設定されていること、および設定済みのデータソースが We.Gov Derby DS であることを確認します。 -
「保存して閉じる」をクリックします。
-
サービスのテストを行い、設定したデータソースに正常に接続できることを確認します。
- 接続をテストするには、HOMEMORTGAGEACCOUNT を選択し、get サービスを実行します。サービスおよびシステム管理者をテストすると、取得されたデータを確認できます。
Adobe Analytics 設定(オプション) adobe-analytics-configuration
この節では、Adobe Analytics Cloud 設定の詳細と手順について説明します。
参照:
Adobe Analytics Cloud サービス設定 adobe-analytics-cloud-service-configuration
このパッケージは、Adobe Analytics に接続するように事前設定されています。この設定を更新するには、次の手順を実行します。
-
https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html に移動します。
-
Adobe Analytics セクションを探し、「設定を表示」リンクを選択します。
-
「We.Gov Adobe Analytics (Analytics Configuration)」設定を選択します。
-
「編集」ボタンをクリックして、Adobe Analytics 設定を更新します(シェアドシークレットを指定する必要があります)。「Analytics に接続」をクリックして接続し、「OK」をクリックして完了します。
-
フレームワーク設定を更新する場合は、同じページで、「We.Gov Adobe Analytics Framework (Analytics Framework)」をクリックします(オーサリングを有効にするには AEM オーサリングの有効化を参照してください)。
Adobe Analytics ユーザー資格情報の検索 analytics-locating-user-credentials
Adobe Analytics アカウントのユーザー資格情報を検索するには、アカウント管理者は次のタスクを実行する必要があります。
- Adobe Experience Cloud ポータルに移動します。
- 管理者の資格情報を使用してログインします。
- メインダッシュボードで「Adobe Analytics」アイコンを選択します。
- 「管理者」タブに移動し、「User Management」の既存項目を選択します。
- 「ユーザー」タブを選択します。
- ユーザーのリストから目的のユーザーを選択します。
- ページの下部までスクロールすると、ページの下部にユーザー認証情報が表示されます。
- ユーザー名とシェアドシークレットの情報が、権限ボックスの右側に表示されます。
- ユーザー名の名前の中にコロンが含まれていることに注意してください。コロンの左側にあるすべての情報はユーザー名で、コロンの右側にあるすべての情報は会社名です。
- 次に例を示します。ユーザー名 : 会社名
Adobe Analyticsでのユーザー認証の設定 setup-user-authentication
管理者は次の操作を実行して、ユーザーに AEM Analytics の権限を付与できます。
-
Adobe Admin Console に移動します。
-
Admin Console に公開されている Analytics インスタンスをクリックします。
- これは、管理ページのメインページにあります。
-
「 Analytics 管理者の完全なアクセス」を選択します。
-
ユーザーをプロファイルに追加します。
-
ユーザー ID がプロファイルにマッピングされたら、「権限」タブをクリックします。
-
すべての権限がプロファイルにマッピングされていることを確認します。
-
ユーザーのログイン機能に関して権限がマッピングされると、数時間かかる場合があります。
Adobe Analytics レポート adobe-analytics-reporting
Adobe Analytics Sites レポートを表示 view-adobe-analytics-sites-reporting
we-gov-forms.ui.analytics-<version>.zip
パッケージがインストールされている場合、AEM Forms Analytics データはオフラインでも、Adobe Analytics クラウド設定なしでも利用できますが、AEM Sites データにはアクティブなクラウド設定が必要です。-
https://<aemserver>:<port>/sites.html/content に移動します。
-
「AEM Forms We.Gov サイト」を選択して、サイトのページを表示します。
-
サイトページの 1 つ(ホームなど)を選択し、「Analytics & Recommendations」を選択します。
-
このページには、AEM Sites ページに関連する、Adobe Analytics から取得した情報が表示されます(メモ:設計上、この情報は Adobe Analytics から定期的に更新され、リアルタイムには表示されません)。
-
ページビューページ(手順 3 でアクセス)に戻ると、「リスト表示」の項目を表示する表示設定を変更することで、ページビュー情報を表示することもできます。
-
「表示」ドロップダウンメニューで「リスト表示」を選択します。
-
同じメニューから「設定を表示」を選択し、「分析」セクションから表示する列を選択します。
-
「アップデート」をクリックして、新しい列を使用可能にします。
Adobe Analytics Forms レポートを表示 view-adobe-analytics-forms-reporting
we-gov-forms.ui.analytics-<version>.zip
パッケージがインストールされている場合、AEM Forms Analytics データはオフラインでも、Adobe Analytics クラウド設定なしでも利用できますが、AEM Sites データにはアクティブなクラウド設定が必要です。-
次に移動します。
https:///<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
-
「Enrollment Application For Health Benefits」アダプティブフォームを選択し、「分析レポート」オプションを選択します。
-
ページが読み込まれるのを待ち、分析レポートデータを表示します。
Adobe Automated Forms 設定イネーブルメント automated-forms-enablement
AEM Forms を Adobe Forms と共にインストールして設定するには、変換ツールのユーザーが以下を所有している必要があります。
-
Adobe Developer へのアクセス権限。
-
Adobe Forms コンバージョンサービスとの統合をする権限。
-
オーサーとして実行される Adobe AEM 6.5 最新のサービスパック。
詳細な手順を読む前に、以下を確認してください。
IMS 設定の作成パート 1 creating-ims-config
Forms 変換ツールと正しく通信するようにサービスを設定するには、ユーザーは Adobe I/O に登録できるように Identity Management System(IMS)サービスを設定する必要があります。
-
https://<aemserver>:<port> > に移動します。Adobe Experience
Manager の左上の />ツール/>セキュリティ/ >Adobe IMS設定をクリックします。 -
「作成」をクリックします。
-
以下の画像のアクションを実行します。
-
必ず証明書をダウンロードしてください。
-
設定の残りの部分を続行しないでください。 Adobe I/O での統合の作成節を確認してください。
Adobe I/O での統合の作成 create-integration-adobeio
アドビメイン内で統合を作成するためにシステム管理者に連絡しない場合は、ご自身に作成する能力があることを確認してください。
-
Adobe Developer Console に移動します。
-
統合を作成をクリックします。
-
API にアクセスを選択します。
-
正しいグループ(右上のドロップダウンリスト)に所属していることを確認します。
-
Experience Cloud セクションで、 Forms コンバージョンツールを選択します。
-
「続行」をクリックします。
-
統合の名前と説明を入力します。
-
2.1 節の公開鍵を使用して、鍵の統合内に配置します。
-
自動 Forms コンバージョン用のプロファイルを選択します。
IMS 設定の作成パート 2 create-ims-config-part-next
これで統合を作成したので、IMS 設定のインストールを完了します。
-
接続の詳細を表示するには、Adobe I/O 内の統合をクリックします。
-
AEM(ツール/セキュリティ/IMS)内で IMS 設定に移動します。
-
IMS 設定画面で「次へ」をクリックします。
-
認証サーバー(スクリーンショットに表示されている値)を入力します。
-
API キーを入力します。
-
クライアントの秘密鍵を入力します(統合を表示するには、Adobe I/O で公開をクリックする必要があります)。
-
Adobe I/O の「JWT」タブをクリックして、JWT ペイロードを取得し、IMS 設定のペイロードに貼り付けます。
-
作成したら、IMS 設定をクリックし、ヘルスチェックを選択すると、次の結果が表示されます。
クラウド設定(We.Gov AFC 実稼動) configure-cloud-configuration
IMS の設定が完了したら、AEM でクラウド設定を確認できます。設定が存在しない場合は、次の手順を使用して AEM でクラウド設定を作成します。
-
ブラウザーを開き、システム URL https://<domain_name>:<system_port> に移動します。
-
画面の左上隅にある Adobe Experience Manager/ツール/Cloud Services/自動フォームコンバージョン設定をクリックします。
-
設定を配置する設定フォルダーを選択します。
-
作成をクリックします。
-
以下のスクリーンショットに情報を入力します。
-
設定にタイトルと名前を入力します。
-
システムのサービス URL は、https://aemformsconversion.adobe.io/ に設定されます。
-
テンプレート URL /conf/we-gov/settings/wcm/templates/we-gov-flamingo-template。
-
テーマ URL:/content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme
-
次へをクリックします。
-
この設定では、2 つのチェックボックス値を空のままにしておきます。
- これらのオプションについて詳しくは、クラウドサービスを設定を参照してください。
クラウド設定(We.Finance AFC 実稼動) configure-cloud-configuration-wefinance
IMS 設定が完了したら、AEM でクラウド設定を作成する手順に進むことができます。
-
ブラウザーを開き、システム URL https://<domain_name>:<system_port> に移動します。
-
画面の左上隅にある Adobe Experience Manager/ツール/Cloud Services/自動フォームコンバージョン設定をクリックします。
-
設定を配置する設定フォルダーを選択します。
-
作成をクリックします。
-
以下のスクリーンショットに情報を入力します。
-
設定にタイトルと名前を入力します。
-
システムのサービス URL は https://aemformsconversion.adobe.io/ に設定されます
-
テンプレート URL:/conf/we-finance/settings/wcm/templates/we-finance-adaptive-form
-
テーマ URL:/content/dam/formsanddocuments-themes/adobe-finance-forms-themes/we-finance-theme
-
次へをクリックします。
-
この設定では、2 つのチェックボックス値を空のままにしておきます。
- これらのオプションについて詳しくは、クラウドサービスを設定を参照してください。
フォーム変換のテスト(We.Gov 登録アプリケーション) test-forms-conversion
設定が完了したら、PDF ドキュメントをアップロードしてテストできます。
-
AEM システム https://<domain_name>:<system_port> に移動します
-
フォーム/フォームとドキュメント/AEM Forms We.gov Forms/AFC をクリックします。
-
We.Gov 登録アプリケーション PDF を選択します。
-
右上隅にある「自動変換を開始」をクリックします。
-
ユーザーは、次に示すようにこのオプションを表示できます。
-
ボタンを選択すると、次のオプションが表示されます
- ユーザーが We.Gov AFC 実稼働 設定を選択していることを確認してください
-
使用するすべてのオプションを設定したら、「変換を開始」を選択します。
-
変換処理が始まると、次の画面が表示されます。
-
変換が完了すると、次の画面が表示されます。
出力 フォルダーをクリックして、生成されたアダプティブフォームを表示します。
既知の問題とメモ known-issues-notes
フォーム自動変換サービスには、ベストプラクティス、既知の複雑なパターン、および 既知の問題が含まれています。AEM Forms のフォーム自動変換サービスを使用する前に、これらを確認してください。
-
変換後にフォームを FDM にバインドする場合は、「データをバインドせずにアダプティブフォームを生成」を有効にしてフォームを生成します。
-
テンプレートフォルダーで、すべてのユーザーに対して jcr:read 権限が有効になっていることを確認してください。有効になっていないと、サービスユーザーがリポジトリーからテンプレートを読み取れず、変換が失敗します。
デモパッケージのカスタマイズ demo-package-customizations
このセクションでは、デモのカスタマイズ手順を説明します。
テンプレートのカスタマイズ templates-customization
編集可能テンプレートは、次の場所にあります。
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
スタイルシステム customizetemplates
このサイトではクライアントライブラリも取り上げており、その 1 つが Bootstrap 4(https://getbootstrap.com/)を読み込みます。このクライアントライブラリは、次の場所から利用できます。
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
このパッケージに含まれる編集可能なテンプレートには、ページネーションやスタイル設定などに Bootstrap 4 の CSS クラスを使用するテンプレートポリシーやページポリシーも事前に設定されています。テンプレートポリシーにすべてのクラスが追加されているわけではありませんが、Bootstrap 4 でサポートされるクラスはすべてポリシーに追加できます。使用可能なクラスの一覧については、はじめにページを参照してください。
https://getbootstrap.com/docs/4.1/getting-started/introduction/
このパッケージに含まれるテンプレートは、スタイルシステムもサポートしています。
テンプレートロゴ template-logos
プロジェクト DAM アセットには、We.Gov のロゴや画像も含まれています。これらのアセットは、次の場所から利用できます。
https://<aemserver>:<port>/assets.html/content/dam/we-gov
ページテンプレートとフォームテンプレートの編集時に、ナビゲーションコンポーネントとフッターコンポーネントを編集することで、ブランドロゴを更新することができます。これらのコンポーネントには、ロゴの更新に使用でき、ブランドとロゴを設定可能なダイアログが用意されています。
詳しくは、ページコンテンツの編集を参照してください。
サイトページのカスタマイズ sites-pages-customization
すべてのサイトページは、https://<aemserver>:<port>/sites.html/content/we-gov から利用できます。
また、これらのサイトページでは、AEM グリッドパッケージを使用して一部のコンポーネントのレイアウトを制御しています。
スタイルシステム style-system
このパッケージに含まれているページは、スタイルシステムもサポートしています。
また、サポートされるスタイルに関するドキュメントについては、テンプレートのカスタマイズのスタイルシステムを参照してください。
アダプティブフォームのカスタマイズ adaptive-forms-customization
すべてのアダプティブフォームが次の場所から利用できます。
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
これらのフォームは、特定の使用例に合わせてカスタマイズできます。フォームの正常な機能を維持するために、特定のフィールドと送信ロジックを変更しないでください。変更してはいけないものの一例は、次のとおりです。
健康増進のための登録申請:
- contact_id - 送信時に MS Dynamics の連絡先 ID を受け取るために使用される非表示フィールド
- 送信 - コールバックをサポートするために、送信ボタンのロジックにカスタマイズが必要でした。カスタマイズについてはドキュメントにまとめられています。しかし、フォームデータモデルを使用して MS Dynamics に POST と GET の両方の操作を実行しながらフォームを送信するには、大規模なスクリプトが必要でした。
- ルートパネル - AEM インボックスの Granite UI コンポーネントはどれも変更できないので、Initialize イベントを使用して可能な限り控えめな方法で AEM インボックスに MS Dynamics ボタンを追加します。
アダプティブフォームのスタイル設定 adaptive-form-styling
アダプティブフォームもスタイル設定することができ、それにはスタイルエディターまたはテーマエディターを使用します。
ワークフローのカスタマイズ workflow-customization
登録アダプティブフォームは、OSGI ワークフローに送信されて処理されます。このワークフローは、https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html にあります。
一部の制限があるため、このワークフローには、複数のスクリプトとカスタム OSGi ワークフロープロセスステップが含まれています。 これらのワークフローステップは汎用ステップとして作成され、設定ダイアログを使用して作成されたものではありません。現時点では、ワークフローステップの設定はプロセス引数に応じて異なります。
すべてのワークフローステップの Java コードは、we-gov-forms.core-<version>.jar バンドルに含まれています。
デモに関する考慮事項と既知の問題 demo-considerations-and-known-issues
このセクションでは、デモ機能についての説明と、デモプロセスの設計において特に検討が必要になる可能性のある項目について説明します。
デモに関する考慮事項 demo-considerations
- AGRS-159 に従い、登録アダプティブフォームで使用する連絡先の名前(名、ミドルネーム、姓)は固有にします。
- 登録アダプティブフォームは、フォームのメールフィールドに指定されたメールアドレスに Adobe Sign メールを送信します。このメールアドレスには、Adobe Sign クラウド設定で使用したのと同じメールアドレスを指定することはできません。
既知の問題 known-issues
- (AGRS-120)サイトナビゲーションコンポーネントは現在、2 レベル以上の深さのネストされた子ページをサポートしていません。
- (AGRS-159)現時点では MS Dynamics FDM は操作を 2 回実行する必要があり、まず、登録アダプティブフォームのデータを Dynamics に POST し、次に連絡先 ID を取得するためにユーザーレコードを取り込みます。現在の状態では、同じ名前のユーザーが Dynamics に複数存在すると連絡先 ID の取得が失敗し、登録アダプティブフォームを送信できません。
アクセシビリティテストの設定 configure-accessibility-testing
アクセシビリティテスト用の Chrome アドオンの有効化 enable-chrome-add-on
アクセシビリティのテストを実施するには、こちらhttps://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en
の Chrome プラグインをインストールします。
インストールしたら、テストするページを Chrome ブラウザーで読み込みます(メモ:タブが複数開かれているとスコアに影響する場合があります。タブは 1 つだけ開くことをお勧めします)。ページを読み込んだら、そのページで 右クリック し、「Audits」タブを選択します。その画面で開発者は、アクセシビリティプラグインで実行する検証のタイプを選択できます。必要なオプションをすべて選択したら、「レポートを生成」ボタンをクリックできます。これにより、アクセシビリティの総合評価や、その評価の向上につながる提案が記載された PDF ドキュメントが生成されます。
レポートの実行後、次の情報が表示されます。
ユーザーに表示される数値は、アクセシビリティの総合評価の判定です。スコアに続いて、計算方法に関する説明もあります。
これをエクスポートする場合は、画面の右側の 3 つのボタンをクリックし、プラグインに表示される該当オプションをさらに選択します。
Ultramarine テーマ ultramarine-theme
アドビがサポートし一般公開されている Ultramarine テーマは、
インストール可能な ZIP ファイルである we-gov-forms.pkg.all-<version>.zip
に組み込まれています。CRX パッケージマネージャーを使用してこのパッケージをインストールしたら、
AEM Forms で Forms/テーマ/リファレンステーマ/Ultramarine の順にクリックして Ultramarine テーマにアクセスできます。
設定オプション configuration-options
ユーザーは、次のような様々なワークフローサービスオプションを設定できます。
- Microsoft® Dynamics エントリ
- Adobe Sign
- AEM 顧客コミュニケーション管理
- Adobe Analytics
これらをワークフロー内で有効になるように設定するには、次のタスクを実行する必要があります。
-
https://'[server]:[port]'/system/console/configMgr に移動します。
-
WeGov Configurations を見つけます。
-
サービス定義を開き、選択したサービスをワークフロー内で呼び出せるようにしてください。
note note NOTE ユーザーが Configuration Manager ページ内でサービスを有効にしているのと同じ理由で、要求された外部サービスと通信するために、ユーザーは引き続きサービス設定を行う必要があります。 -
設定が完了したら、「保存」ボタンをクリックして設定を保存します。
次の手順 next-steps
これで、We.Gov リファレンスサイトを利用するための設定がすべて完了しました。We.Gov リファレンスサイトのワークフローと手順について詳しくは、We.Gov リファレンスサイトのチュートリアルを参照してください。