配置旨在提供用於儲存服務配置的邏輯和結構。
您可以擴充現有例項,以建立您自己的設定。
在開發配置時使用的原則基於以下概念:
配置的基本路徑是:
/etc/cloudservices
。
對於每種類型的配置,將提供模板和元件。這樣,配置模板就可以滿足自定義後的大多數需求。
要為新服務提供配置,您需要:
在中建立服務頁面
/etc/cloudservices
下方:
範本和元件必須繼承 sling:resourceSuperType
從基礎模板:
cq/cloudserviceconfigs/templates/configpage
或基元
cq/cloudserviceconfigs/components/configpage
服務提供商還應提供服務頁:
/etc/cloudservices/<service-name>
您的範本將擴充基礎範本:
cq/cloudserviceconfigs/templates/configpage
並定義 resourceType
指向自訂元件。
/libs/cq/analytics/templates/sitecatalyst
sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage
allowedChildren = /libs/cq/analytics/templates/sitecatalyst
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
componentReference = cq/analytics/components/sitecatalyst
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/sitecatalystpage
/libs/cq/analytics/templates/generictracker
sling:resourceSuperType = cq/cloudservices/templates/configpage
allowedChildren = /libs/cq/analytics/templates/generictracker
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/generictrackerpage
元件應擴充基礎元件:
cq/cloudserviceconfigs/templates/configpage
/libs/cq/analytics/components/sitecatalystpage
/libs/cq/analytics/components/generictrackerpage
設定範本和元件後,您可以在下方新增子頁面,以新增設定:
/etc/cloudservices/<service-name>
內容模型儲存為 cq:Page
在下:
/etc/cloudservices/<service-name>(/*)
/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config
配置儲存在子節點下 jcr:content
.
jcr:node
直接。parsys
或 iparsys
)使用子節點來儲存元件資料。/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*
如需API的參考檔案,請參閱 com.day.cq.wcm.webservicesupport.
可用服務列於 Cloud Services 的 頁面屬性 對話框(從繼承的任何頁) foundation/components/page
或 wcm/mobile/components/page
)。
索引標籤也提供:
儲存服務的使用者憑證時,應加密所有密碼。
您可以新增隱藏的表單欄位來達到此目的。 此欄位應具有註解 @Encrypted
在屬性名稱中;即為 password
欄位名稱將寫入為:
password@Encrypted
然後會自動加密屬性(使用 CryptoSupport
服務) EncryptionPostProcessor
.
這類似於標準 [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
註解。
依預設, EcryptionPostProcessor
僅加密 POST
向 /etc/cloudservices
.
屬性 | 說明 |
componentReference | 要自動包含在頁面中的元件的參考路徑。 這可用於其他功能和JS包含。 這包括頁面上的元件,其中 cq/cloudserviceconfigs/components/servicecomponents 包含在內(通常是在 body 標籤)。在Analytics和Target中,我們會使用此功能來包含其他功能,例如追蹤訪客行為的JavaScript呼叫。 |
說明 | 服務的簡短說明。 |
descriptionExtended | 服務的延伸說明。 |
排名 | 用於清單的服務排名。 |
selectableChildren | 在頁面屬性對話方塊中顯示設定的篩選。 |
serviceUrl | 網站服務URL。 |
serviceUrlLabel | 服務URL的標籤。 |
thumbnailPath | 服務的縮圖路徑。 |
可見 | 頁面屬性對話方塊中的可見性;預設顯示(可選) |
預設會提供下列服務:
另請參閱 建立自訂Cloud Service.