Neuerungen für Entwickler bei der SharePoint-Suche

  • Artikel

Informationen Sie zu den neuen Features für Entwickler bei der Suche in SharePoint.

Search-Clientobjektmodell für den Zugriff auf die Funktionalität des Objektmodells für online Abfragen, lokalen und Mobilgeräte-Entwicklung

SharePoint Suche enthält ein Clientobjektmodell (CSOM), die Zugriff auf die Funktionalität des Abfrage-Objektmodells für die meisten online ermöglicht, lokalen und Mobilgeräte-Entwicklung. Dem Search-Clientobjektmodell können zum Erstellen von Clientanwendungen, die auf einem Computer ausgeführt werden, die keinen SharePoint installiert haben, um Suchergebnisse SharePoint zurückzugeben.

Die Suche CSOM besteht aus einem verwalteten Clientobjektmodell Microsoft .NET Framework und JavaScript-Objektmodell, und es basiert auf SharePoint. Erstens greift Clientcode des SharePoint-CSOM auf. Klicken Sie dann auf Clientcode die Suche CSOM zugegriffen.

Um das verwaltete CSOM von Search .NET Framework verwenden zu können, müssen Sie eine ClientContext-Instanz abrufen (befindet sich im Microsoft.SharePoint.Client-Namespace im Microsoft.SharePoint.Client.dll). Klicken Sie dann mithilfe des-Objektmodells im Microsoft.SharePoint.Client.Search.Query -Namespace in der Microsoft.Office.Server.Search.Client.dll. Weitere Informationen zu SharePoint-CSOM finden Sie unter Verwaltetes Clientobjektmodell. Weitere Informationen zum ClientContext -Objekt, das den Einstiegspunkt für das CSOM ist, finden Sie unter Clientkontext als zentrales Objekt.

Die Search-CSOM zurückgegeben Search Results Daten vom Server in JavaScript Object Notation (JSON). Der JSON-Code für die Suchergebnissedaten enthält eine ResultTableCollection-Auflistung , die aus ResultTable-Objekten besteht, die verschiedene Resultsets darstellen.

Unterstützung für SQL-Syntax entfernt

Benutzerdefinierte Suchlösungen in SharePoint unterstützen keine SQL-Syntax. Suche in SharePoint unterstützt die FQL-Syntax und KQL-Syntax für benutzerdefinierte suchlösungen. In benutzerdefinierten Suchlösungen können Sie keine SQL-Syntax verwenden. Das gilt unabhängig von der eingesetzten Technologie und damit auch bei Verwendung des Abfrageserver-Objektmodells, des Clientobjektmodells und des REST-Suchdiensts. In früheren SharePoint-Versionen erstellte benutzerdefinierte Suchlösungen, in denen SQL-Syntax mit dem Abfrageserver-Objektmodell und dem Abfragewebdienst verwendet wird, funktionieren nach einem Upgrade auf SharePoint nicht mehr. Über diese Anwendungen gesendete Abfragen geben einen Fehler zurück. Weitere Informationen zur Verwendung von FQL-Syntax und KQL-Syntax finden Sie unter KQL-Syntaxreferenz (Keyword Query Language) und FAST Query Language (FQL.md)-Syntaxreferenz.

REST-Suchdienst für die Remoteausführung von Abfragen über Clientanwendungen

In SharePoint ist ein REST-Dienst (Representational State Transfer) integriert, mit dem Sie über Clientanwendungen Remoteabfragen an den SharePoint-Suchdienst senden können. Für diese Abfragen können Sie jede Technologie verwenden, die REST-Webanforderungen unterstützt. Der REST-Suchdienst macht zwei Endpunkte verfügbar (query und suggest) und unterstützt sowohl Operationen des Typs GET als auch Operationen des Typs POST. Ergebnisse werden in XML oder JSON-Format zurückgegeben.

Es folgt der Zugriffspunkt für den Dienst: http://server/_api/search/. Sie können die Website auch in der URL wie folgt angeben: http://server/site/_api/search/. Der Suchdienst gibt Ergebnisse aus der gesamten Websitesammlung zurück, sodass für beide Arten des Zugriffs auf den Dienst dieselben Ergebnisse zurückgegeben werden.

Sie können auch die URL verwenden, die auf client.svc verweist, um wie folgt auf den Dienst zuzugreifen: http://server/_vti_bin/client.svc/search/. Allerdings ist _api die bevorzugte Konvention.

Verwenden Sie den folgenden Zugriffspunkt Zugriff auf die webdienstmetadaten:

http://server/_api/$metadata

