Guida all’implementazione per semplici ricerche

L'implementazione della ricerca semplice è costituita dai materiali del laboratorio di Adobe Summit AEM Search Demystified. Questa pagina contiene i materiali di questo laboratorio. Per una visita guidata del laboratorio, vedere la cartella di lavoro Lab nella sezione Presentazione di questa pagina.

Materiali di presentazione

• Cartella di lavoro Lab
• Presentazione

Segnalibri

Strumenti

• Gestione indice
• Spiega query
• CRXDE Lite > /oak:index/cqPageLucene
• Gestione pacchetti CRX
• Debugger di QueryBuilder
• Generatore di definizione dell'indice Oak

Capitoli

I collegamenti riportati di seguito presuppongono l’installazione dei pacchetti iniziali su AEM Author all’indirizzohttp://localhost:4502

• Capitolo 1
• Capitolo 2
• Capitolo 3
• Capitolo 4
• Capitolo 5
• Capitolo 6
• Capitolo 7
• Capitolo 8
• Capitolo 9

Pacchetti

Pacchetti iniziali

• Tag
• Pacchetto applicazione di ricerca semplice

Colli per capitolo

• Soluzione del capitolo 1
• Soluzione del capitolo 2
• Capitolo 3: soluzione
• Capitolo 4 soluzione
• Capitolo 5
• Capitolo 5 soluzione
• Capitolo 6 soluzione
• Capitolo 9 soluzione

Materiali di riferimento

• Archivio Github
• Modelli Sling
• Esportatore di modelli Sling
• API di QueryBuilder
• Plug-in AEM Chrome (pagina Documentazione)

Correzioni e follow-up

Correzioni e chiarimenti dalle discussioni di laboratorio e risposte alle domande successive dei partecipanti.

1. Come interrompere la reindicizzazione?

   La reindicizzazione può essere arrestata tramite la MBean IndexStats disponibile tramite AEM console Web > JMX

   • http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats
     • Esegui abortAndPause() per interrompere la reindicizzazione. Questo blocca l'indice per un'ulteriore reindicizzazione fino a quando resume() non viene richiamato.
     • L'esecuzione di resume() riavvierà il processo di indicizzazione.
   • Documentazione: https://jackrabbit.apache.org/oak/docs/query/indexing.html#async-index-mbean

2. Come possono gli indici oak supportare più tenant?

   Oak supporta il posizionamento di indici attraverso la struttura del contenuto, e questi indici si indicizzeranno solo all’interno di tale sottoalbero. Ad esempio, /content/site-a/oak:index/cqPageLucene può essere creato per indicizzare il contenuto solo sotto /content/site-a.

   Un approccio equivalente consiste nell'utilizzare le proprietà includePaths e queryPaths su un indice in /oak:index. Esempio:

   • /oak:index/siteAcqPageLucene@includePaths=/content/site-a
   • /oak:index/siteAcqPageLucene@queryPaths=/content/site-a

   Le considerazioni di questo approccio sono le seguenti:

   • Le query DEVONO specificare una restrizione del percorso che sia uguale all'ambito del percorso di query dell'indice, o essere un discendente di.
   • Gli indici con ambito più ampio (ad esempio /oak:index/cqPageLucene) indicizzeranno anche i dati, con conseguente inserimento di duplicati e costo di utilizzo del disco.
   • Può essere necessaria la gestione della configurazione duplicativa (ad esempio, aggiungi le stesse regole di indice su più indici tenant se devono soddisfare gli stessi set di query)
   • Questo approccio è più adatto al livello di pubblicazione di AEM per la ricerca di siti personalizzati, come in AEM Author, è comune che le query vengano eseguite ad alto livello nella struttura dei contenuti per tenant diversi (ad esempio, tramite OmniSearch) - diverse definizioni di indice possono causare comportamenti diversi in base solo alla restrizione del percorso.

3. Dove si trova un elenco di tutti gli analizzatori disponibili?

   Oak espone un set di elementi di configurazione dell'analizzatore lucene-fornisce da utilizzare in AEM.

   • Documentazione di Apache Oak Analyzers
     • Token
     • Filtri
     • CharFilters

4. Come cercare pagine e risorse nella stessa query?

   La novità di AEM 6.3 è la capacità di eseguire query per più tipi di nodo nella stessa query fornita. La seguente query QueryBuilder. Tieni presente che ogni "sottoquery" può risolvere il proprio indice, pertanto in questo esempio la sottoquery cq:Page viene risolta in /oak:index/cqPageLucene e la sottoquery dam:Asset viene risolta in /oak:index/damAssetLucene.

   group.p.or=true
   group.1_group.type=cq:Page
   # add all page restrictions to this group
   group.2_group.type=dam:Asset
   # add all asset restrictions to this group
   

   restituisce il seguente piano di query e query:

   QUERY:(//element(*, cq:Page) | //element(*, dam:Asset))
   
   PLAN: [cq:Page] as [a] /* lucene:cqPageLucene(/oak:index/cqPageLucene) *:* */ union [dam:Asset] as [a] /* lucene:damAssetLucene(/oak:index/damAssetLucene) *:* */
   

   Esplora la query e i risultati tramite QueryBuilder Debugger e AEM Chrome Plug-in.

5. Come eseguire la ricerca su più percorsi nella stessa query?

   La novità di AEM 6.3 è la capacità di eseguire query su più percorsi nella stessa query fornita. La seguente query QueryBuilder. Tieni presente che ogni "sottoquery" può risolvere al proprio indice.

   group.p.or=true
   group.1_group.type=cq:Page
   group.1_group.path=/content/docs/en/6-2
   # add all page restrictions to this group
   group.2_group.type=cq:Page
   group.2_group.path=/content/docs/en/6-3
   # add all asset restrictions to this group
   

   restituisce il seguente piano di query

   QUERY: (/jcr:root/content/docs/en/_x0036_-2//element(*, cq:Page) | /jcr:root/content/docs/en/_x0036_-3//element(*, cq:Page))
   
   PLAN: [cq:Page] as [a] /* traverse "/content/docs/en/6-2//*" where isdescendantnode([a], [/content/docs/en/6-2]) */ union [cq:Page] as [a] /* traverse "/content/docs/en/6-3//*" where isdescendantnode([a], [/content/docs/en/6-3]) */
   

   Esplora la query e i risultati tramite QueryBuilder Debugger e AEM Chrome Plug-in.