建立工作項目查詢

更新：2007 年 11 月

使用「查詢」(Query) 以根據工作項目表單中的資訊找出工作項目。簡單的查詢可能會搜尋包含了表單一部分中的特定值之工作項目，例如，指派給您的所有工作項目。較複雜的查詢可以搜尋表單上的幾個值；建立查詢時，可以透過「子句」(Clause) 來限定查詢結果。

在 Team Foundation 工作項目追蹤中，特別針對工作項目的查詢稱為工作項目查詢，而且是使用副檔名 .wiq 識別。

查詢運算子

查詢運算子用於建立工作項目查詢時的查詢子句中。每一個查詢子句由欄位名稱、查詢運算子和值所組成。查詢運算子會決定在判斷工作項目是否應包含在結果中時，所要套用的運算。

下表列出可以在 Team Foundation 工作項目追蹤中使用的查詢運算子。

查詢運算子	說明	適用的欄位型別
=	如果欄位符合指定之值，傳回工作項目。	號碼、文字、日期、樹狀結構
<>	傳回欄位與指定之值不相符的工作項目。	號碼、文字、日期、樹狀結構
>	傳回欄位大於指定之值的工作項目。	號碼、文字、日期
<	傳回欄位小於指定之值的工作項目。	號碼、文字、日期
>=	傳回欄位大於或等於指定之值的工作項目。	號碼、文字、日期
<=	傳回欄位小於或等於指定之值的工作項目。	號碼、文字、日期
包含	如果欄位包含指定之文字值，傳回工作項目。	文字
不包含	傳回欄位未包含指定之文字值的工作項目。	文字
In	傳回欄位符合指定之集合中任何一個值的工作項目。例如，比較 ID 欄位與值集合 100、101 和 102，將傳回工作項目 100、101 和 102。	號碼、文字、日期、樹狀結構
曾經是	搜尋欄位的記錄。如果任一個歷史欄位值符合指定的值，傳回工作項目。	文字、日期
在其下	搜尋樹狀結構欄位，並傳回在值所指定之節點下的所有工作項目。	樹狀結構
不在其下	搜尋樹狀結構欄位，並傳回不在值所指定之節點下的所有工作項目。	樹狀結構

查詢變數可讓您產生查詢的值，此查詢值可讓您建立動態查詢來搜尋目前的日期、目前的使用者或目前的專案。

下表列出 Team Foundation 工作項目追蹤中的可用查詢變數。

查詢變數	結果
@Me	在 [值] 一欄中使用 @Me 值，便能在具有使用者別名的欄位中自動搜尋目前使用者的別名。例如，如果您想要傳回由您開啟的工作項目清單，請將 [欄位] 一欄設定為 [啟動者]，並將 [運算子] 一欄設定為 [=]，再將 [值] 一欄設定為 [@Me]。
@Project	針對任何參考 Team 專案的欄位，於 [值] 一欄中使用 @Project 值，即可在目前的 Team 專案中搜尋。例如，如果您想要傳回目前所選專案的所有作用中工作項目清單，請將 [欄位] 一欄設定為 [Team 專案]，並將 [運算子] 一欄設定為 [=]，再將 [值] 一欄設定為 [@Project]。
@Today	針對任何日期欄位，於 [值] 一欄中使用 @Today 值，即可搜尋目前的日期。此查詢即會進入當它執行時的目前日期，您也可以減去一些天數來修改 @Today 變數。例如，若要尋找上週所啟動的所有項目，您可將 [欄位] 一欄設定為 [啟動日期]，並將 [運算子] 一欄設定為 [>=]，以及將 [值] 一欄設定為 [@Today - 7]。