Configurazione di ContextHub configuring-contexthub

ContextHub è un framework per l’archiviazione, la manipolazione e la presentazione dei dati contestuali. Per ulteriori dettagli su ContextHub, vedi Panoramica per gli sviluppatori ContextHub.

Puoi configurare la barra degli strumenti di ContextHub per controllare se viene visualizzata in modalità Anteprima, per creare store ContextHub e aggiungere moduli di interfaccia utente.

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.

Barra degli strumenti di ContextHub

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, seleziona Strumenti > Siti > Context Hub.

  2. Seleziona il Contenitore di configurazione predefinito.

  3. Seleziona la configurazione Context Hub.

  4. Seleziona il pulsante Crea, quindi seleziona Modalità interfaccia utente Context Hub.

    Aggiungi modalità interfaccia utente

  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. Seleziona 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.location
Visualizza la latitudine e la longitudine del client e la posizione su una mappa. Consente di modificare la posizione.
geolocation
contexthub.screen-orientation
Visualizza l'orientamento dello schermo del dispositivo (orizzontale o verticale)
emulators
contexthub.tagcloud
Visualizza le statistiche sui tag pagina
tagcloud
granite.profile
Visualizza le informazioni sul profilo per l'utente corrente, inclusi authorizableID, displayName e familyName. È possibile modificare il valore di displayName e familyName.
profile
  1. Nella barra degli Experienci Manager, seleziona Strumenti > Siti > ContextHub.

  2. Seleziona il Contenitore di configurazione a cui desideri aggiungere un modulo di interfaccia utente.

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

  4. Seleziona la modalità dell’interfaccia utente a cui stai aggiungendo il modulo dell’interfaccia utente.

  5. Seleziona il pulsante Crea, quindi seleziona Modulo interfaccia utente ContextHub (generico).

    Modulo interfaccia utente ContextHub

  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. Seleziona 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
contexthub.geolocation
Memorizza la latitudine e la longitudine della posizione del browser.
granite.emulators
Definisce proprietà e funzionalità per diversi dispositivi e rileva il dispositivo client corrente
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
  1. Nella barra degli Experienci Manager, seleziona Strumenti > Siti > ContextHub.

  2. Seleziona il contenitore di configurazione predefinito.

  3. Seleziona configurazione Contexthub

  4. Per aggiungere un archivio, seleziona l’icona Crea, quindi seleziona Configurazione archivio ContextHub.

    Configurazione archivio ContextHub

  5. Immetti i valori per le proprietà di configurazione di base, quindi seleziona Successivo:

    • 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. Seleziona 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-javascript
    {
     "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:

Archivio ContextHub MD5

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-javascript
    {
     "icon": "coral-Icon--data",
     "title": "MD5 Conversion",
     "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 seleziona Strumenti > Siti > ContextHub
  2. Seleziona il contenitore configurazione predefinito
  3. Seleziona la configurazione ContextHub e seleziona Modifica elemento selezionato
  4. Seleziona Debug e seleziona Salva

Via CRXDE via-crxde

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

  • /conf/global/settings/cloudsettings o
  • /conf/<site>/settings/cloudsettings

Registrazione dei messaggi di debug per ContextHub logging-debug-messages-for-contexthub

Configura il servizio OSGi Adobe Granite ContextHub (PID = com.adobe.granite.contexthub.impl.ContextHubImpl) per registrare i messaggi di debug dettagliati che sono utili durante lo sviluppo.

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

  • Console web: per registrare i messaggi di debug, seleziona la proprietà Debug.
  • Nodo JCR: per registrare i messaggi di debug, impostare la proprietà booleana com.adobe.granite.contexthub.debug su true.

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

Disabilitazione di ContextHub disabling-contexthub

ContextHub può essere disabilitato per impedirgli di caricare js/css e di inizializzare. Sono disponibili due opzioni per disabilitare ContextHub:

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

    1. Nella barra seleziona Strumenti > Siti > ContextHub
    2. Seleziona il contenitore configurazione predefinito
    3. Seleziona la configurazione ContextHub e seleziona Modifica elemento selezionato
    4. Seleziona Disattiva ContextHub e seleziona Salva

oppure

  • Utilizzare CRXDE Lite per impostare la proprietà disabled su true in /conf/global/settings/cloudsettings/<configName>/contexthub
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab