다음을 통해 공유


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

업데이트: 2012 년 8 월

찾고 작업 항목 쿼리에 작업 항목 목록을 만들 수 있습니다.하나 이상의 절을 정의 하 여 팀 프로젝트 또는 원하는 작업 항목의 집합을 반환 하는 팀 프로젝트 컬렉션 내의 모든 작업 항목을 필터링 합니다.각 절에 대한 필드, 연산자 및 값 또는 변수를 지정합니다.예를 들어, 특정 팀 프로젝트의 모든 작업 항목을 지정 하 여 검색할 수 있습니다에서 팀 프로젝트 필드, 같음 (=) 연산자 및 값으로 팀 프로젝트의 이름입니다.값을 지정 하지 않고 변수 같은 지정한 수 @Project, 현재 팀 프로젝트를 나타냅니다.

샘플 쿼리 절

And/Or

필드

Operator

And

팀 프로젝트

=

@Project

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

항목 내용

  • And/Or

  • 쿼리 필드 및 값

  • 쿼리 연산자

  • 쿼리 변수

  • 전체 텍스트 및 부분 단어 검색

  • 인덱스 필드 쿼리

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

  1. 첫 번째 빈 행에서 아래는 필드 열 머리글을 사용할 수 있는 필드 목록을 표시 하려면 아래쪽 화살표를 선택 하 고 목록에서 항목을 선택 합니다.

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

  2. 동일한 행에서 아래는 운영자 열 머리글을 사용할 수 있는 연산자의 목록을 표시 하려면 아래쪽 화살표를 선택 하 고 목록에서 항목을 선택 합니다.

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

  3. 같은 행에서 아래는 열 머리글을 중 하나에 값을 입력 하거나 아래쪽 화살표를 선택 하 고 목록에서 항목을 선택 합니다.

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

  5. 절을 추가 하려면 새 절을 추가 하려면 여기를 클릭 하십시오. 또는 새 조건절 추가.

    필요한 경우 쿼리의 끝에 절을 추가하고, 기존 절 뒤에 절을 삽입하고(쿼리 절 삽입), 절을 제거(쿼리 절 삭제), 그룹화(쿼리 절 그룹화) 및 그룹 해제(쿼리 절 그룹 해제)할 수 있습니다.

And/Or

지정한 또는 또는 논리 식을 쿼리 절을 만듭니다.지정한 현재 절과 선행 절이 모두 조건을 만족 하는 작업 항목을 찾을 수 있습니다.지정 또는 현재 절 또는 이전 절에서 조건을 충족 하는 작업 항목을 찾을 수 있습니다.

원하는 작업 항목 집합만 반환 되도록 검색 조건을 구체화 하기 위해 각 작업 항목 필드에 대해 새 절을 추가할 수 있습니다.쿼리에서 원하는 결과를 얻지 못하면 쿼리 절을 추가, 제거, 그룹화 또는 그룹 해제하여 쿼리 결과를 구체화할 수 있습니다.

쿼리 절을 그룹화하여 나머지 쿼리와 독립된 하나의 단위로 실행할 수 있습니다. 이는 방정식이나 논리 문에서 식을 괄호로 묶는 것과 같습니다.절을 그룹화하면 그룹의 첫 번째 절에 대한 AND 또는 OR 연산자가 전체 그룹에 적용됩니다.

다음 예제와 같이 그룹화 된 절이 해당 논리식으로 변환 됩니다.첫 번째 식은 우선 순위 1, 뿐만 아니라 모든 우선 모든 활성 버그 작업 항목을 반환 합니다.두 번째 식은 현재 모든 우선 순위 1 작업 항목을 반환 뿐만 아니라 모든 우선 순위 1 버그를 활성화 되어 있는지 여부.

그룹화된 절

논리 식

그룹화된 AND 절이 있는 OR 연산자

우선 순위=1 OR (작업 항목 형식=버그 AND 상태=활성)

그룹화된 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에 대한 작업 항목 필드 참조을 참조하십시오.

쿼리 연산자

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

적용 가능한 데이터 형식

=

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

Number, which includes Double, GUID, Integer, and String, DateTime, andTreePath

<>

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

Number, String, DateTime, andTreePath

>

조건절의 값보다 큽니다.

번호, String, 및DateTime

<

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

번호, String, 및DateTime

>=

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

번호, String, 및DateTime

<=

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

번호, String, 및DateTime

=[Field]

지정 된 필드에 포함 된 값을 찾습니다.

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

<>[Field]

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

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

>[Field]

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

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

<[Field]

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

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

>=[Field]

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

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

<=[Field]

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

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

포함

가 정확 하 게 또는 부분 일치 필터링을 선택한 필드 내에서 텍스트 문자열을 포함 합니다.

String

포함 안 함

가 정확 하 게 또는 부분 일치 필터링을 선택한 필드 내에서 텍스트 문자열을 포함 하지 않습니다.

String

단어를 포함합니다.

정확한 텍스트 문자열 또는 필터링에 대해 선택한 필드 내에서 단어를 포함 합니다.와일드 카드 문자를 포함 하는 구 또는 부분 단어를 입력할 수도 있습니다 *.제한에 대한 참조 하십시오 전체 텍스트 검색 서버 및 데이터 정렬 요구 사항에 대한.

