查詢欄位、運算子、值和變數

更新：2012 年 8 月

您可以建立工作項目查詢來尋找並建立工作項目清單。您可以定義一個或多個子句，您在 Team 專案或 Team 專案集合中的所有工作項目類型篩選傳回您感興趣的一組工作項目。在每個子句中，您可以指定欄位、運算子和值或變數。例如，若要搜尋特定 Team 專案中的所有工作項目，您可以指定 [ Team Project] 欄位、等於 (=) 運算子，並指定 Team 專案的名稱做為值。如不指定值，您可以改為指定變數，例如表示目前 Team 專案的 @Project 變數。

範例查詢子句

及/或	欄位	運算子	值
And	Team 專案	=	@Project

如需查詢的一般資訊，請參閱尋找 Bug、工作和其他工作項目。如需如何使用鍵盤快速鍵在查詢編輯器或查詢檢視內巡覽的詳細資訊，請參閱查詢編輯器和查詢結果檢視的鍵盤快速鍵。

本主題內容

• 及/或

• 查詢欄位和值

• 查詢運算子

• 查詢變數

• 全文檢索和部分文字搜尋

• 查詢索引欄位

關於如何定義查詢子句的檢查清單：

1. 在第一行空白資料列的 [Field] 資料行標題底下，選擇向下箭號以顯示可用欄位清單，然後選擇清單中的項目。

   如需詳細資訊，請參閱查詢欄位和值。

2. 在相同資料列的 [Operator] 資料行標題底下，選擇向下箭號以顯示可用運算子清單，然後選擇清單中的項目。

   如需詳細資訊，請參閱運算子。

3. 在相同的資料列，在 [值] 資料行標題底下，任一型別值或選取 下拉箭號，然後選取清單中的項目。

4. 如需如何使用變數指定目前的 Team 專案、使用者或日期的詳細資訊，請參閱變數。

5. 若要加入子句，請選取 [按一下這裡將新子句] 或 [將新的子句]。

   您可以視需要在查詢結尾加入子句、在現有子句後面插入子句 ()，以及移動 ()、群組 () 和取消群組 () 子句。

及/或

您指定 [而且] [或] 或建立自己的查詢子句邏輯運算式。指定 [而且] 尋找符合目前子句和上一個子句中之準則的工作項目。指定 [或] 尋找符合目前子句或上一個子句中之準則的工作項目。

您可以為每一個工作項目欄位加入一個新子句，以精簡搜尋準則，只傳回您要的工作項目組。如果您沒有從查詢得到您預期的結果，則可以加入、移除、群組或取消群組查詢子句，以精簡查詢結果。

查詢子句可加以群組，使其當成單一單位運作，並與查詢的其餘部分區隔開來，這種方式與在數學方程式或邏輯陳述式的運算式周圍放置括號類似。當您群組子句時，群組中第一個子句的 AND 或 OR 會套用至整個群組。

如下列例子所示，群組子句會轉譯成對應的邏輯運算式。第一個運算式會傳回優先權 1 的工作項目以及任何優先權的所有待處理的 Bug。第二個運算式會傳回所有作用中的優先權 1 工作項目以及所有優先權 1 Bug，不論它們是否待處理。

群組子句	邏輯運算式
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	Priority=1 AND (Work Item Type=Bug OR State=Active)

如需詳細資訊，請參閱指定查詢篩選準則。

查詢欄位和值

針對該欄位所指定的值必須符合該欄位的資料型別。下表列出支援的資料型別:

