Sök i Grundläggande search-essentials

Översikt overview

Sökfunktionen är en viktig funktion i AEM Communities. Förutom AEM AEM Communities har API för UGC-sökning för sökning efter användargenererat innehåll (UGC). UGC har unika egenskaper eftersom de anges och lagras separat från andra AEM och användardata.

För Communities är de två saker som generellt söks igenom:

Det här avsnittet av dokumentationen är av intresse för utvecklare som skapar anpassade komponenter som skapar eller hanterar UGC.

Säkerhets- och skuggnoder security-and-shadow-nodes

För en anpassad komponent måste du använda SocialResourceUtilities metoder. Verktygsmetoderna som skapar och söker efter UGC skapar de nödvändiga skuggnoder och se till att medlemmen har rätt behörigheter för begäran.

Det som inte hanteras via SRP-verktygen är egenskaper som är relaterade till moderering.

Se SRP och UGC Essentials om du vill ha information om verktygsmetoder som används för att komma åt UGC- och ACL-skuggnoder.

API för UGC-sökning ugc-search-api

The UGC-gemensam butik tillhandahålls av en av flera olika lagringsresursleverantörer (SRP), som båda kan ha olika systemspecifika frågespråk. Därför bör anpassad kod, oavsett vald SRP, använda metoder från API-paket för UGC (com.adobe.cq.social.ugc.api) som anropar det frågespråk som är lämpligt för den valda SRP.

ASRP-sökningar asrp-searches

För ASRP, lagras UGC i molnet Adobe. UGC är inte synligt i CRX, moderering är tillgängligt både från författare och publiceringsmiljöer. Användning av API för UGC-sökning fungerar för ASRP på samma sätt som för andra SRP.

Det finns för närvarande inga verktyg för att hantera ASRP-sökningar.

När du skapar anpassade egenskaper som är sökbara måste du följa namngivningskrav.

MSRP-sökningar msrp-searches

För MSRP, lagras UGC i MongoDB som är konfigurerad att använda Solr för sökning. UGC visas inte i CRX, men moderering är tillgängligt både från författare och publiceringsmiljöer.

Om MSRP och Solr:

Anpassade sökfunktioner bör använda API för UGC-sökning.

När du skapar anpassade egenskaper som är sökbara måste du följa namngivningskrav.

JSRP-sökningar jsrp-searches

För JSRP, lagras UGC i Oak och är bara synligt i databasen för den AEM författaren eller publiceringsinstans som den angavs för.

Eftersom UGC vanligtvis används i publiceringsmiljön måste du konfigurera en publiceringskluster, inte en publiceringsgrupp, så att det angivna innehållet visas för alla utgivare.

För JSRP visas aldrig UGC som anges i publiceringsmiljön i författarmiljön. Alla moderering uppgifter utförs i publiceringsmiljön.

Anpassade sökfunktioner bör använda API för UGC-sökning.

Oak-indexering oak-indexing

Även om det inte skapas automatiskt för AEM plattformssökning har de från och med AEM 6.2 lagts till för AEM Communities för att förbättra prestanda och ge stöd för sidnumrering när UGC-sökresultat presenteras.

Om anpassade egenskaper används och sökningarna är långsamma, måste ytterligare index skapas för de anpassade egenskaperna för att de ska bli bättre. Om du vill behålla bärbarheten följer du namngivningskrav när du skapar anpassade egenskaper som är sökbara.

Om du vill ändra befintliga index eller skapa anpassade index läser du Fråga och indexering.

The Oak Index Manager finns på ACS AEM Commons. Den innehåller följande:

Så här visar du de befintliga eknodindexen i CRXDE Lite, platsen är:

Egenskaper för indexerad sökning indexed-search-properties

Egenskaper för standardsökning default-search-properties

Nedan följer några av de sökbara egenskaper som används för olika webbgruppsfunktioner:

Namngivning av anpassade egenskaper naming-of-custom-properties

När du lägger till anpassade egenskaper, för att dessa egenskaper ska vara synliga för sorteringar och sökningar som skapas med API för UGC-sökning, är det *required *för att lägga till ett suffix till egenskapsnamnet.

Suffixet är för frågespråk som använder ett schema:

Solr är ett exempel på ett frågespråk som använder ett schema.

Anteckningar:

Filter filters

Komponenter som innehåller kommentarsystem har stöd för filterparametern som läggs till i slutpunkterna.

Filtersyntaxen för AND- och OR-logiken uttrycks enligt följande (visas innan den är URL-kodad):

Standardimplementeringen av Sökkomponent använder den här syntaxen så som den visas i URL:en som öppnar sidan Sökresultat i Community Components Guide. Om du vill experimentera går du till http://localhost:4503/content/community-components/en/search.html.

Filteroperatorer är:

Det är viktigt att URL:en refererar till komponenten Communities (resursen) och inte till sidan som komponenten är placerad på:

SRP-verktyg srp-tools

Det finns ett Adobe Marketing Cloud GitHub-projekt som innehåller:

AEM Communities SRP Tools

Den här databasen innehåller verktyg för att hantera data i SRP.

För närvarande finns det en serverenhet som kan ta bort all UGC från alla SRP.

Om du till exempel vill ta bort all UGC i ASRP:

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

Felsökning troubleshooting

Solr-fråga solr-query

Aktivera DEBUG-loggning för att felsöka problem med en Solr-fråga

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

Den verkliga Solr-frågan visas URL-adress som är kodad i felsökningsloggen:

Frågan som ska tolkas är: 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

Värdet för q -parametern är frågan. När URL-kodningen har avkodats kan frågan skickas till Solr Admin Query Tool för ytterligare felsökning.

Relaterade resurser related-resources