構成パッチファイルの例
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
以下のパッチ構文の例は、パッチがSitecoreAIの設定にどのように影響するかを示しています。すべての例は元の構成を示し、次にパッチファイル、そしてパッチファイルがSitecore.configファイルと統合された後の構成を示します。
例は以下の通りです:
- マージ構成
- 特定の要素の前に要素を挿入する
- 特定の要素の後に要素を挿入する
- 属性の追加や更新
- 要素の削除
- 要素の値の置換
SitecoreAIの設定をカスタマイズするには、これらのパッチ構文の例を使って 設定の追加や変更に役立ちます。
patchおよびset名前空間を使用するには、パッチファイルの冒頭で
マージ構成
異なるパッチファイルの構成は、パッチファイルの処理順にマージされます。
実行時に使用される構成は以下の通りです:
特定の要素の前に要素を挿入する
特定の要素の前に設定要素を挿入することができます。この例では、test2型のプロセッサの前にプロセッサを追加し、構成上のtest2の位置に関係なく:
実行時に使用される構成は以下の通りです:
特定の要素の後に要素を挿入する
特定の既存の要素の後に設定要素を挿入できます。この例では、test2の位置に関係なく、test2型のプロセッサの後にプロセッサを挿入します。
実行時に使用される構成は以下の通りです:
属性の追加や更新
新しい属性を追加したり、既存の属性の値を更新したりできます。属性がすでに存在している場合、その既存の値はパッチファイルの値に置き換えられます。もし属性がmysiteに存在しなければ、mysiteに追加されます。この効果を得るには、patch名前空間またはset名前空間のいずれかを使うことができます。
この例では、mysiteサイトにdomainPath属性を追加し、/homeに設定し、virtualFolder属性を/sitecore modules/webに変更しています:
このパッチファイルはpatch名前空間を使って属性を変更します:
このパッチファイルはset名前空間を使って同じ結果を得ています:
最終的な結果は両方のパッチファイルで同じです。実行時に使用される構成は以下の通りです:
要素の削除
設定要素はpatch
.で削除できます。除去すべき要素を特定するために、その要素ノードのname属性を指定します。!重要patch
、実行時に指定された要素とそのすべての属性を設定から削除してしまうので注意してください。
例えば、以下のSitecore設定は以下の通りです:
対応するパッチ設定は要素「b」を削除します:
実行時に使用される構成は以下の通りです:
もしその要素に名前属性がなければ、削除すべき要素とそのすべての属性をリストアップし、patch
。例えば、以下は設定ファイルです:そしてこれが対応するパッチファイルです:
実行時の結果として得られる構成は次の通りです:
要素の値の置換
patch
、選択した要素を兄弟要素の代わりに挿入するように指定してください。patch:beforeやpatch、この属性は元のノードや要素を完全に置き換えることを可能にします。構文は以下の通りです:
実行時に使用される構成は以下の通りです: