Essentiële zoekopdrachten search-essentials

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

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

chlimage_1-235

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:

Eigenschap
Gegevenstype
isFlagged
Boolean
isSpam
Boolean
lezen
Boolean
invloed
Boolean
bijlagen
Boolean
sentiment
Lang
gemarkeerd
Boolean
added
Datum
modifiedDate
Datum
state
String
userIdentifier
String
antwoorden
Lang
jcr:titel
String
jcr:beschrijving
String
sling:resourceType
String
allowThreadedReply
Boolean
isDraft
Boolean
publishDate
Datum
publishJobId
String
beantwoord
Boolean
chosenanswer
Boolean
tag
String
cq:Tag
String
maker_display_name
String
location_t
String
parentPath
String
parentTitle
String

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.

Achtervoegsel
Gegevenstype
_b
Boolean
_dt
Kalender
_d
Dubbel
_tl
Lang
_s
String
_t
Tekst

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, eigenschap
    • viewDates_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:

EQ
equals
NE
niet gelijk aan
LT
minder dan
LTE
kleiner dan of gelijk aan
GE
groter dan
GTE
groter dan of gelijk aan
LIKE
vage match

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:

AEM Communities SRP Tools

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

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6