Grundlagen suchen search-essentials

Überblick overview

Die Suchfunktion ist eine wichtige Funktion von Adobe Experience Manager (AEM) Communities. Zusätzlich zu den Funktionen der AEMPlattformsuche stellt AEM Communities die UGC-Such-API für die Suche nach benutzergenerierten Inhalten (UGC) bereit. UGC verfügt über eindeutige Eigenschaften, da sie getrennt von anderen AEM-Inhalten und Benutzerdaten eingegeben und gespeichert werden.

Für Communities werden im Allgemeinen die beiden folgenden Elemente durchsucht:

Dieser Abschnitt der Dokumentation ist für Entwickler von Interesse, die benutzerdefinierte Komponenten zum Erstellen oder Verwalten von benutzergenerierten Inhalten erstellen.

Sicherheits- und Schattenknoten security-and-shadow-nodes

Für eine benutzerdefinierte Komponente müssen die Methoden SocialResourceUtilities verwendet werden. Die Dienstprogrammmethoden, die UGC erstellen und suchen, legen die erforderlichen Shadow-Knoten fest und stellen sicher, dass der Member über die richtigen Berechtigungen für die Anfrage verfügt.

Was nicht über die SRP-Dienstprogramme verwaltet wird, sind Eigenschaften, die sich auf die Moderation beziehen.

Siehe SRP und UGC Essentials für Informationen zu Dienstprogrammmethoden, die für den Zugriff auf UGC- und ACL-Shadow-Knoten verwendet werden.

UGC Search-API ugc-search-api

Der UGC Common Store wird von einem von verschiedenen Speicherressourcenanbietern (SRPs) bereitgestellt, von denen jeder möglicherweise eine andere native Abfragesprache aufweist. Daher sollte benutzerdefinierter Code unabhängig vom ausgewählten SRP Methoden aus dem UGC-API-Paket (com.adobe.cq.social.ugc.api) verwenden, das die für das ausgewählte SRP geeignete Abfragesprache aufruft.

ASRP-Suchen asrp-searches

Bei ASRP wird UGC in der Adobe-Cloud gespeichert. Während benutzergenerierter Inhalt in CRX nicht sichtbar ist istModeration“ sowohl in der Authoring- als auch in der Publish-Umgebung verfügbar. Die Verwendung der UGC Search API funktioniert für ASRP genauso wie für andere SRPs.

Für die Verwaltung von ASRP-Suchen gibt es derzeit keine Tools.

Beim Erstellen benutzerdefinierter Eigenschaften, die durchsuchbar sind, müssen Sie die Namensanforderungen“.

MSRP-Suchen msrp-searches

Bei MSRP wird der UGC in MongoDB gespeichert, das für die Verwendung von Solr für die Suche konfiguriert ist. UGC ist in CRX nicht sichtbar, aber Moderation ist sowohl in der Authoring- als auch in der Publish-Umgebung verfügbar.

Zu MSRP und Solr:

Benutzerdefinierte Suchfunktionen sollten die UGC-Such-API verwenden.

Beim Erstellen benutzerdefinierter Eigenschaften, die durchsuchbar sind, müssen Sie die Namensanforderungen“.

JSRP-Suchen jsrp-searches

Bei JSRP wird der benutzergenerierte Inhalt (UGC) in Oak gespeichert und ist nur im Repository der AEM-Autoren- oder Publish-Instanz sichtbar, in der er eingegeben wurde.

Da benutzergenerierter Inhalt normalerweise in der Publish-Umgebung eingegeben wird, ist es bei Produktionssystemen mit mehreren Herausgebern erforderlich, einen Veröffentlichungs-Cluster und keine Veröffentlichungsfarm zu konfigurieren, damit der eingegebene Inhalt von allen Herausgebern sichtbar ist.

Bei JSRP ist der in der Publish-Umgebung eingegebene benutzergenerierte Inhalt nie in der Autorenumgebung sichtbar. Daher finden alle Moderationsaufgaben in der Publish-Umgebung statt.

Benutzerdefinierte Suchfunktionen sollten die UGC-Such-API verwenden.

Oak-Indizierung oak-indexing

Oak-Indizes werden zwar seit AEM 6.2 nicht automatisch für die AEM-Plattformsuche erstellt, aber sie wurden für AEM Communities hinzugefügt, um die Leistung zu verbessern und die Paginierung bei der Darstellung von UGC-Suchergebnissen zu unterstützen.

Wenn benutzerdefinierte Eigenschaften verwendet werden und Suchvorgänge langsam sind, müssen zusätzliche Indizes für die benutzerdefinierten Eigenschaften erstellt werden, um sie leistungsfähiger zu machen. Um die Portabilität zu gewährleisten, müssen Sie die Benennungsanforderungen beim Erstellen von benutzerdefinierten Eigenschaften beachten, die durchsuchbar sind.

Informationen zum Ändern vorhandener Indizes oder Erstellen benutzerdefinierter Indizes finden Sie unter Oak-Abfragen und -Indizierung.

Der Oak Index Manager ist über ACS AEM Commons verfügbar. Es bietet:

Um die vorhandenen Oak-Indizes in CRXDE Lite anzuzeigen, lautet der Speicherort:

Indizierte Sucheigenschaften indexed-search-properties

Standardsucheigenschaften default-search-properties

Im Folgenden finden Sie einige durchsuchbare Eigenschaften, die für verschiedene Communities-Funktionen verwendet werden:

Benennung benutzerdefinierter Eigenschaften naming-of-custom-properties

Wenn Sie benutzerdefinierte Eigenschaften hinzufügen, müssen diese Eigenschaften dem Eigenschaftsnamen ein Suffix hinzufügen, damit sie für Sortierungen und Suchen sichtbar sind🔗 die mit der UGC Such API erstellt wurden.

Das Suffix bezieht sich auf Abfragesprachen, die ein Schema verwenden:

Solr ist ein Beispiel für eine Abfragesprache, die ein Schema verwendet.

Anmerkungen:

Filter filters

Komponenten, die das Kommentarsystem enthalten, unterstützen den Filterparameter zusätzlich zu ihren Endpunkten.

Die Filtersyntax für die Logik AND und OR wird wie folgt ausgedrückt (vor der URL-Kodierung angezeigt):

Die Standardimplementierung der Suchkomponente verwendet diese Syntax, die in der URL zu sehen ist, die die Seite mit den Suchergebnissen im Community-Komponenten-Handbuch öffnet. Zum Experimentieren navigieren Sie zu http://localhost:4503/content/community-components/en/search.html.

Filteroperatoren sind:

Es ist wichtig, dass die URL auf die Communities-Komponente (Ressource) verweist und nicht auf die Seite, auf der die Komponente platziert ist:

SRP-Tools srp-tools

Es gibt ein Adobe Experience Cloud-GitHub-Projekt, das Folgendes enthält:

AEM Communities SRP-Tools

Dieses Repository enthält Tools zum Verwalten von Daten in SRP.

Derzeit gibt es ein Servlet, das alle benutzergenerierten Inhalte aus jedem SRP löschen kann.

So löschen Sie beispielsweise alle benutzergenerierten Inhalte in ASRP:

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

Fehlerbehebung troubleshooting

Solr-Abfrage solr-query

Um Probleme mit einer Solr-Abfrage zu beheben, aktivieren Sie die DEBUG-Protokollierung für

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

Die eigentliche Solr-Abfrage wird als URL codiert im Debug-Protokoll angezeigt:

Abfrage an Solr lautet: 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

Der Wert des q ist die Abfrage. Sobald die URL-Codierung decodiert ist, kann die Abfrage zur weiteren Fehlerbehebung an das Solr Admin Query Tool übergeben werden.

Verwandte Ressourcen related-resources