Suchgrundlagen search-essentials

Übersicht overview

Die Suchfunktion ist eine wesentliche Funktion von Adobe Experience Manager (AEM) Communities. Zusätzlich zu den AEM Plattformsuche -Funktionen bietet AEM Communities die UGC-Such-API zum Durchsuchen benutzergenerierter Inhalte (UGC). UGC verfügt über eindeutige Eigenschaften, da es separat von anderen AEM-Inhalten und Benutzerdaten eingegeben und gespeichert wird.

Für Communities werden im Allgemeinen zwei Dinge gesucht:

  • Inhalt von Community-Mitgliedern

    • Es verwendet die UGC-Such-API von AEM Communities.
  • Benutzer und Benutzergruppen (Benutzerdaten)

    • Es verwendet die Suchfunktionen der AEM Plattform.

Dieser Abschnitt der Dokumentation ist für Entwickler von Interesse, die benutzerdefinierte Komponenten erstellen, die benutzergenerierte Inhalte erstellen oder verwalten.

Sicherheits- und Schattenknoten security-and-shadow-nodes

Für eine benutzerdefinierte Komponente muss die SocialResourceUtilities -Methoden. Die Dienstprogrammmethoden, die UGC erstellen und suchen, stellen die erforderlichen Shadow-Knoten und stellen Sie sicher, dass das Mitglied über die richtigen Berechtigungen für die Anfrage verfügt.

Was nicht über die SRP-Dienstprogramme verwaltet wird, sind Eigenschaften im Zusammenhang mit der Moderation.

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

UGC Search API ugc-search-api

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

ASRP-Suchvorgänge asrp-searches

Für ASRP, wird UGC in der Adobe-Cloud gespeichert. Während UGC in CRX nicht sichtbar ist, Moderation ist sowohl in der Autoren- als auch in der Veröffentlichungsumgebung verfügbar. Die Verwendung der UGC-Such-API funktioniert für ASRP genauso wie für andere SRPs.

Es gibt derzeit keine Tools für die Verwaltung von ASRP-Suchen.

Beim Erstellen von benutzerdefinierten Eigenschaften, die durchsuchbar sind, müssen Sie die Namensanforderungen.

MSRP-Suchvorgänge msrp-searches

Für MSRP, wird 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 Autoren- als auch in der Veröffentlichungsumgebung verfügbar.

MSRP und Solr:

  • Der eingebettete Solr für die AEM Plattform wird nicht für MSRP verwendet.
  • Wenn Sie einen Remote-Solr für die AEM-Plattform verwenden, kann er für MSRP freigegeben werden, sollte jedoch unterschiedliche Sammlungen verwenden.
  • Solr kann für die Standardsuche oder für die mehrsprachige Suche (MLS) konfiguriert werden.
  • Weitere Informationen zur Konfiguration finden Sie unter Solr-Konfiguration für MSRP.

Benutzerdefinierte Suchfunktionen sollten UGC-Such-API.

Beim Erstellen von benutzerdefinierten Eigenschaften, die durchsuchbar sind, müssen Sie die Namensanforderungen.

JSRP-Suchvorgänge jsrp-searches

Für JSRP, wird UGC in gespeichert Oak und ist nur im Repository der AEM- oder Veröffentlichungsinstanz sichtbar, in der sie eingegeben wurde.

Da UGC in der Regel in die Veröffentlichungsumgebung eingegeben wird, muss für Produktionssysteme mit mehreren Herausgebern ein Veröffentlichungscluster, nicht eine Veröffentlichungsfarm, sodass der eingegebene Inhalt für alle Herausgeber sichtbar ist.

Bei JSRP ist in der Veröffentlichungsumgebung eingegebener benutzergenerierter Inhalt in der Autorenumgebung nie sichtbar. Daher Moderation Aufgaben finden in der Veröffentlichungsumgebung statt.

Benutzerdefinierte Suchfunktionen sollten UGC-Such-API.

Oak-Indizierung oak-indexing

Auch wenn Oak-Indizes ab AEM 6.2 nicht automatisch für die AEM-Plattformsuche erstellt werden, wurden sie für AEM Communities hinzugefügt, um die Leistung zu verbessern und die Paginierung bei der Präsentation von UGC-Suchergebnissen zu unterstützen.

Wenn benutzerdefinierte Eigenschaften verwendet werden und die 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 wahren, halten Sie die Namensanforderungen beim Erstellen von benutzerdefinierten Eigenschaften, die durchsuchbar sind.

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

Die Oak Index Manager ist in ACS AEM Commons verfügbar. Es bietet:

  • Eine Ansicht der vorhandenen Indizes.
  • Die Möglichkeit, die Neuindizierung zu starten.

So zeigen Sie die vorhandenen Oak-Indizes in CRXDE Lite, lautet der Speicherort:

  • /oak:index/socialLucene

social-lucene

Indexierte Sucheigenschaften indexed-search-properties

Standardsucheigenschaften default-search-properties

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

Eigenschaft
Datentyp
isGekennzeichnet
Boolesch
isSpam
Boolesch
lesen
Boolesch
Einfluss
Boolesch
Anlagen
Boolesch
sentiment
Long
markiert
Boolesch
hinzugefügt
Datum
modifiedDate
Datum
state
Zeichenfolge
userIdentifier
Zeichenfolge
antworten
Long
jcr:title
Zeichenfolge
jcr:description
Zeichenfolge
sling:resourceType
Zeichenfolge
allowThreadedReply
Boolesch
isDraft
Boolesch
publishDate
Datum
publishJobId
Zeichenfolge
beantwortet
Boolesch
chosenantwortet
Boolesch
tag
Zeichenfolge
cq:Tag
Zeichenfolge
author_display_name
Zeichenfolge
location_t
Zeichenfolge
parentPath
Zeichenfolge
parentTitle
Zeichenfolge

Benennung benutzerdefinierter Eigenschaften naming-of-custom-properties

Wenn Sie benutzerdefinierte Eigenschaften hinzufügen, damit diese Eigenschaften für Sortierungen und Suchen sichtbar sind, die mit der UGC-Such-API, ist es erforderlich , um dem Eigenschaftsnamen ein Suffix hinzuzufügen.

Das Suffix richtet sich an Abfragesprachen, die ein Schema verwenden:

  • Sie identifiziert die Eigenschaft als durchsuchbar.
  • Er identifiziert den Datentyp.

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

Suffix
Datentyp
_b
Boolesch
_dt
Kalender
_d
Double
_tl
Long
_s
Zeichenfolge
_t
Text

Anmerkungen:

  • Text eine tokenisierte Zeichenfolge ist, Zeichenfolge ist nicht. Verwendung Text für unscharfe (mehr wie diese) Suchen.

  • Fügen Sie dem Suffix für Typen mit mehreren Werten "s"hinzu, beispielsweise:

    • viewDate_dt: Eigenschaft für ein einzelnes Datum
    • viewDates_dts: list of date property

Filter filters

Komponenten, zu denen die Kommentarsystemunterstützt den Filterparameter zusätzlich zu seinen Endpunkten.

Die Filtersyntax für die UND- und ODER-Logik lautet wie folgt (wird angezeigt, bevor sie URL-codiert wird):

  • So geben Sie OR einen Filterparameter mit kommagetrennten Werten an:

    • filter=name eq 'Jennifer',name eq 'Jen'
  • So geben Sie UND verwenden mehrere Filterparameter an:

    • filter = name eq 'Jackson'&filter=message eq 'testing'

Die Standardimplementierung der Suchkomponente verwendet diese Syntax, wie in der URL zu sehen ist, die die Seite "Suchergebnisse"in der Handbuch zu Community-Komponenten. Navigieren Sie zum Experimentieren zu http://localhost:4503/content/community-components/en/search.html.

Filteroperatoren sind:

EQ
gleich
NE
nicht gleich
LT
kleiner als
LTE
kleiner als oder gleich
GE
größer als
GTE
größer als oder gleich
LIKE
Fuzzy Match

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

  • Richtig: Forumkomponente
    • /content/community-components/en/forum/jcr:content/content/forum.social.json
  • Falsch: Forumsseite
    • /content/community-components/en/forum.social.json

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 einem beliebigen 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 Query solr-query

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

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

Die tatsächliche Solr-Abfrage wird in der URL angezeigt, die im Debug-Protokoll kodiert ist:

Die 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 der q -Parameter ist die Abfrage. Sobald die URL-Kodierung dekodiert wurde, kann die Abfrage zur weiteren Fehlerbehebung an das Solr Admin Query Tool übergeben werden.

Verwandte Ressourcen related-resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791