Aggiunta di ContextHub alle pagine e accesso ai negozi adding-contexthub-to-pages-and-accessing-stores
Aggiungi ContextHub alle tue pagine per abilitare le funzionalità di ContextHub e per effettuare il collegamento alle librerie Javascript di ContextHub
L’API Javascript di ContextHub fornisce l’accesso ai dati contestuali gestiti da ContextHub. Questa pagina descrive brevemente le funzioni principali dell’API per l’accesso e la manipolazione dei dati contestuali. Segui i collegamenti alla documentazione di riferimento API per visualizzare informazioni dettagliate ed esempi di codice.
Aggiunta di ContextHub a un componente pagina adding-contexthub-to-a-page-component
Per abilitare le funzioni ContextHub e per effettuare il collegamento alle librerie Javascript di ContextHub, includi il componente contexthub nel head della pagina. Il codice JSP per il componente pagina è simile al seguente esempio:
<head>
<sling:include path="contexthub" resourceType="granite/contexthub/components/contexthub" />
</head>
È inoltre necessario configurare se la barra degli strumenti di ContextHub viene visualizzata in modalità Anteprima. Vedi Mostrare e nascondere l’interfaccia utente di ContextHub.
Informazioni sugli archivi ContextHub about-contexthub-stores
Utilizza gli archivi ContextHub per mantenere i dati contestuali. ContextHub fornisce i seguenti tipi di archivi che costituiscono la base di tutti i tipi di store:
Tutti i tipi di archivio sono estensioni del ContextHub.Store.Core classe. Per informazioni sulla creazione di un nuovo tipo di archivio, consulta Creazione di store personalizzati. Per informazioni sui tipi di archivio di esempio, consulta Candidati allo store ContextHub di esempio.
Modalità di persistenza persistence-modes
Gli archivi di Context Hub utilizzano una delle seguenti modalità di persistenza:
- Locale: Utilizza HTML5 localStorage per mantenere i dati. L'archiviazione locale viene mantenuta sul browser in più sessioni.
- Sessione: Utilizza HTML5 sessionStorage per mantenere i dati. L’archiviazione della sessione viene mantenuta per tutta la durata della sessione del browser ed è disponibile per tutte le finestre del browser.
- Cookie: Utilizza il supporto nativo dei cookie del browser per l'archiviazione dei dati. I dati dei cookie vengono inviati a e dal server nelle richieste HTTP.
- Window.name: Utilizza la proprietà window.name per mantenere i dati.
- Memoria: Utilizza un oggetto Javascript per mantenere i dati.
Per impostazione predefinita, Context Hub utilizza la modalità di persistenza locale. Se il browser non supporta o consente HTML5 localStorage, viene utilizzata la persistenza della sessione. Se il browser non supporta o consente HTML5 sessionStorage, viene utilizzata la persistenza Window.name.
Dati store store-data
All’interno, archiviare i dati forma una struttura ad albero, consentendo l’aggiunta di valori come tipi principali o oggetti complessi. Quando si aggiungono oggetti complessi agli archivi, le proprietà dell'oggetto vengono aggiunte ai rami della struttura dati. Ad esempio, il seguente oggetto complesso viene aggiunto a un archivio vuoto denominato location:
Object {
number: 321,
data: {
city: "Basel",
country: "Switzerland",
details: {
population: 173330,
elevation: 260
}
}
}
La struttura ad albero dei dati archiviati può essere concettualizzata come segue:
/
|- number
|- data
|- city
|- country
|- details
|- population
|- elevation
La struttura ad albero definisce gli elementi dati nell’archivio come coppie chiave/valore. Nell’esempio precedente, la chiave /number corrisponde al valore 321e la chiave /data/country corrisponde al valore Switzerland.
Manipolazione degli oggetti manipulating-objects
ContextHub fornisce ContextHub.Utils.JSON.tree Classe per la manipolazione di oggetti JavaScript. Utilizzare le funzioni di questa classe per manipolare gli oggetti Javascript prima di aggiungerli a uno store o dopo averli ottenuti da uno store.
Inoltre, la ContextHub.Utils.JSON Questa classe fornisce funzioni per la serializzazione degli oggetti alle punture e la deserializzazione delle stringhe agli oggetti. Usa questa classe per gestire i dati JSON per supportare i browser che non includono in modo nativo i JSON.parse e JSON.stringify funzioni.
Interazione con gli archivi ContextHub interacting-with-contexthub-stores
Utilizza la ContextHub Oggetto JavaScript per ottenere un archivio come oggetto Javascript. Una volta ottenuto l'oggetto Store è possibile manipolare i dati contenuti. Utilizza la getAllStores o getStore per ottenere lo store.
Accesso ai dati dell’archivio accessing-store-data
La ContexHub.Store.Core La classe JavaScript definisce diverse funzioni per l'interazione con i dati dell'archivio. Le seguenti funzioni memorizzano e recuperano più elementi dati contenuti negli oggetti:
I singoli elementi dati sono memorizzati come un insieme di coppie chiave/valore. Per memorizzare e recuperare i valori si specifica la chiave corrispondente:
I candidati all’archivio personalizzati possono definire funzioni aggiuntive che consentono l’accesso ai dati archiviati.
Evento ContextHub contexthub-eventing
ContextHub include un framework di eventi che consente di reagire automaticamente agli eventi archiviati. Ogni oggetto store contiene un ContextHub.Utils.Eventing oggetto disponibile come eventing proprietà. Utilizza la on o once per associare una funzione Javascript a un evento store.
Utilizzo di Context Hub per manipolare i cookie using-context-hub-to-manipulate-cookies
L’API Javascript di Context Hub fornisce supporto cross-browser per la gestione dei cookie del browser. La ContextHub.Utils.Cookie Lo spazio dei nomi definisce diverse funzioni per la creazione, la manipolazione e l’eliminazione dei cookie.
Determinazione dei segmenti ContextHub risolti determining-resolved-contexthub-segments
Il motore di segmenti ContextHub ti consente di determinare quali dei segmenti registrati vengono risolti nel contesto corrente. Utilizzare la funzione getResolvedSegments del ContextHub.SegmentEngine.SegmentManager per recuperare i segmenti risolti. Quindi, utilizza il getName o getPath funzione ContextHub.SegmentEngine.Segment da sottoporre a test per un segmento.
Segmenti installati installed-segments
I segmenti ContextHub sono installati sotto la /conf/we-retail/settings/wcm/segments nodo.
- femmina
- femmina-over-30
- femmina sotto i 30 anni
- maschio
- maschio su 30
- maschio-under-30
- order-value-75-to-100
- order-value-over-100
- oltre 30
- estate
- femminile d'estate
- estate-femminile-over-30
- estate-femminile-under-30
- maschio estivo
- estate-maschio-over-30
- estate-maschio-under-30
- under 30
- inverno
- femminile invernale
- inverno-femmina-over-30
- inverno-femmina-under-30
- maschio invernale
- inverno-maschio-over-30
- inverno-maschio-under-20
Le regole utilizzate per risolvere questi segmenti sono riepilogate come segue:
-
Femmina o maschio è determinato dalla
genderla voce profilo archiviare. -
L’età è determinata dall’elemento dati età dell’archivio profili.
-
La stagionalità è determinata dalla voce dei dati di latitudine del geolocalizzazione e l'elemento dati del mese dell'archivio surferinfo.
Registrazione dei messaggi di debug per ContextHub logging-debug-messages-for-contexthub
Configura il servizio Adobe OSGi ContextHub Granite (PID = com.adobe.granite.contexthub.impl.ContextHubImpl) per registrare messaggi di debug dettagliati utili durante lo sviluppo.
Per configurare il servizio è possibile utilizzare Console web o utilizzare Nodo JCR nell'archivio:
- Console Web: Per registrare i messaggi di debug, selezionare la proprietà Debug.
- Nodo JCR: Per registrare i messaggi di debug, imposta il valore booleano
com.adobe.granite.contexthub.debugproprietà ditrue.
Vedi una panoramica del framework ContextHub see-an-overview-of-the-contexthub-framework
ContextHub fornisce un pagina di diagnostica dove puoi visualizzare una panoramica del framework ContextHub.