文件AEM 6.5使用手冊

覆蓋 overlays

Last update: Tue Aug 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Experience Manager (AEM) （以及之前的CQ）一直使用覆蓋原則來讓您擴充及自訂 主控台 和其他功能(例如， 頁面製作)。

覆蓋是許多內容中使用的辭彙。 在此情境中(擴充AEM)，覆蓋是指採用預先定義的功能，並將您自己的定義強加於此功能（以自訂標準功能）。

在標準例項中，預先定義的功能儲存在 /libs 而且建議您在下定義覆蓋（自訂） /apps 分支。 AEM使用搜尋路徑來尋找資源，先搜尋 /apps 分支，然後是 /libs 分支( 可設定搜尋路徑)。 此機制表示您的覆蓋（以及其中定義的自訂）有優先權。

自AEM 6.0起，覆蓋的實作與使用方式已發生變更：

  • AEM 6.0及更高版本 — 適用於 Granite — 相關覆蓋圖（即觸控式UI）

    • 方法

      • 重新建構適當的 /libs 結構於 /apps.

        這不需要一對一複製， Sling資源合併 用於互動參照所需的原始定義。 Sling Resource Merger提供的服務可存取及合併具有不同（差異）機制的資源。

      • 在 /apps，進行任何變更。

    • 優點

      • 對下的變更更健全 /libs.
      • 僅重新定義必要的專案。

  • AEM 6.0之前的非Granite覆蓋圖和覆蓋圖

    • 方法

      • 複製內容來源 /libs 至 /apps

        複製整個子分支，包括屬性。

      • 在 /apps，進行任何變更。

    • 缺點

      • 雖然您的變更不會在下方發生變更時遺失 /libs，您可能必須重新建立下覆蓋圖中所發生的特定變更 /apps.
CAUTION
此 Sling資源合併 而相關方法只能搭配 Granite. 這表示建立具有骨架結構的覆蓋圖僅適用於標準觸控式UI。
其他區域（包括傳統UI）的覆蓋需要複製適當的節點和整個子結構，然後進行必要的變更。

針對許多變更，建議使用覆蓋圖，例如 設定您的主控台 或 在側面板中的資產瀏覽器中建立您的選取範圍類別 （用於編寫頁面）。 其需求為：

  • 不要 變更 /libs 分支​ ​您所做的任何變更都可能會遺失，因為每當您：

    • 在您的執行個體上升級
    • 套用hotfix
    • 安裝功能套件

  • 這些功能可將您的變更集中在一個位置；如有需要，讓您更輕鬆地追蹤、移轉、備份或偵錯變更。

設定搜尋路徑 configuring-the-search-paths

對於覆蓋圖，傳送的資源是擷取的資源和屬性的彙總，取決於可定義的搜尋路徑：

  • 資源 解析程式搜尋路徑 如 OSGi設定 針對 Apache Sling Resource Resolver Factory.

    • 搜尋路徑的由上而下的順序表示其各自的優先順序。
    • 在標準安裝中，主要預設值為 /apps， /libs — 所以內容屬於 /apps 的優先順序高於 /libs (也就是說 覆蓋 it)。

  • 兩位服務使用者需要有JCR：READ存取權才能存取儲存指令碼的位置。 這些使用者是： components-search-service (由com.day.cq.wcm.coreto使用)和sling-scripting （由org.apache.sling.servlets.resolver使用來尋找servlet）。

  • 下列設定也必須根據您放置指令碼的位置（此範例中位於/etc、/libs或/apps下）進行設定。

    code language-none 
    PID = org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl
resource.resolver.searchpath=["/etc","/apps","/libs"]
resource.resolver.vanitypath.whitelist=["/etc/","/apps/","/libs/","/content/"]

  • 最後，也必須設定Servlet Resolver （在此範例中，亦要新增/etc）

    code language-none 
    PID = org.apache.sling.servlets.resolver.SlingServletResolver
servletresolver.paths=["/bin/","/libs/","/apps/","/etc/","/system/","/index.servlet","/login.servlet","/services/"]

使用範例 example-of-usage

以下情形會說明部分範例：

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2