次の方法で共有

SDK およびモジュール ライブラリの更新

  • [アーティクル]

この記事では、Microsoft Dynamics 365 Commerce オンライン ソフトウェア開発キット (SDK) の一部としてリリースされる定期的な更新について説明します。

定期的な更新は、Dynamics 365 Commerce オンライン SDK およびモジュール ライブラリの一部としてリリースされます。 これらの更新には、新機能や製品の修正プログラムが含まれる場合があります。 すべての変更に関する製品リリース ノートが提供されます。

package.json ファイルの依存関係バージョン

SDK ルート ディレクトリに含まれている SDK ackage.json ファイルは、SDK、モジュール ライブラリ、Fabrikam デザイン キット、および Retail Server プロキシのどのバージョンがダウンロードされるかを制御します。 特定のエントリは、次の例に示すように「依存関係」セクションで検索できます。 バージョン番号は、SDK を取得した時期によって異なる場合があることに注意してください。

"dependencies": {
    "@msdyn365-commerce-modules/starter-pack": "9.41",
    "@msdyn365-commerce-modules/fabrikam-design-kit": "9.41",
    "@msdyn365-commerce/bootloader": "^1.0.0",
    "@msdyn365-commerce/retail-proxy": "9.41",
}
  • @msdyn365-commerce-modules/starter-pack – このエントリは、一連のスターター モジュールおよびデータ アクションを含む、モジュール ライブラリを表します。 前の例では、指定したバージョンのみをプルダウンするように構成されています。
  • @msdyn365-commerce-modules/fabrikam-design-kit – このエントリは、Fabrikam テーマを含む Fabrikam デザイン キットを表します。 Fabrikam テーマでは、モジュール ライブラリの一連のモジュールに対して、特定のカスケード スタイル シート (CSS) およびモジュール ビューの上書きが定義されます。 前の例では、指定したバージョンのみをプルダウンするように構成されています。
  • @msdyn365-commerce/retail-proxy – このエントリは、Commerce Scale Unit の一連の API にアクセスするために使用する Retail Server プロキシを表します。 前の例では、指定したバージョンのみをプルダウンするように構成されています。
  • @msdyn365-commerce/bootloader – このエントリは SDK を表します。 キャレット (^) 記号により、yarn コマンドが常に最新のリリース バージョンをプルダウンします。

前の例で使用されたバージョン番号は、X.Y.Z の形式で使用され、X はメジャー バージョン、Y はマイナー バージョン、Z はパッチ バージョンになります。

SDK の依存関係には下位互換性があり、いつでもプルダウンできます。 モジュール ライブラリのマイナー バージョンは Commerce Scale Unit に依存します。 したがって、次の表に示すバージョンより高くなることはありません。

パッチ バージョンは Commerce Scale Unit への依存関係を変更しないため、いつでも更新できます。 パッチ バージョン番号は、starter-pack、fabrikam-design-kit、retail-proxy などの package.json ファイルのいくつかのパッケージには含まれていないため、yarn コマンドを実行すると、現在ダウンロードしたパッケージより新しい任意のパッチ リリースが選択されます。

Commerce Scale Unit バージョンにマッピングされたモジュール ライブラリのバージョン

次の表では、モジュール ライブラリのバージョンを Commerce Scale Unit バージョンにマッピングします。 Commerce Scale Unit にマッピングされているのと同じモジュール ライブラリ バージョンを、Retail Server プロキシおよび Fabrikam デザイン キットに使用する必要があります。 次の表は、2023 年 1 月 13 日 時点で、現在サポートされているバージョンを一覧表示しています。

Commerce Scale Unit バージョン モジュール ライブラリの最大バージョン
10.0.13 9.23.x
10.0.14 9.24.x
10.0.15 9.25.x
10.0.16 9.26.x
10.0.17 9.27.x
10.0.18 9.28.x
10.0.19 9.29.x
10.0.20 9.30.x
10.0.21 9.31.x
10.0.22 9.32.x
10.0.23 9.33.x
10.0.24 9.34.x
10.0.25 9.35.x
10.0.26 9.36.x
10.0.27 9.37.x
10.0.28 9.38.x
10.0.29 9.39.x
10.0.30 9.40.x
10.0.31 9.41.x

更新プログラムをプルする

SDK、モジュール ライブラリ、およびその他の依存関係の更新はオプションであり、SDK ソース コードの yarn コマンドを使用してローカルの開発環境にプルダウンすることができます。 このコマンドを実行すると、package.json ファイルに指定されたバージョンに基づいて、最新の依存関係がプルダウンされます。 yarn コマンドを実行する前に、ルート ディレクトリから yarn.lock ファイルを削除する必要があります。 必要に応じて、/node_modules フォルダーを削除して、一連のクリーンな依存関係ファイルを取得することもできます。

最新の依存関係がプルダウンされたら、yarn start を実行して開発環境でノード サーバーを実行し、新しい SDK およびモジュール ライブラリ コンポーネントをテストすることができます。

yarn msdyn365 pack コマンドライン インターフェイス (CLI) ツールを使用してコンフィギュレーション パッケージを作成すると、すべての依存関係がパッケージング プロセス中にローカル バージョンに更新されます。 次に、作成されたパッケージは、Microsoft Dynamics Lifecycle Services (LCS) を使用してオンライン サイトにアップロードできます。

CLI コマンドで SDK を更新する

