配置和配置瀏覽器

AEM設定可用於管理AEM中的設定,並作為工作區。

什麼是配置?

可從兩個不同的觀點來考慮配置。

  • 理員會將設定作為AEM內的工作區,以定義和管理設定群組。
  • 發人員會使用實作設定的基礎設定機制,以保存並在AEM中查詢設定。

總之:從管理員的角度來看,設定是您建立工作區以在AEM中管理設定的方式,而開發人員應了解AEM如何在存放庫中使用和管理這些設定。

無論從您的角度來看,設定在AEM中有兩個主要用途:

  • 設定可為特定使用者群組啟用特定功能。
  • 設定會定義這些功能的存取權限。

作為管理員的配置

AEM管理員及作者可將設定視為工作區。 這些工作區可用於透過對這些功能實作存取權限,以收集設定群組以及其相關內容,以利於組織用途。

可在AEM中針對許多不同功能建立設定。

範例

例如,管理員可為可編輯的範本建立兩個設定。

  • WKND-General
  • WKND-Magazine

然後,管理員可使用WKND-General配置建立常規頁面模板,然後使用WKND-Magazine下該雜誌的特定模板。

然後,管理員可將WKND-General與WKND網站的所有內容相關聯。 但WKND-Magazine配置只與雜誌網站相關聯。

執行此動作:

  • 當內容作者為雜誌建立新頁面時,作者可從一般範本(WKND-General)或雜誌範本(WKND-Magazine)中選擇。
  • 當內容作者為網站的其他部分(而非雜誌)建立新頁面時,作者只能從一般範本(WKND-General)中選擇。

不僅可編輯的範本,雲端設定、ContextHub區段和內容片段模型也可進行類似的設定。

使用配置瀏覽器

組態瀏覽器可讓管理員輕鬆建立、管理和設定AEM中組態的存取權限。

注意

只有當您的使用者擁有admin權限時,才能使用「設定瀏覽器」建立設定。 admin 為了指派存取權給設定或以其他方式修改設定,也需要權限。

建立配置

使用「設定瀏覽器」在AEM中建立新設定非常簡單。

  1. 以Cloud Service身分登入AEM,並從主功能表選取​Tools -> General -> Configuration Browser

  2. 點選或按一下​建立

  3. 為您的設定提供​Title​和​Name

    建立設定

    • Title​應是描述性的。
    • Name​將成為儲存庫中的節點名稱。
  4. 檢查您要允許的配置類型。

  5. 點選或按一下​建立

秘訣

配置可以嵌套。

編輯配置及其訪問權限

如果您將設定視為工作區,則可在這些設定上設定存取權限,以強制哪些人可以和哪些人不可以存取這些工作區。

  1. 以Cloud Service身分登入AEM,並從主功能表選取​Tools -> General -> Configuration Browser

  2. 選取您要修改的設定,然後點選或按一下工具列中的​屬性

  3. 選擇要添加到配置的任何其他功能

    注意

    建立配置後,無法取消選取特徵。

  4. 使用​有效權限​按鈕可查看角色的矩陣以及它們當前授予配置的哪些權限。
    有效權限窗口

  5. 若要指派新權限,請在​新增權限​區段的​選取使用者或群組​欄位中輸入使用者或群組名稱。

    • 選擇用戶或組​欄位提供基於現有用戶和角色的自動完成。
  6. 從自動完成結果中選擇適當的用戶或角色。

    • 您可以選取多個使用者或角色。
  7. 檢查所選用戶或角色應具有的訪問選項,然後按一下​Add
    將存取權限新增至設定

  8. 重複這些步驟以選取使用者或角色,並視需要指派其他存取權限。

  9. 完成後,點選或按一下「儲存並關閉」。

以開發人員身分進行的設定

身為開發人員,請務必了解AEM as aCloud Service如何搭配設定運作,以及處理設定解析的方式。

分離配置和內容

雖然管理員和用戶可能將配置視為工作場所來管理不同的設定和內容,但務必了解配置和內容由儲存庫中的AEM單獨儲存和管理。

  • /content 是所有內容的首頁。
  • /conf 是所有設定的首頁。

