サーバーの構成

構成パッチ・ファイルの例

Version:

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

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

次のパッチ構文の例は、パッチ適用がSitecore設定にどのように影響するかを示しています。すべての例は、元の構成、次にパッチ・ファイル、最後にパッチ・ファイルがSitecore.configファイルにマージされた後の構成を示しています。

これらの例は、次のことを示しています。

Sitecoreの設定をカスタマイズするには、これらのパッチ構文の例を使用して、Sitecoreの設定設定を追加または変更することができます。

構成のマージ

異なるパッチ・ファイルの構成は、パッチ・ファイルが処理される順序でマージされます。

<!-- Sitecore.config -->
<settings>
  <setting name="name" value="Aaron" />
</settings>
<!-- /App_Config/Include/file1.config -->
<settings>
  <setting name="city" value="New York" />
</settings>
<!-- /App_Config/Include/file2.config -->
<settings>
  <setting name="country" value="USA" />
</settings>

実行時に使用される設定は次のとおりです。

<settings>
  <setting name="name" value="Aaron" />
  <setting name="city" value="New York" />
  <setting name="country" value="USA" />
</settings>

特定の要素の前に要素を挿入する

特定の要素の前に構成要素を挿入できます。この例では、構成内のtest2の位置に関係なく、タイプtest2のプロセッサの前にプロセッサを追加します。

<!-- Sitecore.config -->
<test>
  <processor type="test1" />
  <processor type="test2" />
  <processor type="test3" />
</test>
<!-- Patch file -->
<test>
  <processor type="testA" patch:before = "processor[@type='test2']"/>
</test>

実行時に使用される設定は次のとおりです。

<test>
  <processor type="test1" />
  <processor type="testA" />
  <processor type="test2" />
  <processor type="test3" />
</test>

特定の要素の後に要素を挿入する

特定の既存の要素の後に構成要素を挿入できます。この例では、構成内のtest2の位置に関係なく、タイプtest2のプロセッサの後にプロセッサを挿入します。

<!-- Sitecore.config -->
<test>
  <processor type="test1" />
  <processor type="test2" />
  <processor type="test3" />
</test>
<!-- Patch file -->
<test>
  <processor type="testA" patch:after = "processor[@type='test2']"/>
</test>

実行時に使用される設定は次のとおりです。

<test>
  <processor type="test1" />
  <processor type="test2" />
  <processor type="testA" />
  <processor type="test3" />
</test>

属性の追加または更新

新しい属性を追加したり、既存の属性の値を更新したりできます。属性がすでに存在する場合は、その既存の値がパッチ・ファイルの値に置き換えられます。属性がmysiteにまだ存在しない場合は、mysiteに追加されます。この効果を得るには、patch名前空間またはset名前空間のいずれかを使用できます。

この例では、domainPath属性をサイトmysite, に追加して /homeに設定し、virtualFolder属性を /sitecore modules/webに変更します。

<!-- Sitecore.config -->
<sites>
  <site name="mysite" virtualFolder="/"></site>
 </sites>

このパッチファイルでは、patch名前空間を使用して属性を変更します。

<!-- Patch file -->
<sites>
<site name="mysite" virtualFolder="/">
<patch:attribute name="domainPath">/home</patch:attribute>
<patch:attribute name="virtualFolder">/sitecore modules/web</patch:attribute>
</site>
</sites>

このパッチファイルでは、set名前空間を使用して同じ結果が得られます。

<!-- Patch file -->
<sites>
<site name="mysite" virtualFolder="/" set:domainPath="/home" set:virtualFolder="/sitecore modules/web"></site>
</sites>

最終的な結果は、両方のパッチファイルで同じです。実行時に使用される設定は次のとおりです。

<sites>
  <site name="mysite" domainPath="/home" virtualFolder="/sitecore modules/web"></site>
</sites>

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