Allgemeine Informationen zum REST-Dienst in SharePoint finden Sie unter Verwenden von OData-Abfragevorgängen in SharePoint-REST-Anforderungen.

SharePoint-Suchabfrage-Webdienst ist veraltet.

Der Abfragewebdienst (im Pfad http://server/site/_vti_bin/search.asmx) ist in SharePoint veraltet. Wenn Sie neue Anwendungen schreiben, vermeiden Sie die Verwendung dieses veralteten Features, und verwenden Sie stattdessen den neuen Abfrage CSOM oder Abfrage REST-Dienst. Wenn Sie vorhandene Anwendungen ändern, empfehlen wir dringend empfohlen, keine Abhängigkeit dieses Feature zu entfernen.

SharePoint Search-Objektmodell Abfragevorgängen

Eigenschaften von Abfrage enthalten Informationen zu einer Suchabfrage. Eine Eigenschaftensammlung wurde in SharePoint suchen die Abfrage und Ergebnisse Klassen zum Aktivieren der benutzerdefinierte Abfrageeigenschaften hinzugefügt. Sie können vorhandene Abfrageeigenschaften über die Eigenschaft auf eine der Abfrageklassen wie folgt zugreifen:

KeywordQuery.EnableStemming

Sie können auch den Eigenschaftenbehälter wie folgt:

KeywordQuery.Properties["EnableStemming"]

Sie können benutzerdefinierte Eigenschaften zugreifen, nur mithilfe der Eigenschaftensammlung wie folgt:

KeywordQuery.Properties["UserDefinedProperty"]

SharePoint Suche schließt Abfrageeigenschaften im Eigenschaftenbehälter, einschließlich der neuen Abfrageeigenschaften wie etwa:

  • BypassResultTypes Gibt an, ob der Suchergebniselementtyp für die Abfrageergebnisse zurückgegeben wird. Geben Sie true an, um keinen Ergebnistyp zurückzugeben. andernfalls false.

  • EnableInterleaving Gibt an, ob die Resultsets, die beim Ausführen von Abfrageregelaktionen zum Hinzufügen eines Ergebnisblocks generiert werden, mit dem Resultset für die ursprüngliche Abfrage gemischt werden. Geben Sie true an, um das generierte Resultset mit dem ursprünglichen Resultset zu mischen. andernfalls false.

  • EnableQueryRules Gibt an, ob Abfrageregeln für diese Abfrage aktiviert sind. Geben Sie true an, um Abfrageregeln für die Abfrage zu aktivieren. andernfalls false.

Sie können eine beliebige Eigenschaft im Eigenschaftenbehälter, einschließlich der benutzerdefinierten Eigenschaften als abfrageregelbedingungen angeben. Verwenden Sie Abfrageregeln zum Anpassen des Suchvorgangs für die Arten von Abfragen, die für Ihre Benutzer wichtig sind. Wenn eine Abfrage in einer Abfrageregel angegebene Bedingungen entspricht, gibt die Regel Benutzeraktionen zum Verbessern der Relevanz der Suchergebnisse zugeordnet.

Schlüsselwort Sprache Abfragevorgängen

SharePoint enthält Verbesserungen an der Schlüsselwort-Abfragesprache, die in diesem Abschnitt beschrieben werden.

Verbesserte NEAR-operator

In SharePoint Server 2010 Operators NEAR impliziert einen token maximalen Abstand von 8 und die Reihenfolge der Eingabe Token beibehalten. In SharePoint behält der Operator NEAR nicht mehr die Reihenfolge der Token. Darüber hinaus erhält der Operator NEAR jetzt einen optionalen Parameter, der maximalen token Abstand angibt. Der Standardwert ist jedoch weiterhin 8. Wenn Sie das vorherige Verhalten verwenden müssen, verwenden Sie stattdessen ONEAR.

Der NEAR -Operator kann in Eigenschaft Einschränkung Ausdrücken verwendet werden, wie im folgenden Beispiel dargestellt:

"acquisition" NEAR "debt"

Diese Abfrage stimmt exakt mit Elementen, in dem das Token "Erwerb" und "Forderung" innerhalb desselben Dokuments, mit einer maximalen token Abstand von 8 angezeigt (der Standardwert der n ist, wenn kein Wert angegeben ist). Die Reihenfolge der Token ist nicht von Bedeutung für die Übereinstimmung.

Wenn Sie einen geringeren token Abstand benötigen, können Sie es wie folgt angeben:

"acquisition" NEAR(n=3) "debt"

Diese Abfrage stimmt exakt Elemente, in denen die beiden Token "Erwerb" und "Forderung" innerhalb desselben Dokuments, mit einer maximalen token Abstand von 3 angezeigt werden. Die Reihenfolge der Token ist nicht von Bedeutung für die Übereinstimmung.

Neue ONEAR-operator

Der ONEAR-Operator stellt eine geordnete Near-Funktionalität bereit. Er empfängt einen optionalen Parameter, der den maximalen Tokenabstand angibt. der Standardwert ist 8.

Der Operator ONEAR behält die Reihenfolge der Eingabe Ausdrücke. Verwenden Sie für ungeordnete Nähe NEAR.

Den Operator ONEAR können in Eigenschaft Einschränkung Ausdrücken wie im folgenden Beispiel dargestellt:

"acquisition" ONEAR "debt"

Diese Abfrage stimmt exakt Elemente, in denen die beiden Token "Erwerb" und "Forderung" angezeigt werden, innerhalb desselben Dokuments, mit einer maximalen token Abstand von 8 (die den Standardwert n ist, wenn kein Wert angegeben ist). Die Reihenfolge der Token muss für ein Element, das zurückgegeben werden übereinstimmen.

Wenn Sie einen geringeren token Abstand benötigen, können Sie es wie folgt angeben:

"acquisition" ONEAR(n=3) "debt"

Diese Abfrage stimmt exakt Elemente, in denen die beiden Token "Erwerb" und "Forderung" innerhalb desselben Dokuments, mit einer maximalen token Abstand von 3 angezeigt werden. Die Reihenfolge der Token muss für ein Element, das zurückgegeben werden übereinstimmen.

Neue XRANK-operator

In SharePoint Server 2010 war der XRANK Operator nur mit FAST Query Language (FQL) verfügbar. SharePoint führt einen neuen und leistungsstarken XRANK -Operator.

Der Operator XRANK bietet dynamische Steuerung der Rangordnung. Dieser Operator steigert die dynamische Rangfolge der Elemente, die auf Basis des Vorkommens bestimmter Angaben ohne Ändern der Elemente, die mit die Abfrage übereinstimmen.

Rich-Ergebnis-Framework für das Anpassen der Benutzeroberfläche für Suchergebnisse

SharePoint Suche umfasst ein neue Framework Ergebnisse, das zum Anpassen der Darstellung (Aussehen und Verhalten) über die Search Results-Benutzeroberfläche (UI) erleichtert. Nun können Sie anstelle von Schreiben von benutzerdefiniertem XSLT zum Ändern der Anzeige von Suchergebnissen aus, die Darstellung der wichtige Typen von Ergebnissen mithilfe von Anzeigevorlagen und Ergebnistypen anpassen.

Anzeigevorlagen

Anzeigevorlagen definieren das visuelle Layout und das Verhalten der einen Ergebnistyp mithilfe von HTML und CSS- JavaScript. Anpassen die vorhandenen Anzeigevorlagen oder Erstellen von Anzeigevorlagen mithilfe ein HTML-Editor, und Laden Sie sie in der Galerieansicht Vorlagen.

Ergebnistypen

Ergebnistypen definieren, wie Sie eine Reihe von Suchergebnisse basierend auf einer der folgenden Auflistung anzuzeigen:

  • Regeln Bestimmen Sie, wann einen Ergebnistyp basierend auf den angegebenen Bedingungen gelten. Regelbedingungen können mithilfe von Gleichheit, Vergleichsoperatoren und logischen Operatoren verknüpft werden.

  • Eigenschaften Bestimmen Sie die Liste der verwalteten Eigenschaften für das Ergebnis. Sie müssen verwaltete Eigenschaften zur Liste hinzufügen, bevor Sie eine Anzeigevorlage die verwaltete Eigenschaft zuordnen.

  • Anzeigevorlagen Definieren Sie das visuelle Layout des Ergebnistyps.

Administratoren können erstellen und Verwalten von Ergebnistypen auf Standortebene oder dienstanwendungsebene; keine benutzerdefinierte Codierung ist erforderlich.

Connector-Framework-Verbesserungen

SharePoint Suchen können Sie abrufen Anspruchsinformationen für Inhalte, die in benutzerdefinierten externen Datenquellen, die mithilfe des Frameworks Connector gecrawlt werden.

Das konnektorframework bietet auch verbesserte Ausnahme erfassen und Protokollierung, um Ihnen bei der Problembehandlung für Fehler beim Crawlen von Inhaltsquellen mit benutzerdefinierten Connectors, die auf das konnektorframework aufbauen. Informationen zum Connectorframework finden Sie unter Suchconnectorframework in SharePoint.

Siehe auch