設定 ContextHub configuring-contexthub
ContextHub是一種用於儲存、操控和呈現內容資料的架構。 如需ContextHub的詳細資訊,請參閱ContextHub開發人員概觀。
您可以設定ContextHub工具列來控制它是否出現在預覽模式中、建立ContextHub存放區以及新增UI模組。
顯示和隱藏ContextHub UI showing-and-hiding-the-contexthub-ui
設定AdobeGranite ContextHub OSGi服務,以在您的頁面上顯示或隱藏ContextHub UI。 此服務的PID為com.adobe.granite.contexthub.impl.ContextHubImpl.
若要設定服務,您可以使用網頁主控台或使用存放庫中的JCR節點:
- 網頁主控台: 若要顯示UI,請選取[顯示UI]屬性。 若要隱藏UI,請清除「隱藏UI」屬性。
- JCR節點: 若要顯示UI,請將布林值
com.adobe.granite.contexthub.show_ui
屬性設定為true
。 若要隱藏UI,請將屬性設定為false
。
顯示ContextHub UI時,它只會顯示在AEM作者執行個體的頁面上。 UI未出現在發佈執行個體的頁面上。
新增ContextHub UI模式和模組 adding-contexthub-ui-modes-and-modules
在「預覽」模式下設定ContextHub工具列中出現的UI模式和模組:
- UI模式:相關模組群組
- 模組:從存放區公開內容資料並允許作者操控內容的Widget
UI模式會在工具列左側顯示為一系列圖示。 選取後,UI模式的模組會顯示在右側。
圖示是來自Coral UI圖示庫的參考。
新增UI模式 adding-a-ui-mode
新增UI模式至群組相關的ContextHub模組。 建立UI模式時,您會提供顯示在ContextHub工具列中的標題和圖示。
-
在Experience Manager邊欄中,選取「工具>網站>內容中心」。
-
選取預設的「組態容器」。
-
選取Context Hub組態。
-
選取「建立」按鈕,然後選取「Context Hub UI模式」。
-
提供下列屬性的值:
- UI模式標題:識別UI模式的標題
- 模式圖示:要使用的Coral UI圖示的選擇器,例如
coral-Icon--user
- 啟用:選取此選項可在ContextHub工具列中顯示UI模式
-
選取「儲存」。
新增使用者介面模組 adding-a-ui-module
將ContextHub UI模組新增至UI模式,使其顯示在ContextHub工具列中以預覽頁面內容。 新增UI模組時,您會建立已向ContextHub註冊的模組型別例項。 若要新增UI模組,您必須知道關聯模組型別的名稱。
AEM提供基礎UI模組型別以及數個範例UI模組型別,您可以依據這些型別建立UI模組。 下表提供每個專案的簡短說明。 如需有關開發自訂UI模組的資訊,請參閱建立ContextHub UI模組。
UI模組屬性包含詳細設定,您可以在其中提供模組特定屬性的值。 您可以提供JSON格式的詳細資料設定。 表格中的模組型別欄提供每個UI模組型別所需JSON程式碼相關資訊的連結。
authorizableID
、displayName
和familyName
。 您可以變更displayName
和familyName
的值。profile
-
在Experience Manager邊欄中,選取「工具>網站> ContextHub」。
-
選取要新增UI模組的設定容器。
-
選取或輸入您要新增UI模組的ContextHub組態。
-
選取要新增UI模組的UI模式。
-
選取「建立」按鈕,然後選取「ContextHub UI模組(一般)」。
-
提供下列屬性的值:
- UI模組標題:識別UI模組的標題
- 模組型別:模組型別
- 啟用:選取以在ContextHub工具列中顯示UI模組
-
(選用)若要覆寫預設存放區設定,請輸入JSON物件以設定UI模組。
-
選取「儲存」。
建立ContextHub存放區 creating-a-contexthub-store
建立Context Hub存放區以儲存使用者資料,並視需要存取資料。 ContextHub存放區是以已註冊的存放區候選專案為基礎。 當您建立存放區時,您需要存放區候選專案註冊所在的storeType值。 (請參閱建立自訂商店候選者。)
詳細存放區設定 detailed-store-configuration
當您設定存放區時,Detail Configuration屬性可讓您提供存放區特定屬性的值。 此值是以存放區init
函式的config
引數為基礎。 因此,您是否需提供此值,以及值的格式取決於存放區。
Detail Configuration屬性的值是JSON格式的config
物件。
範例商店候選者 sample-store-candidates
AEM提供下列範例商店候選者,您可以據以建立商店。
-
在Experience Manager邊欄中,選取「工具>網站> ContextHub」。
-
選取預設設定容器。
-
選取Contexthub設定
-
若要新增存放區,請選取「建立」圖示,然後選取「ContextHub存放區設定」。
-
提供基本組態屬性的值,然後選取[下一步]:
- 設定標題: 識別存放區的標題
- 存放區型別: 存放區基礎之存放區候選專案的storeType屬性值
- 必要: 選取
- 已啟用: 選取以啟用存放區
-
(選用)若要覆寫預設存放區設定,請在「詳細資料設定(JSON)」方塊中輸入JSON物件。
-
選取「儲存」。
範例:使用JSONP服務 example-using-a-jsonp-service
此範例說明如何設定存放區並在UI模組中顯示資料。 在此範例中,jsontest.com網站的MD5服務會作為存放區的資料來源。 此服務會傳回指定字串的MD5雜湊代碼,格式為JSON。
contexthub.generic-jsonp存放區已設定為儲存服務呼叫https://md5.jsontest.com/?text=%22text%20to%20md5%22
的資料。 此服務會傳回以下資料,這些資料會顯示在UI模組中:
{
"md5": "919a56ab62b6d5e1219fe1d95248a2c5",
"original": "\"text to md5\""
}
建立contexthub.generic-jsonp存放區 creating-a-contexthub-generic-jsonp-store
contexthub.generic-jsonp範例存放區候選專案可讓您從JSONP服務或傳回JSON資料的Web服務擷取資料。 對於此存放區候選專案,請使用存放區設定來提供有關要使用的JSONP服務的詳細資訊。
ContextHub.Store.JSONPStore
JavaScript類別的init函式定義初始化此存放區候選專案的config
物件。 config
物件包含service
物件,其中包含有關JSONP服務的詳細資料。 若要設定存放區,請以JSON格式提供service
物件,作為Detail Configuration屬性的值。
若要從jsontest.com網站的MD5服務儲存資料,請使用使用下列屬性建立ContextHub存放區中的程式:
-
設定標題: md5
-
存放區型別: contexthub.generic-jsonp
-
必要: 選取
-
已啟用: 選取
-
詳細設定(JSON):
code language-javascript { "service": { "jsonp": false, "timeout": 1000, "ttl": 1800000, "secure": false, "host": "md5.jsontest.com", "port": 80, "params":{ "text":"text to md5" } } }
新增md5資料的UI模組 adding-a-ui-module-for-the-md-data
將UI模組新增至ContextHub工具列,以顯示儲存在範例md5存放區中的資料。 在此範例中,contexthub.base模組用於產生下列UI模組:
使用新增UI模組中的程式,將UI模組新增至現有的UI模式,例如範例Persona UI模式。 對於UI模組,請使用以下屬性值:
-
UI模組標題: MD5
-
模組型別: contexthub.base
-
詳細設定(JSON):
code language-javascript { "icon": "coral-Icon--data", "title": "MD5 Conversion", "storeMapping": { "md5": "md5" }, "template": "<p> {{md5.original}}</p>; <p>{{md5.md5}}</p>" }
偵錯ContextHub debugging-contexthub
可以啟用ContextHub的偵錯模式,以進行疑難排解。 偵錯模式可以透過ContextHub設定或透過CRXDE啟用。
透過設定 via-the-configuration
編輯ContextHub的組態並核取選項 偵錯
- 在邊欄中,選取 工具> Sites > ContextHub
- 選取預設 設定容器
- 選取 ContextHub組態 並選取 編輯選取的專案
- 選取 偵錯 並選取 儲存
透過CRXDE via-crxde
使用CRXDE Lite將屬性debug
設定為 true,位於:
/conf/global/settings/cloudsettings
或/conf/<site>/settings/cloudsettings
記錄ContextHub的偵錯訊息 logging-debug-messages-for-contexthub
設定AdobeGranite ContextHub OSGi服務(PID = com.adobe.granite.contexthub.impl.ContextHubImpl
)以記錄開發時有用的詳細偵錯訊息。
若要設定服務,您可以使用網頁主控台或使用存放庫中的JCR節點:
- Web主控台:若要記錄「除錯」訊息,請選取「除錯」屬性。
- JCR節點:若要記錄偵錯訊息,請將布林值
com.adobe.granite.contexthub.debug
屬性設定為true
。
無訊息模式 silent-mode
無訊息模式會隱藏所有偵錯資訊。 與一般偵錯選項不同(可針對每個ContextHub組態個別設定),無訊息模式是全域設定,其優先於ContextHub組態層級上的任何偵錯設定。
這對於您根本不想要任何偵錯資訊的發佈執行個體非常有用。 由於這是全域設定,因此會透過OSGi啟用。
- 在
http://<host>:<port>/system/console/configMgr
開啟 Adobe Experience Manager Web主控台組態 - 搜尋 AdobeGranite ContextHub
- 按一下組態 AdobeGranite ContextHub 以編輯其屬性
- 核取選項 無訊息模式 並按一下 儲存
正在停用ContextHub disabling-contexthub
可以停用ContextHub以防止其載入js/css和初始化。 有兩個選項可停用ContextHub:
-
編輯ContextHub的組態並核取選項 停用ContextHub
- 在邊欄中,選取 工具> Sites > ContextHub
- 選取預設 設定容器
- 選取 ContextHub組態 並選取 編輯選取的專案
- 選取 停用ContextHub 並選取 儲存
或
- 使用CRXDE Lite將屬性
disabled
設定為/conf/global/settings/cloudsettings/<configName>/contexthub
下的 true