DocumentazioneAEM 6.4Guida all’amministrazione

Configurazione di ContextHub configuring-contexthub

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Admin
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

ContextHub è un framework per la memorizzazione, la manipolazione e la presentazione dei dati contestuali. Per maggiori dettagli su ContextHub, consulta la sezione documentazione per gli sviluppatori. ContextHub sostituisce Contesto client nell’interfaccia touch.

Configura le ContextHub per controllare se viene visualizzato in modalità Anteprima, per creare archivi ContextHub e aggiungere moduli di interfaccia utente utilizzando l’interfaccia utente ottimizzata per il tocco.

Disabilitazione di ContextHub disabling-contexthub

Per impostazione predefinita, ContextHub è abilitato in un'installazione AEM. ContextHub può essere disabilitato per impedirgli di caricare js/css e di inizializzare. Esistono due opzioni per disabilitare ContextHub:

  • Modifica la configurazione di ContextHub e seleziona l’opzione Disattiva ContextHub

    1. Nella barra, tocca o fai clic su Strumenti > Siti > ContextHub
    2. Tocca o fai clic sul valore predefinito Contenitore di configurazione
    3. Seleziona la Configurazione ContextHub e tocca o fai clic su Modifica elemento selezionato
    4. Tocca o fai clic su Disattiva ContextHub e tocca o fai clic su Salva

oppure

  • Utilizzare CRXDE Lite per impostare la proprietà disabled a true sotto /libs/settings/cloudsettings
NOTE
A causa della ristrutturazione degli archivi nella AEM 6.4, il percorso delle configurazioni di ContextHub è stato modificato da /etc/cloudsettings a:
  • /libs/settings/cloudsettings
  • /conf/global/settings/cloudsettings
  • /conf/<tenant>/settings/cloudsettings

Mostrare e nascondere l’interfaccia utente di ContextHub showing-and-hiding-the-contexthub-ui

Configura il servizio Adobe ContextHub OSGi per mostrare o nascondere il Interfaccia utente ContextHub sulle tue pagine. Il PID di questo servizio è com.adobe.granite.contexthub.impl.ContextHubImpl.

Per configurare il servizio è possibile utilizzare Console web o utilizzare Nodo JCR nell'archivio:

  • Console Web: Per visualizzare l’interfaccia utente, seleziona la proprietà Mostra interfaccia utente . Per nascondere l’interfaccia utente, deselezionare la proprietà Nascondi interfaccia utente .
  • Nodo JCR: Per visualizzare l’interfaccia utente, imposta il valore booleano com.adobe.granite.contexthub.show_ui proprietà di true. Per nascondere l’interfaccia utente, imposta la proprietà su false.

Quando mostra l’interfaccia utente di ContextHub, questa viene visualizzata solo sulle pagine AEM istanze dell’autore. L’interfaccia utente non viene visualizzata sulle pagine delle istanze di pubblicazione.

Aggiunta di modalità e moduli dell’interfaccia utente di ContextHub adding-contexthub-ui-modes-and-modules

Configura le modalità e i moduli dell’interfaccia utente visualizzati nella barra degli strumenti di ContextHub in modalità Anteprima:

  • Modalità interfaccia utente: Gruppi di moduli correlati
  • Moduli: Widget che espongono i dati contestuali da un archivio e consentono agli autori di manipolare il contesto

Le modalità di interfaccia utente vengono visualizzate come una serie di icone sul lato sinistro della barra degli strumenti. Quando è selezionata questa opzione, i moduli di una modalità di interfaccia utente vengono visualizzati a destra.

chlimage_1-319

Le icone sono riferimenti dal Libreria di icone dell’interfaccia utente Coral.

Aggiunta di una modalità di interfaccia utente adding-a-ui-mode

Aggiungi una modalità di interfaccia utente per raggruppare i moduli ContextHub correlati. Quando crei la modalità di interfaccia utente, fornisci il titolo e l’icona visualizzati nella barra degli strumenti di ContextHub.

  1. Nella barra degli Experienci Manager, tocca o fai clic su Strumenti > Siti > Context Hub.

  2. Tocca o fai clic sul contenitore di configurazione predefinito.

  3. Tocca o fai clic su Configurazione Context Hub.

  4. Tocca o fai clic sul pulsante Crea , quindi tocca o fai clic su Modalità interfaccia utente di Context Hub .

    chlimage_1-320

  5. Immetti i valori per le seguenti proprietà:

    • Titolo modalità interfaccia utente: Titolo che identifica la modalità di interfaccia utente
    • Icona modalità: Il selettore per Icona dell’interfaccia utente Coral per utilizzare, ad esempio coral-Icon--user
    • Abilitato: Seleziona per visualizzare la modalità di interfaccia utente nella barra degli strumenti di ContextHub

  6. Tocca o fai clic su Salva.

Aggiunta di un modulo dell’interfaccia utente adding-a-ui-module

Aggiungi un modulo dell’interfaccia utente ContextHub a una modalità dell’interfaccia utente in modo che venga visualizzato nella barra degli strumenti di ContextHub per visualizzare l’anteprima del contenuto della pagina. Quando aggiungi un modulo di interfaccia utente, stai creando un'istanza di un tipo di modulo registrato con ContextHub. Per aggiungere un modulo di interfaccia utente, è necessario conoscere il nome del tipo di modulo associato.

AEM fornisce un tipo di modulo di interfaccia utente di base e diversi tipi di moduli di interfaccia utente di esempio su cui è possibile basare un modulo di interfaccia utente. La tabella seguente fornisce una breve descrizione di ciascuna di esse. Per informazioni sullo sviluppo di un modulo di interfaccia utente personalizzato, consulta Creazione di moduli di interfaccia utente ContextHub.

Le proprietà del modulo dell’interfaccia utente includono una configurazione dettagliata in cui è possibile fornire valori per proprietà specifiche del modulo. Fornisci la configurazione dei dettagli in formato JSON. La colonna Tipo di modulo nella tabella fornisce collegamenti a informazioni sul codice JSON richiesto per ciascun tipo di modulo di interfaccia utente.

Tipo modulo
Descrizione
Store
contexthub.base
Un tipo di modulo di interfaccia utente generico
Configurata nelle proprietà del modulo dell’interfaccia utente
contexthub.browserinfo
Visualizza informazioni sul browser
surferinfo
contexthub.datetime
Visualizza informazioni su data e ora
datetime
contexthub.device
Visualizza il dispositivo client
emulatori
contexthub.location
Visualizza la latitudine e la longitudine del client, nonché la posizione su una mappa. Consente di modificare la posizione.
geolocalizzazione
contexthub.screen-orientation
Visualizza l’orientamento dello schermo del dispositivo (orizzontale o verticale)
emulatori
contexthub.tagcloud
Visualizza statistiche sui tag pagina
tagcloud
granite.profile
Visualizza le informazioni di profilo per l'utente corrente, compresi authorizableID, displayName e familyName. È possibile modificare il valore di displayName e familyName.
profilo

  1. Nella barra degli Experienci Manager, tocca o fai clic su Strumenti > Siti > ContextHub.

  2. Tocca o fai clic sul contenitore di configurazione a cui desideri aggiungere un modulo di interfaccia utente.

  3. Fai clic o digita la configurazione ContextHub alla quale desideri aggiungere il modulo dell’interfaccia utente.

  4. Tocca o fai clic sulla modalità di interfaccia a cui stai aggiungendo il modulo di interfaccia utente.

  5. Tocca o fai clic sul pulsante Crea , quindi tocca o fai clic sul modulo dell’interfaccia utente ContextHub (generico).

    chlimage_1-321

  6. Immetti i valori per le seguenti proprietà:

    • Titolo modulo interfaccia utente: Titolo che identifica il modulo dell’interfaccia utente
    • Tipo di modulo: Tipo di modulo
    • Abilitato: Seleziona per visualizzare il modulo dell’interfaccia utente nella barra degli strumenti di ContextHub

  7. (Facoltativo) Per ignorare la configurazione predefinita dell’archivio, immetti un oggetto JSON per configurare il modulo dell’interfaccia utente.

  8. Tocca o fai clic su Salva.

Creazione di un archivio ContextHub creating-a-contexthub-store

Crea un archivio Context Hub per mantenere i dati utente e accedervi in base alle esigenze. Gli archivi ContextHub si basano su candidati di store registrati. Quando si crea lo store, è necessario il valore dello storeType con cui è stato registrato il candidato dello store. (Vedi Creazione di candidati store personalizzati.)

Configurazione dettagliata archivio detailed-store-configuration

Quando si configura un archivio, la proprietà Configurazione dettagli consente di fornire valori per proprietà specifiche dell'archivio. Il valore è basato sul config parametro dell'archivio init funzione . Pertanto, se è necessario fornire questo valore e il formato del valore, dipende dall'archivio.

Il valore della proprietà Configurazione dettagli è un config in formato JSON.

Candidati dell’archivio esempi sample-store-candidates

AEM fornisce i seguenti candidati all'archivio di esempio su cui è possibile basare un archivio.

Tipo di archivio
Descrizione
aem.segmentation
Memorizzazione di segmenti ContextHub risolti e non risolti. Recupera automaticamente i segmenti da ContextHub SegmentManager
aem.resolvedsegment
Memorizza i segmenti attualmente risolti. Ascolta il servizio ContextHub SegmentManager per aggiornare automaticamente lo store
contexthub.geolocation
Memorizza la latitudine e la longitudine della posizione del browser.
contexthub.datetime
Memorizza la data, l'ora e la stagione correnti per la posizione del browser
granite.emulatori
Definisce proprietà e funzionalità per diversi dispositivi e rileva il dispositivo client corrente
contexthub.generic-jsonp
Recupera e archivia dati da un servizio JSONP
granite.profile
Memorizza i dati del profilo per l'utente corrente
contexthub.surferinfo
Memorizza informazioni sul client, ad esempio informazioni sul dispositivo, sul tipo di browser e sull'orientamento della finestra
contexthub.tagcloud
Memorizza i tag delle pagine e i conteggi dei tag

  1. Nella barra degli Experienci Manager, tocca o fai clic su Strumenti > Siti > ContextHub.

  2. Tocca o fai clic sul contenitore di configurazione predefinito.

  3. Tocca o fai clic su Configurazione contexthub

  4. Per aggiungere un archivio, tocca o fai clic sull’icona Crea , quindi tocca o fai clic su Configurazione archivio ContextHub .

    chlimage_1-322

  5. Immetti i valori per le proprietà di configurazione di base, quindi tocca o fai clic su Avanti:

    • Titolo configurazione: Titolo che identifica lo store
    • Tipo archivio: Valore della proprietà storeType del candidato store su cui basare lo store
    • Obbligatorio: Seleziona
    • Abilitato: Selezionare per abilitare lo store

  6. (Facoltativo) Per ignorare la configurazione predefinita dell’archivio, immetti un oggetto JSON nella casella Configurazione dettagli (JSON) .

  7. Tocca o fai clic su Salva.

Esempio: Utilizzo di un servizio JSONP example-using-a-jsonp-service

Questo esempio illustra come configurare un archivio e visualizzare i dati in un modulo di interfaccia utente. In questo esempio, il servizio MD5 del sito jsontest.com viene utilizzato come origine dati per un archivio. Il servizio restituisce il codice hash MD5 di una stringa specificata, in formato JSON.

Un archivio contexthub.generic-jsonp è configurato in modo da memorizzare i dati per la chiamata al servizio https://md5.jsontest.com/?text=%22text%20to%20md5%22. Il servizio restituisce i seguenti dati visualizzati in un modulo dell'interfaccia utente:

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

Creazione di un archivio contexthub.generic-jsonp creating-a-contexthub-generic-jsonp-store

Il candidato per l’archivio di esempio contexthub.generic-jsonp ti consente di recuperare dati da un servizio JSONP o da un servizio Web che restituisce dati JSON. Per questo Store Candidato, utilizza la configurazione dello store per fornire dettagli sul servizio JSONP da utilizzare.

La init funzione ContextHub.Store.JSONPStore La classe Javascript definisce un config oggetto che inizializza il candidato all'archivio. La config un oggetto contiene service oggetto che include dettagli sul servizio JSONP. Per configurare lo store, fornisci il service in formato JSON come valore della proprietà Configurazione dettagli.

