Configurazione di ContextHub configuring-contexthub

ContextHub è un framework per l’archiviazione, la manipolazione e la presentazione dei dati contestuali. Per ulteriori dettagli su ContextHub, consulta la documentazione per gli sviluppatori. ContextHub sostituisce ClientContext nell'interfaccia utente touch.

Configura la barra degli strumenti ContextHub per controllare se viene visualizzata in modalità Anteprima, per creare archivi ContextHub e aggiungere moduli di interfaccia utente tramite 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.

  • Utilizzare CRXDE Lite per impostare la proprietà disabled su true in /libs/settings/cloudsettings/legacy/contexthub
NOTE
A causa della ristrutturazione dell'archivio in AEM 6.4, la posizione delle configurazioni ContextHub è cambiata da /etc/cloudsettings a:
  • /libs/settings/cloudsettings
  • /conf/global/settings/cloudsettings
  • /conf/<tenant>/settings/cloudsettings

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

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

Per configurare il servizio è possibile utilizzare la console Web o un nodo JCR nell'archivio:

  • Console Web: Per visualizzare l'interfaccia utente, selezionare la proprietà Mostra interfaccia utente. Per nascondere l’interfaccia utente, cancella la proprietà Nascondi interfaccia utente.
  • Nodo JCR: Per visualizzare l'interfaccia utente, impostare la proprietà booleana com.adobe.granite.contexthub.show_ui su true. Per nascondere l'interfaccia utente, impostare la proprietà su false.

Quando viene visualizzata l’interfaccia utente di ContextHub, viene visualizzata solo sulle pagine delle istanze di authoring AEM. L’interfaccia utente non viene visualizzata nelle pagine delle istanze di pubblicazione.

Aggiunta di modalità e moduli dell’interfaccia utente 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à dell’interfaccia utente vengono visualizzate sotto forma di una serie di icone sul lato sinistro della barra degli strumenti. Se selezionata, i moduli di una modalità interfaccia utente vengono visualizzati a destra.

chlimage_1-319

Le icone sono riferimenti dalla libreria di icone dell'interfaccia utente Coral.

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

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

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

  2. Fai clic sul Contenitore di configurazione predefinito.

  3. Fai clic sulla configurazione Context Hub.

  4. Fai clic sul pulsante Crea, quindi fai clic su Modalità interfaccia utente Context Hub.

    chlimage_1-320

  5. Immetti i valori per le seguenti proprietà:

    • Titolo modalità interfaccia utente: titolo che identifica la modalità interfaccia utente
    • Icona modalità: selettore dell'icona dell'interfaccia utente Coral da utilizzare, ad esempio coral-Icon--user
    • Abilitato: seleziona per visualizzare la modalità interfaccia utente nella barra degli strumenti di ContextHub
  6. Fai clic su Salva.

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

Aggiungi un modulo dell’interfaccia utente ContextHub a una modalità interfaccia utente in modo che venga visualizzato nella barra degli strumenti di ContextHub per 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.

L’AEM fornisce un tipo di modulo dell’interfaccia utente di base e diversi tipi di modulo dell’interfaccia utente di esempio su cui puoi basare un modulo dell’interfaccia utente. La tabella seguente fornisce una breve descrizione di ciascuno di essi. Per informazioni sullo sviluppo di un modulo interfaccia utente personalizzato, vedi Creazione di moduli interfaccia utente ContextHub.

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

Tipo modulo
Descrizione
Store
contexthub.base
Un tipo di modulo interfaccia utente generico
Configurato nelle proprietà del modulo 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 e 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 le statistiche sui tag pagina
tagcloud
granite.profile
Visualizza le informazioni di profilo per l'utente corrente, inclusi authorizableID, displayName e familyName. È possibile modificare il valore di displayName e familyName.
profilo
  1. Nella barra degli Experienci Manager, fai clic su Strumenti > Siti > ContextHub.

  2. Fai clic sul Contenitore di configurazione a cui desideri aggiungere un modulo di interfaccia utente.

  3. Fai clic o digita la configurazione ContextHub a cui desideri aggiungere il modulo di interfaccia utente.

  4. Fai clic sulla modalità dell’interfaccia utente a cui stai aggiungendo il modulo dell’interfaccia utente.

  5. Fai clic sul pulsante Crea, quindi fai clic su Modulo interfaccia utente ContextHub (generico).

    chlimage_1-321

  6. Immetti i valori per le seguenti proprietà:

    • Titolo modulo interfaccia utente: titolo che identifica il modulo interfaccia utente
    • Tipo di modulo: il tipo di modulo
    • Abilitato: seleziona per mostrare il modulo 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 interfaccia utente.

  8. Fai clic su Salva.

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

