Azure Boards의 쿼리 필드, 연산자 및 매크로

설명

True/False 값을 사용하는 필드를 지정합니다.

변수(예: 또는 ) 또는 @Today-1값(예01/01/2025: @Today .)을 지정할 수 있는 날짜 필드입니다. 개인 프로필에 대해 설정한 날짜 패턴에 날짜를 입력합니다. (참조) 세부 정보에 대한 개인 기본 설정을 지정합니다 .) 쿼리 예제는 다음을 참조하세요 Query by date or @CurrentIteration.

WIQL 쿼리의 경우 UTC(협정 세계시) 패턴에서 날짜를 지정할 수도 있습니다. 자세한 내용은 WIQL(작업 항목 쿼리 언어)의 구문을 참조하세요.

0.2 또는 3.5와 같은 실수입니다. 쿼리 예제는 숫자 필드별 쿼리를 참조 하세요.

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

기록 정보를 추적하는 데 사용되는 사용자 지정 형식 필드입니다. 이 데이터 형식은 기록 필드를 지원하는 데만 사용됩니다. 이 필드는 전체 텍스트 검색을 사용할 수 있는 경우 전체 텍스트 검색을 위해 자동으로 인덱싱됩니다. 이 문서의 뒷부분에 설명된 전체 텍스트 및 부분 단어 검색을 참조하세요. 쿼리 예제는 기록 및 감사를 참조 하세요.

설명 또는 재현 단계 필드와 같은 서식이 지정된 설명을 지원하는 텍스트 문자열입니다. 전체 텍스트 검색을 사용할 수 있는 경우 전체 텍스트 검색을 위해 이러한 필드가 자동으로 인덱싱됩니다. 이 문서의 뒷부분에 설명된 전체 텍스트 및 부분 단어 검색을 참조하세요. 서식 있는 텍스트 필드를 쿼리하려면 제목, ID 및 서식 있는 텍스트 필드별 쿼리를 참조 하세요.

사용자 ID를 식별하는 짧은 텍스트 문자열입니다.

0, 1, 2, 34와 같이 서명된 32비트 정수입니다.

애플리케이션 시작 정보 필드와 같은 긴 설명을 지원하는 텍스트 문자열입니다. 전체 텍스트 검색을 사용할 수 있는 경우 이러한 필드는 전체 텍스트 검색을 위해 자동으로 인덱싱됩니다. 이 문서의 뒷부분에 설명된 전체 텍스트 및 부분 단어 검색을 참조하세요. 일반 텍스트 필드를 쿼리하려면 제목, ID 및 서식 있는 텍스트 필드별 쿼리를 참조 하세요.

소수점 값의 선택 목록을 포함하도록 정의된 사용자 지정 필드입니다.

정수 값의 선택 목록을 포함하도록 정의된 사용자 지정 필드입니다.

짧은 텍스트 문자열(255자 이하) 값의 선택 목록을 포함하도록 정의된 사용자 지정 필드입니다.

최대 255개의 유니코드 문자를 포함할 수 있는 짧은 텍스트 문자열입니다. 문자열 텍스트 필드는 종종 선택 목록 또는 드롭다운 메뉴를 지원하는 데 사용됩니다.

영역 경로 또는 반복 경로와 같은 분기 트리 구조입니다. 유효한 값 목록에서 항목을 선택합니다. 트리 구조와 같거나, 같지 않거나, 아래 또는 아래에 있지 않은 작업 항목을 찾습니다. 또는 Not In 연산자를 In 사용하여 여러 값을 지정할 수도 있습니다. 프로젝트의 트리 구조(영역 경로 및 반복 경로)를 정의한 다음 팀과 연결할 트리 구조를 선택합니다.

쿼리 생성에 대한 자세한 내용은 영역별 쿼리 또는 반복 경로 또는 날짜 또는 현재 반복별 쿼리를 참조하세요.

작업 항목의 값이 나열된 조건과 일치하는 경우 작업 항목을 반환합니다.

적용 가능한 데이터 형식

절의 값과 일치합니다.

Double, GUID, Integer 및 String, DateTime 및 TreePath를 포함하는 Number

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

Number, String, DateTime 및 TreePath

절의 값보다 큰 경우

Number, String 및 DateTime

절의 값보다 작습니다.

Number, String 및 DateTime

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

Number, String 및 DateTime

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

Number, String 및 DateTime

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

지정된 필드와 데이터 형식이 동일한 필드의 이름
부울 필드가 다른 필드와 같은지 확인합니다.

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

지정된 필드와 데이터 형식이 동일한 필드의 이름
부울 필드가 다른 필드와 같지 않은지 확인합니다.

지정된 필드에 포함된 값보다 큰 경우

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

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

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

지정된 필드에 포함된 값보다 크거나 같은 경우

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

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

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

