パッチ ファイルを使用して Sitecore 設定をカスタマイズする

Sitecore の次の 2 つのカスタマイズ可能なレイヤーのいずれかでファイルを作成します。

パッチ ファイルは、上記のフォルダーのルートまたは上記のフォルダー内に作成したサブフォルダーのいずれかに配置できます。

パッチ ファイルのファイル名は自由ですが、拡張子は .config にします。

まず次の基本構造をファイルに記述します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<sitecore>
</sitecore>
</configuration>

パッチ ファイルの <sitecore> セクションに、構成に追加する設定変更を記述します。

patch と set の XML 名前空間を登録し、属性を使用して設定の変更や追加ができるようにします。そのためには、これらの名前空間を次のように <configuration> 設定に追加します。

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" 
xmlns:set="http://www.sitecore.net/xmlconfig/set/">

patch: 属性を使用して、既存の要素に対する要素の相対的な配置場所、または同じ名前を持つ既存の要素を置換するか更新するかを指定します。以下の属性を使用できます。

たとえば、mysite という名前のサイトを追加し、それを website という既存のサイトの前に配置するには、次の構文を使用します。

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <sites>
      <site patch:before=”*[@name='website']” name=”mysite” ... />
    </sites>
  </sitecore>
</configuration>

/App_config/layers.config ファイルで、<loadOrder> 設定をレイヤーの定義に追加します。

<layer name="Custom" includeFolder="/App_Config/Custom/">
<loadOrder>
</loadOrder>
</layer>

<loadOrder> セクションに、ファイル フォルダーまたは個々のファイルを読み込み順に追加します。

<loadOrder>
<add path="Folder23" type="Folder" />
<add path="Folder9/sitespecific.config" type="File" />
<add path="Folder1" type="Folder" />
</loadOrder>

まず、<loadOrder> セクションに指定されたフォルダーとファイルが記載された順に読み込まれます。前の例では、Folder23 フォルダー内のファイル、sitespecific.config ファイル、Folder1 内のファイルの順に読み込まれます。.

次に、<loadOrder> セクションに指定されていないフォルダーとファイルが読み込まれます。この読み込みはアルファベット順に行われます。フォルダーのルートに配置されたファイルのほうが、サブフォルダー内のファイルよりも先に読み込まれます。