資料型別	儲存的資料
DateTime	國際標準時間 (UTC) 時間點。您可以指定變數 (例如 @Today 或 @Today-1)，也可以指定值 (例如 1/1/2012)。
Double	實際數字，例如 0.2 或 3.5。
GUID	字元字串，表示唯一 ID。
History	用來自訂格式化欄位追蹤記錄資訊。這個資料型別只用來支援 [記錄] 欄位。當全文檢索搜尋可用時，這個欄位會指定全文檢索搜尋自動索引。請參閱本主題稍後描述的 全文檢索和部分文字搜尋 。
HTML	支援版本描述的文字字串，例如 [描述] 或 [Repro 步驟] 欄位。當全文檢索搜尋可用時，這些欄位為全文檢索搜尋自動索引。請參閱本主題稍後描述的 全文檢索和部分文字搜尋 。 注意事項 當您升級 Team Foundation Server時， [ [描述] 欄位會從 PlainText 欄位型別變更為 HTML。使用 witadmin changefield 命令可以還原這個欄位的資料型別視需要。請參閱 管理工作項目欄位 [witadmin]。
Integer	32 位元帶正負號的整數，例如 0、1、2、34。
PlainText	支援長描述的文字字串，例如 [應用程式啟動資訊] 欄位。當全文檢索搜尋可用時，這些欄位為全文檢索搜尋自動索引。請參閱本主題稍後描述的 全文檢索和部分文字搜尋 。
String	可以包含多達 255 個 Unicode 字元的簡短文字字串。
TreePath	分支狀樹狀結構，例如 [區域路徑] 或 [反覆項目路徑]。您必須選擇可用值清單中的項目。您可以尋找等於樹狀結構或在樹狀結構底下的工作項目。如需詳細資訊，請參閱建立和修改區域和反覆項目。

回到頁首

查詢運算子

您可以使用下表中的查詢運算子，指定子句中的每個值必須與工作項目中的對應值有何關係。如需指派給工作項目欄位之資料型別的詳細資訊，請參閱Visual Studio ALM 的工作項目欄位參考。

查詢運算子	當工作項目中的值符合所列的準則時，傳回工作項目	適用的資料型別
=	符合子句中的值。	編號，包括 Double、 GUID、 Integer、 String、 DateTime和 TreePath
<>	不符合子句中的值。	Number、 String、 DateTime和 TreePath
>	大於子句中的值。	數字、 String和 DateTime
<	小於子句中的值。	數字、 String和 DateTime
>=	大於或等於子句中的值。	數字、 String和 DateTime
<=	小於或等於子句中的值。	數字、 String和 DateTime
=[欄位]	符合指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
<>[欄位]	不符合指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
>[欄位]	大於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
<[欄位]	小於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
>=[欄位]	大於或等於指定之欄位中包含的值	與指定之欄位屬於相同資料型別的欄位名稱
<=[欄位]	小於或等於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
包含	包含文字字串的完整或部分符合您的篩選選項的欄位中。	String
不包含	不包含文字字串的完整或部分符合您的篩選選項的欄位中。	String
包含文字	包含完全相同的文字字串或文字在您指定的篩選選項的欄位中。您也可以輸入包含萬用字元的部分文字或片語， [*]。如需限制，為伺服器和定序需求請參閱 全文檢索搜尋 。	為全文檢索搜尋索引，對應於所有 PlainText 和 HTML 欄位和 [標題] 的長文字欄位。
不包含文字	包含不正確的文字字串或 Word 在您指定的篩選選項的欄位中。	為全文檢索索引的文字欄位。
In	符合分隔之集合中的任何值。例如，如果您針對 ID 欄位指定 100、101 和 102，就可以找到具有這些 ID 值的工作項目。 重要事項 使用針對用戶端電腦定義之地區設定的對應清單分隔符號，來分隔值。例如，您可能會使用逗號 (,)。	數字， String， DateTime， TreePath
在群組中	符合子句中群組成員的值。您可以在 Team Foundation Server 中指定預設、自訂或分類群組。例如，您可以建立一個查詢，以尋找所有指派給 [Contributors] 群組成員的工作項目。 注意事項 您不能將安全性或電子郵件通訊群組指定為值。	符合使用者群組或分類群組名稱 Team Foundation Server的String 。 注意事項 您可以使用 [在群組中] 運算子只能對使用 String 資料型別或 [工作項目類型] 欄位中的欄位。 如需分類群組的詳細資訊，請參閱定義分類以分組工作項目類型。
不在群組中	不符合子句中群組成員的值。	符合針對 Team 專案定義的一個使用者群組或分類群組名稱在 Team Foundation Server 的String 。 注意事項 [在群組中] 運算子只能對使用String 資料型別的欄位或 [Work Item Type] 欄位使用。 如需分類群組的詳細資訊，請參閱定義分類以分組工作項目類型。
曾經是	之前曾符合子句中的值。	String, DateTime
在其下	符合子句中的值或是包含在子句中的節點下。	TreePath
不在其下	不符合子句中的值而且不包含在子句中的節點下。	TreePath

回到頁首

查詢變數

您可以使用下表中的變數，尋找與目前使用者、目前專案或目前日期相關的工作項目。

查詢變數	使用方式
@Me	使用這個變數以在包含使用者別名的欄位中自動搜尋目前使用者的別名。例如，如果您將 [欄位] 資料行設為 [啟動者]、將 [運算子] 資料行設為 [=]，並將 [值] 資料行設為 [@Me]，就可以找到您所開啟的工作項目。
@Project	使用這個變數以搜尋目前 Team 專案中的工作項目。例如，如果您將 [欄位] 資料行設為 [Team 專案]、將 [運算子] 資料行設為 [=]，並將 [值] 資料行設為 [@Project]，就可以找到目前 Team 專案中的所有工作項目。
@Today	使用這個變數以搜尋與目前日期或更早日期相關的工作項目。您也可以減去一些天數來修改 @Today 變數。例如，如果您將 [欄位] 資料行設為 [啟動日期]、將 [運算子] 資料行設為 [>=]，並將 [值] 資料行設為 [@Today - 7]，就可以找到上週所啟動的所有項目。
[Any]	使用這個變數，以搜尋與針對特定欄位定義之任何值相關的工作項目。

回到頁首

全文檢索和部分文字搜尋

指定 [包含] 或 [不包含] 搜尋物件的文字或片語的完整或部分相符。指定 [包含文字] 或 [不包含文字] 搜尋物件完全相同的片語或使用萬用字元， [*]。這些運算子使用全文檢索搜尋索引。您只能使用萬用字元一部分文字或片語的結尾。

如需範例，請參閱根據關鍵字或片語尋找工作項目和使用記錄欄位檢視記錄並尋找工作項目。

注意事項
並非所有的部署設定為支援全文檢索搜尋。例如， SQL Express 和 SQL Azure，支援 Team Foundation 服務，不支援全文檢索搜尋。在這些情況下，您只會看到 [包含] 和 [不包含] 運算子。

[包含文字] 和 [不包含文字] 以全文檢索搜尋索引的篩選項目建立為長文字欄位。Team Foundation 會自動索引具有 PlainText 和 HTML 資料型別和 [標題] 欄位的所有長文字欄位全文檢索搜尋。支援 Team Foundation Server 支援全文檢索搜尋的索引和運算子只可以使用，在 SQL Server。

全文檢索搜尋要求對應至語言都有一個文字分割電腦移至 SQL Server 註冊的 SQL 定序。如果在您的 Team Foundation Server 執行個體的 Team 專案集合資料庫的定序設定未對應至一個支援的語言，您的搜尋結果不符合您的預期。在這些情況下，您可能嘗試使用 [包含] 或 [不包含] 運算子。

如需詳細資訊，請參閱 全文檢索搜尋查詢及定序設定。。

查詢索引欄位

在對全文檢索搜尋索引的加法，查詢建立索引。它根據有索引允許的欄位。查詢索引改善回應時間，當您執行包含索引鍵欄位的查詢時。

根據預設，下列欄位索引: [指派]、 [建立的日期]、 [變更]、 [狀態]、 [原因]、 [區域識別]、 [反覆項目 ID] 和 [工作項目類型]。如果您的小組在其查詢經常使用的其他欄位，您可以加入查詢中的索引。

您可以使用 witadmin indexfield 命令啟用或停用欄位的索引。請參閱 管理工作項目欄位 [witadmin]。

請參閱

工作

指定查詢篩選準則

處理一般清單 (預設) 查詢

使用連結的階層架構 (工作項目的樹狀目錄)

概念

尋找 Bug、工作和其他工作項目

其他資源

使用連結的相依性 (直接連結)

變更記錄

日期	記錄	原因
2012 年 8 月	描述欄位資料型別和移除的來源 Description 為全文檢索搜尋索引的集合的資料表欄位。加入有關全文檢索搜尋 andn 的兩個部分查詢索引。	補充資訊。