Configurazione di ContextHub
- Argomenti:
- Sviluppo
- Personalizzazione
Creato per:
- Amministratore
- Sviluppatore
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
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_uisutrue. Per nascondere l'interfaccia utente, impostare la proprietà sufalse.
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
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.
Le icone sono riferimenti dalla libreria di icone dell'interfaccia utente Coral.
Aggiunta di una modalità interfaccia utente
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.
-
Nella barra degli Experienci Manager, seleziona Strumenti > Siti > Context Hub.
-
Seleziona il Contenitore di configurazione predefinito.
-
Seleziona la configurazione Context Hub.
-
Seleziona il pulsante Crea, quindi seleziona Modalità interfaccia utente Context Hub.
-
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
-
Seleziona Salva.
Aggiunta di un modulo interfaccia utente
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.
geolocationemulatorsauthorizableID, displayName e familyName. È possibile modificare il valore di displayName e familyName.profile-
Nella barra degli Experienci Manager, seleziona Strumenti > Siti > ContextHub.
-
Seleziona il Contenitore di configurazione a cui desideri aggiungere un modulo di interfaccia utente.
-
Seleziona o digita la configurazione ContextHub a cui desideri aggiungere il modulo di interfaccia utente.
-
Seleziona la modalità dell’interfaccia utente a cui stai aggiungendo il modulo dell’interfaccia utente.
-
Seleziona il pulsante Crea, quindi seleziona Modulo interfaccia utente ContextHub (generico).
-
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
-
(Facoltativo) Per ignorare la configurazione predefinita dell’archivio, immetti un oggetto JSON per configurare il modulo interfaccia utente.
-
Seleziona Salva.
Creazione di un archivio ContextHub
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
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
L’AEM fornisce i seguenti esempi di store candidati su cui puoi basare un negozio.
-
Nella barra degli Experienci Manager, seleziona Strumenti > Siti > ContextHub.
-
Seleziona il contenitore di configurazione predefinito.
-
Seleziona configurazione Contexthub
-
Per aggiungere un archivio, seleziona l’icona Crea, quindi seleziona Configurazione archivio ContextHub.
-
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
-
(Facoltativo) Per ignorare la configurazione predefinita dell’archivio, immetti un oggetto JSON nella casella Configurazione dettaglio (JSON).
-
Seleziona Salva.
Esempio: utilizzo di un servizio JSONP
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
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):
{ "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
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:
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):
{ "icon": "coral-Icon--data", "title": "MD5 Conversion", "storeMapping": { "md5": "md5" }, "template": "<p> {{md5.original}}</p>; <p>{{md5.md5}}</p>" }
Debug di 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
Modifica la configurazione di ContextHub e seleziona l'opzione Debug
- Nella barra seleziona Strumenti > Siti > ContextHub
- Seleziona il contenitore configurazione predefinito
- Seleziona la configurazione ContextHub e seleziona Modifica elemento selezionato
- Seleziona Debug e seleziona Salva
Via CRXDE
Utilizzare CRXDE Lite per impostare la proprietà debug su true in:
/conf/global/settings/cloudsettingso/conf/<site>/settings/cloudsettings
Registrazione dei messaggi di debug per 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.debugsutrue.
Modalità silenziosa
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.
- Apri la configurazione console Web Adobe Experience Manager in
http://<host>:<port>/system/console/configMgr - Cerca Adobe Granite ContextHub
- Fai clic sulla configurazione Adobe Granite ContextHub per modificarne le proprietà
- Seleziona l'opzione Modalità silenziosa e fai clic su Salva
Disabilitazione di 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
- Nella barra seleziona Strumenti > Siti > ContextHub
- Seleziona il contenitore configurazione predefinito
- Seleziona la configurazione ContextHub e seleziona Modifica elemento selezionato
- Seleziona Disattiva ContextHub e seleziona Salva
oppure
- Utilizzare CRXDE Lite per impostare la proprietà
disabledsu true in/conf/global/settings/cloudsettings/<configName>/contexthub