SharePoint Server 中的查詢變數
適用於：
Subscription Edition SharePoint in Microsoft 365
注意：本文不適用於新式Microsoft搜尋體驗和 API。 若要瞭解新式搜尋，請參閱 配置檔查詢變數。
查詢變數
下表顯示 Microsoft 365 中 SharePoint Server 和 SharePoint 的查詢變數，以及如何使用它們的範例。
網站與網站集合屬性
| 查詢變數 | 定義 |
|---|---|
| {Site} 或 {Site.URL} |
發出查詢之網站的 URL。 例如，此值可以用來查詢 Managed 屬性 Path 的內容。 |
| {Site.ID} |
發出查詢之網站的 GUID。 這個值會對應至Managed屬性WebId的值。 |
| {Site.LCID} |
地區設定的數值，如同發出查詢之 [網站] 上 [網站設定] 中的 [地區設定] 所指定。 |
| {Site.Locale} |
以 ll-cc 格式發出查詢的網站語言 - 例如 en-us。 |
| {網站。<property>} |
來自發出查詢之網站 (SPWeb) 的屬性包的任何屬性，包含自訂屬性。 |
| {SiteCollection} 或 {SiteCollection.URL} |
發出查詢之網站集合的 URL。 例如，此值可以用來查詢 Managed 屬性 Path 的內容。 |
| {SiteCollection.ID} |
發出查詢之網站集合的 GUID。 此值對應至 Managed 屬性 SiteID 的值。 |
| {SiteCollection.LCID} |
地區設定的數值，如同發出查詢之 [網站集合] 上 [網站設定] 中的 [地區設定] 所指定。 |
| {SiteCollection.Locale} |
以 ll-cc 格式發出查詢的網站集合語言 - 例如 en-us。 |
| {SiteCollection。<property>} |
來自發出查詢之網站集合 (SPSite) 中根網站 (SPWeb) 的屬性包的任何屬性，包含自訂屬性。 |
頁面、URL Token、查詢字串及要求屬性
| 查詢變數 | 定義 |
|---|---|
| {Page} 或 {Page.URL} |
發出查詢之頁面的 URL。 例如，此值可以用來查詢 Managed 屬性 Path 的內容。 |
| {Page.UsageAnalyticsId} |
使用分析的項目識別碼 |
| {Page。<FieldName>} |
發出查詢之網頁上的欄位值。 例如，如果發出查詢的頁面包含名為 "ContentOwner" 的網站欄，指定 {Page.ContentOwner} 便能允許您查詢 "ContentOwner" 的值。 |
| {URLToken。<integer>} |
來自頁面 URL 的值。 這個整數代表 URL 中值的位置 (由右往左計數)。 例如，針對頁面 http://www.contoso/audio/mp3/1010101，查詢變數 {URLToken.1} 會查詢 URL 中的最後一個值，1010101。 查詢變數 {URLToken.3} 將會查詢 URL 中的倒數第三個值 (audio)。 您最多可以在 URL 中查詢倒數第 9 個位置的值。 |
| {QueryString。<ParameterName>} |
目前頁面 URL 中查詢字串的值。 例如，若目前頁面的 URL 包含像是 ItemNumber=567 的查詢字串，則您可以藉由指定 {QueryString.ItemNumber} 來獲得 567 這個值。 |
| {要求。<PropertyName>} |
目前 http 要求的值 - 例如 {Request.Url}。 |
使用者屬性
| 查詢變數 | 定義 |
|---|---|
| {User} 或 {User.Name} |
發出查詢之使用者的顯示名稱。 例如，此值可以用來查詢 Managed 屬性 Author 的內容。 |
| {User.Email} |
發出查詢之使用者的電子郵件地址。 例如，此值可以用來查詢 Managed 屬性 WorkEmail 的內容。 |
| {User.SID} |
發出查詢之使用者的 SID。 |
| {User.LCID} |
地區設定的數值，如發出查詢之使用者的設定檔中所定義。 |
| {User.PreferredContentLanguage} |
如同發出查詢之使用者設定檔中 [慣用內容語言] 中指定的語言。 |
| {User.PreferredDisplayLanguage} |
如同發出查詢之使用者設定檔中 [慣用顯示語言] 中指定的語言。 |
| {使用者。<property>} |
來自發出查詢之使用者的使用者設定檔的任何屬性 - 例如，SPS-Interests，包括自訂屬性。 |
| {User.Audiences} 僅 (SharePoint) |
與 Managed 屬性 ModernAudienceAadObjectIds上的新式 SharePoint 對象目標篩選搭配使用。 範例: ModernAudienceAadObjectIds:{User.Audiences}。 |
字詞和字詞組屬性
| 查詢變數 | 定義 |
|---|---|
| {Term} 或 {Term.ID} 或 {Term.IDNoChildren} |
前置詞為 #0 之目前網站瀏覽節點的 GUID - 例如 #083e99dcb-7907-4dc9-abc8-b5614a284f1c。 舉例來說，此值可用來查詢 [產品目錄網站集合] 中 Managed 屬性 owstaxIdMetadataAllTagsInfo 或 owstaxIdProductCatalogItemCategory 的內容。 |
| {Term.IDWithChildren} |
前置詞為 # 之目前網站瀏覽節點的 GUID - 例如 #83e99dcb-7907-4dc9-abc8-b5614a284f1c。 這將會傳回所有以目前網站瀏覽字詞或目前網站瀏覽字詞之子項標記的字詞。 例如，這個值可用來查詢產品類別目錄網站集合中 Managed 屬性 owstaxIdProductCatalogItemCategory 的內容。 此值無法用來查詢 Managed 屬性 owstaxidmetadataalltagsinfo 的內容。 |
| {Term.Name} |
網站瀏覽節點的標籤 - 例如 Audio。 |
| {字詞。<property>} |
來自字詞之屬性包的任何屬性，包括自訂屬性。 |
| {TermSet} 或 {TermSet.ID} |
用於目前網站瀏覽之字詞組的 GUID。 |
| {TermSet.Name} |
用於目前網站瀏覽之字詞組的標籤。 |
清單與清單項目屬性
| 查詢變數 | 定義 |
|---|---|
| {List} |
目前清單的 URL。 |
| {List。<property>} |
目前清單的任何屬性。 |
| {ListItem} |
目前清單項目的 URL。 |
| {ListItem。<property>} |
目前清單項目的任何屬性。 |
其他屬性
| 查詢變數 | 定義 |
|---|---|
| {Today+/- <天>數的整數值} |
透過從發出查詢的日期加/減指定天數計算而得的日期。 日期格式為 YYYY-MM-DD。 例如，此值可以用來查詢 Managed 屬性 LastModifiedTime 的內容。 |
| {SearchBoxQuery} |
在頁面的搜尋方塊中輸入的查詢值。 |
| {CurrentDisplayLanguage} |
以 MUI 為根據且格式為 ll-cc 的目前顯示語言。 |
| {CurrentDisplayLCID} |
以 MUI 為根據且格式為 ll-cc 之目前顯示語言的數值。 |
處理值中間的空格
搜尋查詢會使用空白字元，將使用者所發出的查詢值 Token 化。 將查詢變數展開為包含空格的值時，完整的值會以雙引號括起來。 例如，針對 author:{User} 的查詢，展開的值會變成 author:"John Smith"。
如果您不想使用雙引號將值括起來 (例如，在串連多個值時)，則可在查詢變數中使用逸出字元。 例如：customProperty：“{\User.Name};{\User.ZipCode}“ 會變成 customProperty：”John Smith;98109".
含有多個值的查詢變數
部分查詢變數可能會傳回多個值。 針對傳回多個值的查詢變數，必須使用下列語法：{|ManagedProperty:{QueryVariable}}。 所有的查詢變數值將會使用位元 OR 運算來結合。 例如，假設有一個可用來分類使用者興趣的字詞組。 您使用 User Profile Service 應用程式中的多值屬性 SPS-Interests，將所有使用者設定為具有一或多個興趣。 若要針對目前使用者的任一興趣發出查詢，可以使用下列語法：{|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}}。 如果目前的使用者設定為有兩個興趣 - 足球 (#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) 和籃球 (#0c2cff933-9377-4692-aa98-ce59768aa38b) ， 查詢將會轉換為 (owstaxIdMetadataAllTagsInfo：#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo：#0c2cff933-9377-4692-aa98-ce59768aa38b) 。
使用多個值時有一些限制。 只有 OR 運算子 ({|) 支援多個值。 不支援 AND 運算子。 此外，只有類型為 [受管理的中繼資料] 的欄可以針對多值案例正常運作。 可能會使用多個值的其他類型欄 (例如，類型為 [個人]、[群組] 或 [選項] 的欄)，即會將字詞展開為分隔的字串。