1. Sitecoreにおけるシリアライズ

YAMLのシリアル化フォーマット

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

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

YAMLのシリアライゼーション形式を使うと、好きなだけアイテムツリーをシリアライズできます。これは、デフォルトで常に1つのデータベース(マスター、コア)1つにつき木を使うフォーマットとは異なります。設定ファイルのpredicateノードでこれを指定します。以下のルールと制限が適用されます。

  • 各アイテムはツリーに一つしか入れません。

  • ツリーに含まれていないアイテムは、シリアライズ時に保存されません。

  • もし1つのアイテムをシリアライズに選べば、コンテンツツリー全体もシリアライズされます。

ユーザーやロールは設定したツリーには保存されませんが、ファイルに格納されている場合はエンティティをフィルタリングできます。

このトピックでは以下の内容を説明します:

YAMLシリアライゼーションファイル形式

アイテムをシリアライズする際、Sitecoreは処理するアイテムごとに別々のテキストファイルを作成します。ファイルはSerializationFolder設定で指定されているルートフォルダに保存されています。Sitecoreでシリアル化テキストファイルをYAML形式で保存するように設定すると、ファイルは次のようになります:

---
ID: "110d559f-dea5-42ea-9c1c-8a5df7e70ef9"
Parent: "0de95ae4-41ab-4d01-9eb0-67441b7c2450"
Template: "76036f5e-cbce-46d1-af0a-4143f9b557aa"
Path: /sitecore/content/Home
DB: master
Created: 20190311T155629Z
SharedFields:
- ID: "06d5295c-ed2f-4a54-9bf2-26228d113318"
  Hint: __Icon
  Value: Network/16x16/home.png
- ID: "56776edf-261c-4abc-9fe7-70c618795239"
  Hint: __Help link
  Value: |
    <link url="http://www.google.com" linktype="external" />
- ID: "6fd695e7-7f6d-4ca5-8b49-a829e5950ae9"
  Hint: __Subitems Sorting
  Value: "{781247D2-9785-400F-8935-C818EC757967}"
- ID: "a4f985d9-98b3-4b52-aaaf-4344f6e747c6"
  Hint: __Workflow
  Value: "{A5BC37E7-ED96-4C1E-8590-A26E64DB55EA}"
- ID: "ba3f86a2-4a1c-4d78-b63d-91c2779c1b5e"
  Hint: __Sortorder
  Value: "-1"
- ID: "ca9b9f52-4fb0-4f87-a79f-24dea62cda65"
  Hint: __Default workflow
  Value: 
- ID: "dec8d2d5-e3cf-48b6-a653-8e69e2716641"
  Hint: __Security
  Value: "sitecore|{B92EB493-5BD2-4603-9296-7D9CB7464CFD}|5396||"
- ID: "f1a1fe9e-a60c-4ddb-a3a0-bb5b29fe732e"
  Hint: __Renderings
  Type: layout
  Value: |
    <r>
      <d
        id="{FE5D7FDF-89C0-4D99-9AA3-B5FBD009C9F3}"
        l="{14030E9F-CE92-49C6-AD87-7D49B50E42EA}">
        <r
          id="{493B3A83-0FA7-4484-8FC9-4680991CF743}"
          ph=""
          ds=""
          par="" />
      </d>
      <d
        id="{46D2F427-4CE5-4E1F-BA10-EF3636F43534}"
        l="{14030E9F-CE92-49C6-AD87-7D49B50E42EA}">
        <r
          id="{493B3A83-0FA7-4484-8FC9-4680991CF743}"
          ph=""
          ds=""
          par="" />
      </d>
    </r>
Languages:
- Language: en
  Fields:
  - ID: "9541e67d-ce8c-4225-803d-33f7f29f09ef"
    Hint: __Short description
    Value: Welcome to Sitecore.
  Versions:
  - Version: 1
    Fields:
    - ID: "001dd393-96c5-490b-924a-b0f25cd9efd8"
      Hint: __Lock
      Value: <r />
    - ID: "25bed78c-4957-4165-998a-ca1b52f67497"
      Hint: __Created
      Value: 
    - ID: "3e431de1-525e-47a3-b6b0-1ccbec3a8c98"
      Hint: __Workflow state
      Value: 
    - ID: "75577384-3c97-45da-a847-81b00500e250"
      Hint: Title
      Value: Sitecore
    - ID: "8cdc337e-a112-42fb-bbb4-4143751e123f"
      Hint: __Revision
      Value: "fb39b6ea-11e0-4f2e-a3dd-6f2e8b1db2a2"
    - ID: "a60acd61-a6db-4182-8329-c957982cec74"
      Hint: Text
      Value: Welcome to Sitecore.
    - ID: "d9cf14b1-fa16-4ba6-9288-e8a174d4d522"
      Hint: __Updated
      Value: 20070823T125217

YAMLシリアライズの設定

YAMLのシリアライズには、このフォーマットにのみ関連する設定ファイルがいくつかあります。最も重要なものは以下の通りです:

舞台設定

概要

fieldFormatters

このノードの設定は、特定のアイテムフィールドタイプをどのようにシリアライズするかを指定します。フォーマットツールの追加も可能です。

述語

シリアライズすべきツリーの名前、データベース、シリアライズする親アイテムのパスを指定します。

userPredicate, rolePredicate

Sitecoreがユーザーや役割をシリアライズされた際にフィルタリングするルールを指定します。

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