Sitecore コンテンツのシリアル化の構造についての概要

プロジェクト設定ファイルの名前は sitecore.json. で、このファイルには関連する Sitecore コンテンツのシリアル化モジュールを参照する modules プロパティなどのいくつかのプロパティが含まれます。

最も単純な形式のプロジェクト設定は次のようになります。

{
  "$schema": "./.sitecore/schemas/RootConfigurationFile.schema.json",    
  "modules": [ "src/*/*.module.json" ],
  "variables": {},
    "serialization": {
      "defaultMaxRelativeItemPathLength": 120,
      "defaultModuleRelativeSerializationPath": "serialization"
   }
}

シリアル化は、手動または自動で実行できます。

includes と rules を使用して、シリアル化するコンテンツ アイテムのサブセットを選択できます。これは、コンテンツ アイテム ツリーの特定の部分のシリアル化を繰り返す場合に便利です。

Project.module.json のようなモジュール ファイルで、どのコンテンツ アイテムをどのようにシリアル化するか、または除外するかを設定します。すべてのモジュール ファイルでシリアル化の設定や設定の上書きを行うことができます。

各シリアル化には、ファイル システムのフォルダー名として使用する name プロパティ、およびコンテンツ アイテム ツリーのどの部分をシリアル化するかを指定する path プロパティが含まれます。

たとえば、コンテンツ アイテム ツリー全体をファイル システムの serialization\content\ フォルダーにシリアル化し、これを Project.module.json ファイルに追加して sitecore ser pull コマンドを実行する場合、以下の画像のようになります。

"items": {
  "includes": [
    {
      "name": "content",
      "path": "/sitecore/content/home"
    }
  ]
}

“include” プロパティと “rule” プロパティの完全なリストについては、「Sitecore コンテンツのシリアル化設定の詳細」を参照してください。

"items": {
  "includes": [
    {
      "name": "content",
      "path": "/sitecore/content/home",
      "rules": [
        {
           "path": "/products/legacy",
           "scope": "ignored"
        },
        {
           "path": "/products",
           "scope": "ItemAndDescendants",
           "allowedPushOperations": "createUpdateAndDelete"
        },
        {
           "path": "*",
           "scope": "ignored"
        }
      ]
    }
  ]
}

sitecore.json 設定ファイルと任意の *modules.json file でフィールドを指定することで、シリアル化からフィールドを除外できるようになりました。

excludedFields プロパティには、fieldId および description の 2 つのプロパティを含む除外フィールドの配列が含まれます。

CLI コマンド package、watch、diff に対して、除外されたフィールドを設定することもできます。