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

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

範例查詢子句

如需查詢的一般資訊，請參閱查詢工作項目。 如需如何使用鍵盤快速鍵在查詢編輯器或查詢檢視內巡覽的詳細資訊，請參閱使用 Team Web Access 或 Team Explorer 時所適用的鍵盤快速鍵。

本主題內容

• 及/或

• 查詢欄位和值

• 查詢運算子

• 查詢變數

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

• 查詢索引欄位

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

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

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

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

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

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	支援格式化描述的文字字串，例如 [描述] 或 [重新產生步驟] 欄位。 當全文檢索搜尋可用時，這些欄位會自動索引以供全文檢索搜尋之用。 請參閱本主題稍後說明的全文檢索和部分文字搜尋。 注意事項 升級 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
<>	不符合子句中的值。	數字、String、DateTime 和 TreePath
>	大於子句中的值。	數字、String 和 DateTime
<	小於子句中的值	數字、String 和 DateTime
>=	大於或等於子句中的值。	數字、String 和 DateTime
<=	小於或等於子句中的值。	數字、String 和 DateTime
=[欄位]	符合指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
<>[欄位]	不符合指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
>[欄位]	大於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
<[欄位]	小於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
>=[欄位]	大於或等於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
<=[欄位]	小於或等於指定之欄位中包含的值。	與指定之欄位屬於相同資料型別的欄位名稱
包含	在您所選用於篩選的欄位中包含文字字串的完全或部分符合。	String
不包含	在您所選用於篩選的欄位中未包含文字字串的完全或部分符合。	String
包含文字	在您所選用於篩選的欄位中包含完整文字字串或單字。 您也可以輸入包含萬用字元 * 的部分單字或片語。 如需相關限制，請參閱全文檢索搜尋以了解伺服器和定序需求。	對應於所有 PlainText 和 HTML 欄位與 [標題]，已編列索引供全文檢索搜尋之用的長文字欄位。
不包含文字	在您所選用於篩選的欄位中未包含完整文字字串或單字。	已編列索引供全文檢索搜尋之用的文字欄位。
In	符合分隔之集合中的任何值。 例如，如果您針對 ID 欄位指定 100、101 和 102，就可以找到具有這些 ID 值的工作項目。 重要 使用針對用戶端電腦定義之地區設定的對應清單分隔符號，來分隔值。例如，您可能會使用逗號 (,)。	數字、String、DateTime、TreePath
在群組中	符合子句中群組成員的值。 群組對應至分類或 TFS 群組的名稱。 例如，您可以建立一個查詢，以尋找所有指派給 Contributors 群組成員或小組的工作項目。 當您建立小組時，會建立小組群組。 小組群組的名稱遵循模式 [Team Project Name]\ Team Name。 您不能將安全性或電子郵件通訊群組指定為值。 如需已處理的範例，請參閱查詢範例。	符合 Team Foundation Server 中使用者群組或分類群組名稱的 String。 注意事項 您只能將 [在群組中] 運算子與具有 String 資料類型的欄位或 [工作項目類型] 欄位搭配使用。 如需分類群組的詳細資訊，請參閱使用分類以分組工作項目類型。
不在群組中	不符合子句中群組成員的值。	String，符合 Team Foundation Server 中某個使用者群組的名稱，或針對 Team 專案定義之分類群組的名稱。 注意事項 您只能將 [不在群組中] 運算子與具有 String 資料類型的欄位或 [工作項目類型] 欄位搭配使用。 如需分類群組的詳細資訊，請參閱使用分類以分組工作項目類型。
曾經是	之前曾符合子句中的值。	String, DateTime
在其下	符合子句中的值或是包含在子句中的節點下。	TreePath
不在其下	不符合子句中的值而且不包含在子句中的節點下。	TreePath

回到頁首

查詢變數

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

回到頁首

全文檢索和部分文字搜尋

指定 [包含] 或 [不包含] 根據單字或片語的完全或部分符合進行搜尋。 指定 [包含文字] 或 [不包含文字] 搜尋完全相同的片語或使用萬用字元 *。 這些運算子會使用全文檢索搜尋索引。 您只能在部分單字或片語的結尾使用萬用字元。

如需範例，請參閱範例工作項目查詢和使用記錄欄位查詢工作項目。

注意事項
並非所有的部署都支援全文檢索搜尋。例如，SQL Express 和 SQL Azure (支援 Visual Studio Online) 不支援全文檢索搜尋。在這些情況中，您只會看到 [包含] 和 [不包含] 運算子。

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

全文檢索搜尋需要對應至語言的 SQL 定序，而此語言已在 SQL Server 中註冊斷詞工具。 如果用於 Team Foundation Server 執行個體的 Team 專案集合資料庫的定序設定未對應至支援的語言，則搜尋結果可能不符合您的預期。 在這些情況下，您可以嘗試使用 [包含] 或 [不包含] 運算子。

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

查詢索引欄位

除了全文檢索搜尋索引之外，也會建立查詢索引。 這是根據那些啟用索引的欄位所建立。 當您執行包含索引欄位的查詢時，查詢索引會改善回應時間。

下列欄位預設會有索引：[指派給]、[建立日期]、[變更者]、[狀態]、[原因]、[區域 ID]、[反覆項目 ID] 和 [工作項目類型]。 如果您的小組還有其他經常在查詢中使用的欄位，您可以將這些欄位加入至查詢索引。

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

請參閱

概念

查詢工作項目