필터링을 위해 선택한 필드 내의 텍스트 문자열과 정확히 일치하거나 부분적으로 일치하는 항목을 포함합니다.

String

필터링을 위해 선택한 필드 내의 텍스트 문자열과 정확히 일치하거나 부분적으로 일치하는 항목이 없습니다.

String

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

모든 PlainText 및 HTML 필드와 기록 및 제목 필드에 해당하는 전체 텍스트 검색을 위해 인덱싱되는 긴 텍스트 필드입니다.

필터링을 위해 선택한 필드 내의 정확한 텍스트 문자열이나 단어를 포함하지 않습니다. 텍스트 문자열은 100자로 제한됩니다.

이 연산자를 연산자와 절과 함께 Contains Words 사용하여 특정 키워드를 포함 및 제외합니다.

전체 텍스트 검색을 위해 인덱싱된 텍스트 필드입니다.

구분된 집합의 모든 값과 일치합니다. 예를 들어 ID 필드에 해당 값을 지정하면 ID가 100, 101 및 102인 작업 항목을 찾을 수 있습니다. 클라이언트 컴퓨터에 대해 정의된 국가별 설정에 해당하는 목록 구분 기호를 사용하여 값을 구분합니다. 예를 들어 쉼 ,표로 사용할 수 있습니다.

Number, String, DateTime, TreePath

빈 HTML 필드가 포함된 작업 항목을 나열합니다. 이 연산자를 사용하여 값을 지정하지 않습니다. 이 연산자는 Azure Boards 및 Azure DevOps Server에 대해 지원됩니다.

HTML

HTML 필드에 일부 콘텐츠가 포함된 작업 항목을 나열합니다. 이 연산자를 사용하여 값을 지정하지 않습니다. 이 연산자는 Azure Boards 및 Azure DevOps Server에 대해 지원됩니다.

HTML

구분된 집합의 값과 일치하지 않습니다. 상태 필드에 해당 값을 지정하는 경우 쿼리 결과에서 상태가 해결됨, 완료됨 또는 닫혀 있지 않은 작업 항목을 제외할 수 있습니다. 클라이언트 컴퓨터에 대해 정의된 국가별 설정에 해당하는 목록 구분 기호를 사용하여 값을 구분합니다. 예를 들어 쉼 ,표로 사용할 수 있습니다.

Not In 연산자는 Azure Boards 및 Azure DevOps Server에 대해 지원됩니다.

Number, String, DateTime, TreePath

절에 있는 그룹의 멤버인 값과 일치합니다. 그룹은 팀, 보안 그룹 또는 작업 추적 범주의 이름에 해당합니다. 예를 들어 쿼리를 만들어 참가자 그룹 구성원 또는 팀에 할당된 모든 작업 항목을 찾을 수 있습니다. 팀 그룹은 팀을 만들 때 만들어집니다. 팀 그룹의 이름은 [팀 프로젝트 이름]\팀 이름 패턴을 따릅니다.

예를 들어 쿼리는 할당별 쿼리 또는 워크플로 변경 내용을 참조 하세요.

시스템에 정의된 팀, 보안 그룹 또는 범주의 이름과 일치하는 문자열 입니다.

자세한 내용은 범주를 사용하여 작업 항목 유형을 그룹화합니다.

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

Azure DevOps Server의 사용자 그룹 이름 또는 프로젝트에 대해 정의된 범주 그룹과 일치하는 문자열 입니다.

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

TreePath

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

TreePath

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

String , DateTime

설명

작업 항목 유형 또는 상태 필드와 함께 모든 작업 항목 유형 또는 모든 상태에서 검색할 수 있습니다. 예를 들어 Work Item Type=[Any] 작업 항목 유형에 따라 필터를 배치하지 않습니다.

반복 경로 필드와 함께 사용하면 현재 팀 포커스 또는 컨텍스트에 따라 현재 스프린트에 할당된 작업 항목을 자동으로 필터링할 수 있습니다. 특정 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.
@CurrentIteration 매크로는 웹 포털에서 실행할 때만 작동합니다. 테스트 도구 모음 및 테스트 사례를 복사하거나 복제하거나 경고를 정의하거나 REST API를 사용하는 경우 매크로를 사용할 수 없습니다.

반복 경로 필드와 함께 사용하여 현재 팀 포커스 또는 컨텍스트에 따라 현재 스프린트 +/- n 스프린트에 할당된 작업 항목 집합을 필터링합니다. 특정 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.
@CurrentIteration +/- n 매크로는 웹 포털에서 실행할 때 Azure Boards, Azure DevOps Server에 대해 지원됩니다.

ID 필드 및 In 연산자와 함께 프로젝트에서 팔로우하는 모든 작업 항목을 나열합니다. 자세한 내용은 작업 항목 또는 끌어오기 요청 팔로우를 참조하세요. 작업 항목 페이지, 다음 피벗 보기에서 이 동일한 목록을 볼 수 있습니다.
@Follows 매크로는 웹 포털에서 실행되는 경우에만 지원됩니다.

ID 또는 사용자 계정 필드와 함께 사용하여 사용자 또는 계정 이름과 연결된 항목을 자동으로 검색합니다. 예를 들어 절 Created By=@Me을 사용하여 연 작업 항목을 찾을 수 있습니다. 자세한 예제는 할당, 워크플로 또는 보드 변경 내용별 쿼리를 참조 하세요.

ID 필드 및 In 연산자와 함께 지난 30일 이내에 프로젝트에서 보거나 업데이트한 작업 항목을 나열합니다. 작업 항목 페이지 내 활동 피벗 보기에서 이 동일한 목록을 볼 수 있습니다.

팀 프로젝트 필드와 함께 사용하여 다른 프로젝트의 작업 항목을 필터링합니다. 예를 들어 절을 사용하여 현재 선택한 프로젝트에서 Team Project=@Project모든 작업 항목을 찾을 수 있습니다. 시스템은 현재 프로젝트에 따라 자동으로 필터링을 기본값으로 지정합니다. 자세한 내용은 쿼리 정의, 프로젝트 간 쿼리를 참조 하세요.

ID 필드 및 In 연산자와 함께 토론 섹션에서 언급한 작업 항목을 나열합니다. 작업 항목 페이지, 멘션된 피벗 보기에서 이 동일한 목록을 볼 수 있습니다.

ID 필드 및 In 연산자와 함께 사용하여 최근에 업데이트된 작업 항목을 나열합니다. 나열된 작업 항목 수는 프로젝트의 작업 추적 작업에 따라 달라집니다. 매우 활발한 프로젝트의 경우 매크로는 지난 30일 이내에 프로젝트에서 업데이트된 작업 항목을 나열합니다. 그러나 활성 프로젝트가 적은 경우 이 목록에는 30일보다 오래된 작업 항목이 포함될 수 있습니다. 최근에 만든 작업 항목 페이지, 최근에 업데이트된 피벗 보기 및 최근에 완료된 피벗 보기에서 유사한 목록을 볼 수 있습니다. 반환되는 작업 항목 수는 5,000개로 제한됩니다.

필드와 함께 현재 날짜와 DateTime 관련된 작업 항목을 필터링하거나 더하기/빼기 오프셋을 사용하여 필터링합니다. 예를 들어 절 Closed Date>=@StartOfDay-7을 사용하여 지난 주에 닫힌 모든 항목을 찾을 수 있습니다. 자세한 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.

필드와 DateTime 함께 현재 월과 관련된 작업 항목을 필터링하거나 더하기/빼기 오프셋을 사용하여 필터링합니다. 예를 들어 절 Created Date>=@StartOfMonth-3을 사용하여 지난 3개월 동안 만든 모든 항목을 찾을 수 있습니다. 자세한 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.

필드와 DateTime 함께 현재 주와 관련된 작업 항목을 필터링하거나 더하기/빼기 오프셋을 사용하여 필터링합니다. 예를 들어 절 Changed Date>=@StartOfWeek-2을 사용하여 지난 2주 동안 변경된 모든 항목을 찾을 수 있습니다. 자세한 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.

필드와 함께 현재 연도와 DateTime 관련된 작업 항목을 필터링하거나 더하기/빼기 오프셋을 사용하여 필터링합니다. 예를 들어 절을 사용하여 현재 연도 Target Date>=@StartOfYear내에 대상 날짜가 예약된 모든 기능을 찾을 수 있습니다. 자세한 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.

영역 경로 필드에만 사용하여 특정 팀에 할당된 영역 경로에 해당하는 작업 항목을 필터링합니다. 연산자를 = 사용해야 합니다. 예를 들어 절 Area Path=@TeamAreas [Fabrikam Fiber]\Web을 사용하여 웹 팀에 할당된 영역 경로에 할당된 모든 항목을 찾을 수 있습니다. 자세한 예제는 영역별 또는 반복 경로별 쿼리를 참조 하세요.
@TeamAreas 매크로는 웹 포털에서 실행되는 경우에만 Azure DevOps Server에서 지원됩니다.

필드와 DateTime 함께 현재 날짜 또는 이전 날짜와 관련된 작업 항목을 필터링할 수 있습니다. 일자를 빼서 @Today 매크로를 수정할 수도 있습니다. 예를 들어 절 Created Date>=@Today-7을 사용하여 지난 주에 만든 모든 항목을 찾을 수 있습니다. 자세한 예제는 날짜 또는 현재 반복별 쿼리를 참조 하세요.