sitecore系統教程之使用修補程序文件自定義Sitecore配置


您可以使用修補程序文件在Sitecore中添加或更改配置設置。Sitecore將修補程序文件與Sitecore.config 文件合並,以創建在運行時使用的配置文件。

本主題描述:

  • 補丁文件放置
  • 補丁文件語法
  • 預覽修補結果

補丁文件放置

您必須/App_Config/Include直接或在子文件夾中將修補程序文件放在Sitecore安裝的文件夾中。您必須提供以擴展名結尾的補丁文件名稱.config

Sitecore按字母順序合並補丁文件。文件夾中的文件在文件夾中的子文件夾中的文件之前合並。例如,文件/App_Config/Include/mywebsite9.config在文件之前合並 /App_Config/Include/Myfolder/mywebsite1.config

如果Sitecore在多個修補程序文件中找到相同的配置,則要合並的最后一個修補程序文件將覆蓋以前版本的配置。

例如,如果以下列表中的所有文件都定義了相同的配置,則Sitecore僅使用列出的最后一個文件中的配置:

  • /App_Config/Include/z.config
  • /App_Config/Include/b/b.config
  • /App_Config/Include/b/c.config
  • /App_Config/Include/c/a.config [用過的]

補丁文件語法

以下XML名稱空間包含與修補相關的所有屬性和元素:

  • 補丁 - http://www.sitecore.net/xmlconfig/
  • 設置 - http://www.sitecore.net/xmlconfig/set/

必須先聲明命名空間,然后才能在補丁文件中使用它們。通常,您在文件的開頭聲明它們:

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" 
xmlns:set="http://www.sitecore.net/xmlconfig/set/">
. . . . . 
. . . . .
</configuration>

當Sitecore應用補丁文件中的更改時,它會嘗試將補丁文件中的每個元素與現有配置中的元素進行匹配。它使用元素名稱和元素的所有屬性的組合來匹配元素。如果匹配,Sitecore將更新現有元素。如果沒有匹配,Sitecore會插入一個新元素。

注意

如果修補程序文件元素與現有配置中的多個元素匹配,則Sitecore會將更新應用於它找到的第一個匹配元素。因此,強烈建議您指定元素的足夠屬性以唯一標識它。

默認情況下,Sitecore會在元素所屬的配置部分的末尾插入新元素。您可以使用patch:元素中屬性來指定相對於現有元素的放置位置,或指定它替換,更新或刪除同名的現有元素。您可以使用以下屬性:

  • patch:before - 在指定元素之前插入元素。
  • patch:after - 在指定元素后插入元素。
  • patch:attribute - 定義或替換元素的指定屬性。您可以使用set 命名空間實現相同的效果

例如,要在具有名稱的站點之前添加站點website,請使用以下語法:

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <sites>
      <site patch:before=”*[@name='website']” name=”mysite” ... />
    </sites>
  </sitecore>
</configuration>

您可以使用補丁文件的示例 幫助您更改Sitecore配置。

注意

在該/App_Config/Include文件夾中,有幾個文件以擴展名結尾.example在這些文件中,您可以看到如何修補配置元素的示例。要在運行時配置中包含示例文件,必須將文件重命名為end in .config

您可以在Sitecore開發人員網站上找到有關補丁文件的更詳細說明請注意,此描述主要涉及Sitecore版本6。

預覽修補結果

要查看運行時使用的配置文件,請加載URL http:// <hostName> /sitecore/admin/showconfig.aspx

您還可以使用Sitecore實例管理器中的Config Builder來模擬合並過程。Config Builder將所有補丁文件與Sitecore.config文件合並,使您可以將生成的文件保存在任何您喜歡的位置。然后,您可以檢查是否已按預期修補了配置更改。

您可以在Sitecore實例管理器的“ 主頁”選項卡上的“ 捆綁工具 ” 下找到“配置生成器”。您必須先選擇Sitecore站點,然后才能選擇Config Builder。

注意

生成的配置文件顯示修補元素的來源。例如,從Sitecore.Analytics.config 文件中獲取的元素包含該patch:source="Sitecore.Analytics.config"屬性。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM