다음을 통해 공유


쿼리 필드, 연산자, 값 및 변수

업데이트: 2010년 7월

Visual Studio Team Foundation Server 2010에서 작업 항목을 검색하는 쿼리를 만들 경우 찾으려는 작업 항목 집합을 식별하는 하나 이상의 절을 정의할 수 있습니다. 각 절에 대해 필드, 연산자 및 값 또는 변수를 지정할 수 있습니다. 예를 들어 팀 프로젝트 필드, 같음(=) 연산자 및 팀 프로젝트의 이름을 값으로 지정하여 특정 팀 프로젝트의 모든 작업 항목을 검색할 수 있습니다. 값을 지정하는 대신 현재 팀 프로젝트를 나타내는 @Project와 같은 변수를 지정할 수도 있습니다.

샘플 쿼리 절

And/Or

필드

연산자

And

팀 프로젝트

=

@Project

쿼리에 대한 자세한 내용은 버그, 작업 및 기타 작업 항목 찾기를 참조하십시오. 바로 가기 키를 사용하여 쿼리 편집기 또는 쿼리 뷰를 탐색하는 방법에 대한 자세한 내용은 쿼리 편집기 및 쿼리 결과 뷰의 바로 가기 키를 참조하십시오.

항목 내용

  • And/Or

  • 쿼리 필드 및 값

  • 쿼리 연산자

  • 쿼리 변수

쿼리 절을 정의하는 방법에 대한 검사 목록:

  1. 첫 번째 빈 행에서 필드 열 머리글 아래를 클릭하고 아래쪽 화살표를 클릭하여 사용 가능한 필드 목록을 표시한 다음 목록에서 항목을 클릭합니다.

    자세한 내용은 쿼리 필드 및 값을 참조하십시오.

  2. 동일한 행에서 연산자 열 머리글 아래를 클릭하고 아래쪽 화살표를 클릭하여 사용 가능한 연산자 목록을 표시한 다음 목록에서 항목을 클릭합니다.

    자세한 내용은 연산자를 참조하십시오.

  3. 동일한 행에서 값 열 머리글 아래를 클릭합니다.

  4. 값을 입력하거나 아래쪽 화살표를 클릭한 다음 목록에서 항목을 클릭합니다.

  5. 변수를 사용하여 현재 팀 프로젝트, 사용자 또는 날짜를 지정하는 방법에 대한 자세한 내용은 변수를 참조하십시오.

  6. 절을 추가하려면 **새 조건절을 추가하려면 여기를 클릭하십시오.**를 클릭합니다.

    필요한 경우 쿼리의 끝에 절을 추가하고, 기존 절 뒤에 절을 삽입하고(쿼리 절 삽입), 절을 제거(쿼리 절 삭제), 그룹화(쿼리 절 그룹화) 및 그룹 해제(쿼리 절 그룹 해제)할 수 있습니다. 절의 내용을 복사하여 새 위치에 붙여넣을 수도 있습니다. 자세한 내용은 쿼리 필터 조건 지정을 참조하십시오.

And/Or

이 열을 사용하여 절을 테스트하는 방식을 지정할 수 있습니다. 이 절과 이전 절의 기준을 모두 충족하는 작업 항목을 찾으려면 And를 지정할 수 있습니다. 이 절 또는 이전 절의 기준 중 하나를 충족하는 작업 항목을 찾으려면 Or를 지정할 수 있습니다.

쿼리 필드 및 값

각 필드에 대한 값을 지정할 경우 값이 필드의 데이터 형식을 준수해야 합니다. Team Foundation의 모든 필드에는 다음 표에 나열된 데이터 형식 중 하나가 있습니다.

데이터 형식

저장된 데이터

DateTime

UTC(지역 표준시) 시간입니다. 변수(예: @Today 또는 @Today-1) 또는 값(예: 2009/1/1)을 지정할 수 있습니다.

Double

0.2, 3.5 등과 같은 실수입니다.

GUID

고유 ID를 나타내는 문자열입니다.

HTML

서식 있는 설명을 지원하는 텍스트 문자열입니다.

Integer

0, 1, 2, 34 등과 같은 부호 있는 32비트 정수입니다.

PlainText

설명 필드나 기록 필드처럼 긴 설명을 지원하는 텍스트 문자열이 작업 항목에 대해 정의됩니다. PlainText 필드에 포함되어 있는 구 또는 키워드를 기반으로 작업 항목을 찾을 수 있습니다.

String

최대 255자의 유니코드 문자를 포함하는 텍스트 문자열입니다.

TreePath

영역 경로 또는 반복 경로와 같은 분기 트리 구조입니다. 유효한 값 목록에서 항목을 클릭해야 합니다. 트리 구조나 트리 구조 아래에 있는 작업 항목을 찾을 수 있습니다.

맨 위로 이동

쿼리 연산자

다음 표의 쿼리 연산자를 사용하여 절의 각 값을 작업 항목의 해당 값과 연결하는 방법을 지정할 수 있습니다. 작업 항목 필드에 할당된 데이터 형식에 대한 자세한 내용은 MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용을 참조하십시오.

쿼리 연산자

작업 항목의 값이 나열된 기준과 일치하면 작업 항목을 반환합니다.

적용 가능한 데이터 형식

=

조건절의 값과 일치합니다.

숫자, 텍스트, 날짜, 트리

<>

조건절의 값과 일치하지 않습니다.

숫자, 텍스트, 날짜, 트리

>

조건절의 값보다 큽니다.

숫자, 텍스트, 날짜

<

조건절의 값보다 작습니다.

숫자, 텍스트, 날짜

>=

조건절의 값보다 크거나 같습니다.

숫자, 텍스트, 날짜

<=

조건절의 값보다 작거나 같습니다.

숫자, 텍스트, 날짜

=[Field]

지정된 필드에 포함된 값과 일치합니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

<>[Field]

지정된 필드에 포함된 값과 일치하지 않습니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

>[Field]

지정된 필드에 포함된 값보다 큽니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

<[Field]

지정된 필드에 포함된 값보다 작습니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

>=[Field]

지정된 필드에 포함된 값보다 크거나 같습니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

<=[Field]

지정된 필드에 포함된 값보다 작거나 같습니다.

지정된 필드와 데이터 형식이 동일한 필드의 이름입니다.

포함

조건절에서 텍스트 값을 포함합니다.

Text

포함 안 함

조건절에서 텍스트 값을 포함하지 않습니다.

Text

다음에 포함

구분된 집합의 한 값과 일치합니다. 예를 들어 ID 필드의 값을 지정하여 ID가 100, 101 및 102인 작업 항목을 찾을 수 있습니다.

중요중요
클라이언트 컴퓨터에 대해 정의된 국가별 설정에 해당하는 목록 구분 기호로 값을 구분하십시오.예를 들어 쉼표(,)를 사용할 수 있습니다.

숫자, 텍스트, 날짜, 트리

그룹에 포함

조건절에 있는 그룹의 멤버인 값과 일치합니다. Team Foundation Server에서 기본, 사용자 지정 또는 범주 그룹을 지정할 수 있습니다. 예를 들어 Contributors 그룹의 멤버에게 할당된 모든 작업 항목을 찾는 쿼리를 만들 수 있습니다.

참고참고
보안 또는 전자 메일 그룹을 값으로 지정할 수 없습니다.

Team Foundation Server의 범주 그룹이나 사용자 그룹의 이름과 일치하는 문자열

참고참고
In Group 연산자는 String 데이터 형식을 사용하는 필드나 작업 항목 형식 필드에서만 사용할 수 있습니다.

범주 그룹에 대한 자세한 내용은 작업 항목 형식을 범주로 그룹화를 참조하십시오.

그룹에 포함되지 않음

조건절에 있는 그룹의 멤버인 값과 일치하지 않습니다.

Team Foundation Server의 범주 그룹이나 사용자 그룹의 이름과 일치하는 문자열

참고참고
Not In Group 연산자는 String 데이터 형식을 사용하는 필드나 작업 항목 형식 필드에서만 사용할 수 있습니다.

범주 그룹에 대한 자세한 내용은 작업 항목 형식을 범주로 그룹화를 참조하십시오.

할당된 적 있음

이전의 한 지점에서 조건절의 값과 일치합니다.

텍스트, 날짜

다음에 속함

조건절의 값과 일치하거나 조건절의 노드 아래에 포함됩니다.

트리

다음에 속하지 않음

조건절의 값과 일치하지 않고 조건절의 노드 아래에 포함되지 않습니다.

트리

맨 위로 이동

쿼리 변수

다음 표의 변수를 사용하여 현재 사용자, 현재 프로젝트 또는 현재 날짜와 관련된 작업 항목을 찾을 수 있습니다.

쿼리 변수

용도

@Me

이 변수를 사용하면 사용자 별칭이 포함된 필드에서 현재 사용자의 별칭을 자동으로 검색할 수 있습니다. 예를 들어 필드 열을 활성화한 사람으로 설정하고 연산자 열을 =으로 설정한 다음 열을 @Me로 설정한 경우 자신이 열어 본 작업 항목을 찾을 수 있습니다.

@Project

이 변수를 사용하여 현재 팀 프로젝트에서 작업 항목을 검색할 수 있습니다. 예를 들어 필드 열을 팀 프로젝트로 설정하고 연산자 열을 =으로 설정한 다음 열을 @Project로 설정한 경우 현재 팀 프로젝트의 모든 작업 항목을 찾을 수 있습니다.

@Today

이 변수를 사용하여 현재 날짜나 이전 날짜와 관련된 작업 항목을 검색할 수 있습니다. 현재 날짜에서 며칠을 빼는 방식으로 @Today 변수를 수정할 수도 있습니다. 예를 들어 필드 열을 활성화된 날짜로 설정하고 연산자 열을 >=으로 설정한 다음 열을 @Today - 7로 설정한 경우 지난 주에 활성화한 항목을 모두 찾을 수 있습니다.

[Any]

이 변수를 사용하여 특정 필드에 대해 정의된 값과 관련된 작업 항목을 검색할 수 있습니다.

맨 위로 이동

참고 항목

작업

쿼리 필터 조건 지정

열 추가, 제거, 순서 변경 및 정렬

작업 항목 쿼리 저장, 복사, 이름 바꾸기 및 삭제

작업 항목 나열(기본 목록)

직접 링크 뷰에서 작업 항목 보기 및 수정

트리 뷰에서 작업 항목 보기 및 수정

개념

버그, 작업 및 기타 작업 항목 찾기

기타 리소스

작업 항목 및 쿼리를 팀 멤버와 공유

변경 기록

날짜

변경 내용

이유

2010년 7월

여러 값을 지정할 때 사용하는 구분 기호에 대한 정보가 수정되었습니다.

고객 의견

2010년 9월

In GroupNot In Group 연산자에 대해 지정할 수 있는 값에 대한 정보가 수정되었습니다.

고객 의견