Abrufen von Abfragevorschläge mithilfe des Such-REST-Diensts
Erfahren Sie, wie Sie den Search-REST-Dienst aus Ihren Client- und mobilen Anwendungen verwenden können, um Abfragevorschläge aus der Suche in SharePoint abzurufen. Abfragevorschläge, auch Suchvorschläge genannt, sind Ausdrücke, nach denen Benutzer bereits gesucht haben und die beim Eingeben einer Abfrage angezeigt oder "vorgeschlagen" werden. Über die Suche in SharePoint können Sie die Vorschläge nach und vor der Abfrage aktivieren. Die Vorschläge werden in einer Liste unter dem Suchfeld angezeigt, während der Benutzer eine Abfrage eingibt. Weitere Informationen zu Abfragevorschlägen und deren Aktivierung finden Sie unter Verwalten von Abfragevorschlägen in SharePoint.
Vorschlagen eines Endpunkts im Search-REST-Dienst
Der Search-REST-Dienst enthält einen Suggest -Endpunkt, den Sie verwenden können, in jeder Technologie, die unterstützt der REST-Webanfragen Abfragevorschläge abgerufen, die das Suchsystem für eine Abfrage von Client oder mobilen Anwendungen generiert.
Der URI für GET Anforderungen an die Search-REST-Dienst Suggest Endpunkt ist:
/_api/search/suggest
Die Abfrageparameter Vorschlag werden in der URL angegeben. Sie können die URL der Anforderung auf zwei Arten erstellen:
http://server/_api/search/suggest?parameter=value&parameter=value
http://server/_api/search/suggest(parameter=value&parameter=value)
Hinweis
Der Search-REST-Dienst unterstützt keine anonyme Anfragen an den Endpunkt Suggest.
Parameter für die Abfragevorschläge
Den folgenden Abschnitten werden die Parameter, die Sie für den Endpunkt Suggest verwenden können.
Abfragetext
Eine Zeichenfolge, die den Text für die Suchabfrage enthält
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext = "Sharepoint"
iNumberOfQuerySuggestions
Die Anzahl der Abfragevorschläge abgerufen. Muss größer als 0 (null) sein. Der Standardwert ist 5.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofquerysuggestions=3
iNumberOfResultSuggestions
Die Anzahl der persönlichen Ergebnisse abgerufen. Muss größer als 0 (null) sein. Der Standardwert ist 5.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofresultsuggestions=4
fPreQuerySuggestions
Ein boolescher Wert, der angibt, ob Vorschläge vor der Abfrage oder nach der Abfrage abgerufen. true Vorschläge vor der Abfrage zurückzugebenden; andernfalls false. Der Standardwert ist false.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&fprequerysuggestions=true
fHitHighlighting
Ein boolescher Wert, der angibt, ob Treffer hervorheben oder Abfragevorschläge fett formatiert. true fett formatiert die Ausdrücke in den zurückgegebenen Abfragevorschläge, die Ausdrücke in der angegebenen Abfrage übereinstimmen; andernfalls false. Der Standardwert ist true.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&fhithighlighting=false
fCapitalizeFirstLetters
Ein boolescher Wert, der angibt, ob für die Großschreibung des ersten Buchstabens in jeden Ausdruck in der zurückgegebenen Abfragevorschläge. true für die Großschreibung des ersten Buchstabens in jeden Ausdruck; andernfalls false. Der Standardwert ist false.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&fcapitalizefirstletters=false
Culture
Die Gebietsschema-ID (LCID) für die Abfrage (siehe Von Microsoft zugewiesene Gebietsschema-IDs).
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&culture=1044
EnableStemming
Ein boolescher Wert, der angibt, ob Wortstammerkennung aktiviert ist true zum Aktivieren der wortstammerkennung; andernfalls false. Der Standardwert ist true.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&enablestemming=false
ShowPeopleNameSuggestions
Ein boolescher Wert, der angibt, ob in der zurückgegebenen Abfragevorschläge Personennamen eingeschlossen. true Personennamen in der zurückgegebenen Abfragevorschläge enthalten; andernfalls false. Der Standardwert ist true.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&showpeoplenamesuggestions=false
EnableQueryRules
Ein boolescher Wert, der angibt, ob Abfrageregeln für diese Abfrage zu aktivieren. true um Abfrageregeln zu aktivieren; andernfalls false. Der Standardwert ist true.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&enablequeryrules=false
fPrefixMatchAllTerms
Ein boolescher Wert, der angibt, ob Abfragevorschläge zurückgegeben für Präfix übereinstimmt. true zurückzugebenden Abfragevorschläge basierend auf Präfix entspricht, andernfalls false beim Abfragevorschläge das vollständige Abfragewort übereinstimmen soll.
Beispiel für GET-Anforderung
http:// server/_api/search/suggest?querytext='sharepoint'&fprefixmatchallterms=false