本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

SharePoint Server 2013 的查詢變數

 

適用版本:SharePoint Server 2013

上次修改主題的時間:2016-06-21

摘要:了解當您設定查詢時可以使用的查詢變數。

下列表格顯示適用於 SharePoint Server 2013 的查詢變數,以及如何使用它們的範例。

網站與網站集合屬性

查詢變數 定義

{Site} 或 {Site.URL}

發出查詢之網站的 URL。例如,此值可以用來查詢 Managed 屬性 Path 的內容。

{Site.ID}

發出查詢之網站的 GUID。此值對應至 Managed 屬性 SiteID 的值。

{Site.LCID}

地區設定的數值,如同發出查詢之 [網站] 上 [網站設定] 中的 [地區設定] 所指定。

{Site.Locale}

以 ll-cc 格式發出查詢的網站語言 - 例如 en-us。

{Site.<屬性>}

來自發出查詢之網站 (SPWeb) 的屬性包的任何屬性,包含自訂屬性。

{SiteCollection} 或 {SiteCollection.URL}

發出查詢之網站集合的 URL。例如,此值可以用來查詢 Managed 屬性 Path 的內容。

{SiteCollection.ID}

發出查詢之網站集合的 GUID。

{SiteCollection.LCID}

地區設定的數值,如同發出查詢之 [網站集合] 上 [網站設定] 中的 [地區設定] 所指定。

{SiteCollection.Locale}

以 ll-cc 格式發出查詢的網站集合語言 - 例如 en-us。

{SiteCollection.<屬性>}

來自發出查詢之網站集合 (SPSite) 中根網站 (SPWeb) 的屬性包的任何屬性,包含自訂屬性。

頁面、URL Token、查詢字串及要求屬性

查詢變數 定義

{Page} 或 {Page.URL}

發出查詢之頁面的 URL。例如,此值可以用來查詢 Managed 屬性 Path 的內容。

{Page.UsageAnalyticsId}

使用分析的項目識別碼

{Page.<欄位名稱>}

發出查詢之網頁上的欄位值。例如,如果發出查詢的頁面包含名為 "ContentOwner" 的網站欄,指定 {Page.ContentOwner} 便能允許您查詢 "ContentOwner" 的值。

{URLToken.<整數>}

來自頁面 URL 的值。這個整數代表 URL 中值的位置 (由右往左計數)。例如,針對頁面 http://www.contoso/audio/mp3/1010101,查詢變數 {URLToken.1} 將會查詢 URL 中的最後一個值 (1010101)。查詢變數 {URLToken.3} 將會查詢 URL 中的倒數第三個值 (audio)。您最多可以在 URL 中查詢倒數第 9 個位置的值。

{QueryString.<參數名稱>}

目前頁面 URL 中查詢字串的值。例如,若目前頁面的 URL 包含像是 ItemNumber=567 的查詢字串,則您可以藉由指定 {QueryString.ItemNumber} 來獲得 567 這個值。

{Request.<PropertyName>}

目前 http 要求的值 - 例如 {Request.Url}。

使用者屬性

查詢變數 定義

{User} 或 {User.Name}

發出查詢之使用者的顯示名稱。例如,此值可以用來查詢 Managed 屬性 Author 的內容。

{User.Email}

發出查詢之使用者的電子郵件地址。例如,此值可以用來查詢 Managed 屬性 WorkEmail 的內容。

{User.SID}

發出查詢之使用者的 SID。

{User.LCID}

地區設定的數值,如發出查詢之使用者的設定檔中所定義。

{User.PreferredContentLanguage}

如同發出查詢之使用者設定檔中 [慣用內容語言] 中指定的語言。

{User.PreferredDisplayLanguage}

如同發出查詢之使用者設定檔中 [慣用顯示語言] 中指定的語言。

{User.<屬性>}

來自發出查詢之使用者的使用者設定檔的任何屬性 - 例如,SPS-Interests,包括自訂屬性。

字詞和字詞組屬性

查詢變數 定義

{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。

{Term.<屬性>}

來自字詞之屬性包的任何屬性,包括自訂屬性。

{TermSet} 或 {TermSet.ID}

用於目前網站瀏覽之字詞組的 GUID。

{TermSet.Name}

用於目前網站瀏覽之字詞組的標籤。

清單與清單項目屬性

查詢變數 定義

{List}

目前清單的 URL。

{List.<屬性>}

目前清單的任何屬性。

{ListItem}

目前清單項目的 URL。

{ListItem.<屬性>}

目前清單項目的任何屬性。

其他屬性

查詢變數 定義

{Today+/- <天數的整數值>}

{TodayLocal + /-< 整數值的天數 >}

以新增/outgoingrate 指定的天數至/從時即發出查詢的日期來計算日期。日期格式是 YYYY-公釐-DD以 UTC 時區設定的日期。例如,這個值可用來查詢 LastModifiedTime 之 managed 屬性的內容。

以新增/outgoingrate 指定的天數至/從時即發出查詢的日期來計算日期。日期格式是 YYYY-公釐-DD日期設為其使用者設定檔中的使用者具有所指定的時區。如果使用者尚未指定時間的時區,會使用網站集合中指定的時區。例如,這個值可用來查詢 LastModifiedTime 之 managed 屬性的內容。

{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 運算子。此外,只有類型為 [受管理的中繼資料] 的欄可以針對多值案例正常運作。可能會使用多個值的其他類型欄 (例如,類型為 [個人]、[群組] 或 [選項] 的欄),即會將字詞展開為分隔的字串。

https://technet.microsoft.com/zh-tw/library/jj219574.aspx
顯示: