文件AEM 6.5使用手冊

設定 ContextHub configuring-contexthub

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

ContextHub是一種用於儲存、操控和呈現內容資料的架構。 如需ContextHub的詳細資訊，請參閱開發人員檔案。 ContextHub取代觸控式UI中的使用者端內容。

設定ContextHub工具列，以控制其是否出現在預覽模式、建立ContextHub存放區，以及使用觸控最佳化UI新增UI模組。

正在停用ContextHub disabling-contexthub

預設會在AEM安裝中啟用ContextHub。 可以停用ContextHub以防止其載入js/css和初始化。

  • 使用CRXDE Lite將屬性disabled設定為/libs/settings/cloudsettings/legacy/contexthub下的​ true
NOTE
由於AEM 6.4中的存放庫重組， ContextHub設定的位置已從/etc/cloudsettings變更為：
  • /libs/settings/cloudsettings
  • /conf/global/settings/cloudsettings
  • /conf/<tenant>/settings/cloudsettings

顯示和隱藏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模式的模組會顯示在右側。

chlimage_1-319

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

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

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

  1. 在Experience Manager邊欄中，按一下「工具>網站>內容中心」 。

  2. 按一下預設的「組態容器」。

  3. 按一下Context Hub組態。

  4. 按一下「建立」按鈕，然後按一下「Context Hub UI模式」。

    chlimage_1-320

  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
顯示日期和時間資訊
日期時間
contexthub.device
顯示使用者端裝置
模擬器
contexthub.location
顯示使用者端的經緯度，以及地圖上的位置。 可讓您變更位置。
地理位置
contexthub.screen-orientation
顯示裝置的熒幕方向（橫向或縱向）
模擬器
contexthub.tagcloud
顯示頁面標籤的相關統計資料
tagcloud
granite.profile
顯示目前使用者的設定檔資訊，包括authorizableID、displayName和familyName。 您可以變更displayName和familyName的值。
側面像

  1. 在Experience Manager邊欄中，按一下「工具>網站> ContextHub」 。

  2. 按一下要新增UI模組的設定容器。

  3. 按一下或輸入您要新增UI模組的ContextHub組態。

  4. 按一下要新增UI模組的UI模式。

  5. 按一下「建立」按鈕，然後按一下「ContextHub UI模組（一般）」。

    chlimage_1-321

  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擷取區段
aem.resolvedsegments
儲存目前解析的區段。 偵聽ContextHub SegmentManager服務以自動更新存放區
contexthub.geolocation
儲存瀏覽器位置的經緯度。
contexthub.datetime
儲存瀏覽器位置的目前日期、時間和季節
granite.emulators
定義數個裝置的屬性和功能，並偵測目前的使用者端裝置
contexthub.generic-jsonp
從JSONP服務擷取並儲存資料
granite.profile
儲存目前使用者的設定檔資料
contexthub.surferinfo
儲存使用者端的相關資訊，例如裝置資訊、瀏覽器型別和視窗方向
contexthub.tagcloud
儲存頁面標籤和標籤計數

  1. 在Experience Manager邊欄中，按一下「工具>網站> ContextHub」 。

  2. 按一下預設設定容器。

  3. 按一下Contexthub設定

  4. 若要新增存放區，請按一下「建立」圖示，然後按一下ContexHub存放區設定。

    chlimage_1-322

  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-xml 
    {
 "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模組：

chlimage_1-323

使用新增UI模組中的程式，將UI模組新增至現有的UI模式，例如範例Perona UI模式。 對於UI模組，請使用以下屬性值：

  • UI模組標題： MD5

  • 模組型別： contexthub.base

  • 詳細設定(JSON)：

    code language-xml 
    {
 "icon": "coral-Icon--data",
 "title": "MD5 Converstion",
 "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/<tenant>/settings/cloudsettings
NOTE
對於ContextHub設定仍位於其舊版路徑下的情況，設定debug property的位置為/libs/settings/cloudsettings/legacy/contexthub。

無訊息模式 silent-mode

無訊息模式會隱藏所有偵錯資訊。 與一般偵錯選項不同（可針對每個ContextHub組態個別設定），無訊息模式是全域設定，其優先於ContextHub組態層級上的任何偵錯設定。

這對於您根本不想要任何偵錯資訊的發佈執行個體非常有用。 由於這是全域設定，因此會透過OSGi啟用。

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

升級後復原ContextHub設定 recovering-contexthub-configurations-after-upgrading

執行升級至AEM時，會將ContextHub設定備份並儲存在安全位置。 在升級期間，會安裝預設ContextHub組態，取代現有組態。 您必須進行備份，才能保留所做的任何變更或新增。

ContextHub設定儲存在下列節點下名為contexthub的資料夾中：

  • /conf/global/settings/cloudsettings
  • /conf/<tenant>/settings/cloudsettings

升級之後，備份會儲存在名為contexthub的資料夾中，位於名為的節點下方：

/conf/global/settings/cloudsettings/default-pre-upgrade_yyyymmdd_xxxxxxx或
/conf/<tenant>/settings/cloudsettings/default-pre-upgrade_yyyymmdd_xxxxxxx

節點名稱的yyyymmdd部分是執行升級的日期。

若要復原您的ContextHub設定，請使用CRXDE Lite將代表您存放區、UI模式和UI模組的節點從default-pre-upgrade_yyyymmdd_xxxxxx節點複製到以下位置：

  • /conf/global/settings/cloudsettings或
  • /conf/<tenant>/settings/cloudsettings
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2