ContextHub configureren configuring-contexthub
ContextHub is een kader voor het opslaan van, het manipuleren van, en het voorstellen van contextgegevens. Voor meer detail op ContextHub, gelieve te zien ontwikkelaarsdocumentatie. ContextHub vervangt Clientcontext in de aanraakinterface.
Configureer de ContextHub toolbar om 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. Er zijn twee opties om ContextHub onbruikbaar te maken:
-
Bewerk de configuratie van ContextHub en controleer de optie ContextHub uitschakelen
- Klik of tik in de spoorstaaf Extra > Sites > ContextHub
- Klik of tik de standaard Configuratiecontainer
- Selecteer ContextHub-configuratie en klik of tik Geselecteerd element bewerken
- Klikken of tikken ContextHub uitschakelen en klik of tik Opslaan
of
- CRXDE Lite gebruiken om de eigenschap in te stellen
disabled
tot true krachtens/libs/settings/cloudsettings
/etc/cloudsettings
tot:/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 dienst van ContextHub OSGi van Adobe Granite om te tonen of te verbergen ContextHub UI op uw pagina's. De PID van deze service is com.adobe.granite.contexthub.impl.ContextHubImpl.
Om de dienst te vormen kunt u of gebruiken Webconsole of een JCR-knooppunt in de gegevensopslagruimte:
- Webconsole: Om UI te tonen, selecteer het bezit UI van de Show. Om UI te verbergen, ontruim het bezit UI van de Huid.
- JCR-knooppunt: Om UI te tonen, plaats boolean
com.adobe.granite.contexthub.show_ui
eigenschap aantrue
. Stel de eigenschap in opfalse
.
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 van verwante modules
- Modules: Widgets die contextgegevens van een opslag blootstellen en auteurs toelaten om 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.
Pictogrammen zijn verwijzingen uit de Pictogrambibliotheek van Koral UI.
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.
-
Klik of tik op Gereedschappen > Sites > Context Hub in de Experience Manager.
-
Klik of tik de standaardContainer van de Configuratie.
-
Klik of tik de Configuratie van de Hub van de Context.
-
Klik of tik de Create knoop, en klik of tik dan de Wijze UI van de Hub van de Context.
-
Geef waarden op voor de volgende eigenschappen:
- Titel UI-modus: De titel die de UI-modus identificeert
- Pictogram modus: De kiezer voor de Pictogram Koraalinterface bijvoorbeeld
coral-Icon--user
- Ingeschakeld: Selecteer om de wijze UI op de toolbar te tonen ContextHub
-
Klik op Opslaan of tik op Opslaan.
UI-modules 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. De volgende tabel bevat een korte beschrijving van elke tabel. Voor informatie over het ontwikkelen van een module van douaneUI, zie ContextHub UI-modules maken.
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.
-
Klik of tik op Extra > Sites > ContextHub in de Experience Manager.
-
Klik of tik de Container van de Configuratie waaraan u een module UI wilt toevoegen.
-
Klik of typ de Configuratie ContextHub waaraan u de module UI wilt toevoegen.
-
Klik of tik de wijze UI waaraan u de module UI toevoegt.
-
Klik of tik de Create knoop, dan klik of tik de Module van ContextHub UI (algemeen).
-
Geef waarden op voor de volgende eigenschappen:
- Titel module UI: Een titel die de UI-module identificeert
- Moduletype: Het moduletype
- Ingeschakeld: Selecteer om de module UI in de toolbar te tonen ContextHub
-
(Optioneel) Als u de standaardwinkelconfiguratie wilt overschrijven, voert u een JSON-object in om de UI-module te configureren.
-
Klik op Opslaan of tik 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 Aangepaste winkelkandidaten maken.)
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 config
parameter van de opslag init
functie. Daarom of u deze waarde, en het formaat van de waarde moet verstrekken, hangt van de opslag af.
De waarde van het bezit van de Configuratie van het Detail 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.
-
Klik of tik op Extra > Sites > ContextHub in de Experience Manager.
-
Klik of tik de standaardconfiguratiecontainer.
-
Klik of tik Configuratie Contexthub
-
Als u een winkel wilt toevoegen, klikt of tikt u op het pictogram Maken en klikt of tikt u op ContexHub Store Configuration.
-
Geef waarden op voor de basisconfiguratie-eigenschappen en klik of tik op Volgende:
- Configuratitel: De titel die de winkel identificeert
- Winkeltype: De waarde van het storeType bezit van de opslagkandidaat waarop om de opslag te baseren
- Vereist: Selecteren
- Ingeschakeld: Selecteren om de winkel in te schakelen
-
(Optioneel) Als u de standaardopslagconfiguratie wilt overschrijven, voert u een JSON-object in het vak Detail Configuration (JSON) in.
-
Klik op Opslaan of tik op Opslaan.
Voorbeeld: Het gebruiken van de Dienst JSONP 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-opslag is geconfigureerd zodat 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 init de functie van de ContextHub.Store.JSONPStore
De klasse JavaScript definieert een config
object dat deze winkelkandidaat initialiseert. De config
object bevat een service
object dat details over de JSONP-service bevat. Om de opslag te vormen, verstrekt u service
object in JSON-indeling als de waarde voor de eigenschap Detail Configuration.
Als u gegevens wilt opslaan van de MD5-service van de site jsontest.com, gebruikt u de procedure in Een ContextHub-winkel maken de volgende eigenschappen gebruiken:
-
Configuratitel: md5
-
Winkeltype: contexthub.generic-jsonp
-
Vereist: Selecteren
-
Ingeschakeld: Selecteren
-
Detailconfiguratie (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:
De procedure gebruiken in UI-modules toevoegen om 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 module UI: MD5
-
Moduletype: contexthub.base
-
Detailconfiguratie (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 Foutopsporing
- Klik of tik in de spoorstaaf Extra > Sites > ContextHub
- Klik of tik de standaard Configuratiecontainer
- Selecteer ContextHub-configuratie en klik of tik Geselecteerd element bewerken
- Klikken of tikken Foutopsporing en klik of tik Opslaan
Via CRXDE via-crxde
CRXDE Lite gebruiken om de eigenschap in te stellen debug
tot true onder:
/conf/global/settings/cloudsettings
of/conf/<tenant>/settings/cloudsettings
debug property
is /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.
- Open de Configuratie Adobe Experience Manager-webconsole om
http://<host>:<port>/system/console/configMgr
- Zoeken naar Adobe Granite ContextHub
- Klik op de configuratie Adobe Granite ContextHub om de eigenschappen te bewerken
- Schakel de optie in Stille modus en klik op Opslaan
Het terugkrijgen van Configuraties ContextHub na Bevordering recovering-contexthub-configurations-after-upgrading
Wanneer een upgrade naar AEM wordt 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
De yyyymmdd
Het gedeelte van de knooppuntnaam is de datum toen de verbetering werd uitgevoerd.
Om uw configuraties te herstellen ContextHub, gebruik CRXDE Lite om de knopen te kopiëren die uw opslag, wijzen UI, en modules UI van onder vertegenwoordigen default-pre-upgrade_yyyymmdd_xxxxxx
knooppunt tot hieronder:
/conf/global/settings/cloudsettings
of/conf/<tenant>/settings/cloudsettings