文件AEM as a Cloud Service使用手冊

設定 ContextHub configuring-contexthub

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 開發人員

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
顯示目前使用者的設定檔資訊，包括authorizableID、displayName和familyName。 您可以變更displayName和familyName的值。
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