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.

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:

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:

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

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.

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.

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:

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:

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à:

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

Via CRXDE via-crxde

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

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.

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:

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: