DocumentatieAEM 6.5Handboek

ContextHub configureren configuring-contexthub

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

Gemaakt voor:

  • Ontwikkelaar

ContextHub is een kader voor het opslaan van, het manipuleren van, en het voorstellen van contextgegevens. Voor meer detail op ContextHub, zie de documentatie van de ontwikkelaar. ContextHub vervangt Context van de Cliëntin aanraking UI.

Vorm de toolbar ContextHubom te controleren of het op de wijze van de Voorproef verschijnt, om opslag te creëren ContextHub, en modules toe te voegen UI gebruikend touch-Geoptimaliseerde UI.

ContextHub uitschakelen disabling-contexthub

Door gebrek, wordt ContextHub toegelaten in een AEM installatie. ContextHub kan worden onbruikbaar gemaakt om het te verhinderen js/css te laden en te initialiseren.

  • Gebruik CRXDE Lite om het bezit disabled aan waar onder /libs/settings/cloudsettings/legacy/contexthub te plaatsen
NOTE
wegens bewaarplaatsherstructurering in AEM 6.4,de plaats van configuraties ContextHub veranderde van /etc/cloudsettings in:
  • /libs/settings/cloudsettings
  • /conf/global/settings/cloudsettings
  • /conf/<tenant>/settings/cloudsettings

Het tonen van en het Verbergen van ContextHub UI showing-and-hiding-the-contexthub-ui

Vorm de Adobe granite ContextHub OSGi dienst om ContextHub UIop uw pagina's te tonen of te verbergen. De PID van deze service is com.adobe.granite.contexthub.impl.ContextHubImpl.

Om de dienst te vormen kunt u of de Console van het Webgebruiken of a knoop JCR in de bewaarplaatsgebruiken:

  • Console van het Web: om UI te tonen, selecteer het bezit van UI van de Show. Om UI te verbergen, ontruim het bezit UI van de Huid.
  • knoop JCR: om UI te tonen, plaats het booleaanse com.adobe.granite.contexthub.show_ui bezit aan true. Stel de eigenschap in op false om de interface te verbergen.

Wanneer het tonen van ContextHub UI, verschijnt het slechts op pagina's op AEM auteursinstanties. De interface wordt niet weergegeven op pagina's met publicatie-instanties.

ContextHub UI-modi en modules toevoegen adding-contexthub-ui-modes-and-modules

Vorm de wijzen UI en de modules die op de toolbar ContextHub op de wijze van de Voorproef verschijnen:

  • UI-modi: Groepen gerelateerde modules
  • Modules: widgets die contextgegevens uit een winkel beschikbaar maken en auteurs in staat stellen de context te manipuleren

UI-modi worden als een reeks pictogrammen aan de linkerkant van de werkbalk weergegeven. Wanneer geselecteerd, verschijnen de modules van een wijze UI aan het recht.

chlimage_1-319

Pictogrammen zijn verwijzingen van de Koraal UI pictogrambibliotheek.

UI-modus toevoegen adding-a-ui-mode

Voeg een wijze UI aan groep verwante modules ContextHub toe. Wanneer u de wijze UI creeert, verstrekt u de titel en het pictogram die in de toolbar ContextHub verschijnen.

  1. Voor de spoorstaaf van de Experience Manager, klik Hulpmiddelen > Plaatsen > de Hub van de Context.

  2. Klik de standaardContainer van de Configuratie.

  3. Klik de Configuratie van de Hub van de Context.

  4. Klik de Create knoop, en klik dan de Wijze UI van de Hub van de Context.

    chlimage_1-320

  5. Geef waarden op voor de volgende eigenschappen:

    • UI Mode Title: The title that identify the UI mode
    • Het Pictogram van de wijze: De selecteur voor het Koraal UI pictogramaan gebruik, bijvoorbeeld, coral-Icon--user
    • Toegelaten: Uitgezocht om de wijze UI op de toolbar te tonen ContextHub

  6. Klik op Opslaan.

Een UI-module toevoegen adding-a-ui-module

Voeg een module ContextHub UI aan een wijze UI toe zodat het in de toolbar ContextHub voor het voorvertonen van paginainhoud verschijnt. Wanneer u een module UI toevoegt, creeert u een geval van een moduletype dat met ContextHub wordt geregistreerd. Om een module UI toe te voegen, moet u de naam van het bijbehorende moduletype kennen.

AEM verstrekt een moduletype van basisUI evenals verscheidene types van steekproefUI Module waarop u een module UI kunt baseren. In de volgende tabel vindt u een korte beschrijving van elke tabel. Voor informatie over het ontwikkelen van een module van douane UI, zie Creërend Modules ContextHub UI.

De eigenschappen van de module UI omvatten een detailconfiguratie waar u waarden voor module-specifieke eigenschappen kunt verstrekken. U verstrekt de detailconfiguratie in formaat JSON. De kolom van het Type van Module in de lijst verstrekt verbindingen aan informatie over de code JSON die voor elk UI moduletype wordt vereist.

Moduletype
Beschrijving
Winkel
contexthub.base
Een generiek type UI-module
Gevormd in de eigenschappen van de UI module
contexthub.browserinfo
Hiermee wordt informatie over de browser weergegeven
surferinfo
contexthub.datetime
Datum- en tijdgegevens weergeven
datetime
contexthub.device
Het clientapparaat weergeven
emulators
contexthub.location
Geeft de breedte en lengte van de client en de locatie op een kaart weer. Hiermee kunt u de locatie wijzigen.
geolocatie
contexthub.screen-orientation
Geeft de schermstand van het apparaat (liggend of staand) weer
emulators
contexthub.tagcloud
Statistieken over paginatags weergeven
tagcloud
granite.profile
Hiermee wordt de profielinformatie voor de huidige gebruiker weergegeven, inclusief authorizableID, displayName en familyName. U kunt de waarde van displayName en familyName wijzigen.
profiel

  1. Voor de spoorstaaf van de Experience Manager, klik Hulpmiddelen > Plaatsen > ContextHub.

  2. Klik de Container van de Configuratie waaraan u een module UI wilt toevoegen.

  3. Klik of typ de Configuratie ContextHub waaraan u de module UI wilt toevoegen.

  4. Klik de wijze UI waaraan u de module UI toevoegt.

  5. Klik de Create knoop, dan klik de Module van ContextHub (algemeen).

    chlimage_1-321

  6. Geef waarden op voor de volgende eigenschappen:

    • UI Module Title: Een titel die de UI module identificeert
    • Moduletype: het moduletype
    • Toegelaten: Uitgezocht om de module UI in de toolbar te tonen ContextHub

  7. (Optioneel) Als u de standaardwinkelconfiguratie wilt overschrijven, voert u een JSON-object in om de UI-module te configureren.

  8. Klik op Opslaan.

Een ContextHub-winkel maken creating-a-contexthub-store

Creeer een opslag van de Hub van de Context om gebruikersgegevens en toegang tot de gegevens voort te zetten zoals nodig. ContextHub-winkels zijn gebaseerd op geregistreerde winkelkandidaten. Wanneer u de opslag creeert, hebt u de waarde van storeType nodig waarmee de opslagkandidaat werd geregistreerd. (Zie Creërend de Kandidaten van de Opslag van de Douane.)

Gedetailleerde opslagconfiguratie detailed-store-configuration

Wanneer u een opslag vormt, laat het bezit van de Configuratie van het Detail u toe om waarden voor store-specific eigenschappen te verstrekken. De waarde is gebaseerd op de parameter config van de functie init van de store. Daarom of u deze waarde, en het formaat van de waarde moet verstrekken, hangt van de opslag af.

De waarde van de eigenschap Detail Configuration is een config -object in JSON-indeling.

Voorbeeld van winkelkandidaten sample-store-candidates

AEM verstrekt de volgende kandidaten van de steekproefopslag waarop u een opslag kunt baseren.

Winkeltype
Beschrijving
aem.segmentation
Bewaren voor opgeloste en onopgeloste segmenten ContextHub. Wint automatisch segmenten van ContextHub SegmentManager terug
aem.resolvedsegments
Hiermee slaat u de momenteel opgeloste segmenten op. Luistert aan de dienst ContextHub SegmentManager om de opslag automatisch bij te werken
contexthub.geolocation
Hiermee slaat u de breedte en lengte van de browserlocatie op.
contexthub.datetime
Hiermee worden de huidige datum, tijd en seizoen voor de browserlocatie opgeslagen
granite.emulators
Definieert eigenschappen en mogelijkheden voor verschillende apparaten en detecteert het huidige clientapparaat
contexthub.generic-jsonp
Wint en slaat gegevens van de dienst JSONP op
granite.profile
Hiermee worden profielgegevens voor de huidige gebruiker opgeslagen
contexthub.surferinfo
Hiermee wordt informatie over de client opgeslagen, zoals apparaatinformatie, browsertype en vensterrichting
contexthub.tagcloud
Hiermee worden paginatags en tellingen van tags opgeslagen

  1. Voor de spoorstaaf van de Experience Manager, klik Hulpmiddelen > Plaatsen > ContextHub.

  2. Klik op de standaardconfiguratiecontainer.

  3. Klik op Contexthub-configuratie

  4. Om een opslag toe te voegen, klik het Create pictogram en klik dan de Configuratie van de Winkel ContexHub.

    chlimage_1-322

  5. Geef waarden op voor de basisconfiguratie-eigenschappen en klik op Volgende:

    • Titel van de Configuratie: de titel die de opslag identificeert
    • Type van opslag: de waarde van het bezit storeType van de opslagkandidaat waarop om de opslag te baseren
    • Vereist: Uitgezocht
    • Toegelaten: Uitgezocht om de opslag toe te laten

  6. (Optioneel) Als u de standaardopslagconfiguratie wilt overschrijven, voert u een JSON-object in het vak Detail Configuration (JSON) in.

  7. Klik op Opslaan.

Voorbeeld: een JSONP-service gebruiken example-using-a-jsonp-service

Dit voorbeeld illustreert hoe te om een opslag te vormen en de gegevens in een module UI te tonen. In dit voorbeeld wordt de MD5-service van de site jsontest.com gebruikt als gegevensbron voor een winkel. De service retourneert de MD5-hash-code van een tekenreeks in JSON-indeling.

Een contexthub.generic-jsonp-winkel is zo geconfigureerd dat deze gegevens opslaat voor de serviceaanroep https://md5.jsontest.com/?text=%22text%20to%20md5%22 . De dienst keert de volgende gegevens terug die in een module UI worden getoond:

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

Een contexthub.generic-jsonp Store maken creating-a-contexthub-generic-jsonp-store

De contextthub.generic-jsonp-voorbeeldopslagkandidaat stelt u in staat gegevens op te halen uit een JSONP-service of een webservice die JSON-gegevens retourneert. Voor deze opslagkandidaat, gebruik de opslagconfiguratie om details over de dienst te verstrekken JSONP aan gebruik.

De initfunctie van de ContextHub.Store.JSONPStore klasse van JavaScript bepaalt een config voorwerp dat deze opslagkandidaat initialiseert. Het config -object bevat een service -object dat details over de JSONP-service bevat. Om de opslag te vormen, verstrekt u het service voorwerp in formaat JSON als waarde voor het bezit van de Configuratie van het Detail.

Om gegevens van de MD5 dienst van de jsontest.com plaats te bewaren, gebruik de procedure in Creërend een Winkel ContextHubgebruikend de volgende eigenschappen:

  • Titel van de Configuratie: md5

  • Type van opslag: contexthub.generic-jsonp

  • Vereist: Uitgezocht

  • Toegelaten: Uitgezochte

  • Configuratie van het Detail (JSON):

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

Een UI-module toevoegen voor de md5-gegevens adding-a-ui-module-for-the-md-data

Voeg een module UI aan de toolbar ContextHub toe om de gegevens te tonen die in het voorbeeld md5 opslag wordt opgeslagen. In dit voorbeeld wordt de module contexthub.base gebruikt om de volgende UI-module te produceren:

chlimage_1-323

Gebruik de procedure in Toevoegend een Module UIom de module UI aan een bestaande Wijze UI, zoals de wijze toe te voegen Perona UI van de steekproef. Voor de Module UI, gebruik de volgende bezitswaarden:

  • Titel van de Module UI: MD5

  • Type van Module: contexthub.base

  • Configuratie van het Detail (JSON):

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

Foutopsporing in ContextHub debugging-contexthub

Een het zuiveren wijze voor ContextHub kan worden toegelaten om voor het oplossen van problemen toe te staan. Zuiver wijze kan of door de configuratie ContextHub of via CRXDE worden toegelaten.

Via de configuratie via-the-configuration

Bewerk de configuratie van ContextHub en controleer de optie zuivert

  1. In het spoor klikt Hulpmiddelen > Plaatsen > ContextHub
  2. Klik de standaard Container van de Configuratie
  3. Selecteer de Configuratie ContextHub en klik uitgeeft Geselecteerd Element
  4. Klik zuiveren en klik sparen

Via CRXDE via-crxde

Gebruik CRXDE Lite om het bezit debug aan waar te plaatsen onder:

  • /conf/global/settings/cloudsettings of
  • /conf/<tenant>/settings/cloudsettings
NOTE
Voor configuraties ContextHub die zich nog onder hun erfeniswegen bevinden, is de plaats om debug property te plaatsen /libs/settings/cloudsettings/legacy/contexthub.

Stille modus silent-mode

In de modus Stil worden alle foutopsporingsgegevens onderdrukt. In tegenstelling tot normale zuiveren optie, die onafhankelijk voor elke configuratie kan worden geplaatst ContextHub, is de stille wijze het globale plaatsen die precedent over om het even welke neemt zuiveren montages op het ContextHub configuratieniveau.

Dit is nuttig voor uw publicatie-instantie, waar u helemaal geen foutopsporingsinformatie wilt. Omdat het een globaal plaatsen is, wordt het toegelaten via OSGi.

  1. Open de Configuratie van de Console van het Web van Adobe Experience Manager bij http://<host>:<port>/system/console/configMgr
  2. Onderzoek naar Adobe granite ContextHub
  3. Klik de configuratie Adobe granite ContextHub om zijn eigenschappen uit te geven
  4. Controle de optie Stille Wijze en klik sparen

Het terugkrijgen van Configuraties ContextHub na Bevordering recovering-contexthub-configurations-after-upgrading

Wanneer een verbetering aan AEMwordt uitgevoerd, worden de configuraties ContextHub gesteund en in een veilige plaats opgeslagen. Tijdens de verbetering, zijn de standaardconfiguraties ContextHub geïnstalleerd, die de bestaande configuraties vervangen. De back-up is vereist om eventuele wijzigingen of toevoegingen te behouden.

ContextHub-configuraties worden opgeslagen in een map met de naam contexthub onder de volgende knooppunten:

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

Na een upgrade wordt de back-up opgeslagen in een map met de naam contexthub onder een knooppunt met de naam:

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

Het yyyymmdd -gedeelte van de knooppuntnaam is de datum waarop de upgrade is uitgevoerd.

Om uw configuraties terug te krijgen ContextHub, gebruik CRXDE Lite om de knopen te kopiëren die uw opslag, wijzen UI, en modules UI van onder de default-pre-upgrade_yyyymmdd_xxxxxx knoop aan hieronder vertegenwoordigen:

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