Per salvare i dati dal servizio MD5 del sito jsontest.com, utilizza la procedura descritta in Creazione di un archivio ContextHub utilizzando le seguenti proprietà:

  • Titolo configurazione: md5

  • Tipo archivio: contexthub.generic-jsonp

  • Obbligatorio: Seleziona

  • Abilitato: Seleziona

  • Configurazione dettagli (JSON):

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

Aggiunta di un modulo dell'interfaccia utente per i dati md5 adding-a-ui-module-for-the-md-data

Aggiungi un modulo dell’interfaccia utente alla barra degli strumenti di ContextHub per visualizzare i dati memorizzati nell’archivio md5 di esempio. In questo esempio, il modulo contexthub.base viene utilizzato per produrre il seguente modulo di interfaccia utente:

chlimage_1-323

Utilizza la procedura in Aggiunta di un modulo dell’interfaccia utente per aggiungere il modulo dell’interfaccia utente a una modalità dell’interfaccia utente esistente, ad esempio la modalità dell’interfaccia utente Perona di esempio. Per il modulo dell’interfaccia utente, utilizza i seguenti valori di proprietà:

  • Titolo modulo interfaccia utente: MD5

  • Tipo di modulo: contexthub.base

  • Configurazione dettagli (JSON):

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

Debug di ContextHub debugging-contexthub

È possibile abilitare una modalità di debug per ContextHub per consentire la risoluzione dei problemi. La modalità di debug può essere abilitata sia tramite la configurazione ContextHub che tramite CRXDE.

Tramite la configurazione via-the-configuration

Modifica la configurazione di ContextHub e seleziona l’opzione Debug

  1. Nella barra, tocca o fai clic su Strumenti > Siti > ContextHub
  2. Tocca o fai clic sul valore predefinito Contenitore di configurazione
  3. Seleziona la Configurazione ContextHub e tocca o fai clic su Modifica elemento selezionato
  4. Tocca o fai clic su Debug e tocca o fai clic su Salva

Tramite CRXDE via-crxde

Utilizzare CRXDE Lite per impostare la proprietà debug a true in:

  • /conf/global/settings/cloudsettings oppure
  • /conf/<tenant>/settings/cloudsettings
NOTE
Per le configurazioni ContextHub ancora presenti nei percorsi legacy, la posizione in cui impostare la debug property è /libs/settings/cloudsettings/legacy/contexthub.

Modalità silenziosa silent-mode

La modalità silenziosa sopprime tutte le informazioni di debug. A differenza dell'opzione di debug normale, che può essere impostata indipendentemente per ogni configurazione di ContextHub, la modalità silenziosa è un'impostazione globale che ha precedenza su qualsiasi impostazione di debug a livello di configurazione ContextHub.

Questo è utile per l'istanza di pubblicazione, in cui non si desidera alcuna informazione di debug. Poiché è un’impostazione globale, viene abilitata tramite OSGi.

  1. Apri Configurazione della console Web di Adobe Experience Manager a http://<host>:<port>/system/console/configMgr
  2. Cerca Adobe Granite ContextHub
  3. Fai clic sulla configurazione Adobe Granite ContextHub per modificarne le proprietà
  4. Controlla l’opzione Modalità silenziosa e fai clic su Salva

Ripristino delle configurazioni ContextHub dopo l’aggiornamento recovering-contexthub-configurations-after-upgrading

Quando un aggiornamento a AEM viene eseguita, le configurazioni ContextHub vengono sottoposte a backup e archiviate in una posizione sicura. Durante l’aggiornamento, vengono installate le configurazioni ContextHub predefinite, sostituendo le configurazioni esistenti. Il backup è necessario per mantenere le modifiche o le aggiunte apportate.

Le configurazioni ContextHub vengono memorizzate in una cartella denominata contexthub sotto i seguenti nodi:

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

Dopo un aggiornamento, il backup viene memorizzato in una cartella denominata contexthub sotto un nodo chiamato:

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

La yyyymmdd parte del nome del nodo è la data in cui è stato eseguito l'aggiornamento.

Per recuperare le configurazioni di ContextHub, utilizza CRXDE Lite per copiare i nodi che rappresentano gli store, le modalità di interfaccia utente e i moduli di interfaccia da sotto default-pre-upgrade_yyyymmdd_xxxxxx nodo a sotto:

  • /conf/global/settings/cloudsettings oppure
  • /conf/<tenant>/settings/cloudsettings
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8