Experience League

雲端服務設定

設定旨在提供儲存服務設定的邏輯和結構。

您可以擴充現有執行個體來建立自己的設定。

概念

開發設定時採用的原則以以下概念為基礎：

服務/配接器用於擷取組態。
設定（例如屬性/段落）繼承自父項。
依路徑從Analytics節點參照。
易於擴充。
具備彈性以因應更複雜的設定，例如 Adobe Analytics.
支援相依性(例如 Adobe Analytics 外掛程式需要 Adobe Analytics configuration)。

結構

設定的基本路徑為：

/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

如需有關API的參考檔案，請參閱 com.day.cq.wcm.webservicesupport.

AEM整合

可用的服務列於 Cloud Services 的標籤 頁面屬性 對話方塊（任何繼承自的頁面） foundation/components/page 或 wcm/mobile/components/page)。

索引標籤也提供：

您可以啟用服務之位置的連結
從路徑欄位選擇設定（服務的子節點）

密碼加密

儲存服務的使用者認證時，所有密碼都應加密。

您可以新增隱藏的表單欄位來達成此目的。此欄位應該有註解 @Encrypted 在屬性名稱中；亦即 password 欄位名稱將寫成：

password@Encrypted

然後，該屬性將自動加密(使用 CryptoSupport service)，由 EncryptionPostProcessor.

注意

這類似標準 [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html) 註解。

注意

根據預設 EcryptionPostProcessor 僅加密 POST 向提出要求 /etc/cloudservices.

服務頁面的其他屬性jcr：content節點

屬性	說明
componentreference	要自動包含在頁面中的元件的參照路徑。這會用於其他功能和JS包含。這包括頁面上的元件，其中 `cq/cloudserviceconfigs/components/servicecomponents` 包含(通常早於 `body` 標籤)。若是Analytics和Target，我們會使用這個包含其他功能，例如追蹤訪客行為的JavaScript呼叫。
說明	服務的簡短說明。
descriptionExtended	服務的延伸說明。
排名	用於清單中的服務排名。
selectableChildren	用於在頁面屬性對話方塊中顯示設定的篩選器。
serviceUrl	服務網站的URL。
serviceUrlLabel	服務URL標籤。
thumbnailPath	服務的縮圖路徑。
可見	頁面屬性對話方塊中的可見性；預設為可見（選擇性）