Search Essentials search-essentials

Panoramica overview

La funzione di ricerca è una caratteristica essenziale delle community Adobe Experience Manager (AEM). Oltre alle funzionalità di ricerca per piattaforma AEM, AEM Communities fornisce API di ricerca UGC per la ricerca di contenuti generati dagli utenti (UGC, User-Generated Content). UGC ha proprietà univoche in quanto viene immesso e memorizzato separatamente dagli altri contenuti e dati utente dell’AEM.

Per le comunità, le due cose generalmente cercate sono:

Questa sezione della documentazione è interessante per gli sviluppatori che creano componenti personalizzati per la creazione o la gestione di contenuti generati dagli utenti (UGC, User-Generated Content).

Sicurezza e nodi ombra security-and-shadow-nodes

Per un componente personalizzato, è necessario utilizzare i metodi SocialResourceUtilities. I metodi di utilità che creano e cercano UGC stabiliscono i nodi shadow richiesti e garantiscono che il membro disponga delle autorizzazioni corrette per la richiesta.

Ciò che non viene gestito tramite le utility SRP sono proprietà relative alla moderazione.

Per informazioni sui metodi di utilità utilizzati per accedere ai nodi shadow UGC e ACL, vedere SRP e UGC Essentials.

API di ricerca UGC ugc-search-api

L'archivio comune UGC è fornito da uno dei vari provider di risorse di archiviazione (SRP), ciascuno con un linguaggio di query nativo diverso. Pertanto, indipendentemente dall'SRP scelto, il codice personalizzato deve utilizzare i metodi del pacchetto API UGC (com.adobe.cq.social.ugc.api) che richiama il linguaggio di query appropriato per l'SRP scelto.

Ricerche ASRP asrp-searches

Per ASRP, UGC è archiviato nel cloud Adobe. Anche se UGC non è visibile in CRX, moderation è disponibile sia dall'ambiente di authoring che da quello di Publish. L'utilizzo dell'API di ricerca UGC funziona per ASRP allo stesso modo degli altri SRP.

Al momento non esistono strumenti per la gestione delle ricerche ASRP.

Durante la creazione di proprietà personalizzate ricercabili, è necessario rispettare i requisiti di denominazione.

Ricerche MSRP msrp-searches

Per MSRP, UGC è archiviato in MongoDB configurato per l'utilizzo di Solr per la ricerca. UGC non è visibile in CRX, ma moderation è disponibile sia dall'ambiente di authoring che da quello di Publish.

Per quanto riguarda MSRP e Solr:

Le funzionalità di ricerca personalizzate devono utilizzare l'API di ricerca UGC.

Durante la creazione di proprietà personalizzate ricercabili, è necessario rispettare i requisiti di denominazione.

Ricerche JSRP jsrp-searches

Per JSRP, UGC è archiviato in Oak ed è visibile solo nell'archivio dell'istanza di Publish o di creazione AEM in cui è stato immesso.

Poiché UGC viene in genere immesso nell'ambiente Publish, per i sistemi di produzione con più editori è necessario configurare un cluster di pubblicazione 🔗, non una farm di pubblicazione, in modo che il contenuto immesso sia visibile da tutti gli editori.

Per JSRP, le voci UGC immesse nell’ambiente Publish non sono mai visibili nell’ambiente di authoring. Pertanto, tutte le attività di moderazione si svolgono nell'ambiente Publish.

Le funzionalità di ricerca personalizzate devono utilizzare l'API di ricerca UGC.

Indicizzazione Oak oak-indexing

Sebbene gli indici Oak non vengano creati automaticamente per la ricerca della piattaforma AEM, a partire dalla versione 6.2 dell’AEM sono stati aggiunti per consentire ad AEM Communities di migliorare le prestazioni e supportare l’impaginazione durante la presentazione dei risultati della ricerca UGC.

Se le proprietà personalizzate sono in uso e le ricerche sono lente, è necessario creare indici aggiuntivi per le proprietà personalizzate per renderle più performanti. Per mantenere la portabilità, attieniti ai requisiti di denominazione durante la creazione di proprietà personalizzate ricercabili.

Per modificare gli indici esistenti o creare indici personalizzati, vedere Query e indicizzazione di Oak.

Gestione indice Oak è disponibile da ACS AEM Commons. Esso prevede:

Per visualizzare gli indici Oak esistenti in CRXDE Liti, il percorso è:

Proprietà ricerca indicizzata indexed-search-properties

Proprietà di ricerca predefinite default-search-properties

Di seguito sono riportate alcune delle proprietà ricercabili utilizzate per varie funzioni di Communities:

Denominazione delle proprietà personalizzate naming-of-custom-properties

Quando si aggiungono proprietà personalizzate, affinché siano visibili agli ordinamenti e alle ricerche creati con UGC search API, è obbligatorio aggiungere un suffisso al nome della proprietà.

Il suffisso è per i linguaggi di query che utilizzano uno schema:

Solr è un esempio di linguaggio di query che utilizza uno schema.

Note:

Filtri filters

I componenti, che includono il sistema di commenti, supportano il parametro di filtro oltre ai relativi endpoint.

La sintassi del filtro per la logica AND e OR è espressa come segue (visualizzata prima dell’URL codificato):

L'implementazione predefinita del componente Ricerca utilizza questa sintassi, come riportato nell'URL che apre la pagina Risultati ricerca nella guida dei componenti community. Per fare delle prove, passa a http://localhost:4503/content/community-components/en/search.html.

Gli operatori filtro sono:

È importante che l’URL faccia riferimento al componente Communities (risorsa) e non alla pagina in cui il componente viene inserito:

Strumenti SRP srp-tools

Esiste un progetto GitHub Adobe Experience Cloud che contiene:

Strumenti AEM Communities SRP

Questo archivio contiene strumenti per la gestione dei dati in SRP.

Attualmente, esiste un servlet che può eliminare tutti i contenuti UGC da qualsiasi SRP.

Ad esempio, per eliminare tutti i contenuti generati dagli utenti (UGC) in ASRP:

curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin

Risoluzione dei problemi troubleshooting

Query Solr solr-query

Per facilitare la risoluzione dei problemi relativi a una query Solr, abilitare la registrazione DEBUG per

com.adobe.cq.social.srp.impl.SocialSolrConnector.

La query Solr effettiva viene visualizzata con l’URL codificato nel registro di debug:

Query da solr: sort=timestamp+desc&bl=en&pl=en&start=0&rows=10 &q=%2Btitle_t:(hello)+%2Bprovider_id:\/content/usergenerated/asi/mongo/content/+%2Bresource_type_s:&df=provider_id&trf=verbatim&fq={!cost%3D100}report_suite:mongo

Il valore del parametro q è la query. Una volta decodificata la codifica URL, la query può essere passata allo strumento Solr Admin Query per ulteriori operazioni di debug.

Risorse correlate related-resources