1. パッチファイルを使ってSitecoreの設定をカスタマイズしてください

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

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

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

パッチファイルを使ってSitecoreAI設定を変更する場合は、追加または更新したいノードを必ず特定する必要があります。デフォルトでは、SitecoreAIパッチされた属性で既存ノードを更新しますが、重要な属性を使ってSitecoreAIに新しいノードを追加させることもできます。

このトピックでは、以下の方法を説明します:

ノードを指定する

どのノードを更新したいかを指定する必要があります。

ノードを指定するために:

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

例えば、AliasActive設定はElementノードの一部であり、その <settings> ノードは <sitecore> Elementノードの一部です。 AliasActive設定の値をfalseに変更するには、パッチファイル内に以下の要素ノードを含める必要があります:

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

重要な属性を使う

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

例えば、Sitecore.configファイルの<clientscripts>ノードにスクリプトファイルを追加するパッチファイルを2つ持つことができます。

<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>

SitecoreAI最初のパッチファイルを処理すると、<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つ目のパッチファイルのノードを新しいノードとして追加したい場合は、ノード定義に重要な属性を追加できます。SitecoreAI重要な属性を統合することはなく、2番目のscript要素に一意の価値を持つ重要な属性が含まれている場合、SitecoreAIはそれを新しい要素として追加します。例えば、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>

以下の重要な属性をこのように活用できます:

  • 先祖

  • 集会

  • ビルダータイプ

  • カテゴリー

  • channelId(チャンネルID)

  • コメント

  • 包含

  • creationType(創造タイプ)

  • 概要

  • 説明

  • displayName

  • 拡張

  • facetKey

  • fieldID

  • フィールドネーム

  • fieldType

  • fieldTypeName

  • ファイル

  • 発見

  • フォルダ

  • グループ名

  • ヒント

  • ホスト名

  • ID

  • 実装タイプ

  • 本文内

  • インターフェース

  • キー

  • messageDataType

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

  • 方法

  • 名称

  • Namespace

  • ネットワーク名

  • オリジナルキー

  • 経路

  • postingConfiguration

  • 接頭辞

  • providerName

  • クエリ文字列

  • 参考文献

  • 地域

  • サービスタイプ

  • sitecoreKey

  • statusCode

  • タグ名

  • テンプレートID

  • トラフィックタイプ

  • トリガー

  • 種類

  • タイプコンバーター

  • タイプネーム

  • UID

  • urlReferrerHost

  • 価値

  • 動詞

  • ビューネーム

  • では

  • xmlControl

  • XMLS

既存のノードにおける重要な属性の値を変更するには:

  • patch:attributeの構文を使いましょう:

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

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

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

自分の重要な属性を定義するために:

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

例えば、以下はmy-own-attributeという有意な属性を加えます:

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

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

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