フィードバックを送信

4.0 旧バージョンと非互換の変更

本ドキュメントは、Commerce 4.0 において、既存の機能、API、サードパーティの Liferay Commerce 開発者やユーザーとの契約を破壊する変更点を時系列で紹介します。私たちはこれらの混乱を最小限にするために最善を尽くしていますが、時には避けられないこともあります。

このファイルに記載されている変更の種類の一部を次に示します。

削除または置換される機能
旧バージョンと非互換の変更：パブリックJavaまたはJavaScript APIの変更
テンプレートで利用可能なコンテキスト変数の変更
Liferayテーマおよびポートレットで利用可能なCSSクラスの変更
設定の変更。 com.liferay.commerce.*.cfg などの設定ファイルの変更。
実行要件。Javaバージョン、JEEバージョン、ブラウザバージョンなど。
非推奨またはサポート終了：たとえば、次のバージョンで特定の機能またはAPIが停止されると警告している
推奨事項：たとえば、後方互換性のためにLiferay Portalに古いAPIが保持されているにもかかわらず、古いAPIに代わる、新しく導入されたAPIを使用することを推奨している

宛先名の変更

日付： 2020年9月10日
JIRAチケット： COMMERCE-4762

変更点

プレフィックス commerce_ が com.liferay.commerce.constants.CommerceDestinationNamesで定義された Commerceの宛先に追加されました。

liferay/commerce_order_status;
liferay/commerce_payment_status;
liferay/commerce_order_status;
liferay/commerce_payment_status;
liferay/commerce_subscription_status.

日付： 2021年2月22日
JIRAチケット： COMMERCE-4762

変更点

externalReferenceCode を参照するメソッドの再整理.

メソッドを更新したクラス。

com.liferay.commerce.inventory.service.CommerceInventoryWarehouseLocalService
com.liferay.commerce.inventory.service.CommerceInventoryWarehouseService
com.liferay.commerce.price.list.service.CommercePriceEntryLocalService
com.liferay.commerce.price.list.service.CommercePriceEntryService
com.liferay.commerce.price.list.service.CommercePriceListLocalService
com.liferay.commerce.price.list.service.CommercePriceListService
com.liferay.commerce.price.list.service.CommerceTierPriceEntryLocalService
com.liferay.commerce.price.list.service.CommerceTierPriceEntryService
com.liferay.commerce.pricing.service.CommercePriceModifierLocalService
com.liferay.commerce.pricing.service.CommercePriceModifierService
com.liferay.commerce.pricing.service.CommercePricingClassLocalService
com.liferay.commerce.pricing.service.CommercePricingClassService
com.liferay.commerce.product.service.CommerceCatalogLocalService
com.liferay.commerce.product.service.CommerceCatalogService
com.liferay.commerce.product.service.CommerceChannelLocalService
com.liferay.commerce.product.service.CommerceChannelService
com.liferay.commerce.product.service.CPAttachmentFileEntryLocalService
com.liferay.commerce.product.service.CPAttachmentFileEntryService
com.liferay.commerce.product.service.CPDefinitionLocalService
com.liferay.commerce.product.service.CPDefinitionService
com.liferay.commerce.product.service.CPInstanceLocalService
com.liferay.commerce.product.service.CPInstanceService
com.liferay.commerce.product.service.CPOptionLocalService
com.liferay.commerce.product.service.CPOptionService
com.liferay.commerce.product.service.CPOptionValueLocalService
com.liferay.commerce.product.service.CPOptionValueService
com.liferay.commerce.product.service.CProductLocalService
com.liferay.commerce.product.service.CProductService
com.liferay.commerce.service.CommerceAddressLocalService
com.liferay.commerce.service.CommerceAddressService
com.liferay.commerce.service.CommerceOrderItemLocalService
com.liferay.commerce.service.CommerceOrderItemService
com.liferay.commerce.service.CommerceOrderLocalService
com.liferay.commerce.service.CommerceOrderNoteLocalService
com.liferay.commerce.service.CommerceOrderNoteService
com.liferay.commerce.service.CommerceOrderService

日付： 2021年2月12日
JIRAチケット： COMMERCE-4974

変更点

MiniCart TagとFE React Componentは、そのコンポーネントビューとラベルの部分的および全体的な置き換えをサポートし、その機能の一部を標準のタグ属性、またはJS実装の直接インポートによって設定できるように拡張されています。
- 公開されている MiniCartTag の属性が変更されました。
- commerce-frontend-js モジュールは、そのコンテンツ（特に MiniCartContext MiniCart の統合に必要）へのアクセスや公開を制御できるように、適切なインターフェイスで公開されるようになりました。
- MiniCartコンポーネントのユーザビリティと拡張性については、こちらのドキュメント（）に記載されています。

日付： 2021年3月02日
JIRAチケット： LPS-125991

変更点

