Essentiële zoekopdrachten search-essentials
Overzicht overview
De zoekfunctie is een essentieel onderdeel van AEM Communities. Naast de AEM zoeken mogelijkheden biedt AEM Communities UGC-zoekAPI voor het zoeken van door gebruikers gegenereerde inhoud (UGC). UGC heeft unieke eigenschappen omdat deze afzonderlijk van andere AEM inhoud en gebruikersgegevens wordt ingevoerd en opgeslagen.
Voor Gemeenschappen zijn de twee dingen die over het algemeen worden doorzocht:
-
Inhoud geplaatst door leden van de gemeenschap
- Gebruikt de UGC-zoekAPI van AEM Communities
-
Gebruikers en gebruikersgroepen (gebruikersgegevens)
- Gebruikt de zoekmogelijkheden van het AEM platform
Deze sectie van de documentatie is van belang voor ontwikkelaars die douanecomponenten creëren die tot UGC leiden of leiden.
Beveiligings- en schaduwknooppunten security-and-shadow-nodes
Voor een aangepaste component moet u de opdracht SocialResourceUtilities methoden. De nutsmethodes die tot en onderzoek naar UGC leiden zullen de vereiste vestigen schaduwknooppunten en ervoor zorgen dat het lid de juiste machtigingen voor het verzoek heeft.
Wat niet door de nut SRP wordt beheerd zijn eigenschappen met betrekking tot matiging.
Zie SRP en UGC Essentials voor informatie betreffende nutsmethodes die worden gebruikt om tot UGC en ACL schaduwknopen toegang te hebben.
UGC-zoekAPI ugc-search-api
De UGC Common Store wordt verstrekt door één van een verscheidenheid van opslagmiddelleveranciers (SRPs), elk misschien verschillend inheemse vraagtaal. Daarom, ongeacht het gekozen SRP, zou de douanecode methodes van moeten gebruiken UGC API-pakket (com.adobe.cq.social.ugc.api) die de vraagtaal aangewezen voor gekozen SRP zal aanhalen.
ASRP-zoekopdrachten asrp-searches
Voor ASRP, wordt UGC opgeslagen in de Adobe-cloud. Hoewel UGC niet zichtbaar is in CRX, matiging is beschikbaar in zowel de auteur- als de publicatieomgeving. Het gebruik van de UGC-zoekAPI werkt voor ASRP het zelfde als voor andere SRPs.
De hulpmiddelen bestaan momenteel niet voor het beheren van de onderzoeken van ASRP.
Wanneer u aangepaste eigenschappen maakt die doorzoekbaar zijn, moet u zich aan de naamgevingsvereisten.
MSRP-zoekopdrachten msrp-searches
Voor MSRP, wordt UGC opgeslagen in MongoDB wordt gevormd om Solr voor het zoeken te gebruiken. UGC is niet zichtbaar in CRX, maar matiging is beschikbaar in zowel de auteur- als de publicatieomgeving.
Wat MSRP en Solr betreft:
- Ingesloten Solr voor het AEM platform wordt niet gebruikt voor MSRP
- Als het gebruiken van verre Solr voor het AEM platform, kan het met MSRP worden gedeeld, maar zij zouden verschillende inzamelingen moeten gebruiken
- Solr kan worden gevormd voor standaardonderzoek of voor meertalig onderzoek (MLS)
- Voor configuratiedetails, zie Solr-configuratie voor MSRP
Voor aangepaste zoekfuncties moet u de opdracht UGC-zoekAPI.
Wanneer u aangepaste eigenschappen maakt die doorzoekbaar zijn, moet u zich aan de naamgevingsvereisten.
JSRP-zoekopdrachten jsrp-searches
Voor JSRP, UGC wordt opgeslagen in Eik en is alleen zichtbaar in de gegevensopslagruimte van de AEM auteur of het publicatieexemplaar waarop het is ingevoerd.
Aangezien UGC typisch in het publicatiemilieu, voor multi-uitgeversproductiesystemen is ingegaan, is het noodzakelijk om een publicatiecluster, niet een publicatiecentrum, zodat de ingevoerde inhoud zichtbaar is voor alle uitgevers.
Voor JSRP, zal UGC ingegaan in het publicatiemilieu nooit in het auteursmilieu zichtbaar zijn. Aldus matiging taken vinden plaats in de publicatieomgeving.
Voor aangepaste zoekfuncties moet u de opdracht UGC-zoekAPI.
Oak-indexering oak-indexing
Hoewel er niet automatisch eiken-indices worden gemaakt voor het zoeken naar AEM platform, zijn deze vanaf AEM 6.2 toegevoegd voor AEM Communities om de prestaties te verbeteren en paginering te ondersteunen bij de presentatie van UGC-zoekresultaten.
Als aangepaste eigenschappen in gebruik zijn en zoekacties traag zijn, moeten aanvullende indexen voor de aangepaste eigenschappen worden gemaakt om deze beter te laten presteren. Om draagbaarheid te behouden, dient u zich aan de naamgevingsvereisten wanneer u aangepaste eigenschappen maakt die doorzoekbaar zijn.
Als u bestaande indexen wilt wijzigen of aangepaste indexen wilt maken, raadpleegt u Oak-query's en indexering.
De Indexbeheer voor onak is beschikbaar bij ACS AEM Commons. Het voorziet in:
- Een weergave van bestaande indexen
- De mogelijkheid om een nieuwe indexering te starten
Bestaande eiken-indexen weergeven in CRXDE Lite, is de locatie:
/oak:index/socialLucene
Eigenschappen van Geïndexeerde zoekopdracht indexed-search-properties
Standaardzoekeigenschappen default-search-properties
Hieronder vindt u een aantal van de doorzoekbare eigenschappen die worden gebruikt voor verschillende functies van de Gemeenschappen:
Naamgeving van aangepaste eigenschappen naming-of-custom-properties
Wanneer u aangepaste eigenschappen toevoegt, zodat deze eigenschappen zichtbaar zijn voor sorteren en zoeken die zijn gemaakt met de opdracht UGC-zoekAPI, is het *required *om een achtervoegsel aan de bezitsnaam toe te voegen.
Het achtervoegsel is voor vraagtalen die een schema gebruiken:
- Het identificeert de eigenschap als doorzoekbaar
- Het identificeert het gegevenstype
Solr is een voorbeeld van een vraagtaal die een schema gebruikt.
Opmerkingen:
-
Tekst een getokeniseerde tekenreeks is, String is niet. Gebruiken Tekst voor vage (meer als dit) zoekopdrachten.
-
Voeg voor typen met meerdere waarden "s" toe aan het achtervoegsel, bijvoorbeeld:
viewDate_dt
: single date, eigenschapviewDates_dts
: list of dates, eigenschap
Filters filters
Onderdelen die de opmerkingssysteem ondersteunen de filterparameter als aanvulling op de eindpunten.
De filtersyntaxis voor AND en OR logica wordt als volgt uitgedrukt (getoond alvorens URL wordt gecodeerd):
-
U kunt als volgt één filterparam met door komma's gescheiden waarden opgeven OF gebruiken:
filter=name eq 'Jennifer',name eq 'Jen'
-
Meerdere filterparams opgeven EN gebruiken:
filter = name eq 'Jackson'&filter=message eq 'testing'
De standaardimplementatie van de component Zoeken gebruikt deze syntaxis zoals u kunt zien in de URL waarmee de pagina Zoekresultaten wordt geopend in het dialoogvenster Community Components Guide. Als u wilt experimenteren, bladert u naar http://localhost:4503/content/community-components/en/search.html.
Filteroperatoren zijn:
Het is belangrijk dat de URL verwijst naar de communautaire component (bron) en niet naar de pagina waarop de component is geplaatst:
- Juist: forumcomponent
/content/community-components/en/forum/jcr:content/content/forum.social.json
- Onjuist: forumpagina
/content/community-components/en/forum.social.json
SRP srp-tools
Er is een project Adobe Marketing Cloud GitHub dat bevat:
Deze opslagplaats bevat hulpmiddelen voor het beheren van gegevens in SRP.
Momenteel, is er één servlet die de capaciteit verstrekt om al UGC van om het even welk SRP te schrappen.
Bijvoorbeeld, om al UGC in ASRP te schrappen:
curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin
Problemen oplossen troubleshooting
Solr-query solr-query
Om problemen met een Solr vraag problemen op te lossen, laat het registreren DEBUG voor toe
com.adobe.cq.social.srp.impl.SocialSolrConnector
.
De daadwerkelijke Solr vraag zal URL worden getoond die in zuivert logboek wordt gecodeerd:
Zoekopdracht voor solderen is: 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
De waarde van de q
parameter is de query. Zodra het coderen URL wordt gedecodeerd, kan de vraag tot het Solr hulpmiddel van de Vraag Admin voor verdere het zuiveren worden overgegaan.
Gerelateerde bronnen related-resources
- Opslag van communautaire inhoud - Bespreekt de beschikbare SRP keuzen voor een gemeenschappelijk opslag UGC
- Overzicht opslagbronprovider - Inleiding en overzicht van het gebruik van opslagruimten
- Toegang tot UGC met SRP - Codeerrichtsnoeren
- SocialUtils Refactoring - Hulpprogrammamethoden voor SRP die SocialUtils vervangen
- Componenten met zoekresultaten - UGC-zoekfunctie toevoegen aan een sjabloon