構成パッチファイルの例
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
以下のパッチ構文の例は、パッチが設定に与える影響を示しています。すべての例は元の構成を示し、次にパッチファイル、そしてパッチファイルがSitecore.configファイルとマージされた後の構成を示します。
例は以下の通りです:
設定をカスタマイズするには、これらのパッチ構文の例を使って 設定の追加や変更に役立ちます。
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、この属性は元のノードや要素を完全に置き換えることを可能にします。構文は以下の通りです:
実行時に使用される構成は以下の通りです: