DocumentationAEM as a Cloud ServiceUser Guide

Configuring ContextHub configuring-contexthub

Last update: Mon Dec 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

ContextHub is a framework for storing, manipulating, and presenting context data. For more detail on ContextHub, see ContextHub developer overview.

You can configure the ContextHub toolbar to control whether it appears in Preview mode, to create ContextHub stores, and add UI modules.

Showing and Hiding the ContextHub UI showing-and-hiding-the-contexthub-ui

Configure the Adobe Granite ContextHub OSGi service to show or hide the ContextHub UI on your pages. The PID of this service is com.adobe.granite.contexthub.impl.ContextHubImpl.

To configure the service you can either use the Web Console or use a JCR node in the repository:

  • Web Console: To show the UI, select the Show UI property. To hide the UI, clear the Hide UI property.
  • JCR node: To show the UI, set the boolean com.adobe.granite.contexthub.show_ui property to true. To hide the UI, set the property to false.

When showing the ContextHub UI, it only appears on pages on AEM author instances. The UI does not appear on pages of publish instances.

Adding ContextHub UI Modes and Modules adding-contexthub-ui-modes-and-modules

Configure the UI modes and modules that appear in the ContextHub toolbar in Preview mode:

  • UI Modes: Groups of related modules
  • Modules: Widgets that expose context data from a store and enable authors to manipulate the context

UI modes appear as a series of icons on the left side of the toolbar. When selected, the modules of a UI mode appear to the right.

ContextHub toolbar

Icons are references from the Coral UI icon library.

Adding a UI Mode adding-a-ui-mode

Add a UI mode to group related ContextHub modules. When you create the UI mode, you provide the title and icon that appear in the ContextHub toolbar.

  1. On the Experience Manager rail, select Tools > Sites > Context Hub.

  2. Select the default Configuration Container.

  3. Select the Context Hub Configuration.

  4. Select the Create button, and then select Context Hub UI Mode.

    Add UI mode

  5. Provide values for the following properties:

    • UI Mode Title: The title that identifies the UI mode
    • Mode Icon: The selector for the Coral UI icon to use, for example, coral-Icon--user
    • Enabled: Select to show the UI mode in the ContextHub toolbar

  6. Select Save.

Adding a UI Module adding-a-ui-module

Add a ContextHub UI module to a UI mode so that it appears in the ContextHub toolbar for previewing page content. When you add a UI module, you are creating an instance of a module type that is registered with ContextHub. To add a UI module, you must know the name of the associated module type.

AEM provides a base UI module type as well several sample UI Module types upon which you can base a UI module. The following table provides a brief description of each one. For information about developing a custom UI module, see Creating ContextHub UI Modules.

The UI module properties include a detail configuration where you can provide values for module-specific properties. You provide the detail configuration in JSON format. The Module Type column in the table provides links to information about the JSON code required for each UI module type.

Module Type
Description
Store
contexthub.base
A generic UI module type
Configured in the UI module properties
contexthub.browserinfo
Displays information about the browser
surferinfo
contexthub.datetime
Displays date and time information
datetime
contexthub.location
Displays the latitude and longitude of the client, and the location on a map. Enables you to change the location.
geolocation
contexthub.screen-orientation
Displays the screen orientation of the device (landscape or portrait)
emulators
contexthub.tagcloud
Displays statistics about page tags
tagcloud
granite.profile
Displays the profile information for the current user, including authorizableID, displayName and familyName. You can change the value of displayName and familyName.
profile

  1. On the Experience Manager rail, select Tools > Sites > ContextHub.

  2. Select the Configuration Container to which you want to add a UI module.

  3. Select or type the ContextHub Configuration to which you want to add the UI module.

  4. Select the UI mode to which you are adding the UI module.

  5. Select the Create button, then select ContextHub UI Module (generic).

    ContextHub UI module

  6. Provide values for the following properties:

    • UI Module Title: A title that identifies the UI module
    • Module Type: The module type
    • Enabled: Select to show the UI module in the ContextHub toolbar

  7. (Optional) To override the default store configuration, enter a JSON object to configure the UI Module.

  8. Select Save.

Creating a ContextHub Store creating-a-contexthub-store

Create a Context Hub store to persist user data and access the data as needed. ContextHub stores are based on registered store candidates. When you create the store, you need the value of the storeType with which the store candidate was registered. (See Creating Custom Store Candidates.)

Detailed Store Configuration detailed-store-configuration

When you configure a store, the Detail Configuration property enables you to provide values for store-specific properties. The value is based on the config parameter of the store’s init function. Therefore, whether you need to provide this value, and the format of the value, depends on the store.

The value of the Detail Configuration property is a config object in JSON format.

Sample Store Candidates sample-store-candidates

AEM provides the following sample store candidates upon which you can base a store.

Store Type
Description
aem.segmentation
Store for resolved and unresolved ContextHub segments. Automatically retrieves segments from the ContextHub SegmentManager
contexthub.geolocation
Stores the latitude and longitude of the browser location.
granite.emulators
Defines properties and capabilities for several devices, and detects the current client device
granite.profile
Stores profile data for the current user
contexthub.surferinfo
Stores information about the client, such as device information, browser type, and window orientation

  1. On the Experience Manager rail, select Tools > Sites > ContextHub.

  2. Select the default configuration container.

  3. Select Contexthub Configuration

  4. To add a store, select the Create icon and then select ContextHub Store Configuration.

    ContextHub store configuration

  5. Provide values for the basic configuration properties and then select Next:

    • Configuration Title: The title that identifies the store
    • Store Type: The value of the storeType property of the store candidate upon which to base the store
    • Required: Select
    • Enabled: Select to enable the store

  6. (Optional) To override the default store configuration, enter a JSON object in the Detail Configuration (JSON) box.

  7. Select Save.

Example: Using a JSONP Service example-using-a-jsonp-service

This example illustrates how to configure a store and display the data in a UI module. In this example, the MD5 service of the jsontest.com site is used as a data source for a store. The service returns the MD5 hash code of a given string, in JSON format.

A contexthub.generic-jsonp store is configured so that it stores data for the service call https://md5.jsontest.com/?text=%22text%20to%20md5%22. The service returns the following data which is displayed in a UI module:

{
   "md5": "919a56ab62b6d5e1219fe1d95248a2c5",
   "original": "\"text to md5\""
}

Creating a contexthub.generic-jsonp Store creating-a-contexthub-generic-jsonp-store

The contexthub.generic-jsonp sample store candidate enables you to retrieve data from a JSONP service or a web service that returns JSON data. For this store candidate, use the store configuration to provide details about the JSONP service to use.

The init function of the ContextHub.Store.JSONPStore JavaScript class defines a config object that initializes this store candidate. The config object contains a service object that includes details about the JSONP service. To configure the store, you provide the service object in JSON format as the value for the Detail Configuration property.

To save data from the MD5 service of the jsontest.com site, use the procedure in Creating a ContextHub Store using the following properties:

  • Configuration Title: md5

  • Store Type: contexthub.generic-jsonp

  • Required: Select

  • Enabled: Select

  • Detail Configuration (JSON):

    code language-javascript 
    {
 "service": {
 "jsonp": false,
 "timeout": 1000,
 "ttl": 1800000,
 "secure": false,
 "host": "md5.jsontest.com",
 "port": 80,
 "params":{
 "text":"text to md5"
     }
   }
 }

Adding a UI Module for the md5 Data adding-a-ui-module-for-the-md-data

Add a UI module to the ContextHub toolbar to display the data that is stored in the example md5 store. In this example, the contexthub.base module is used to produce the following UI module:

ContextHub MD5 store

Use the procedure in Adding a UI Module to add the UI module to an existing UI Mode, such as the sample Persona UI Mode. For the UI Module, use the following property values:

  • UI Module Title: MD5

  • Module Type: contexthub.base

  • Detail Configuration (JSON):

    code language-javascript 
    {
 "icon": "coral-Icon--data",
 "title": "MD5 Conversion",
 "storeMapping": { "md5": "md5" },
 "template": "<p> {{md5.original}}</p>;
              <p>{{md5.md5}}</p>"
}

Debugging ContextHub debugging-contexthub

A debugging mode for the ContextHub can be enabled to allow for troubleshooting. The debug mode can be enabled either through the ContextHub configuration or via CRXDE.

Via the Configuration via-the-configuration

Edit the ContextHub’s configuration and check the option Debug

  1. In the rail select Tools > Sites > ContextHub
  2. Select the default Configuration Container
  3. Select the ContextHub Configuration and select Edit Selected Element
  4. Select Debug and select Save

Via CRXDE via-crxde

Use CRXDE Lite to set the property debug to true under:

  • /conf/global/settings/cloudsettings or
  • /conf/<site>/settings/cloudsettings

Logging Debug Messages for ContextHub logging-debug-messages-for-contexthub

Configure the Adobe Granite ContextHub OSGi service (PID = com.adobe.granite.contexthub.impl.ContextHubImpl) to log detailed Debug messages that are useful when developing.

To configure the service you can either use the Web Console or use a JCR node in the repository:

  • Web Console: To log Debug messages, select the Debug property.
  • JCR node: To log Debug messages, set the boolean com.adobe.granite.contexthub.debug property to true.

Silent Mode silent-mode

Silent mode suppresses all debug information. Unlike the normal debug option, which can be set independently for each ContextHub configuration, silent mode is a global setting which takes precedent over any debug settings on the ContextHub configuration level.

This is useful for your publish instance, where you do not want any debug information at all. Because it is a global setting, it is enabled via OSGi.

  1. Open the Adobe Experience Manager Web Console Configuration at http://<host>:<port>/system/console/configMgr
  2. Search for Adobe Granite ContextHub
  3. Click the configuration Adobe Granite ContextHub to edit its properties
  4. Check the option Silent Mode and click Save

Disabling ContextHub disabling-contexthub

ContextHub can be disabled to prevent it from loading js/css and initializing. There are two options to disable ContextHub:

  • Edit the ContextHub’s configuration and check the option Disable ContextHub

    1. In the rail select Tools > Sites > ContextHub
    2. Select the default Configuration Container
    3. Select the ContextHub Configuration and select Edit Selected Element
    4. Select Disable ContextHub and select Save

or

  • Use CRXDE Lite to set the property disabled to true under /conf/global/settings/cloudsettings/<configName>/contexthub
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab