다음을 통해 공유


인덱스를 사용하여 Azure Boards 및 Azure DevOps에서 빠른 참조 데이터 쿼리

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

이 인덱스를 사용하여 쿼리 열기, 정의 및 작업에 대한 예제 쿼리 및 정보에 빠르게 액세스할 수 있습니다. 쿼리 편집기 사용하는 방법을 알아보려면 쿼리 정의를 참조하세요. 쿼리가 결과를 반환하는 데 너무 오래 걸리는 경우 쿼리/모범 사례 정의를 참조 하세요.

예제 쿼리

다음 기준에 따라 작업 항목을 나열할 수 있습니다...


키워드, 와일드카드 쿼리

태그 기반 쿼리

상태, 이유 또는 워크플로 변경 쿼리

날짜 및 반복 기반 쿼리

링크 및 첨부 파일 수 쿼리


쿼리 작업



각 데이터 형식에 대해 지원되는 연산자 및 매크로

다음 표에서는 다양한 필드 데이터 형식에 사용할 수 있는 연산자와 매크로를 나타냅니다. 각 필드는 데이터 형식과 연결됩니다. 작업 항목 필드 인덱스를 사용하여 조회할 수 있는 각 필드의 설명에 나열된 데이터 형식을 찾을 수 있습니다. 쿼리 절을 정의하는 데 사용할 수 있는 연산자는 선택한 필드의 데이터 형식에 따라 달라집니다. 데이터 형식, 연산자 및 매크로에 대한 자세한 설명은 쿼리 필드, 연산자 및 매크로를 참조 하세요.

참고 항목

다음 매크로는 웹 포털에서만 지원됩니다. @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity@TeamAreas. 이러한 매크로가 포함된 쿼리는 Visual Studio/팀 탐색기, Microsoft Excel 또는 Microsoft Project에서 열면 작동하지 않습니다.

데이터 형식

설명

지원되는 연산자 및 매크로

부울

True/False 값을 지원합니다. 쿼리 샘플: 할당 또는 워크플로 변경에 따라 쿼리합니다.

= , <> , =[Field] , <>[Field]

DateTime

변수(예: @Today 또는 @Today-12012년 1월 1일)를 지정할 수 있는 날짜 필드입니다. 개인 프로필에 대해 설정한 날짜 패턴에 날짜를 입력합니다. 자세한 내용은 개인 기본 설정 설정을 참조하세요.

쿼리 예제는 날짜별 쿼리 or@CurrentIteration 참조하세요.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
매크로: @Today모든 DateTime 필드에 유효합니다.

Azure DevOps 2019 업데이트 1 이상 버전에서 지원되는 추가 매크로:
@StartOfDay, @StartOfWeek, @StartOfMonth@StartOfYear, 모든 DateTime 필드에 유효

이중

10진수라고도 하며 picklistDouble1을 포함합니다. 0.2 또는 3.5와 같은 실수입니다.

쿼리 예제: 숫자 필드별로 쿼리합니다.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

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

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

기록

기록 정보를 추적하는 데 사용되며 기록 필드에만 할당된 사용자 지정 형식 필드입니다.

쿼리 예제: 기록 및 감사.

단어 포함, 단어 포함 안 함

HTML

설명 또는 재현 단계 필드와 같은 서식이 지정된 설명을 지원하는 텍스트 문자열입니다. 전체 텍스트 검색을 사용할 수 있는 경우 전체 텍스트 검색을 위해 이러한 필드가 자동으로 인덱싱됩니다. 쿼리 샘플: 제목, ID 및 서식 있는 텍스트 필드별로 쿼리합니다.

Contains Words, Does Not Contain WordsIs Empty2, Is Not Empty2

ID

사용자 ID를 보유하는 데 사용되는 문자열 필드입니다. 쿼리 샘플: 할당 또는 워크플로 변경에 따라 쿼리합니다.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever매크로: @me 모든 ID 필드에 유효합니다.

정수

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

쿼리 샘플: 숫자 필드별 쿼리

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

매크로: @Follows, @MyRecentActivity, @RecentMentions@RecentProjectActivity, ID 필드와 함께 사용할 때 유효합니다.

PlainText

전체 텍스트 검색을 사용할 수 있는 경우 긴 설명을 지원하고 전체 텍스트 검색을 위해 자동으로 인덱싱되는 여러 줄 텍스트 문자열입니다.
쿼리 예제: 제목, ID 및 서식 있는 텍스트 필드별로 쿼리합니다.

Contains Words, Does Not Contain Words, Is EmptyIs Not Empty

String

picklistString1도 포함됩니다. 최대 255개의 유니코드 문자를 포함할 수 있는 짧은 한 줄 텍스트입니다. 문자열 필드는 제목 필드, 선택 목록(드롭다운 메뉴), 사용자 계정, 태그 및 기타 필드를 지원합니다.

쿼리 예제: 제목, ID 및 서식 있는 텍스트 필드 별 쿼리 및 선택 목록 값별 쿼리

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

매크로: [Any]작업 항목 형식 필드에 @Project유효하며 팀 프로젝트 필드에 유효합니다.

TreePath

영역 경로 및 반복 경로 필드를 지원하는 필드 형식입니다. 프로젝트의 트리 구조(영역 경로 및 반복 경로)를 정의합니다.

쿼리 예제: 영역 또는 반복 경로 별로 쿼리하고 날짜 또는 현재 반복을 기준으로 쿼리합니다.

Under, Not Under, =, <>, InNot In

매크로: @TeamAreas3, 영역 경로 필드에 유효
@CurrentIteration반복 @CurrentIteration+/- n경로 필드에 유효한 4

참고 항목

  1. 선택 목록... 데이터 형식은 상속된 프로세스에 대해 정의된 사용자 지정 필드에만 할당됩니다. 상속된 프로세스 모델은 Azure DevOps Server 2019 이상 버전에서만 지원됩니다.
  2. Is EmptyIs Not Empty 연산자는 Azure DevOps Server 2019 RC2 이상 버전에서 지원됩니다.
  3. @TeamAreas 매크로는 Azure Boards 및 Azure DevOps Server 2019 이상 버전에서 지원됩니다.
  4. @CurrentIteration +/- n 매크로는 Azure DevOps Server 2019 이상 버전에서 지원되며 웹 포털에서 실행되는 경우에만 지원됩니다.

날짜 및 시간 패턴

DateTime 필드에 입력하는 날짜 및 시간 패턴은 프로필을 통해 선택한 날짜 및 시간 패턴과 일치해야 합니다. 선택 항목을 보거나 변경하려면 사용자 기본 설정 설정을 참조하세요.

시간 및 로캘 창의 날짜 패턴 드롭다운 옵션을 보여 주는 스크린샷.시간 및 로캘 창의 시간 패턴 드롭다운 옵션을 보여 주는 스크린샷.

날짜 패턴 및 시간 패턴 필드가 있는 시간 및 로캘 창을 보여 주는 스크린샷.

선택 필드에 대한 예제 쿼리

다음 표에서는 일반적인 쿼리 필드와 샘플 쿼리가 제공되는 데이터 형식을 나열합니다. 필드의 데이터 형식을 확인하려면 작업 항목 필드 및 특성 목록 필드 특성을 참조 하세요.

A

B

C

D-E-F

H-P

R

S

T

V-W