AEM Commerce の開発 develop

Commerce integration framework（CIF）に基づくAEM Commerce プロジェクトをAEM用に開発する場合も、他のAEM プロジェクトと同じルールとベストプラクティスに従います。 最初に次の点を確認します。

AEM Commerceのローカル開発 local

CIF プロジェクトを使用する場合は、ローカル開発環境を使用することをお勧めします。

CIF アドオンと呼ばれるAEM用のAEM Commerce アドオンもローカル開発が可能で、AEM パッケージとして提供されます。 これは、​ ソフトウェア配布ポータル ​ から機能パックとしてダウンロードできます。

必要なソフトウェア

以下をローカルにインストールしておく必要があります。

CIF アドオンへのアクセス

CIF アドオンは、​ ソフトウェア配布ポータル ​ からダウンロードして、AEM Commerce add-on を検索できます。

ローカル設定

AEMとアドオン CIFを使用するローカル CIF プロジェクト開発の場合は、次の手順を実行します。

OSGI コンソールを使用して設定を確認します：http://localhost:4502/system/console/osgi-installer。 このリストには、CIF アドオン関連バンドル、コンテンツパッケージ、OSGI 設定が含まれている必要があります。すべてのバンドルが起動されていることを確認します。

プロジェクトのセットアップ project

CIF を使用して AEM Commerce プロジェクトを開始する方法は 2 とおりあります。

AEM プロジェクトアーキタイプの使用

CIF を使い始めるために事前に設定されたプロジェクトを Bootstrap するには、AEM プロジェクトアーキタイプが主なツールです。CIF コアコンポーネントと必要なすべての設定を、生成されたプロジェクトに 1 つの追加オプションで含めることができます。

AEM プロジェクトの生成方法については、AEM プロジェクトアーキタイプの「使用手順」を参照してください。プロジェクトに CIF を含めるには、includeCommerce オプションを使用します。

次に例を示します。

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -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 参照用ストアの使用

CIF プロジェクトを開始する 2 つ目の方法は、AEM Venia 参照用ストアをコピーして使用する方法です。AEM Venia 参照用ストアは、AEM 用の CIF コアコンポーネントの使用方法を示すサンプルのストアフロントアプリケーションです。これは、ベストプラクティス例として意図されていて、独自機能を開発するための有望な出発点としての役割も果たします。

Git リポジトリをクローンして Venia 参照用ストアの使用を開始し ​ 必要に応じてプロジェクトをカスタマイズする開始。

コマースシステムへの AEM の接続

プロジェクトをコマースシステムに接続するには、コマースシステムのGraphQL エンドポイントをAEMに設定する必要があります。

AEM プロジェクトアーキタイプで生成されたプロジェクトにも ​ AEM Venia 参照用ストア ​ で生成されたプロジェクトにも、デフォルト設定が既に含まれており、これを調整する必要があります。

com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json の url の値を、プロジェクトで使用されるコマースシステムの GraphQL エンドポイントに置き換えます。

AEM Commerce アドオンとCIF コアコンポーネントは、AEM サーバーを介してCommerce GraphQL エンドポイントに接続します。 または、ブラウザーから直接。 クライアントサイドのCIF コアコンポーネントとCIF アドオンのオーサリングツールは、デフォルトで /api/graphql に接続します。 必要に応じて、CIF Cloud Service設定を使用して調整できます（以下を参照）。

CIF アドオンは、/api/graphql で GraphQL プロキシサーブレットを提供します。ローカルの AEM Dispatcher を使用する予定がない場合は、GraphQL プロキシサーブレットも設定することをお勧めします。

http://localhost:4502/system/console/configMgr に移動し、Adobe CIF GraphQL Proxy Configuration サービスの OSGI 設定を作成します。 上記の GraphQL クライアントで使用したのと同じ GraphQL エンドポイントを、コマースシステムで使用します。

その他のリソース