모든 항목에 해당 하는 전체 텍스트 검색에 대한 인덱스는 긴 텍스트 필드 PlainText 및 HTML 필드 및 및 제목.

단어를 포함 하지 않습니다.

정확한 텍스트 문자열 또는 필터링에 대해 선택한 필드 내에서 단어를 포함 하지 않습니다.

전체 텍스트 검색에 대한 인덱스는 텍스트 필드입니다.

In

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

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

Number, String, DateTime,TreePath

그룹에 포함

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

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

String범주 그룹이 나 사용자 그룹의 이름을 일치 하는 Team Foundation Server.

참고참고
사용할 수는 그룹 연산자만 사용 하는 필드는 String 데이터 형식 또는 작업 항목 형식 을 필드.

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

그룹에 포함되지 않음

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

String와 일치 하는 사용자 그룹의 이름을 Team Foundation Server 또는 팀 프로젝트에 대해 정의 하는 범주 그룹입니다.

참고참고
사용할 수는 그룹이에서 아니라 연산자만 사용 하는 필드는 String 데이터 형식 또는 작업 항목 형식 필드.

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

할당된 적 있음

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

String, DateTime

다음에 속함

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

TreePath

다음에 속하지 않음

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

TreePath

맨 위로 이동

쿼리 변수

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

쿼리 변수

용도

@Me

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

@Project

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

@Today

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

[Any]

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

맨 위로 이동

전체 텍스트 및 부분 단어 검색

지정 포함 또는 포함 되지 않은 정확 하 게 또는 부분 일치 단어 또는 구를 검색 합니다.지정 포함 하는 단어 또는 하지 않습니다 포함 단어 에 대해 정확한 구를 검색 하거나 와일드 카드 문자를 사용 하 *.이러한 연산자는 전체 텍스트 검색 인덱스를 사용합니다.부분 단어 또는 구의 끝에만 와일드 카드 문자를 사용할 수 있습니다.

예제를 보려면 키워드 또는 구문을 기반으로 작업 항목 찾기기록 필드를 사용하여 기록 보기 및 작업 항목 찾기를 참조하십시오.

[!참고]

일부 배포 전체 텍스트 검색을 지원 합니다.예를 들어, SQL Express와 SQL Azure Team Foundation Service를 지 원하는 전체 텍스트 검색을 지원 하지 않습니다.이러한 경우에만 볼 수는 포함없는 연산자.

단어가 포함 된하지 않습니다 포함 단어 긴 텍스트 필드에 대해 만들어진 전체 텍스트 검색 인덱스를 기준으로 항목을 필터링 합니다.Team Foundation모든 긴 텍스트 필드의 데이터 형식으로 인덱스를 자동으로 PlainText 및 HTML , 제목 전체 텍스트 검색에 대한 필드.SQL Server 지 원하는 경우 인덱스와 연산자만 사용할 수 있습니다 Team Foundation Server 전체 텍스트 검색을 지원 합니다.

전체 텍스트 검색에 해당 하는 SQL Server 등록 된 단어 분리기의 언어는 SQL 데이터 정렬이 필요 합니다.팀에 대한 데이터 정렬 설정을 사용 하는 컬렉션 데이터베이스 프로젝트 경우에 Team Foundation Server 인스턴스는 지원 되는 언어를 일치 하지 않는, 검색 결과가 예상과 다를 수 있습니다.이러한 경우에 사용 하 여 시도해 보십시오는 포함 또는 포함 되지 않은 연산자입니다.

자세한 내용은 전체 텍스트 검색 쿼리 및 데이터 정렬 설정을.

인덱스 필드 쿼리

전체 텍스트 검색 인덱스 뿐만 아니라 쿼리 인덱스 생성 됩니다.인덱싱을 사용할 수 있는 해당 필드를 기반으로 합니다.쿼리 인덱스 인덱싱된 필드를 포함 하는 쿼리를 실행할 때 응답 시간을 향상 시킵니다.

기본적으로 다음 필드가 인덱싱됩니다: 담당자, 작성 일자, 변경으로, 상태, 이유, 영역 ID, 반복 ID, 및 작업 항목 형식.팀에서 해당 쿼리를 자주 사용 하는 다른 필드가 있을 경우 쿼리 인덱스에이 추가할 수 있습니다.

사용은 witadmin indexfield 명령을 사용 하거나 필드에 대한 인덱싱을 사용할 수 없게 합니다.자세한 내용은 작업 항목 필드 관리[witadmin]를 참조하십시오.

참고 항목

작업

쿼리 필터 조건 지정

단순 목록(기본값) 쿼리 작업

연결된 계층 구조 작업(작업 항목 트리)

개념

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

기타 리소스

연결된 종속성 작업(직접 링크)

변경 기록

날짜

변경 내용

이유

2012 년 8 월

테이블 필드의 데이터 형식을 설명 하는 수정 및 제거 Description 에서 전체 텍스트 검색에 대한 인덱싱된 필드 집합입니다.두 섹션 전체 텍스트 검색 andn 쿼리 인덱스에 추가 합니다.

향상된 기능 관련 정보