AEM Commerce for AEM as a Cloud Service の開発 develop
AEM as a Cloud Service 用の Commerce Integration Framework（CIF）に基づく AEM Commerce プロジェクトの開発は、AEM as a Cloud Service 上の他の AEM プロジェクトと同じルールとベストプラクティスに従います。最初に次の点を確認します。
AEM as a Cloud Service SDK を使用したローカル開発 local
CIF プロジェクトを使用する場合は、ローカル開発環境を使用することをお勧めします。AEM as a Cloud Service 用に提供された CIF アドオンは、ローカル開発にも使用できます。 ソフトウェア配布ポータルからダウンロードできます。
CIF アドオンは Sling 機能アーカイブとして提供されます。ソフトウェア配布ポータルで利用できる zip ファイルには、2 つの Sling 機能アーカイブファイルが含まれています。1 つは AEM オーサー用、もう 1 つは AEM パブリッシュインスタンス用です。
>AEM as a Cloud Service SDKを使用したローカル開発環境のセットアップに関する詳細なガイドを参照してください。
必要なソフトウェア required-software
以下をローカルにインストールしておく必要があります。
CIF アドオンへのアクセス accessing-add-on
CIF アドオンは、 ソフトウェア配布ポータルから zip ファイルでダウンロードできます。zip ファイルにSling 機能アーカイブ としてCIF アドオンが含まれているのであれ、AEM パッケージではありません。 SDK リストには、AEM as a Cloud Serviceライセンスでアクセスできます。
ローカル設定 local-setup
AEM as a Cloud Service SDKを使用するローカル CIF アドオン開発の場合は、次の手順に従います。
-
最新のAEM as a Cloud Service SDKを取得します。
-
AEMの.jar を解凍し、
crx-quickstartフォルダーを作成します。 次のコマンドを実行します。code language-bash java -jar <jar name> -unpack -
crx-quickstart/installフォルダーを作成します。 -
CIF アドオンの正しい Sling 機能アーカイブファイルを
crx-quickstart/installフォルダーにコピーします。- CIF アドオン zip ファイルには、2 つの Sling 機能アーカイブ
.farファイルが含まれています。 - ローカル AEM as a Cloud Service SDK を実行する方法に応じて、AEM オーサーまたは AEM パブリッシュに対して正しいものを使用してください。
- CIF アドオン zip ファイルには、2 つの Sling 機能アーカイブ
-
Adobe Commerce GraphQL エンドポイントを保持する
COMMERCE_ENDPOINTという名前のローカル OS 環境変数を作成します。-
この変数は、AEM でコマースシステムへの接続に使用されます。CIF アドオンには、Commerce GraphQL エンドポイントをローカルで使用できるようにするローカルリバースプロキシが含まれています。 このプロキシは、CIF オーサリングツール（製品コンソールおよびピッカー）で使用され、GraphQL の直接呼び出しを行う CIF クライアントサイドコンポーネントにも使用されます。
-
この変数は、AEM as a Cloud Service 環境に対しても設定する必要があります。変数について詳しくは、AEM as a Cloud Serviceの OSGi の設定を参照してください。
-
macOSの下の例：
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql -
Windows での例：
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
-
-
（オプション）ステージング済みカタログ機能を有効にするには、Adobe Commerce インスタンスの統合トークンを作成する必要があります。概要の手順に従って、トークンを作成します。
-
COMMERCE_AUTH_HEADERという名前の OSGi シークレットを次の値に設定します。code language-xml Authorization: Bearer <Access Token> -
秘密鍵について詳しくは、AEM as a Cloud Serviceの OSGi の設定を参照してください。
-
-
AEM as a Cloud Service SDKを開始します。
OSGi コンソールを使用して設定を確認します：http://localhost:4502/system/console/osgi-installer。 リストには、機能モデルファイルで定義されたCIF アドオン関連バンドル、コンテンツパッケージ、OSGi 設定が含まれている必要があります。
プロジェクトのセットアップ project
AEM as a Cloud Service 用の CIF プロジェクトを Bootstrap するには、2 つの方法があります。
AEM プロジェクトアーキタイプの使用 project-archetype
CIF を使い始めるために事前に設定されたプロジェクトを Bootstrap するには、AEM プロジェクトアーキタイプが主なツールです。CIF コアコンポーネントと必要なすべての設定を、1 つの追加オプションで生成されたプロジェクトに含めることができます。
AEM プロジェクトの生成方法については、AEM プロジェクトアーキタイプの「使用手順」を参照してください。プロジェクトに CIF を含めるには、includeCommerce オプションを使用します。
次に例を示します。
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=35 \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
-D includeCommerce=y
CIF コアコンポーネントは、提供されている all パッケージを含めるか、CIF コンテンツパッケージと関連する OSGi バンドルを個別に使用することで、任意のプロジェクトで使用できます。 CIF コアコンポーネントを手動でプロジェクトに追加するには、次の依存関係を使用します。
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-apps</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-config</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-core</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>graphql-client</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>magento-graphql</artifactId>
<version>x.y.z</version>
</dependency>
AEM Venia 参照用ストアの使用 venia-reference
CIF プロジェクトを開始する 2 つ目の方法は、AEM Venia 参照用ストアをコピーして使用する方法です。AEM Venia 参照用ストアは、AEM 用の CIF コアコンポーネントの使用方法を示すサンプルのストアフロントアプリケーションです。これは、ベストプラクティス例として意図されていて、独自機能を開発するための有望な出発点としての役割も果たします。
Venia 参照用ストアを使い始めるには、Git リポジトリをクローンし、必要に応じてプロジェクトをカスタマイズし始めます。