ContextHub configureren

ContextHub is een kader voor het opslaan van, het manipuleren van, en het voorstellen van contextgegevens. Voor meer detail op ContextHub, te zien gelieve ontwikkelaardocumentatie. ContextHub vervangt Clientcontext in aanraak UI.

Vorm de toolbar ContextHub 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

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 Disable ContextHub

  1. Klik of tik Gereedschappen > Sites > ContextHub
  2. Klik of tik het gebrek Container van de Configuratie
  3. Selecteer ContextHub Configuration en klik of tik Geselecteerd Element bewerken
  4. Klik of tik Schakel ContextHub uit en klik of tik Save

or

• Gebruik CRXDE Lite om de eigenschap disabled in te stellen op true onder /libs/settings/cloudsettings

Het tonen van en het Verbergen van ContextHub UI

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

U kunt de service configureren met de webconsole of met een JCR-knooppunt in de opslagruimte:

• Webconsole:selecteer de eigenschap UI weergeven om de interface weer te geven. Om UI te verbergen, ontruim het bezit UI van de Huid.
• JCR-knooppunt: Stel de Booleaanse com.adobe.granite.contexthub.show_ui eigenschap in op true. Als u de interface wilt verbergen, stelt u de eigenschap in op false.

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

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 de Koraal UI.

UI-modus toevoegen

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. Klik of tik op Gereedschappen > Sites > Context Hub in de Experience Manager.

2. Klik of tik de standaardContainer van de Configuratie.

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

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

   

5. Geef waarden op voor de volgende eigenschappen:

   • Titel UI-modus: De titel die de UI-modus identificeert
   • Pictogram modus: De kiezer voor het Koraal UI-pictogram dat moet worden gebruikt, bijvoorbeeld coral-Icon--user
   • Ingeschakeld: Selecteer om de wijze UI op de toolbar te tonen ContextHub

6. Klik op Opslaan of tik op Opslaan.

Een UI-module toevoegen

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 Creërend Modules UI ContextHub.

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.

1. Klik of tik op Extra > Sites > ContextHub in de Experience Manager.

2. Klik of tik 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 of tik de wijze UI waaraan u de module UI toevoegt.

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

   

6. 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

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

8. Klik op Opslaan of tik op Opslaan.

Een ContextHub-winkel maken

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

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 opslag. 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 voorwerp in formaat JSON.

Voorbeeld van winkelkandidaten

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

1. Klik of tik op Extra > Sites > ContextHub in de Experience Manager.

2. Klik of tik de standaardconfiguratiecontainer.

3. Klik of tik Configuratie Contexthub

4. Als u een winkel wilt toevoegen, klikt of tikt u op het pictogram Maken en klikt of tikt u op ContexHub Store Configuration.

   

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

   • Configuratitel: de titel die de winkel identificeert
   • Het Type van opslag: 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

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

7. Klik op Opslaan of tik op Opslaan.

Voorbeeld: Een JSONP-service gebruiken

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 store wordt gevormd zodat het gegevens voor de de dienstvraag https://md5.jsontest.com/?text=%22text%20to%20md5%22 opslaat. 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

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 functie init van de Javascript-klasse ContextHub.Store.JSONPStore definieert een config-object 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 plaats op te slaan jsontest.com, gebruik de procedure in Creërend een Winkel ContextHub gebruikend de volgende eigenschappen:

• Configuratitel: md5

• Winkeltype: contexthub.generic-jsonp

• Vereist: Selecteren

• Ingeschakeld: Selecteren

• Detailconfiguratie (JSON):

  {
   "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

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:

Gebruik de procedure in Toevoegend een Module UI 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 van UI-module: MD5

• Moduletype: contexthub.base

• Detailconfiguratie (JSON):

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

Foutopsporing in 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

Bewerk de configuratie van ContextHub en controleer de optie Debug

1. Klik of tik Gereedschappen > Sites > ContextHub
2. Klik of tik het gebrek Container van de Configuratie
3. Selecteer ContextHub Configuration en klik of tik Geselecteerd Element bewerken
4. Klik of tik Foutopsporing en klik of tik Opslaan

Via CRXDE

Gebruik CRXDE Lite om de eigenschap debug in te stellen op true onder:

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

Stille modus

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 Adobe Experience Manager Web Console Configuration op http://<host>:<port>/system/console/configMgr
2. Zoeken naar Adobe granite ContextHub
3. Klik de configuratie Adobe granite ContextHub om zijn eigenschappen uit te geven
4. Schakel de optie Stille modus in en klik op Opslaan

Het terugkrijgen van Configuraties ContextHub na de Bevordering

Wanneer een verbetering aan 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.

De configuraties ContextHub worden opgeslagen in een omslag genoemd contexthub onder de volgende knopen:

• /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 or
/conf/<tenant>/settings/cloudsettings/default-pre-upgrade_yyyymmdd_xxxxxxx

Het yyyymmdd gedeelte van de knoopnaam is de datum toen de verbetering werd 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

Business.Adobe.com-bronnen

Ecommerce Integrations Personalized Communications Mobile Forms Responsive Forms Dynamic Media Digital Rights Management