Guida all’implementazione della ricerca semplice simple-search-implementation-guide

Come interrompere la reindicizzazione?

La reindicizzazione può essere interrotta tramite la voce MBean IndexStats disponibile tramite Console web AEM > JMX

• http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

  • Eseguire abortAndPause() per interrompere la reindicizzazione. L'indice verrà bloccato per essere reindicizzato finché non verrà richiamato resume().
  • L'esecuzione di resume() riavvierà il processo di indicizzazione.

• Documentazione: https://jackrabbit.apache.org/oak/docs/query/indexing.html#async-index-mbean

In che modo gli indici OAK supportano più tenant?

Oak supporta il posizionamento di indici all’interno della struttura del contenuto e questi indici indicizzeranno solo all’interno di tale sottostruttura. Ad esempio, è possibile creare /content/site-a/oak:index/cqPageLucene per indicizzare il contenuto solo in /content/site-a.

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

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

Le considerazioni relative a questo approccio sono le seguenti:

• Le query DEVONO specificare una restrizione di percorso uguale all'ambito del percorso di query dell'indice oppure essere discendenti di.
• Anche indici con ambito più ampio (ad esempio /oak:index/cqPageLucene) indicizzeranno i dati, con conseguente inserimento di duplicati e costo di utilizzo del disco.
• Può essere necessaria una gestione duplicativa della configurazione (ad es. l’aggiunta degli stessi indexRules a più indici tenant se questi devono soddisfare gli stessi set di query)
• Questo approccio è consigliato sul livello Publish dell’AEM per la ricerca personalizzata del sito, in quanto nell’Autore dell’AEM è comune che le query vengano eseguite in alto nella struttura del contenuto per tenant diversi (ad esempio, tramite OmniSearch); definizioni di indice diverse possono causare comportamenti diversi solo in base alla restrizione del percorso.

Dove si trova un elenco di tutti gli analizzatori disponibili?

Oak espone un set di elementi di configurazione dell’analizzatore forniti da Lucene da utilizzare nell’AEM.

• Documentazione di Apache Oak Analyzers

  • Tokenizer
  • Filtri
  • CharFilters

Come cercare pagine e Assets nella stessa query?

Una novità di AEM 6.3 è la possibilità di eseguire query per più tipi di nodo nella stessa query fornita. La seguente query QueryBuilder. Si noti che ogni "sottoquery" può risolvere nel proprio indice, quindi in questo esempio la sottoquery cq:Page viene risolta in /oak:index/cqPageLucene e la sottoquery dam:Asset 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 piano di query e query seguente:

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 plug-in Chrome.

Come eseguire ricerche in più percorsi nella stessa query?

Una novità di AEM 6.3 è la possibilità di eseguire query su più percorsi nella stessa query fornita. La seguente query QueryBuilder. Tieni presente che ogni "sottoquery" può risolvere nel 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 piano di query e query seguente

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 plug-in Chrome.