オンライン SDK はすべてのバージョンと下位互換性があるので、Commerce Scale Unit およびモジュール ライブラリのバージョンに関係なく、オンライン SDK を最新のバージョンに更新しておくことをお勧めします。 最新の SDK に更新するには、yarn msdyn365 update-versions sdk CLI コマンドを実行して、yarn を実行する前に yarn.lock ファイルが確実に削除されるようにし、オンライン SDK の最新バージョンをプルダウンします。

依存関係パッケージの最新リリース バージョンを判断する

依存関係パッケージの最新リリース バージョンを判断するには、以下のフィード リンクを参照してください:

eコマース サイトに展開するバージョンを判断する

eコマース サイトで使用される、SDK、モジュール ライブラリ、Retail Server プロキシの展開されたバージョンを判断するには、サイト ページを右クリックし、ページ ソースの表示を選択してから、次の文字列を検索してバージョン番号を見つけます:

  • commerceSDKVersion – SDK バージョン。
  • commerceSSKVersion – モジュール ライブラリ バージョン。
  • retailServerProxyVersion – Retail Server プロキシ バージョン。

app.settings.json ファイルを更新する

SDK /src/settings ディレクトリには、app.settings.json というファイルがあります。 このファイルのは、モジュールのモジュール ライブラリ セットによって使用される Commerce サイト ビルダーへのグローバル設定を表面化し、カスタム モジュール用の追加設定を含めることができます。 設定は、サイト設定 > 拡張機能のサイト ビルダーに配置されます。

モジュール ライブラリの更新時に、新しい設定が適用され、手動で追加する必要性があります。 最新の app.settings.json ファイルは、オンライン SDK GitHub 設定ディレクトリで確認できます。 このファイルには、利用可能な最新のモジュール ライブラリの設定が含まれています。 app.settings.json ファイルに任意の追加をしなかった場合は、このファイルの内容を自分のバージョンにコピーするか、diff を実行して新しい設定を手動でマージできます。 古いモジュール ライブラリに更新している場合は GitHub 分岐ページに配置された、特定のビルド分岐の下にある特定の app.settings.json ファイルを検索できます。 内容を自分の app.settings.json ファイルに手動でマージする必要があります。

yarn msdyn365 pack コマンド ライン インターフェイス (MSD) ツールを使用してローカル コンフィギュレーション パッケージを作成する場合、ローカルの app.settings.json ファイルの更新が含まれています。 次に、作成されたパッケージは、Microsoft Dynamics Lifecycle Services (LCS) を使用してオンライン サイトにアップロードできます。 その後、サイト ビルダー ツールの新しい設定が表示されます。

グローバル モジュール ライブラリ拡張機能を使用したモジュール ライブラリを更新する

メモ

eコマース拡張機能のカスタマイズがない場合にのみ、グローバル モジュール ライブラリ拡張機能を使用してモジュール ライブラリを更新します。

新たに配置された環境など、eコマース拡張機能カスタマイズがない (つまり、モジュール、データ アクション、テーマがない) 環境の場合は、LCS 内でコンフィギュレーション済み eコマース グローバル拡張機能を使用してモジュール ライブラリを更新できます。 グローバルに利用可能なカスタマイズのいずれかを使用して展開すると、配置された eコマース拡張機能パッケージが上書きされます。そのため、カスタマイズがアップロードされていないのを確認することが重要です。 また、上記のCommerce Scale Unit バージョンにマッピングされたモジュール ライブラリのバージョン セクションにもあるように、展開された Commerce Scale Unit バージョンに関連付けられているモジュール ライブラリ バージョン以降にアップグレードしていないのを確認することも必要です。

グローバル eコマース拡張機能を展開する

グローバル eコマース拡張機能を展開するには、次の手順に従います。

  1. LCS プロジェクト内から、資産ライブラリを選択します。

    資産ライブラリ タイルが強調表示された LCS プロジェクト画面。

  2. 資産ライブラリ ページで、eコマース パッケージ タブを選択してから、インポートを選択します。

    eコマース パッケージ タブおよびインポート ボタンが強調表示された LCS 資産ライブラリ ページ。

  3. eコマース パッケージのピック ダイアログ ボックスで、インポートするパッケージを選択してから、ピックを選択します。 パッケージが利用可能になるまでに 15 ～ 30 分かかる場合があります。

    グローバル eコマース拡張機能ファイルの名前付け規則には、Commerce リリース バージョンとモジュール ライブラリのリリース バージョンが含まれており、正しいバージョンのピックするのに役立ちます。 次の画像例では、Commerce リリース 10.0.16 がファイル名で、モジュール ライブラリのバージョン 9.26.15 が含まれています。 一般提供のバージョンのみ使用可能になります。

    パッケージ名とピック ボタンが強調表示された eコマース パッケージ ダイアログ ボックスをピックします。

  4. パッケージをインポートした後、eコマース環境に展開できます。 環境が更新されるよう選択してから、管理を選択します。

  5. eコマース タブを選択してから、拡張機能の適用を選択してeコマースの更新ダイアログ ボックスを表示します。 展開する拡張機能を選択してから、更新を選択します。 展開には完了までに 15～30 分かかる場合があります。

    拡張機能が強調表示された e コマース ダイアログ ボックスを更新します。

拡張機能パッケージをアップロードする方法の詳細については、パッケージ コンフィギュレーションとオンライン環境への配置を参照してください。

追加リソース

パッケージ コンフィギュレーションとオンライン環境へのその配置