1. Sitecore Command Line Interface

Version互換性

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

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

Sitecore Command Line Interface(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を使ったプラグインの追加など)後に、廃止されたフィールドを新しいフィールドで自動的に書き換えようとします。しかし、例えばマージエラーや省略の結果としてsitecore.jsonファイルにversionComparingEnabledフィールドがまだ残っている場合、警告メッセージが表示されます:

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

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

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