AEM Forms 用のローカル開発環境を設定 overview

Adobe ID を使用して、https://experience.adobe.com/#/downloads にログイン

「AEM as a Cloud Service」タブに移動します。

公開日を降順で並べ替えます。

最新の Adobe Experience Manager as a Cloud Service SDK、Experience Manager Forms 機能アーカイブ（AEM Forms アドオン）、Forms 参照アアセット、Forms Designer をクリックします。

ソフトウェア利用許諾契約を確認し、同意します。「ダウンロード」ボタンを選択します。

ソフトウェア配布から、お使いのオペレーティングシステム用の最新の AEM Forms アーカイブをダウンロードして抽出します。

crx-quickstart/install ディレクトリに移動します。フォルダーが存在しない場合は作成します。

AEM インスタンスを停止し、AEM Forms アドオン機能アーカイブ aem-forms-addon-<version>.far をインストールフォルダーに配置します。

アクティブなコマンドウィンドウに移動し、Ctrl + C キーコマンドを押して SDK を再起動します。

Docker のインストールおよび設定：

• （Microsoft® Windows の場合）Docker Desktop をインストールします。お使いのマシン上で Docker Engine と docker-compose が設定されます。

• （Apple macOS の場合）Docker Desktop for Mac をインストールします。これには、Docker Engine、Docker CLI クライアント、Docker Compose、Docker Content Trust、Kubernetes、Credential Helper が含まれています。

• （Linux® の場合）Docker Engine と Docker Compose をお使いのマシンにインストールします。

オーサーインスタンスとパブリッシュインスタンスに並行して、aem-sdk などのフォルダーを作成します。例：C:\aem-sdk

aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip ファイルを解凍します。

環境変数 AEM_HOME を作成し、AEM オーサーのローカルのインストール先を指定します。例：C:\aem\author\

sdk.bat または sdk.sh を開いて編集します。AEM_HOME に、AEM オーサーのローカルのインストール先を設定します。例：C:\aem\author\

コマンドプロンプトを開き、aem-forms-addon-native-<version> フォルダーに移動します。

ローカルの AEM オーサーインスタンスが稼働中であることを確認します。次のコマンドを実行して SDK を起動します。

• Microsoft® Windows

  code language-shell
  sdk.bat start

• Linux® または Apple macOS

  code language-shell
  % export AEM_HOME=[local AEM Author installation] % ./sdk.sh start

ローカル開発インスタンス上に Cloud Manager Git リポジトリーを複製する： Cloud Manager Git リポジトリーには、デフォルトの AEM プロジェクトが含まれています。AEM アーキタイプに基づいています。Cloud Manager UI のセルフサービス Git アカウント管理を使用して Cloud Manager Git リポジトリーを複製し、プロジェクトをローカル開発環境に移行します。リポジトリーへのアクセスについて詳しくは、リポジトリーへのアクセスを参照してください。

Experience Manager Forms as a [Cloud Service] プロジェクトの作成： ​最新の AEM アーキタイプ以降に基づいて Experience Manager Forms as a [Cloud Service] プロジェクトを作成します。このアーキタイプは、開発者が AEM Forms as a Cloud Service の開発を容易に開始するのに役立ちます。また、すぐに使い始めるのに役立つテーマとテンプレートのサンプルも含まれています。

コマンドプロンプトを開き、以下のコマンドを実行して Experience Manager Forms as a Cloud Service プロジェクトを作成します。

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate -D archetypeGroupId=com.adobe.aem -D archetypeArtifactId=aem-project-archetype -D archetypeVersion="41" -D appTitle=mysite -D appId=mysite -D groupId=com.mysite -D includeFormsenrollment="y" -D aemVersion="cloud"

上記のコマンドで appTitle、appId、groupId を変更し、環境に反映します。また、ライセンスと要件に応じて、includeFormsenrollment、includeFormscommunications および includeFormsheadless の値を y または n に設定します。コアコンポーネントに基づくアダプティブフォームの作成には、includeFormsheadless が必須です。

• includeFormsenrollment=y オプションを使用して、アダプティブフォームの作成に必要なフォーム固有の設定、テーマ、テンプレート、コアコンポーネントおよび依存関係を含めます。フォームポータルを使用している場合、includeExamples=y オプションを設定します。また、フォームポータルのコアコンポーネントをプロジェクトに追加します。

• includeFormscommunications=y オプションを使用して、Forms コアコンポーネントとカスタマーコミュニケーション機能を含めるために必要な依存関係を含めます。

  note warning
  WARNING
  バージョン 45 でアーキタイププロジェクトを作成する場合、[AEM アーキタイププロジェクトフォルダー]/pom.xml では、最初にフォームコアコンポーネントのバージョンを 2.0.64 に設定します。アーキタイププロジェクトを構築またはデプロイする前に、フォームコアコンポーネントのバージョンを 2.0.62 に更新します。

プロジェクトをローカル開発環境にデプロイします。以下のコマンドを使用して、ローカル開発環境にデプロイできます

mvn -PautoInstallPackage clean install

コマンドの完全なリストについては、 構築とインストール を参照してください

AEM Forms as a Cloud Service 環境にコードをデプロイします。

AEM プロジェクトを開き、\src\conf.dispatcher.d\available_farms に移動します

default.farm ファイルのコピーを作成します（例：forms.farm）。

作成した forms.farm ファイルを開いて編集し、以下のコードを置き換えます。

#/ignoreUrlParams {
#/0001 { /glob "*" /type "deny" }
#/0002 { /glob "q" /type "allow" }
#}

以下に置き換えます。

/ignoreUrlParams {
/0001 { /glob "*" /type "deny" }
/0002 { /glob "dataRef" /type "allow" }
}

ファイルを保存して閉じます。

conf.d/enabled_farms に移動し、forms.farm ファイルへのシンボリックリンクを作成します。

プロジェクトをコンパイルし、AEM Forms as a Cloud Service 環境にデプロイします。

アダプティブフォーム、テーマ、PDF forms をダウンロードします。

アダプティブフォームテンプレートの書き出します。

フォームデータモデルをダウンロードします。

編集可能なテンプレート、クラウド設定、ワークフローモデルを書き出します。前述のすべての項目を既存の SDK から書き出すには、以下のフィルターを含む CRX-Package を作成します。

• /conf/ReferenceEditableTemplates
• /conf/global/settings/cloudconfigs
• /conf/global/settings/wcm
• /var/workflow/models
• /conf/global/settings/workflow

ローカル開発環境からメール設定、送信、事前入力アクションコードを書き出します。これらの設定と構成を書き出すには、以下のフォルダーとファイルのコピーをローカル開発環境上に作成します。

• [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
• [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
• [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

アダプティブフォーム、テーマおよび PDF forms を新しい SDK 環境に読み込みます。

アダプティブフォームテンプレートを新しい SDK 環境に読み込みます。

フォームデータモデルを新しい SDK 環境にアップロードします。

編集可能なテンプレート、クラウド設定、ワークフローモデルを読み込みます。前述のすべての項目を新しい SDK 環境に読み込むには、これらの項目を含む CRX パッケージを新しい SDK 環境に読み込みます。

ローカル開発環境から、メール設定、送信、事前入力アクションのコードを読み込みます。これらの設定と構成を読み込むには、古いアーキタイププロジェクトから新しいアーキタイププロジェクトに以下のファイルを配置します。

• [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
• [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
• [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config