CommerceCountry および CommerceRegion テーブルは、データベースから削除されました。
CommerceCountry および CommerceRegion のサービスおよび永続性クラスは削除されました。
com.liferay.commerce.model.CommerceCountry および com.liferay.commerce.model.CommerceRegion への参照は、 com.liferay.portal.kernel.model.Country および com.liferay.portal.kernel.model.Regionへ置き換わりました。
CommerceCountry と CommerceRegion を参照する外部キーの名前が、 commerceCountryId と commerceRegionId から、それぞれ countryId と regionId に変更されました。更新されたカラムを持つテーブルは
- CommerceAddress
- CommerceAddressRestriction
- CommerceShippingFixedOptionRel
- CommerceTaxFixedRateAddressRel
- com.liferay.commerce.country.CommerceCountryManager が、Commerce 固有の国を取得するために追加されました。利用できる方式は
- getBillingCountries
- getBillingCountriesByChannelId
- getShippingCountries
- getShippingCountriesByChannelId
- getWarehouseCountries

日付： 2021年3月26日
JIRAチケット： COMMERCE-2909

変更点

MiniCompare FEの実装をJSP/vanilla JavaScriptからReactに移行（in commerce-frontend-js）。 commerce-product-content-webにある同じJSPのソースから直接読み込まれます。
CP定義IDは、セッションを使用する代わりに、クッキーに保存され、最終的にクッキーから読み取られるようになりました。
CompareCheckboxTag を JSP 経由でレンダリングするようにリファクタリングしました。 JSP は順番に、 CompareCheckbox React コンポーネントをレンダリングします。
- Deprecated and removed 古い Soy/MetalJS の実装である CompareCheckbox in commerce-frontend-taglib モジュールを削除しました。

影響を受ける人

MiniCompareコンポーネント/ウィジェットの古い実装に依存している開発者、または拡張している開発者。

なぜこの変更が行われたのですか？

Soy/MetalJSの非推奨に伴い
Liferay DXPと連携し、Liferay Classic ThemeをCommerceでサポートし、将来のDXP WEM統合への道を開くこと。

アカウントセレクターを刷新

日付： 2021年4月27日
JIRAチケット： COMMERCE-5888

変更点

AccountSelectorTag をJSPでレンダリングし、 IncludeTagから拡張するようにリファクタリングしました。 JSP は、Soy/MetalJS から移行した AccountSelector React コンポーネントをハイドレートしてレンダリングしています。
Commerce Headless API を介して実行時のライフサイクルで伝達される Account/Order の変更について、他のコンポーネントに通知するイベント名を変更しました。

影響を受ける人

旧Soy/MetalJSコンポーネントとその関連Tagに依存または拡張している開発者の方。

なぜこの変更が行われたのですか？

Soy/MetalJSの非推奨に伴い
Liferay DXPと連携し、Liferay Classic ThemeをCommerceでサポートし、将来のDXP WEM統合への道を開くこと。

ストアフロントにおける商品カードと商品レンダリング戦略

日付： 2021年4月27日
JIRAチケット： COMMERCE-5889

変更点

商品カードコンポーネントをJSPテンプレートに移植し、商品情報を表示するようにしました。 CPContentListRenderer → CPContentListEntryRendererを介してハイドレーションとレンダリングを行います。
- Product Publisher、Search Results、Compare ウィジェットで、これらのレンダリング方法が使用されるようになりました。
- Commerce Theme Minium Site Initializer が、これらのレンダリング戦略を使用するように設定されました。
- この実装は現在 commerce-product-content-web モジュールにあり、 CPContentRenderer override, JSP override, または Liferay Dynamic Include によって拡張可能になっています。
- Deprecated and removed 古い Soy/MetalJS の実装である commerce-frontend-taglib モジュールの Product Card は、 deprecated and removed となりました。
- 古い Minium 専用 CPContentRenderer’s in commerce-theme-minium-impl module has been deprecated and removed …。
AddToCartTag をJSP経由でレンダリングするようにリファクタリングし、現在は IncludeTagから継承しています。 JSP は順番に、 AddToCart React コンポーネントをレンダリングし、 QuantitySelector React コンポーネントもレンダリングします。
- Deprecated and removed 古い Soy/MetalJS の実装である AddToCartButton in commerce-frontend-taglib モジュールを削除しました。
- 非推奨 と commerce-frontend-taglib モジュールにある QuantitySelector の古い Soy/MetalJS の実装を削除しました。
- 非推奨 と削除古い QuantitySelectorTag を commerce-frontend-taglib モジュールで削除しました。
PriceTag は、JSPでレンダリングするようにリファクタリングされ、現在は IncludeTagから継承されています。 JSPは、正しく構造化されたテンプレート（SEO対策用）と、最終的に（ユーザーページの着地用） Price Reactコンポーネントの両方をレンダリングします。
- 非推奨 とを削除 commerce-frontend-taglib モジュールにある 価格 の古い Soy/MetalJS の実装を削除しました。

影響を受ける人

開発者が依存している、または拡張している。

