쿼리 필드, 연산자, 값 및 변수
작업 항목 쿼리를 만들어서 작업 항목 목록을 찾고 만듭니다. 하나 이상의 절을 정의함으로써 팀 프로젝트 또는 팀 프로젝트 컬렉션 내의 모든 작업 항목에서 필터링하여 관심 있는 작업 항목 집합을 반환합니다. 각 절에 대해 필드, 연산자, 그리고 값 또는 변수를 지정합니다. 예를 들어 팀 프로젝트 필드, 등호(=) 연산자 및 팀 프로젝트의 이름을 값으로 지정하여 특정 팀 프로젝트의 모든 작업 항목을 검색할 수 있습니다. 값을 지정하는 대신 현재 팀 프로젝트를 나타내는 @Project와 같은 변수를 지정할 수도 있습니다.
샘플 쿼리 절
And/Or |
필드 |
연산자 |
값 |
And |
팀 프로젝트 |
= |
@Project |
쿼리에 대한 자세한 내용은 작업 항목 쿼리를 참조하십시오. 바로 가기 키를 사용하여 쿼리 편집기 또는 쿼리 뷰를 탐색하는 방법에 대한 자세한 내용은 Team Web Access 및 팀 탐색기 작업에 대한 바로 가기 키를 참조하십시오.
항목 내용
And/Or
쿼리 필드 및 값
쿼리 연산자
쿼리 변수
전체 텍스트 및 부분 단어 검색
쿼리 인덱싱된 필드
쿼리 절을 정의하는 방법에 대한 검사 목록:
첫 번째 빈 행의 필드 열 머리글 아래에서 아래쪽 화살표를 선택하여 사용 가능한 필드 목록을 표시하고 목록에서 항목을 선택합니다.
자세한 내용은 쿼리 필드 및 값을 참조하십시오.
동일한 행의 연산자 열 머리글 아래에서 아래쪽 화살표를 선택하여 사용 가능한 연산자 목록을 표시하고, 목록에서 항목을 선택합니다.
자세한 내용은 연산자를 참조하십시오.
같은 행의 값 열 머리글에 값을 입력하거나 아래쪽 화살표를 선택하고 목록에서 항목을 선택합니다.
변수를 사용하여 현재 팀 프로젝트, 사용자 또는 날짜를 지정하는 방법에 대한 자세한 내용은 변수를 참조하십시오.
절을 추가하려면 새 절을 추가하려면 여기를 클릭하십시오 또는 새 절 추가를 선택합니다.
필요한 경우 쿼리의 끝에 절을 추가하고, 기존 절 뒤에 절을 삽입하고(
.png "쿼리 절 삽입")
), 절을 제거(.png "쿼리 절 삭제")
), 그룹화(.png "쿼리 절 그룹화")
) 및 그룹 해제(.png "쿼리 절 그룹 해제")
)할 수 있습니다.
And/Or
And 또는 Or을 지정해서 쿼리 절의 논리 식을 만듭니다. 현재 절과 이전 절의 조건을 둘 다 충족하는 작업 항목을 찾으려면 And를 지정합니다. 현재 절 또는 이전 절의 조건을 충족하는 작업 항목을 찾으려면 Or을 지정합니다.
원하는 작업 항목 집합만 반환되도록 작업 항목 필드마다 새 절을 하나씩 추가하여 검색 조건을 다시 정의할 수 있습니다. 쿼리에서 원하는 결과를 얻지 못하면 쿼리 절을 추가, 제거, 그룹화 또는 그룹 해제하여 쿼리 결과를 구체화할 수 있습니다.
쿼리 절을 그룹화하여 나머지 쿼리와 독립된 하나의 단위로 실행할 수 있습니다. 이는 방정식이나 논리 문에서 식을 괄호로 묶는 것과 같습니다. 절을 그룹화하면 그룹의 첫 번째 절에 대한 AND 또는 OR 연산자가 전체 그룹에 적용됩니다.
다음 예와 같이 그룹화된 절이 해당 논리 식으로 변환됩니다. 첫 번째 식은 우선 순위 1의 작업 항목과 모든 우선 순위의 활성 버그를 모두 반환합니다. 두 번째 식은 우선 순위 1의 모든 활성 작업 항목과 함께 우선 순위 1의 모든 활성 및 비활성 버그를 반환합니다.
그룹화된 절 |
논리 식 |
|---|---|
.png "그룹화된 AND 절이 있는 OR 연산자") |
우선 순위=1 OR (작업 항목 형식=버그 AND 상태=활성) |
.png "그룹화된 OR 절이 있는 AND 연산자") |
우선 순위=1 AND (작업 항목 형식=버그 OR 상태=활성) |
자세한 내용은 쿼리 필터 조건 지정[리디렉션]을 참조하십시오.
쿼리 필드 및 값
필드에 대해 지정하는 값은 해당 필드의 데이터 형식과 일치해야 합니다. 다음 표에서는 지원되는 데이터 형식을 보여줍니다.
데이터 형식 |
저장된 데이터 |
|---|---|
DateTime |
UTC(지역 표준시) 시간입니다. 변수(예: @Today 또는 @Today-1) 또는 값(예: 2012/1/1)을 지정할 수 있습니다. |
Double |
0.2, 3.5 등과 같은 실수입니다. |
GUID |
고유 ID를 나타내는 문자열입니다. |
History |
사용자 지정 서식 있는 필드는 기록 정보를 추적하는 데 사용됩니다. 이 데이터 형식은 기록 필드를 지원하기 위해서만 사용됩니다. 이 필드는 전체 텍스트 검색을 사용할 수 있을 때 전체 텍스트 검색에 대해 자동으로 인덱싱됩니다. 이 항목의 뒷부분에 설명되어 있는 전체 텍스트 및 부분 단어 검색 을 참조하십시오. |
HTML |
설명 또는 재현 단계와 같은 서식 있는 설명을 지원하는 텍스트 문자열입니다. 이러한 필드는 전체 텍스트 검색을 사용할 수 있을 때 전체 텍스트 검색에 대해 자동으로 인덱싱됩니다. 이 항목의 뒷부분에 설명되어 있는 전체 텍스트 및 부분 단어 검색 을 참조하십시오. 참고 Team Foundation Server로 업그레이드하면 설명 필드가 PlainText 필드 형식에서 HTML로 변경됩니다.필요에 따라 witadmin changefield 명령을 사용하여 이 필드의 데이터 형식을 되돌릴 수 있습니다.작업 항목 필드 관리[witadmin]을 참조하세요. |
Integer |
0, 1, 2, 34 등과 같은 부호 있는 32비트 정수입니다. |
PlainText |
응용 프로그램 시작 정보 필드와 같은 긴 설명을 지원하는 텍스트 문자열입니다. 이러한 필드는 전체 텍스트 검색을 사용할 수 있을 때 전체 텍스트 검색에 대해 자동으로 인덱싱됩니다. 이 항목의 뒷부분에 설명되어 있는 전체 텍스트 및 부분 단어 검색 을 참조하십시오. |
String |
최대 255자의 유니코드 문자를 포함할 수 있는 짧은 텍스트 문자열입니다. |
TreePath |
영역 경로 또는 반복 경로와 같은 분기 트리 구조입니다. 유효한 값 목록에서 항목을 선택해야 합니다. 트리 구조나 트리 구조 아래에 있는 작업 항목을 찾을 수 있습니다. 자세한 내용은 영역 및 반복 경로 추가 및 수정을 참조하십시오. |
맨 위로 이동
쿼리 연산자
다음 표의 쿼리 연산자를 사용하여 절의 각 값을 작업 항목의 해당 값과 연결하는 방법을 지정할 수 있습니다. 작업 항목 필드에 할당된 데이터 형식에 대한 자세한 내용은 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오.
쿼리 연산자 |
작업 항목의 값이 나열된 기준과 일치하면 작업 항목을 반환합니다. |
적용 가능한 데이터 형식 |
|---|---|---|
= |
조건절의 값과 일치합니다. |
Double, GUID, Integer, String, DateTime 및 TreePath를 포함하는 숫자 |
<> |
조건절의 값과 일치하지 않습니다. |
숫자, String, DateTime 및 TreePath |
> |
조건절의 값보다 큽니다. |
숫자, String 및 DateTime |
< |
조건절의 값보다 작습니다. |
숫자, String 및 DateTime |
>= |
조건절의 값보다 크거나 같습니다. |
숫자, String 및 DateTime |
<= |
조건절의 값보다 작거나 같습니다. |
숫자, String 및 DateTime |
=[Field] |
지정된 필드에 포함된 값과 일치합니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
<>[Field] |
지정된 필드에 포함된 값과 일치하지 않습니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
>[Field] |
지정된 필드에 포함된 값보다 큽니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
<[Field] |
지정된 필드에 포함된 값보다 작습니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
>=[Field] |
지정된 필드에 포함된 값보다 크거나 같습니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
<=[Field] |
지정된 필드에 포함된 값보다 작거나 같습니다. |
지정된 필드와 데이터 형식이 동일한 필드의 이름입니다. |
포함 |
필터링을 위해 선택한 필드 내에 정확하게 일치하거나 일부 일치하는 텍스트 문자열이 포함됩니다. |
String |
포함 안 함 |
필터링하도록 선택한 필드에 정확한 또는 일부 일치하는 텍스트 문자열이 포함되어 있지 않습니다. |
String |
단어가 포함됩니다. |
필터링을 위해 선택한 필드 내에 정확한 텍스트 문자열 또는 단어가 포함됩니다. 또한 부분 단어 또는 와일드카드 문자 *가 포함된 구를 입력할 수도 있습니다. 제한 사항은 서버 및 데이터 정렬 요구 사항에 대한 전체 텍스트 검색을 참조하십시오. |
전체 텍스트 검색에 대해 인덱싱된 긴 텍스트 필드로서 모든 PlainText 및 HTML 필드와 제목에 해당합니다. |
단어 포함 안 함 |
필터링하도록 선택한 필드에 정확한 텍스트 문자열 또는 단어가 포함되어 있지 않습니다. |
전체 텍스트 검색에 대해 인덱싱되는 텍스트 필드입니다. |
In |
구분된 집합의 한 값과 일치합니다. 예를 들어 ID 필드의 값을 지정하여 ID가 100, 101 및 102인 작업 항목을 찾을 수 있습니다. 중요 클라이언트 컴퓨터에 대해 정의된 국가별 설정에 해당하는 목록 구분 기호로 값을 구분하십시오.예를 들어 쉼표(,)를 사용할 수 있습니다. |
숫자, String, DateTime, TreePath |
그룹에 포함 |
조건절에 있는 그룹의 멤버인 값과 일치합니다. 그룹은 범주 이름 또는 TFS 그룹에 해당합니다. 예를 들어 Contributors 그룹 멤버 또는 팀에 할당된 모든 작업 항목을 찾는 쿼리를 만들 수 있습니다. 팀 그룹은 팀을 만들 때 만들어집니다. 팀 그룹의 이름은 [팀 프로젝트 이름]\ 팀 이름 패턴을 따릅니다. 보안 또는 전자 메일 배포 그룹을 값으로 지정할 수 없습니다. 작업 예제는 예제 쿼리를 참조하세요. |
Team Foundation Server의 범주 그룹이나 사용자 그룹의 이름과 일치하는 String 참고 그룹에 포함 연산자는 String 데이터 형식을 사용하는 필드 또는 작업 항목 형식 필드에서만 사용할 수 있습니다. 범주 그룹에 대한 자세한 내용은 범주를 사용하여 작업 항목 형식 그룹화를 참조하십시오. |
그룹에 포함되지 않음 |
조건절에 있는 그룹의 멤버인 값과 일치하지 않습니다. |
Team Foundation Server 또는 팀 프로젝트에 대해 정의된 범주 그룹의 사용자 그룹의 이름과 일치하는 String입니다. 참고 그룹에 포함되지 않음 연산자는 String 데이터 형식을 사용하는 필드 또는 작업 항목 형식 필드에서만 사용할 수 있습니다. 범주 그룹에 대한 자세한 내용은 범주를 사용하여 작업 항목 형식 그룹화를 참조하십시오. |
할당된 적 있음 |
이전의 한 지점에서 조건절의 값과 일치합니다. |
String, DateTime |
다음에 속함 |
조건절의 값과 일치하거나 조건절의 노드 아래에 포함됩니다. |
TreePath |
다음에 속하지 않음 |
조건절의 값과 일치하지 않고 조건절의 노드 아래에 포함되지 않습니다. |
TreePath |
맨 위로 이동
쿼리 변수
다음 표의 변수를 사용하여 현재 사용자, 현재 프로젝트 또는 현재 날짜와 관련된 작업 항목을 찾을 수 있습니다.
쿼리 변수 |
용도 |
|---|---|
@Me |
이 변수를 사용하면 사용자 별칭이 포함된 필드에서 현재 사용자의 별칭을 자동으로 검색할 수 있습니다. 예를 들어 필드 열을 활성화한 사람으로 설정하고 연산자 열을 =으로 설정한 다음 값 열을 @Me로 설정한 경우 자신이 열어 본 작업 항목을 찾을 수 있습니다. |
@Project |
이 변수를 사용하여 현재 팀 프로젝트에서 작업 항목을 검색할 수 있습니다. 예를 들어 필드 열을 팀 프로젝트로 설정하고 연산자 열을 =으로 설정한 다음 값 열을 @Project로 설정한 경우 현재 팀 프로젝트의 모든 작업 항목을 찾을 수 있습니다. |
@Today |
이 변수를 사용하여 현재 날짜나 이전 날짜와 관련된 작업 항목을 검색할 수 있습니다. 현재 날짜에서 며칠을 빼는 방식으로 @Today 변수를 수정할 수도 있습니다. 예를 들어 필드 열을 활성화된 날짜로 설정하고 연산자 열을 >=으로 설정한 다음 값 열을 @Today - 7로 설정한 경우 지난 주에 활성화한 항목을 모두 찾을 수 있습니다. |
[Any] |
이 변수를 사용하여 특정 필드에 대해 정의된 값과 관련된 작업 항목을 검색할 수 있습니다. |
맨 위로 이동
전체 텍스트 및 부분 단어 검색
포함 또는 포함 안 함을 지정하여 단어 또는 구의 정확한 일치 또는 부분 일치를 검색합니다. 단어 포함 또는 단어 포함 안 함을 지정하여 정확한 구를 검색하거나 와일드카드 문자 *****를 사용합니다. 이러한 연산자는 전체 텍스트 검색 인덱스를 사용합니다. 부분 단어 또는 구의 끝에만 와일드카드 문자를 사용할 수 있습니다.
예제를 보려면 작업 항목 쿼리 예제 및 기록 필드를 사용하여 작업 항목 쿼리를 참조하십시오.
참고
모든 배포가 전체 텍스트 검색을 지원하지는 않습니다.예를 들어 Visual Studio Online을 지원하는 SQL Express 및 SQL Azure는 전체 텍스트 검색을 지원하지 않습니다.이러한 경우에는 포함 및 포함 안 함 연산자만 나타날 것입니다.
긴 텍스트 필드용으로 만든 전체 텍스트 검색 인덱스 기반의 단어 포함 및 단어 포함 안 함 필터 항목입니다. Team Foundation는 PlainText 및 HTML의 데이터 형식과 전체 텍스트 검색을 위한 제목 필드를 사용하여 모든 긴 텍스트 필드의 인덱스를 만듭니다. 인덱스 및 연산자는 Team Foundation Server를 지원하는 SQL Server가 전체 텍스트 검색을 지원하는 경우에만 사용할 수 있습니다.
전체 텍스트 검색에는 SQL Server로 등록된 단어 분리기가 있는 언어에 해당하는 SQL 정렬이 필요합니다. Team Foundation Server 인스턴스에 사용되는 팀 프로젝트 컬렉션 데이터베이스의 데이터 정렬 설정이 지원되는 언어에 맞지 않는 경우 검색 결과가 기대한 것과 다를 수 있습니다. 이러한 경우에는 포함 또는 포함 안 함연산자를 사용해 볼 수 있습니다.
자세한 내용은 전체 텍스트 검색 쿼리 및 데이터 정렬 설정을 참조하십시오.
쿼리 인덱싱된 필드
전체 텍스트 검색 인덱스뿐만 아니라 쿼리 인덱스도 생성됩니다. 이것은 인덱싱이 활성화된 필드를 기준으로 합니다. 쿼리 인덱스는 인덱싱된 필드를 포함하는 쿼리를 실행할 때 응답 시간을 단축합니다.
기본적으로 담당자, 만든 날짜, 변경한 사람, 상태, 이유, 영역 ID, 반복 ID 및 작업 항목 형식 필드가 인덱싱됩니다. 팀이 쿼리에 자주 사용하는 다른 필드가 있을 경우 쿼리 인덱스에 추가할 수 있습니다.
witadmin indexfield 명령을 사용하여 필드에 대한 인덱싱 사용 가능 여부를 지정합니다. 작업 항목 필드 관리[witadmin]을 참조하세요.