1. Sitecoreコマンドラインインターフェース

バージョンの互換性

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecoreコマンド ライン インターフェース (CLI) には、Sitecore Management Servicesモジュールがお使いのCLIのバージョンと互換性があるかどうかを確認するバージョン互換性機能があります。

バージョン互換性機能はデフォルトで有効になっていますが、sitecore.jsonファイルの新しいsettingsエントリを使用して制御できます。

  "settings": {
    "versionComparisonEnabled": true
  }

CLIをアップグレードした後、Sitecore Management Servicesエンドポイントを呼び出すCLI操作は、モジュールのバージョンが最新の場合にのみ実行されます。バージョンに互換性がない場合、CLIコマンドを実行すると、次のメッセージが表示されます。

The Sitecore Management Service version of the environment this 
Sitecore CLI operates with is outdated, please update the Sitecore 
Management Service to version 5.1.25.

短期的な回避策として、versionComparisonEnabledをfalseに設定することができますが、代わりにSitecore Management Servicesモジュールを更新することを強くお勧めします。

大事な

バージョンの互換性チェックを無効にすることは可能ですが、互換性のないCLIとSitecore Management Serviceのバージョンにより、動作に一貫性がなくなったり、機能に問題が発生したりする可能性があります。

メモ

この機能は、バージョン5.1.25のCLIでversionComparingEnabledとして導入されましたが、現在は非推奨です。

バージョン5.1.25を使用している場合、Sitecore CLIは、Sitecore CLIを使用したプラグインの追加など、sitecore.jsonファイルを更新する操作の後に、非推奨のフィールドを新しいフィールドで自動的に書き換えようとします。ただし、マージのエラー/脱落などにより、versionComparingEnabledフィールドがsitecore.jsonファイルにまだ存在する場合は、次の警告メッセージが表示されます。

The property "versionComparingEnabled" in the sitecore.json file was deprecated. Please, use "versionComparisonEnabled" instead.

さらに、新しいフィールドの優先度は非推奨のフィールドよりも高く、古いフィールドの値は現在のバージョンのデフォルト値と異なる場合でも無視されます。この動作を修正するには、新しいフィールドを必要な値で手動で更新し、非推奨のフィールドを削除する必要があります。

この記事を改善するための提案がある場合は、 お知らせください!