工作項目搜尋語法 (Team Web Access)

發行項
08/12/2011

您可以使用 Team Web Access 搜尋方塊來搜尋工作項目。在搜尋方塊中，您可以指定關鍵字和片語，並使用變數和捷徑識別項來尋找工作項目。搜尋並不會區分大小寫。

主題內容：

指定關鍵字和片語
指定欄位
使用 @Me 巨集
使用搜尋運算子

必要的使用權限

您必須是 [Readers] 群組的成員，或是您的 [檢視此節點中的工作項目] 權限已設為 [允許]，才能在 Team Web Access 中執行搜尋。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

指定關鍵字和片語

在 [搜尋] 方塊中輸入關鍵字，就可以使用關鍵字和片語，來尋找工作項目之 [標題] 或 [描述] 欄位中的特定文字。您必須用引號括住每個片語。

下列範例顯示如何在 [標題] 或 [描述] 欄位中尋找關鍵字和片語。

若要尋找包含關鍵字 duplication 的所有工作項目，請輸入下列字串：

Duplication

若要尋找包含片語 Getting Started 的所有工作項目，請輸入下列字串：

"Getting Started"

若要尋找包含片語 Getting Started 和關鍵字 feature 的所有工作項目，請輸入下列字串：

feature "Getting Started"

指定欄位

您可以搜尋 [標題] 和 [描述] 以外的其他欄位。您必須用引號括住每個片語。若要指定工作項目欄位名稱，請依照下列範例所示輸入搜尋字串。

若要尋找處於作用中狀態的所有工作項目，請指定下列兩個搜尋字串的其中一個：

system.State=Active

State=Active
若要尋找處於作用中狀態的所有 Bug 工作項目，請輸入下列字串：

State=Active WorkItemType=bug
若要搜尋指派給某個小組成員的工作項目，請輸入下列字串：

System.AssignedTo="First Last"

對於幾個常用欄位，您可以使用捷徑識別項而非完整名稱，如下表所示：

捷徑	欄位
A	AssignedTo
C	CreatedBy
S	State
T	WorkItemType

下列範例顯示如何使用其中兩個捷徑識別項。

若要尋找處於作用中狀態之任意類型的所有工作項目，請輸入下列字串：

S=Active
若要尋找處於作用中狀態的所有 Bug 工作項目，請輸入下列字串：

S=Active T=bug

使用 @Me 巨集

您可以使用 @Me 巨集來指定搜尋字串，以尋找和自己有關的工作項目。 @Me 巨集會在任何 Team Web Access 搜尋中展開成目前使用者的完整名稱。@Me 巨集特別適用於建立可和其他使用者共用的搜尋，並且可透過減少您在指定自己時所必須輸入的使用者名稱字元數，來簡化您的工作。下列範例顯示如何使用 @Me 巨集來搜尋工作項目。

若要尋找指派給您的所有工作項目，請輸入下列字串：

A=@me
若要尋找由您所建立的所有工作項目，請輸入下列字串：

C=@me

使用搜尋運算子

您可以使用三種搜尋運算子來指定搜尋準則 (如下表所示)。

運算子	說明
=	EQUALS 運算子。請使用這個運算子來搜尋完全相符的文字。
:	CONTAINS 運算子。請使用這個運算子來搜尋部分相符的文字。
-	NOT 運算子。請使用這個運算子來排除包含特定文字的工作項目。 NOT 運算子只能與欄位名稱搭配使用。

下列範例示範如何在建立搜尋字串時使用運算子。

若要尋找指派給您自己的所有工作項目，請輸入下列字串：

A=@me

若要尋找在專業領域欄位中含有文字 proj 的所有工作項目，請輸入下列字串：

Discipline:proj

注意事項
某些欄位 (如 [記錄] 和 [描述]) 不支援部分文字搜尋。例如，如果 [記錄] 欄位包含片語 reproducible behavior，而您搜尋 History:repro，便無法找到這個工作項目。不過，如果您搜尋完整字串 History:reproducible，就會找到這個工作項目。

若要尋找標題或描述中含有關鍵字 triage、未指派給您，而且未關閉的所有工作項目，請輸入下列字串：

triage -A=@me -S=Closed
若要尋找已指派給您但標題中未含關鍵字 bugbash 的所有作用中 Bug，請輸入下列字串：

S=Active W=bug A=@Me -Title:bugbash