commerce-theme-minium-implの Minium 専用の CP コンテンツレンダラー。
Soy/MetalJS AddToCartTag と AddToCartButton*.
Soy/MetalJS QuantitySelectorTag と QuantitySelector*.
the Soy/MetalJS PriceTag and Price*.

変更が行われた理由

Soy/MetalJSの非推奨に伴い
Liferay DXPと連携し、Liferay Classic ThemeをCommerceでサポートし、将来のDXP WEM統合への道を開くこと。

ServiceImplクラスでAddOrUpdateとUpsertを使い分けるためのメソッド名の標準化

日付： 2021年6月4日
JIRAチケット： COMMERCE-6095

日付： 2021年10月14日
JIRAチケット： COMMERCE-3030

日付： 2021年11月21日
JIRAチケット： COMMERCE-7288

変更点

アカウントウィジェットは、commerceアカウントウィジェットを置き換えたものです。既存のランニングシステム上のすべてのインスタンスが更新されました。

影響を受ける人

Commerce Accountウィジェットをカスタマイズしたり、サイトのイニシャライザーで使用したことのある開発者。
エンドユーザー（アカウントマネージャー）は、アカウントを管理するために別のウィジェットを使用することになります。

なぜこの変更が行われたのですか？

この変更は、Commerce AccountからAccountへの移行に合わせるために必要なものです。

CommerceOrderLocalServiceImpl をリファクタリングしました。

日付： 2022年2月16日
JIRAチケット： COMMERCE-8440

変更点

updateCommerceOrder メソッドのインスタンスが、4つから3つになりました。
updateCustomFields メソッドを削除しました。
updateOrderStatus メソッドを削除した。
updateTransactionId メソッドを削除しました。
updateUser メソッドを削除しました。

影響を受ける人

コード内でこれらのメソッドを呼び出している開発者の方。

コードを更新するにはどうすればよいですか？

残りの 3 つの updateCommerceOrder メソッドをそのまま代用してください。
expandoBridgeAttributes を commerceOrder.setExpandoBridgeAttributes(ServiceContext serviceContext) で設定した後に updateCommerceOrder(CommerceOrder commerceOrder) メソッドを使用して customFieldsを更新してください。
orderStatus を commerceOrder.setOrderStatus(int orderStatus) で設定した後に updateCommerceOrder(CommerceOrder) メソッドを使用して orderStatusを更新してください。
updateCommerceOrder(CommerceOrder commerceOrder) メソッドを使用し、 transactionId を commerceOrder.setTransactionId(String transactionId) で設定後、 transactionIdを更新してください。
userId と userName を commerceOrder.setUserId(long userId) と commerceOrder.setUserName(String userName) で設定し、ユーザー情報を更新してから updateCommerceOrder(CommerceOrder) メソッドを使用してください。

なぜこの変更が行われたのですか？

この変更は、クラス CommerceOrderLocalServiceImplをすっきりさせるために導入されました。

commerce-service service.xml で CommerceOrder を絞り込む。

日付： 2022年4月13日
JIRAチケット： COMMERCE-8408

変更点

CommerceOrderLocalService および CommerceOrderServiceの addCommerceOrder メソッドのパラメーターの再調整を行いました。
CommerceOrderLocalService および CommerceOrderServiceにおける addOrUpdateCommerceOrder メソッドのパラメーターの再調整を行いました。
CommerceOrderLocalService および CommerceOrderServiceの updateCommerceOrder メソッドのパラメーターの再整理を行う。
CommerceOrderLocalService および CommerceOrderServiceの updateCommerceOrderPrices メソッドのパラメーターの再整理。

影響を受ける人

コード内でこれらのメソッドを呼び出している開発者の方。

コードを更新するにはどうすればよいですか？

パラメータが新しい addCommerceOrder メソッド（複数可）と正しく整合していることを確認する。
パラメータが新しい addOrUpdateCommerceOrder メソッド（複数可）と正しく整合していることを確認する。
パラメータが新しい updateCommerceOrder メソッド（複数可）と正しく整合していることを確認する。
パラメータが新しい updateCommerceOrderPrices メソッド（複数可）と正しく整合していることを確認する。

なぜこの変更が行われたのですか？

この変更により、 CommerceOrder in commerce-service service.xmlのエンティティがクリーンアップされました。

CPContentHelperとCPContentHelperImplをリファクタリングしました。

日付： 2021年12月16日
JIRAチケット： COMMERCE-7830

変更点

CPContentHelper.java および CPContentHelperImpl.javaのメソッドのシグネチャを変更しました。
- getReplacementCommerceProductFriendlyURL(long cProductId, String cpIntanceUuid, ThemeDisplay themeDisplay) to getReplacementCommerceProductFriendlyURL(CPSku cpSku, ThemeDisplay themeDisplay)
getCPAttachmentFileEntries() メソッド CPContentHelper.java および CPContentHelperImpl.java を getCPMedias()へ改名しました。

Commerce

DXP Self-Hosted Installation, Maintenance, and Administration

Resource Type:

Official Documentation

Deployment Approach:

Liferay PaaS

Liferay Self-Hosted