設定 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模式的模組會顯示在右側。

ContextHub工具列

圖示是來自Coral UI圖示庫的參考。

新增UI模式 adding-a-ui-mode

新增UI模式至群組相關的ContextHub模組。 建立UI模式時,您會提供顯示在ContextHub工具列中的標題和圖示。

  1. 在Experience Manager邊欄中,選取「工具>網站>內容中心」。

  2. 選取預設的「組態容器」。

  3. 選取Context Hub組態。

  4. 選取「建立」按鈕,然後選取「Context Hub UI模式」。

    新增UI模式

  5. 提供下列屬性的值:

    • UI模式標題:識別UI模式的標題
    • 模式圖示:要使用的Coral UI圖示的選擇器,例如coral-Icon--user
    • 啟用:選取此選項可在ContextHub工具列中顯示UI模式
  6. 選取「儲存」。

新增使用者介面模組 adding-a-ui-module

將ContextHub UI模組新增至UI模式,使其顯示在ContextHub工具列中以預覽頁面內容。 新增UI模組時,您會建立已向ContextHub註冊的模組型別例項。 若要新增UI模組,您必須知道關聯模組型別的名稱。

AEM提供基礎UI模組型別以及數個範例UI模組型別,您可以依據這些型別建立UI模組。 下表提供每個專案的簡短說明。 如需有關開發自訂UI模組的資訊,請參閱建立ContextHub UI模組

UI模組屬性包含詳細設定,您可以在其中提供模組特定屬性的值。 您可以提供JSON格式的詳細資料設定。 表格中的模組型別欄提供每個UI模組型別所需JSON程式碼相關資訊的連結。

模組型別
說明
存放
contexthub.base
通用UI模組型別
在UI模組屬性中設定
contexthub.browserinfo
顯示瀏覽器的相關資訊
surferinfo
contexthub.datetime
顯示日期和時間資訊
datetime
contexthub.location
顯示使用者端的經緯度,以及地圖上的位置。 可讓您變更位置。
geolocation
contexthub.screen-orientation
顯示裝置的熒幕方向(橫向或縱向)
emulators
contexthub.tagcloud
顯示頁面標籤的相關統計資料
tagcloud
granite.profile
顯示目前使用者的設定檔資訊,包括authorizableIDdisplayNamefamilyName。 您可以變更displayNamefamilyName的值。
profile
  1. 在Experience Manager邊欄中,選取「工具>網站> ContextHub」。

  2. 選取要新增UI模組的設定容器。

  3. 選取或輸入您要新增UI模組的ContextHub組態。

  4. 選取要新增UI模組的UI模式。

  5. 選取「建立」按鈕,然後選取「ContextHub UI模組(一般)」。

    ContextHub UI模組

  6. 提供下列屬性的值:

    • UI模組標題:識別UI模組的標題
    • 模組型別:模組型別
    • 啟用:選取以在ContextHub工具列中顯示UI模組
  7. (選用)若要覆寫預設存放區設定,請輸入JSON物件以設定UI模組。

  8. 選取「儲存」。

建立ContextHub存放區 creating-a-contexthub-store

建立Context Hub存放區以儲存使用者資料,並視需要存取資料。 ContextHub存放區是以已註冊的存放區候選專案為基礎。 當您建立存放區時,您需要存放區候選專案註冊所在的storeType值。 (請參閱建立自訂商店候選者。)

詳細存放區設定 detailed-store-configuration

當您設定存放區時,Detail Configuration屬性可讓您提供存放區特定屬性的值。 此值是以存放區init函式的config引數為基礎。 因此,您是否需提供此值,以及值的格式取決於存放區。

Detail Configuration屬性的值是JSON格式的config物件。

範例商店候選者 sample-store-candidates

AEM提供下列範例商店候選者,您可以據以建立商店。

存放區型別
說明
aem.segmentation
儲存已解析和未解析的ContextHub區段。 自動從ContextHub SegmentManager擷取區段
contexthub.geolocation
儲存瀏覽器位置的經緯度。
granite.emulators
定義數個裝置的屬性和功能,並偵測目前的使用者端裝置
granite.profile
儲存目前使用者的設定檔資料
contexthub.surferinfo
儲存使用者端的相關資訊,例如裝置資訊、瀏覽器型別和視窗方向
  1. 在Experience Manager邊欄中,選取「工具>網站> ContextHub」。

  2. 選取預設設定容器。

  3. 選取Contexthub設定

  4. 若要新增存放區,請選取「建立」圖示,然後選取「ContextHub存放區設定」。

    ContextHub存放區組態

  5. 提供基本組態屬性的值,然後選取[下一步]:

    • 設定標題: ​識別存放區的標題
    • 存放區型別: ​存放區基礎之存放區候選專案的storeType屬性值
    • 必要: ​選取
    • 已啟用: ​選取以啟用存放區
  6. (選用)若要覆寫預設存放區設定,請在「詳細資料設定(JSON)」方塊中輸入JSON物件。

  7. 選取「儲存」。

範例:使用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模組:

ContextHub MD5存放區

使用新增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的組態並核取選項​ 偵錯

  1. 在邊欄中,選取​ 工具> Sites > ContextHub
  2. 選取預設​ 設定容器
  3. 選取​ ContextHub組態 ​並選取​ 編輯選取的專案
  4. 選取​ 偵錯 ​並選取​ 儲存

透過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啟用。

  1. http://<host>:<port>/system/console/configMgr開啟​ Adobe Experience Manager Web主控台組態
  2. 搜尋​ AdobeGranite ContextHub
  3. 按一下組態​ AdobeGranite ContextHub ​以編輯其屬性
  4. 核取選項​ 無訊息模式 ​並按一下​ 儲存

正在停用ContextHub disabling-contexthub

可以停用ContextHub以防止其載入js/css和初始化。 有兩個選項可停用ContextHub:

  • 編輯ContextHub的組態並核取選項​ 停用ContextHub

    1. 在邊欄中,選取​ 工具> Sites > ContextHub
    2. 選取預設​ 設定容器
    3. 選取​ ContextHub組態 ​並選取​ 編輯選取的專案
    4. 選取​ 停用ContextHub ​並選取​ 儲存

  • 使用CRXDE Lite將屬性disabled設定為/conf/global/settings/cloudsettings/<configName>/contexthub下的​ true
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab