Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
이 문서에서는 생성, 변경, 해결 또는 닫힌 날짜를 기준으로 작업 항목을 나열하는 방법과 팀 스프린트에 날짜 매크로(예: @Today) 및 반복 매크로를 사용하는 방법을 보여 줍니다. 반복 경로 기본 사항 및 클라이언트/매크로 제한은 영역별 또는 반복 경로별 쿼리를 참조하세요.
Prerequisites
| Category | Requirements |
|---|---|
| 액세스 수준 | - 공유 쿼리를 보고 실행하려면 프로젝트 멤버. - 공유 쿼리를 추가하고 저장하려면: 최소 기본 액세스입니다. |
| Permissions | 쿼리를 추가할 폴더에 허용을 권한 집합에 기여합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다. |
Note
공용 프로젝트에 대한 관련자 액세스 권한이 있는 사용자는 Basic 액세스 권한이 있는 사용자와 마찬가지로 쿼리 기능에 대한 모든 권한을 가 갖습니다. 자세한 내용은 이해 관계자 액세스에 대한 간단한 참조을 참조하세요.
| Category | Requirements |
|---|---|
| 액세스 수준 | - 공유 쿼리를 보고 실행하려면 프로젝트 멤버. - 공유 쿼리를 추가하고 저장하려면 적어도 기본 액세스가 필요합니다. |
| Permissions | 쿼리를 추가할 폴더에 허용을 권한 집합에 기여합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다. |
지원되는 연산자 및 날짜 매크로
쿼리 편집기에서 DateTime 및 반복 경로 필드에 다음 연산자와 매크로를 사용합니다.
- DateTime 연산자:
= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever - 날짜 매크로:
@StartOfDay,@StartOfWeek,@StartOfMonth,@StartOfYear@Today
이러한 매크로와 결합+/- n할 수 있습니다(예:@Today - 7). - 반복 매크로:
@CurrentIteration및@CurrentIteration +/- n(클라이언트 제한 및 팀 매개 변수 동작에 대한 다음 참고 및 링크 참조).
Note
반복 매크로 및 클라이언트 제한 사항은 반복 페이지에서 자세히 다룹니다. 영역별 또는 반복 경로별 쿼리입니다. 웹 UI 외부의 REST/WIQL을 통해 또는 비웹 클라이언트에서 실행하기 위해 쿼리가 필요한 경우 사용자 환경에서 매크로 지원을 확인하고 매크로를 명시적 경로로 확장하는 것을 고려하십시오.
빠른 날짜 예제(일반적인 쿼리)
지난 30일 동안 만든 항목:
특정 날짜에 수정된 항목:
오늘 해결된 항목:
지정된 기간 내에 닫힌 항목: 지정된 기간
닫힌 날짜가 null(닫힘 아님):
지난 주 내에 상태가 변경된 항목:
@CurrentIteration 매크로 사용(간단한 가이드)
팀의 현재 스프린트를 대상으로 지정하고 @CurrentIteration 스프린트의 슬라이딩 윈도우(예: 마지막 2개, 현재 및 다음 두 스프린트)를 만드는 데 사용합니다@CurrentIteration +/- n. 중요 사항:
-
@CurrentIteration는 쿼리를 실행할 때 사용되는 팀 컨텍스트의 현재 스프린트에 할당된 항목을 반환합니다. -
@CurrentIteration +/- n은 해당 스프린트 창을 n으로 이동합니다. 추세 또는 이월 분석에 유용합니다. - 매크로 동작 및 클라이언트 지원은 다양하기 때문에 팀 매개 변수, 클라이언트가 매크로를 평가하는 방법 및 쿼리를 저장할 때 매크로가 저장/확장되는 방법에 대한 자세한 내용은 영역별 쿼리 또는 반복 경로를 참조하세요.
예제 이미지(웹 포털 쿼리 편집기):
Tip
예상 결과를 반환하지 않는 경우 @CurrentIteration 팀 설정에서 팀에서 선택한 반복 및 반복 날짜 범위를 확인합니다.
날짜 매크로: 일/주/월/연도 시작
매크로 시작은 일관된 상대 날짜 범위를 빌드하는 데 도움이 됩니다.
-
@StartOfDay,@StartOfWeek,@StartOfMonth@StartOfYear- 이러한 매크로를+/- n사용하여 "주 시작 이후" 또는 "지난 3개월"과 같은 범위를 빌드합니다. - 이러한 매크로는 웹 포털 UI에서 평가됩니다. 웹이 아닌 시나리오에서의 동작은 대상 클라이언트에서 테스트했을 때와 다를 수 있으므로, 반드시 대상 클라이언트에서 테스트해 보세요.
예제 쿼리:
WIQL을 직접 사용해야 하는 경우
다음과 같은 경우 WIQL을 사용합니다.
- 반복 경로 변경과 같은
WAS EVER고급 연산자가 필요합니다. - 쿼리 편집기가 절을 지원되지 않는 것으로 차단하거나 표시합니다(예: 일부
Was Ever사용). WIQL 편집기 확장을 사용하면 이러한 쿼리를 작성하고 저장할 수 있습니다.
예제는 WIQL(작업 항목 쿼리 언어) 구문 및 WIQL 편집기 마켓플레이스 확장을 참조하세요.
관련 콘텐츠
REST API
프로그래밍 방식으로 쿼리와 상호 작용하려면 다음 REST API 리소스 중 하나를 참조하세요.