Crea un archivio Context Hub per rendere persistenti i dati utente e accedere ai dati in base alle esigenze. Gli store ContextHub si basano sui 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 per store personalizzati.)

Configurazione archivio dettagliata detailed-store-configuration

Quando si configura un archivio, la proprietà Configurazione dettagli consente di fornire valori per le proprietà specifiche del negozio. Il valore è basato sul parametro config della funzione init dell'archivio. Pertanto, l’eventuale necessità di fornire questo valore e il formato del valore dipendono dall’archivio.

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

Candidati dell’archivio esempi sample-store-candidates

L’AEM fornisce i seguenti esempi di store candidati su cui puoi basare un negozio.

Tipo di archivio
Descrizione
aem.segmentation
Archivia per segmenti ContextHub risolti e non risolti. Recupera automaticamente i segmenti da ContextHub SegmentManager
aem.resolvedsegments
Memorizza i segmenti attualmente risolti. Ascolta il servizio SegmentManager di ContextHub 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.emulators
Definisce proprietà e funzionalità per diversi dispositivi e rileva il dispositivo client corrente
contexthub.generic-jsonp
Recupera e memorizza i dati da un servizio JSONP
granite.profile
Memorizza i dati profilo per l'utente corrente
contexthub.surferinfo
Memorizza informazioni sul client, ad esempio informazioni sul dispositivo, il tipo di browser e l'orientamento della finestra
contexthub.tagcloud
Memorizza i tag di pagina e i conteggi dei tag
  1. Nella barra degli Experienci Manager, fai clic su Strumenti > Siti > ContextHub.

  2. Fai clic sul contenitore di configurazione predefinito.

  3. Fai clic su Configurazione Contexthub

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

    chlimage_1-322

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

    • Titolo configurazione: Titolo che identifica l'archivio
    • Tipo archivio: il valore della proprietà storeType del candidato archivio su cui basare l'archivio
    • Obbligatorio: Seleziona
    • Abilitato: Selezionare per abilitare l'archivio
  6. (Facoltativo) Per ignorare la configurazione predefinita dell’archivio, immetti un oggetto JSON nella casella Configurazione dettaglio (JSON).

  7. 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 dell’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 determinata stringa, 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 campioni contexthub.generic-jsonp consente di recuperare dati da un servizio JSONP o da un servizio web che restituisce dati JSON. Per questo candidato all'archivio, utilizza la configurazione dell'archivio per fornire dettagli sul servizio JSONP da utilizzare.

La funzione init della classe JavaScript ContextHub.Store.JSONPStore definisce un oggetto config che inizializza il candidato dell'archivio. L'oggetto config contiene un oggetto service che include dettagli sul servizio JSONP. Per configurare l'archivio, specificare l'oggetto service in formato JSON come valore per la proprietà Configurazione dettagli.

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

  • Titolo configurazione: md5

  • Tipo di 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 interfaccia utente per i dati md5 adding-a-ui-module-for-the-md-data

Aggiungi un modulo di 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

Segui la procedura descritta in Aggiunta di un modulo interfaccia utente per aggiungere il modulo a una modalità interfaccia utente esistente, ad esempio la modalità interfaccia utente personale di esempio. Per il modulo UI, utilizza i seguenti valori delle proprietà:

  • Titolo modulo interfaccia utente: MD5

  • Tipo 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 tramite la configurazione ContextHub o tramite CRXDE.

Tramite la configurazione via-the-configuration

Modifica la configurazione di ContextHub e seleziona l'opzione Debug

  1. Nella barra fai clic su Strumenti > Siti > ContextHub
  2. Fai clic sul contenitore configurazione predefinito
  3. Seleziona la configurazione ContextHub e fai clic su Modifica elemento selezionato
  4. Fai clic su Debug e fai clic su Salva

Via CRXDE via-crxde

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

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

Modalità silenziosa silent-mode

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

Questa funzione è utile per l’istanza Publish, in cui non desideri ricevere informazioni di debug. Poiché si tratta di un’impostazione globale, viene abilitata tramite OSGi.

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

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

Quando viene eseguito un aggiornamento a AEM, le configurazioni ContextHub vengono sottoposte a backup e archiviate in un percorso sicuro. Durante l’aggiornamento, vengono installate le configurazioni ContextHub predefinite, che sostituiscono quelle esistenti. Il backup è necessario per conservare le modifiche o le aggiunte apportate.

Le configurazioni ContextHub sono archiviate in una cartella denominata contexthub nei seguenti nodi:

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

Dopo un aggiornamento, il backup viene archiviato in una cartella denominata contexthub sotto un nodo denominato:

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

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

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

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