バージョン互換性
このページの翻訳は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のバージョンは、動作の一貫性や機能上の問題を引き起こすことがあります。
!注この機能は、CLIのバージョン5.1.25でversionComparingEnabledとして導入されましたが、現在は非推奨となっています。
バージョン5.1.25の場合、Sitecore CLIはsitecore.jsonファイルを更新する操作(例えばSitecore CLIを使ったプラグインの追加など)後に、廃止されたフィールドを新しいフィールドで自動的に書き換えようとします。しかし、例えばマージエラーや省略の結果としてversionComparingEnabledフィールドがsitecore.jsonファイルにまだ存在している場合、警告メッセージが表示されます:
sitecore.jsonファイルの「versionComparingEnabled」プロパティは非推奨になっています。代わりに「versionComparisonEnabled」を使ってください。
さらに、新しいフィールドは廃止されたものよりも優先度が高く、古いフィールドは現在のバージョンのデフォルト値と値が異なっていても無視されます。この動作を修正するには、新しいフィールドを手動で希望の値に更新し、廃止されたフィールドを削除する必要があります。