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

パッチファイル設定の制御

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

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

パッチ ファイルを使用してSitecore設定を変更する場合は、追加または更新するノードを特定する必要があります。デフォルトでは、Sitecoreはパッチが適用された属性で既存のノードを更新しますが、重要な属性を使用して、Sitecoreに新しいノードを追加するように強制できます。

このトピックでは、次の方法について説明します。

ノードを指定する

更新するノードを指定する必要があります。

ノードを指定するには、次のようにします。

  • Sitecore.configファイルのXML構造内の要素名とその場所を指定します。

たとえば、AliasActive設定は <settings> 要素ノードの一部であり、<sitecore> 要素ノードの一部であるとします。 AliasActive設定の値をfalseに変更するには、パッチ ファイルに次の要素ノードを含める必要があります。

<sitecore>
 <settings>
   <setting name="AliasActive">
     <patch:attribute name="value">False</patch:attribute>
   </setting>
 </settings>
</sitecore>

有意な属性を使用する

Sitecoreがパッチ・ファイルから属性を処理するとき、パッチ・ファイル・ノードの属性に適合するSitecore.config・ファイル内の既存のノードを探します。見つかった場合、デフォルトでは、パッチファイル内の属性を既存のノードにマージします。

たとえば、2つのパッチ ファイルがあり、どちらもSitecore.configファイルの <clientscripts> ノードにスクリプト ファイルを追加できます。

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
 <clientscripts>
 <script src="script-1.js" language="javascript" />
 </clientscripts>
  </sitecore>
</configuration>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
 <clientscripts>
 <script src="script-2.js" language="javascript" att1="test" />
 </clientscripts>
  </sitecore>
</configuration>

Sitecoreが最初のパッチ ファイルを処理するときに、<script src="script-1.js"> 要素が追加されます。2番目のパッチ・ファイルを処理するときに、新しい情報を最初の <script> 要素とマージし、src属性を更新し、att1属性を追加します。最終結果は次のとおりです。

<sitecore>
 <clientscripts>
   <script src="script-2.js" language="javascript" att1="test" patch:source="Add-script-2.config"
/>
 </clientscripts>
</sitecore>

2番目のパッチ・ファイルのノードを新しいノードとして追加する場合は、ノード定義に重要な属性を追加できます。Sitecoreは重要な属性をマージしないため、2番目のscript要素に一意の値を持つ重要な属性が含まれている場合、Sitecoreはそれを新しい要素として追加します。たとえば、2番目のパッチ ファイルのscript要素にdesc属性を追加できます。

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
 <clientscripts>
 <script src="script-2.js" language="javascript" att1="test" desc="new script" />
 </clientscripts>
  </sitecore>
</configuration>

両方のパッチファイルを処理した後の結果は、次のようになります。

<sitecore>
    <clientscripts>
        <script src="script-1.js" language="javascript" patch:source="Add-script-1.config" />
        <script desc="new script" src="script-2.js" 
            language="javascript" att1="test" patch:source="Add-script-2.config" />
    </clientscripts>
</sitecore>

この方法では、次の重要な属性を使用できます。

  • 祖先

  • 集会

  • ビルダータイプ

  • カテゴリ

  • チャネルID

  • コメント

  • 含む

  • クリエーションタイプ

  • DESC

  • 形容

  • ディスプレイ名

  • 拡張 機能

  • ファセットキー

  • フィールドID

  • フィールド名

  • フィールドタイプ

  • フィールドタイプ名

  • ファイル

  • 見付ける

  • フォルダ

  • グループ名

  • ヒント

  • ホスト名

  • 身分証明書

  • implementationタイプ

  • インナーテキスト

  • インターフェイス

  • 鍵

  • メッセージデータタイプ

  • メッセージアイテムベースタイプ

  • 方式

  • 名前

  • Namespace

  • ネットワーク名

  • オリジナルキー

  • パス

  • 投稿設定

  • 接頭辞

  • プロバイダー名

  • クエリ文字列

  • 参照

  • 地域

  • サービスタイプ

  • サイトコアキー

  • ステータスコード

  • タグ名

  • テンプレートID

  • trafficType (トラフィックタイプ)

  • トリガー

  • 種類

  • タイプコンバーター

  • タイプ名

  • UIDの

  • urlリファラーホスト

  • 価値

  • 動詞

  • ビューネーム

  • で

  • xmlコントロール

  • xmlnsの

既存のノード内の重要な属性の値を変更するには、次のようにします。

  • patch:attribute構文を使用します。

    <sitecore>
 <clientscript >
   <script src="script-1.js" att1="test">
     <patch:attribute name="desc">new description</patch:attribute>
   </script>
 </clientscript>
</sitecore>

重要な属性定義を追加する

デフォルトの重要な属性を使用できない場合は、独自の属性を定義できます。

独自の重要な属性を定義するには、次のようにします。

  • significant属性をSitecore.configファイルの <sitecore> elementノード内に追加します。

たとえば、次の例では、my-own-attributeという重要な属性を追加します。

<patch>
  <significantAttributes>
  <add name="my-own-attribute"/> 
  </significantAttributes>
</patch>
大事な

Sitecoreは、パッチ・ファイルを処理する前に、重要な属性のリストを処理します。したがって、新しい重要な属性をSitecore.configファイルに直接追加する必要があり、パッチ・ファイルを使用して追加することはできません。この方法は、事前定義された属性を絶対に使用できない場合にのみ使用してください。

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