Abfragevariablen in SharePoint Server 2013
GILT FÜR:
2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
Hinweis: Dieser Artikel gilt nicht für moderne Microsoft Search-Umgebungen und -APIs. Weitere Informationen zur modernen Suche finden Sie unter Profilabfragevariablen.
Abfragevariablen
Die folgenden Tabellen zeigen die Abfragevariablen für SharePoint Server und SharePoint in Microsoft 365 sowie Beispiele für deren Verwendung.
Website- und Websitesammlungseigenschaften
| Abfragevariable | Definition |
|---|---|
| {Site} oder {Site.URL} |
URL der Website, von der die Abfrage stammt. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "Path" abgefragt werden. |
| {Site.ID} |
GUID der Website, von der die Abfrage stammt. Dieser Wert entspricht dem Wert der verwalteten Eigenschaft WebId. |
| {Site.LCID} |
Numerischer Wert des Gebietsschemas gemäß den Landes-/Regionaleinstellungen in den Websiteeinstellungen der Website, von der die Abfrage stammt. |
| {Site.Locale} |
Sprache der Website, von der die Abfrage stammt, im Format "sp-ll" (beispielsweise "en-us"). |
| {Website.<property>} |
Beliebige Eigenschaft aus der Eigenschaftensammlung der Website ("SPWeb"), von der die Abfrage stammt. Hierzu zählen auch benutzerdefinierte Eigenschaften. |
| {SiteCollection} oder {SiteCollection.URL} |
URL einer Websitesammlung, von der die Abfrage stammt. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "Path" abgefragt werden. |
| {SiteCollection.ID} |
GUID der Websitesammlung, von der die Abfrage stammt. Dieser Wert entspricht dem Wert der verwalteten Eigenschaft "SiteID". |
| {SiteCollection.LCID} |
Numerischer Wert des Gebietsschemas gemäß den Landes-/Regionaleinstellungen in den Websiteeinstellungen der Websitesammlung, von der die Abfrage stammt. |
| {SiteCollection.Locale} |
Sprache der Websitesammlung, von der die Abfrage stammt, im Format "sp-ll" (beispielsweise "en-us"). |
| {SiteCollection.<property>} |
Beliebige Eigenschaft aus der Eigenschaftensammlung der Stammwebsite ("SPWeb") in der Websitesammlung ("SPSite"), von der die Abfrage stammt. Hierzu zählen auch benutzerdefinierte Eigenschaften. |
Eigenschaften für Seite, URL-Token, Abfragezeichenfolge und Anforderung
| Abfragevariable | Definition |
|---|---|
| {Page} oder {Page.URL} |
URL der Seite, von der die Abfrage stammt. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "Path" abgefragt werden. |
| {Page.UsageAnalyticsId} |
Element-ID für die Verwendungsanalyse |
| {Seite.<FieldName>} |
Der Wert eines Felds auf der Seite, von der die Abfrage stammt. Enthielt die Seite, von der die Abfrage stammt, beispielsweise eine Websitespalte namens "ContentOwner", könnte durch Angeben von "{Page.ContentOwner}" der Wert von "ContentOwner" abgefragt werden. |
| {URLToken.<integer>} |
Ein Wert aus der URL einer Seite. Die ganze Zahl steht für die Position des Werts in der URL, wobei von rechts nach links gezählt wird. So würde beispielsweise mit der Abfragevariablen "{URLToken.1}" bei der Seite "http://www.contoso/audio/mp3/1010101" der letzte Wert in der URL (also "1010101") abgefragt. Mit der Abfragevariablen "{URLToken.3}" wird die drittletzte Eigenschaft in der URL ("audio") abgefragt. In einer URL können Werte bis zur neuntletzten Position abgefragt werden. |
| {QueryString.<ParameterName>} |
Ein Wert aus einer Abfragezeichenfolge in der URL der aktuellen Seite. Enthält die URL der aktuellen Seite also beispielsweise eine Abfragezeichenfolge wie "ItemNumber=567", können Sie durch Angeben von "{QueryString.ItemNumber}" den Wert "567" abrufen. |
| {Anforderung.<PropertyName>} |
Ein Wert aus der aktuellen HTTP-Anforderung (beispielsweise "{Request.Url}"). |
Benutzereigenschaften
| Abfragevariable | Definition |
|---|---|
| {User} oder {User.Name} |
Anzeigename des Benutzers, von dem die Abfrage stammt. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "Author" abgefragt werden. |
| {User.Email} |
E-Mail-Adresse des Benutzers, von dem die Abfrage stammt. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "WorkEmail" abgefragt werden. |
| {User.SID} |
SID des Benutzers, von dem die Abfrage stammt. |
| {User.LCID} |
Numerischer Wert des Gebietsschemas gemäß Angabe im Profil des Benutzers, von dem die Abfrage stammt. |
| {User.PreferredContentLanguage} |
Sprache, die im Profil des Benutzers, von dem die Abfrage stammt, als bevorzugte Inhaltssprache angegeben ist. |
| {User.PreferredDisplayLanguage} |
Sprache, die im Profil des Benutzers, von dem die Abfrage stammt, als bevorzugte Anzeigesprache angegeben ist. |
| {Benutzer.<property>} |
Eine beliebige Eigenschaft aus dem Benutzerprofil des Benutzers, von dem die Abfrage stammt (beispielsweise "SPS-Interests"). Hierzu zählen auch benutzerdefinierte Eigenschaften. |
| {User.Audiences} (nur SharePoint) |
Wird mit modernen SharePoint-Zielgruppenfiltern für die verwaltete Eigenschaft ModernAudienceAadObjectIdsverwendet. Beispiel: ModernAudienceAadObjectIds:{User.Audiences}. |
Eigenschaften für Ausdrücke und Ausdruckssätze
| Abfragevariable | Definition |
|---|---|
| {Term} oder {Term.ID} oder {Term.IDNoChildren} |
GUID des aktuellen Websitenavigationsknotens mit dem Präfix "#0" (beispielsweise "#083e99dcb-7907-4dc9-abc8-b5614a284f1c"). Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "owstaxIdMetadataAllTagsInfo" oder "owstaxIdProductCatalogItemCategory" in einer Produktkatalog-Websitesammlung abgerufen werden. |
| {Term.IDWithChildren} |
GUID des aktuellen Websitenavigationsknotens mit dem Präfix "#" (beispielsweise "#83e99dcb-7907-4dc9-abc8-b5614a284f1c"). Dadurch werden alle Elemente zurückgegeben, die mit dem aktuellen Websitenavigationsausdruck oder untergeordneten Elementen des aktuellen Websitenavigationsausdrucks markiert sind. Mit diesem Wert können beispielsweise Inhalte der verwalteten Eigenschaft "owstaxIdProductCatalogItemCategory" in einer Produktkatalog-Websitesammlung abgerufen werden. Der Inhalt der verwalteten Eigenschaft "owstaxidmetadataalltagsinfo" kann mit diesem Wert nicht abgerufen werden. |
| {Term.Name} |
Beschriftung des Websitenavigationsknotens (beispielsweise "Audio"). |
| {Begriff.<property>} |
Beliebige Eigenschaft aus der Eigenschaftensammlung des Ausdrucks. Hierzu zählen auch benutzerdefinierte Eigenschaften. |
| {TermSet} oder {TermSet.ID} |
GUID des Ausdruckssatzes für die aktuelle Websitenavigation. |
| {TermSet.Name} |
Beschriftung des Ausdruckssatzes für die aktuelle Websitenavigation. |
Eigenschaften für Listen und Listenelemente
| Abfragevariable | Definition |
|---|---|
| {List} |
URL der aktuellen Liste. |
| {List.<property>} |
Beliebige Eigenschaft der aktuellen Liste. |
| {ListItem} |
URL des aktuellen Listenelement. |
| {ListItem.<property>} |
Beliebige Eigenschaft des aktuellen Listenelements. |
Sonstige Eigenschaften
| Abfragevariable | Definition |
|---|---|
| {Today+/- <ganze Zahl für Anzahl von Tagen>} |
Ein Datum, das durch Hinzufügen/Subtrahieren der angegebenen Anzahl von Tagen zu/von dem Datum berechnet wird, an dem die Abfrage ausgestellt wird. Das Datumsformat ist JJJJ-MM-TT. Dieser Wert kann beispielsweise verwendet werden, um den Inhalt der verwalteten Eigenschaft LastModifiedTime abzufragen. |
| {SearchBoxQuery} |
Der Abfragewert, der auf einer Seite in ein Suchfeld eingegeben wurde. |
| {CurrentDisplayLanguage} |
Die aktuelle Anzeigesprache auf der Grundlage der MUI im Format "sp-ll". |
| {CurrentDisplayLCID} |
Numerischer Wert auf der Grundlage der MUI im Format "sp-ll". |
Umgang mit Leerzeichen in Werten
In Suchabfragen werden Leerzeichen verwendet, um von Benutzern ausgegebene Abfragewerte mit einem Token zu versehen. Wenn eine Abfragevariable zu einem Wert erweitert wird, der ein Leerzeichen enthält, wird der gesamte Wert in doppelte Anführungszeichen eingeschlossen. Beispiel: Der Wert für die Abfrage "author:{User}" wird wie folgt erweitert: author:"John Smith".
Soll der Wert nicht in doppelte Anführungszeichen eingeschlossen werden (beispielsweise beim Verketten mehrerer Werte), können Sie in der Abfragevariablen das Escapezeichen verwenden. Beispiel: "customProperty:"{\User.Name};{\User.ZipCode}"" würde aufgelöst zu "customProperty:"John Smith;98109"".
Abfragevariablen mit mehreren Werten
Von einigen Abfragevariablen werden unter Umständen mehrere Werte zurückgegeben. Für Abfragevariablen, von denen mehrere Werte zurückgegeben werden, muss die folgende Syntax verwendet werden: {|VerwalteteEigenschaft:{Abfragevariable}}. Alle Abfragevariablenwerte werden durch den bitweisen OR-Operator verknüpft. Beispiel: Sie verfügen über einen Ausdruckssatz zum Kategorisieren der Interessen von Benutzern. Alle Benutzer sind in der Benutzerprofildienst-Anwendung mithilfe der mehrwertigen Eigenschaft "SPS-Interests" so konfiguriert, dass sie mindestens ein Interesse haben. Mithilfe folgender Syntax kann eine Abfrage nach den Interessen des aktuellen Benutzers ausgeführt werden: {|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}}. Wenn der aktuelle Benutzer so konfiguriert ist, dass er zwei Interessen hat: Fußball (#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) und Basketball (#0c2cff933-9377-4692-aa98-ce59768aa38b), wird die Abfrage in (9377-4692-aa98-ce59768aa38b) transformiert.owstaxIdMetadataAllTagsInfo:#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo:#0c2cff933-9377-4692-aa98-ce59768aa38b) .
Bei der Verwendung mehrerer Werte gelten einige Einschränkungen. Für mehrere Werte wird ausschließlich der OR-Operator ("{|") unterstützt. Der AND-Operator wird nicht unterstützt. Des Weiteren wird in Fällen mit mehreren Werten nur in Spalten vom Typ "Verwaltete Metadaten" ein korrektes Ergebnis erzielt. Bei anderen Spaltentypen mit mehreren Werten (beispielsweise Spalten vom Typ "Person", "Gruppe" oder "Auswahl") werden die Elemente zu einer getrennten Zeichenfolge erweitert.