內容透過cq:conf屬性參考其相關聯的設定。 AEM會根據內容執行查詢,其內容cq:conf屬性可尋找適當的設定。

範例

在此範例中,假設您有一些對DAM設定感興趣的應用程式程式碼。

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

所有設定查閱的起始點都是內容資源,通常位於/content下。 這可以是頁面、頁面內的元件、資產或DAM資料夾。 這是我們要尋找的實際內容,以尋找適用於此情境的正確設定。

現在,在Conf物件的手上,我們可以擷取我們感興趣的特定設定項目。 在此案例中為dam/imageserver,此為與imageserver相關的設定集合。 getItem呼叫傳回ValueMap。 接著,我們會讀取bgkcolor字串屬性,並提供「FFFFFF」的預設值,以備屬性(或整個設定項目)不存在時使用。

現在,讓我們查看對應的JCR內容:

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wkns
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

在此範例中,我們假設有WKND專屬的DAM資料夾和對應的設定。 從該資料夾/content/dam/wknd開始,我們會看到名為cq:conf的字串屬性會參考應套用至子樹狀結構的設定。 屬性通常會設定在資產資料夾或頁面的jcr:content上。 這些conf連結是明確的,因此只要查看CRXDE中的內容,就可輕鬆追蹤。

/conf內跳轉時,我們會遵循參考,看到有一個/conf/wknd節點。 這是設定。 請注意,其查閱對應用程式程式碼完全透明。 范常式式碼從未有專用的參考,而是隱藏在Conf物件後面。 系統會透過JCR內容完全控制套用的設定。

我們看到配置包含一個名為固定的settings節點,該節點包含實際項,包括我們在本例中需要的dam/imageserver。 此類項目可視為「設定文檔」,通常由cq:Page表示,該jcr:content包含實際內容。

最後,我們看到范常式式碼所需的屬性bgkcolor。 我們從getItem返回的ValueMap是以頁面的jcr:content節點為基礎。

配置解析度

上述基本範例顯示單一設定。 但在許多情況下,您會想要有不同的設定,例如預設全域設定、每個品牌的不同設定,以及子專案的特定設定。

若要支援此功能,AEM中的設定查閱會依下列偏好順序提供繼承和備援機制:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • /content中某處的cq:conf引用的特定配置
    • 階層是任意的,而且可像您的網站結構一樣設計,因此了解這一點並非應用程式程式碼的事務
    • 具有配置權限的用戶在運行時可更改
  2. /conf/<siteconfig>/<parentconfig>
    • 遍歷備援配置的父級
    • 具有配置權限的用戶在運行時可更改
  3. /conf/<siteconfig>
    • 遍歷備援配置的父級
    • 具有配置權限的用戶在運行時可更改
  4. /conf/global
    • 系統全局設定
    • 通常是安裝的全局預設值
    • admin角色設定
    • 具有配置權限的用戶在運行時可更改
  5. /apps
    • 應用程式預設值
    • 透過應用程式部署修正
    • 運行時只讀
  6. /libs
    • AEM產品預設值
    • 僅可按Adobe更改,不允許項目訪問
    • 透過應用程式部署修正
    • 運行時只讀

使用配置

AEM中的設定是以Sling內容感知設定為基礎。 Sling套件組合提供服務API,可用來取得內容感知設定。 上下文感知配置是與內容資源或資源樹相關的配置,如上例中所述

如需內容感知設定、範例及其使用方式的詳細資訊,請參閱Sling檔案。

ConfMgr Web控制台

為了進行偵錯和測試,在https://<host>:<port>/system/console/conf處有一個​ConfMgr Web控制台,可顯示指定路徑/項的配置。

ConfMgr

只需提供:

  • 內容路徑
  • 項目
  • 使用者

按一下​解析​以查看已解析哪些配置並接收將解析這些配置的示例代碼。

上下文感知配置Web控制台

為了偵錯和測試之用,https://<host>:<port>/system/console/slingcaconfig提供​上下文感知設定 Web主控台,可在存放庫中查詢上下文感知設定並檢視其屬性。

內容感知配置Web控制台

只需提供:

  • 內容路徑
  • 設定名稱

按一下​解析​以檢索選定配置的關聯上下文路徑和屬性。

本頁內容