このパッケージは、AEM Forms 6.4 OSGI オーサーのために作成され、テスト済みで、次のプラットフォームバージョンでサポートされています。
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 | サポート対象 |
パッケージのインストールに関する考慮事項: |
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 - フォームのデータモデルやサービスの連結の問題を回避するために役立つ、プレースホルダークラウド設定を含むすべてのデフォルト設定ノードが含まれます。
このパッケージのアセットには、次のものが含まれます。
この節では、デモパッケージのインストールについて説明します。
ソフトウェア配布を開きます。ソフトウェア配布にログインするには、Adobe ID が必要です。
ヘッダーメニューで「Adobe Experience Manager」をタップします。
「フィルター」セクションで、
we-gov-forms.pkg.all-<version>.zip パッケージ名をタップし、「EULA 条項に同意」を選択して、「ダウンロード」をタップします。
パッケージマネージャーを開き「パッケージをアップロード」をクリックしてパッケージをアップロードします。
パッケージを選択して、「インストール」をクリックします。
インストールプロセスを完了させます。
https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled に移動して、インストールが正常に完了したことを確認します。
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 に移動して、インストールが正常に完了したことを確認します。
新しいパッケージバージョンをインストールするには、4.1 と 4.2 で定義されている手順に従います。別の古いパッケージがすでにインストールされていても新しいパッケージバージョンをインストールできますが、最初に古いパッケージバージョンをアンインストールすることをお勧めします。古いパッケージバージョンをアンインストールするには、次の手順に従います。
https://<aemserver>:<port>/crx/packmgr/index.jsp に移動します。
古い we-gov-forms.pkg.all-<version>.zip ファイルを見つけます。
「その他」オプションを選択します。
ドロップダウンから「アンインストール」オプションを選択します。
確認後、「アンインストール」を再度選択し、アンインストール処理を完了させます。
この節では、プレゼンテーション前のデモパッケージのデプロイ後の設定の詳細と手順について説明します。
https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html に移動します。
以下のタスクを実行するには、管理者としてログインします。
ページの末尾まで下にスクロールし、すべてのユーザーグループを読み込みます。
「ワークフロー".
「workflow-users"グループ化し、"プロパティ"をクリックします。
「メンバー」タブに移動します。
入力 wegov 「ユーザーまたはグループを選択」フィールドで、
ドロップダウンから「 」を選択します。We.Gov Forms Users".
メニューバーの「保存して閉じる」をクリックします。
手順 2~7 を繰り返し、「分析」をクリックし、「Analytics 管理者"グループを作成し、"We.Gov Forms Users"グループをメンバーとして使用します。
手順 2~7 を繰り返し、「フォームユーザー」をクリックし、「forms-power-users"グループを作成し、"We.Gov Forms Users"グループをメンバーとして使用します。
手順 2~7 を繰り返し、「forms-users」をクリックし、「forms-users"グループに追加し、今回は"We.Gov ユーザー"グループをメンバーとして使用します。
設定ドキュメントの確認 メール通知の設定
このタスクを実行するには、管理者としてログインします。
https://<aemserver>:<port>/system/console/configMgr に移動します。
Day CQ Mail Service サービスを探して、設定します。
任意の SMTP サーバーに接続するようにサービスを設定します。
「保存」をクリックして設定を保存します。
この節では、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 証明書およびキーの詳細:
秘密鍵は localhostprivate.der。
証明書は localhost.crt。
「次へ」をクリックします。
HTTPS Hostname は localhost に設定する必要があります。
ポートは、システムが公開しているポートに設定する必要があります。
この節では、Adobe Sign クラウド設定の詳細と手順について説明します。
参照:
前提条件を確認します。必要な SSL 設定について詳しくは、AEM SSL 設定を参照してください。
次の 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)。
「We.gov Adobe Sign」設定を選択します。
「プロパティ」をクリックします。
「設定」タブに移動します。
OAuth URL を入力します(例: https://secure.na1.echosign.com/public/oauth)。
設定した Adobe Sign インスタンスから、設定したクライアント ID とクライアント秘密鍵を指定します。
「Adobe Signに接続」をクリックします。
接続に成功したら、「保存して閉じる」をクリックして統合を完了します。
この節では、MS Dynamics クラウド設定の詳細と手順について説明します。
参照:
次の URL に移動します。
https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
「Microsoft Dynamics ODataCloud Service」設定を選択します。
「プロパティ」をクリックします。
「認証設定」タブに移動します。
以下の詳細を入力します。
サービスルート:例https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
認証タイプ: OAuth 2.0
認証設定(この情報を収集するにはMS Dynamics クラウド設定を参照してください)。
https://msdynamicsserver.api.crm3.dynamics.com
「OAuth に接続」をクリックします。
認証が成功したら、「保存して閉じる」をクリックして統合を完了します。
この節で説明する手順は、MS Dynamics Cloud インスタンスからクライアント ID、クライアント秘密鍵、詳細を見つけるのに役立ちます。
https://portal.azure.com/ に移動し、ログインします。
左側のメニューから「すべてのサービス」を選択します。
検索するか、「アプリ登録」に移動します。
既存のアプリケーション登録を作成するか、選択します。
アプリケーション ID を AEM クラウド設定の OAuth として使用されるクライアント ID にコピーします。
「設定」または「マニフェスト」をクリックして、 返信 URL。
設定ビューで、「キー」をクリックして、新しいキーの作成を表示します ( これはAEMのクライアント秘密鍵として使用されます )。
リソース URL/サービスルート URL を探すには、MS Dynamics インスタンスダッシュボードに移動します。
上部のナビゲーションバーで、「Sales」または独自のインスタンスタイプをクリックし、「設定を選択」をクリックします。
右下の「カスタマイズ」と「開発者向けリソース」をクリックします。
次のサービスルート URL があります。例:
*https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
更新およびアクセストークン URL の詳細は、次の場所で確認できます。
https://docs.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app
クラウド設定が完了したら、フォームデータモデルをテストする必要があります。
次に移動します。
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」になっていることを確認します。
フォームデータモデルを編集します。
サービスをテストし、設定済みのデータソースに正常に接続できることを確認します。
サービスをテストしたら、キャンセルをクリックし、不本意の変更がフォームデータモデルに反映されないようにします。
データソースが FDM に正常にバインドされるには、AEM サーバーの再起動が必要であることが報告されています。
クラウド設定が完了したら、フォームデータモデルをテストする必要があります。
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov に移動します。
We.gov 登録 FDM を選択し、プロパティを選択します。
「ソースを更新」タブに移動します。
コンテキスト対応の設定が /conf/we-gov
に設定されていること、および設定済みのデータソースが We.Gov Derby DS であることを確認します。
「保存して閉じる」をクリックします。
サービスのテストを行い、設定したデータソースに正常に接続できることを確認します。
この節では、Adobe Analytics Cloud 設定の詳細と手順について説明します。
参照:
このパッケージは、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 アカウントのユーザー資格情報を見つけるには、アカウント管理者が次のタスクを実行する必要があります。
管理者は次の操作を実行して、ユーザーに AEM Analytics の権限を付与できます。
Adobe Admin Console に移動します。
Admin Console に公開されている Analytics インスタンスをクリックします。
「 Analytics 管理者の完全なアクセス」を選択します。
ユーザーをプロファイルに追加します。
ユーザー ID がプロファイルにマッピングされたら、「権限」タブをクリックします。
すべての権限がプロファイルにマッピングされていることを確認します。
ユーザーのログイン機能に関して権限がマッピングされると、数時間かかる場合があります。
we-gov-forms.ui.analytics-<version>.zip
パッケージがインストールされている場合、AEM Forms Analytics データはオフラインでも、Adobe Analytics クラウド設定なしでも利用できますが、AEM Sites データにはアクティブなクラウド設定が必要です。
https://<aemserver>:<port>/sites.html/content に移動します。
「AEM Forms We.Gov Site」を選択して、サイトのページを表示します。
サイトページの 1 つ(例:ホーム)を選択し、「Analytics & Recommendations」を選択します。
このページには、AEM Sites ページに関連する、Adobe Analytics から取得した情報が表示されます(注意:設計により、この情報は Adobe Analytics から定期的に更新され、リアルタイムには表示されません)。
ページビューページに戻る(手順 3.でアクセス)と、「リスト表示」の項目を表示する表示設定を変更することで、ページビュー情報を表示することもできます。
「表示」ドロップダウンメニューを探し、「リスト表示」を選択します。
同じメニューから「設定を表示」を選択し、「Analytics」セクションから表示する列を選択します。
「更新」をクリックして、新しい列を使用可能にします。
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」アダプティブフォームを選択し、「Analytics レポート」オプションを選択します。
ページが読み込まれるのを待ち、分析レポートデータを表示します。
AEM Forms を Adobe Forms と共にインストールして設定するには、変換ツールのユーザーが以下を所有している必要があります。
Adobe I/O へのアクセス。
Adobe Forms コンバージョンサービスとの統合をする権限。
オーサーとして実行される Adobe AEM 6.5 最新のサービスパック。
詳細な手順を読む前に、次の点を確認してください。
Forms 変換ツールと正しく通信するようにサービスを設定するには、ユーザーは Adobe I/O に登録できるように Identity Management System(IMS)サービスを設定する必要があります。
https://<aemserver>:<port> > に移動します。Adobe Experience
Manager の左上の />ツール/>セキュリティ/ >Adobe IMS設定をクリックします。
「作成」をクリックします。
以下の画像のアクションを実行します。
必ず証明書をダウンロードしてください。
設定の残りの部分を続行しないでください。 Adobe I/O での統合の作成節を確認してください。
この節で作成された証明書は、Adobe I/Oで統合サービスを作成するために使用されます。統合サービスで作成すると、Adobe I/O からのその情報を使用して設定を完了することができます。
アドビメイン内で統合を作成するためにシステム管理者に連絡しない場合は、ご自身に作成する能力があることを確認してください。
Adobe I/O コンソールに移動します。
統合を作成をクリックします。
API にアクセスを選択します。
正しいグループ(右上のドロップダウンリスト)に属していることを確認します。
Experience Cloud セクションで、 Forms コンバージョンツールを選択します。
「続行」をクリックします。
統合の名前と説明を入力します。
2.1 節の公開鍵を使用して、鍵の統合内に配置します。
自動 Forms コンバージョン用のプロファイルを選択します。
これで統合を作成したので、IMS 設定のインストールを完了します。
接続の詳細を表示するには、Adobe I/O 内の統合をクリックします。
AEM(ツール/セキュリティ/IMS)内で IMS 設定に移動します。
IMS 設定画面で「次へ」をクリックします。
認証サーバー(スクリーンショットに表示されている値)を入力します。
API キーを入力します。
クライアントの秘密鍵を入力します(統合を表示するには、Adobe I/O で公開をクリックする必要があります)。
Adobe I/O の「JWT」タブをクリックして、JWT ペイロードを取得し、IMS 設定のペイロードに貼り付けます。
作成したら、IMS 設定をクリックし、ヘルスチェックを選択すると、次の結果が表示されます。
IMS の設定が完了したら、AEM でクラウド設定を確認することができます。設定が存在しない場合は、次の手順を使用して AEM でクラウド設定を作成します。
ブラウザーを開き、システム URL https://<domain_name>:<system_port> に移動します。
/ツール/Cloud Services/自動フォームコンバージョン設定画面の左上隅にある Adobe Experience Manager をクリックします。
設定を配置する設定フォルダーを選択します。
作成をクリックします。
以下のスクリーンショットに情報を入力します。
設定にタイトルと名前を入力します。
システムのサービス 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 つのチェックボックス値を空のままにしておきます。
IMS 設定が完了したら、AEM でクラウド設定を作成する手順に進むことができます。
ブラウザーを開き、システム URL https://<domain_name>:<system_port> に移動します。
/ツール/Cloud Services/自動フォームコンバージョン設定画面の左上隅にある Adobe Experience Manager をクリックします。
設定を配置する設定フォルダーを選択します。
作成をクリックします。
以下のスクリーンショットに情報を入力します。
設定にタイトルと名前を入力します。
システムのサービス 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 つのチェックボックス値を空のままにしておきます。
設定が完了したら、PDF ドキュメントをアップロードしてテストできます。
AEM システム https://<domain_name>:<system_port> に移動します
フォーム/フォームとドキュメント/AEM Forms We.gov Forms/AFC をクリックします。
We.Gov 登録アプリケーション PDF を選択します。
右上隅の「自動変換処理の開始 」ボタンをクリックします。
ユーザーは、次に示すようにこのオプションを表示できます。
ボタンを選択すると、次のオプションが表示されます
使用するすべてのオプションを設定したら、変換を開始を選択します。
変換処理が始まると、次の画面が表示されます。
変換が完了すると、次の画面が表示されます。
出力フォルダーをクリックして、生成されたアダプティブフォームを表示します。
フォーム自動変換サービスには、ベストプラクティス、既知の複雑なパターン、および 既知の問題が含まれています。AEM Forms のフォーム自動変換サービスを使用する前に、これらを確認してください。
変換後にフォームを FDM にバインドする場合は、「データをバインドせずにアダプティブフォームを生成」を有効にしてフォームを生成します。
テンプレートフォルダーで、すべてのユーザーに対して jcr:read 権限が有効になっていることを確認してください。有効になっていないと、サービスユーザーがリポジトリーからテンプレートを読み取れず、変換が失敗します。
このセクションでは、デモのカスタマイズ手順を説明します。
編集可能テンプレートは、次の場所にあります。
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 つが 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/
このパッケージに含まれるテンプレートは、スタイルシステムもサポートしています。
プロジェクト 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
これらのフォームは、特定の使用例に合わせてカスタマイズできます。フォームの正常な機能を維持するために、特定のフィールドと送信ロジックを変更しないでください。変更してはいけないものの一例は、次のとおりです。
健康増進のための登録申請:
アダプティブフォームもスタイル設定することができ、それにはスタイルエディターまたはテーマエディターを使用します。
登録アダプティブフォームは、OSGI ワークフローに送信されて処理されます。このワークフローは、https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html にあります。
一部の制限があるため、このワークフローには、複数のスクリプトとカスタム OSGi ワークフロープロセスステップが含まれています。 これらのワークフローステップは汎用ステップとして作成され、設定ダイアログを使用して作成されたものではありません。現時点では、ワークフローステップの設定はプロセス引数に応じて異なります。
すべてのワークフローステップの Java コードは、we-gov-forms.core-<version>.jar バンドルに含まれています。
このセクションでは、デモ機能についての説明と、デモプロセスの設計において特に検討が必要になる可能性のある項目について説明します。
アクセシビリティテストを実行するには、まずここから Chrome プラグインをインストールする必要があります。
インストールが完了したら、テストするページを Chrome ブラウザーで読み込みます(注:タブを複数開いているとスコアに影響する場合があります。タブは 1 つだけ開くことを推奨します)。ページを読み込んだら、
そのページで右クリックし、「Audits」タブを選択します。その画面で開発者は、アクセシビリティプラグインで実行する検証のタイプを選択できます。必要なオプションをすべて選択したら、「レポートを生成」ボタンを選択します。これにより、アクセシビリティの総合評価や、その評価を向上するための提案が記載された PDF ドキュメントが生成されます。
レポートの生成を実行すると、次の情報が表示されます。
ユーザーに表示される数値は、アクセシビリティの総合評価の判定です。スコアに続いて、計算方法に関する説明もあります。
これを書き出す場合は、画面の右側の 3 つのボタンをクリックし、プラグインに表示される該当オプションをさらに選択します。
アドビがサポートし一般公開されている Ultramarine テーマは、
インストール可能な ZIP ファイルである we-gov-forms.pkg.all-<version>.zip
に組み込まれています。CRX パッケージマネージャーを使用してこのパッケージをインストールしたら、
AEM Forms で Forms/テーマ/リファレンステーマ/Ultramarine の順にクリックして Ultramarine テーマにアクセスできます。
ユーザーは、次のような様々なワークフローサービスオプションを設定できます。
これらをワークフロー内で有効になるように設定するには、次のタスクを実行する必要があります。
https://'[server]:[port]'/system/console/configMgr に移動します。
WeGov Configurations を見つけます。
サービス定義を開き、選択したサービスをワークフロー内で呼び出せるようにしてください。
ユーザーが Configuration Manager ページ内でサービスを有効にしているのと同じ理由で、要求された外部サービスと通信するために、ユーザーは引き続きサービス設定を行う必要があります。
設定が完了したら、「保存」ボタンをクリックして設定を保存します。
これで、We.Gov リファレンスサイトを利用するための設定がすべて完了しました。We.Gov リファレンスサイトのワークフローと手順について詳しくは、We.Gov リファレンスサイトのチュートリアルを参照してください。