Azure Boards에서 날짜 또는 현재 반복별 쿼리

아티클
04/06/2024

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

이 문서에서는 작업 항목이 생성, 닫힘, 해결 또는 변경된 시기에 따라 나열하는 방법을 알아봅니다. 날짜를 지정하거나 지원되는 매크로를 사용할 수 있습니다. 매크로를 @Today 사용하고 상대 날짜에 대해 더하기 또는 빼기 일 수를 지정합니다. 팀의 현재 스프린트 @CurrentIteration에 대한 과제에 따라 작업 항목을 나열하는 쿼리의 경우 .

예를 들어 다음 쿼리를 사용하여 지난 3일 동안 수정된 작업 항목을 찾습니다.

변경된 날짜 필드가 = 3으로 설정된 쿼리 편집기 보여 주는 >스크린샷

또한 매크로를 CurrentIteration +/- _n_ 사용하여 팀 반복의 슬라이딩 윈도우를 기반으로 쿼리를 만들 수 있습니다.

지원되는 연산자 및 매크로

DateTime 필드 또는 반복 경로 필드를 지정하는 쿼리 절은 다음 표에 나열된 연산자와 매크로를 사용할 수 있습니다.

데이터 형식

지원되는 연산자 및 매크로

DateTime

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

매크로: @StartOfDay, @StartOfWeek, @StartOfMonth@StartOfYear및 @Today. 지원되는 각 매크로와 함께 사용할 +/- _n_ 수 있습니다.

TreePath

= , <> 아래, 아래에 없음
매크로:^{@CurrentIteration 반복 경로 필드에 1}과 @CurrentIteration +/- n²가 유효합니다.

참고:

, @StartOfWeek및 @StartOfMonth@StartOfYear 매크로는 @StartOfDayAzure DevOps Server 2019.1 이상 버전에서 지원되며 웹 포털에서 실행되는 경우에만 지원됩니다.
이 @CurrentIteration +/- n 매크로는 Azure DevOps Server 2019 이상 버전에서 지원되며 웹 포털에서 실행되는 경우에만 지원됩니다.

팁

연산자는 WasEver 반복 경로 필드와 함께 사용할 수 있지만 WIQL 구문을 통해 정의된 경우에만 사용할 수 있습니다. 예제 는 WIQL(작업 항목 쿼리 언어) 구문 참조를 참조하세요.

날짜 및 시간 패턴

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

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

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

매크로 사용에 @CurrentIteration 대한 클라이언트 제한 사항

다음 클라이언트의 @CurrentIteration 쿼리에서 매크로를 사용할 수 있습니다.

Azure Boards에 연결하는 웹 포털
Azure Boards에 연결된 Visual Studio 2019 이상 버전
REST API

Azure Boards, Azure DevOps Server 2019 이상 버전 및 팀을 매개 변수로 포함하는 REST API를 사용하여 쿼리에서 매크로를 사용할 @CurrentIteration +/- n 수 있습니다. 예제는 @CurrentIteration('[Project]/Team')입니다.

이전 버전의 Visual Studio 또는 Microsoft Excel 또는 Microsoft Project에서 매크로가 포함된 @CurrentIteration 쿼리를 열면 오류가 발생합니다. 또한 테스트 도구 모음 및 테스트 사례 , 경고 정의 또는 REST API 를 사용하여 복사하거나 복제할 때는 매크로를 사용할 수 없습니다.

날짜 기반 쿼리

변경된 날짜 또는 특정 기간 동안 작업 항목을 필터링합니다. 포함된 날짜 범위에 맞는 결과만 반환하여 성능에 도움이 될 수 있는 쿼리 범위를 제한합니다. 쿼리를 새로 만드는 경우 쿼리 편집기를 사용하여 쿼리를 나열하고 관리합니다.

모든 필드가 모든 작업 항목 형식에 유효하지는 않습니다. 쿼리에 포함할 수 있는 필드 집합 및 해당 필드가 적용되는 작업 항목 형식의 날짜 필드 로 이동합니다.

팁

개인 프로필에 대해 설정한 날짜 패턴 필드에 날짜를 입력해야 합니다.
절을 그룹화하는 방법을 AND/OR 이해하려면 Azure Boards에서 작업 항목 쿼리 정의의 그룹 절 섹션을 참조하세요. 쿼리에 대한 WIQL 구문을 보려면 WIQL 편집기 확장을 설치하여 모든 쿼리 편집기 항목의 WIQL 버전을 볼 수 있습니다.

에 대한 필터

이러한 쿼리 절 포함

지난 30일 동안 만든 항목입니다.

지난 30일 동안 만든 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷

특정 날짜에 수정된 항목입니다.

특정 날짜에 변경된 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷

오늘 해결된 항목입니다.

오늘 해결된 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷.

지정된 기간 내에 닫힌 항목입니다.

지정된 기간 내에 닫힌 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷

닫혀 있지 않은 항목(마감 날짜는 null)입니다.

닫힌 날짜가 비어 있거나 null인 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷

지난 주 내에 상태 업데이트된 항목입니다.

지난 주 내에 상태 업데이트된 항목에 대한 쿼리 편집기 절을 보여 주는 스크린샷

현재 스프린트 중에 닫힌 항목입니다. 매크로는 <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> 현재 팀 컨텍스트에 대해 정의된 스프린트를 참조합니다.

현재 스프린트 중에 닫힌 항목에 대한 쿼리 편집기 절을 보여 주는 스크린샷

일, 주, 월 또는 연도 날짜 기반 쿼리의 시작 만들기

다음 예제에서는 매크로를 사용하여 다양한 오프셋이 StartOf... 있는 작업 항목을 필터링하는 방법을 보여 줍니다. 자세한 내용은 WIQL(작업 항목 쿼리 언어) 구문을 참조 하세요.

참고 항목

Azure DevOps Server 2019 업데이트 1 이상이 필요합니다.

에 대한 필터

이러한 쿼리 절 포함

지난 2주 동안 버그가 닫혔습니다.

지난 10일 동안 수정된 항목입니다.

지난 10일 동안 변경된 항목을 찾기 위한 쿼리 편집기 절을 보여 주는 스크린샷

향후 3개월 이내에 완료될 예정인 기능입니다.

향후 3개월 이내에 완료될 예정인 기능에 대한 쿼리 편집기 절을 보여 주는 스크린샷

팀의 현재 반복에 대한 쿼리 만들기

팀이 스크럼 프로세스를 따르는 경우 스프린트에서 작업을 완료하도록 예약합니다. 매크로를 사용하여 @CurrentIteration 현재 스프린트에서 완료할 요구 사항, 버그 및 기타 작업의 진행률을 추적할 수 있습니다.

팀의 현재 반복 경로에 해당하는 스프린트에 할당된 모든 항목을 찾습니다. 예를 들어 팀이 Sprint 5에 있는 경우 쿼리는 Sprint 5에 할당된 항목을 반환합니다. 나중에 팀이 Sprint 6에서 작업할 때 동일한 쿼리가 Sprint 6에 할당된 항목을 반환합니다.

참고 항목

매크로가 @CurrentIteration 작동하려면 팀에서 날짜 범위가 현재 날짜를 포함하는 반복 경로를 선택해야 합니다. 자세한 내용은 반복 경로 정의(스프린트라고도 함) 및 팀 반복 구성을 참조하세요. 또한 이 매크로를 포함하는 쿼리는 웹 포털에서 실행할 때만 유효합니다.

이 문서의 앞부분에서도 Client restrictions on the use of the @CurrentIteration macros 참조하세요.

azure Boards는 @CurrentIteration 선택하거나 +/- n 매크로를 @CurrentIteration 팀 매개 변수를 추가합니다. 팀 매개 변수는 현재 팀 컨텍스트에서 파생됩니다.

팀 매개 변수와 함께 CurrentIteration 매크로를 사용하여 쿼리 필터를 보여 주는 스크린샷

팁

매크로가 @CurrentIteration 작동하지 않는 경우 팀에 대해 예상 반복이 선택되고 해당 날짜가 설정되어 있는지 검사.

시스템에서 자동으로 설정하는 팀 매개 변수를 변경하려면 @CurrentIteration 매크로 아래에 추가된 매개 변수 필드에 팀 이름을 입력하여 선택합니다.

팀 매개 변수 선택을 보여 주는 스크린샷

팀 반복 쿼리의 슬라이딩 윈도우 만들기

@CurrentIteration +/- <i>n</i> 팀이 예정된 스프린트에 대해 계획한 작업을 추적하고 이전 스프린트에서 완료되지 않은 작업을 이해하려면 매크로를 사용합니다.

참고 항목

매크로가 @CurrentIteration +/- <i>n</i> 작동하려면 팀에서 조건을 충족 +/- _n_ 하는 반복 경로를 선택해야 합니다. 날짜 범위는 .의 현재 날짜를 @CurrentIteration포함해야 합니다. 반복 경로 의 팀 선택에 대한 자세한 내용은 반복(스프린트) 경로 정의 및 팀 반복 구성을 참조하세요.

이 문서의 앞부분에서도 Client restrictions on the use of the @CurrentIteration macros 참조하세요.

다음 이미지는 클라우드 관리 및 도구 팀에 대해 선택한 마지막 두, 현재 및 다음 두 스프린트에 걸쳐 있는 슬라이딩 윈도우에 할당된 모든 사용자 스토리 및 버그 작업 항목 유형을 나열하는 방법을 보여 줍니다.

CurrentIteration plus 및 minus 절을 보여 주는 스크린샷

이 매크로를 사용하려면 지정한 팀이 매크로에 입력한 값에 걸쳐 +/- _n_ 있는 스프린트 집합을 선택해야 합니다.

스프린트에서 이동한 작업 항목 나열

스프린트에 대해 정의되었지만 나중에 반복 경로 필드에 대한 연산자가 포함된 절이 있는 쿼리를 사용하여 이동한 작업 항목을 나열합니다Was Ever. WIQL 구문을 사용하여 이 쿼리만 생성합니다. WIQL 편집기 Marketplace 확장을 설치하여 쿼리 편집기 WIQL 구문을 편집합니다.

예를 들어 작업 항목에 대한 다음 구문 쿼리는 다음 조건을 충족합니다.

현재 프로젝트에 정의되어 있습니다.
작업 항목 유형은 사용자 스토리 또는 버그와 같습니다.
작업 항목은 Fabrikam 파이버 웹 팀 영역 경로 아래에 있습니다.
작업 항목이 , Completed또는 CutResolved 상태가 아닙니다Closed.
Fabrikam 파이버 웹 팀의 현재 반복 경로에 없습니다.
Fabrikam 파이버 웹 팀의 현재 반복 경로에 할당되었습니다.
이제 Fabrikam 파이버 웹 팀의 현재 반복 +1에 할당됩니다.
지난 30일 이내에 변경되었습니다(스프린트의 길이).

SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

구문의 쿼리 편집기 보기가 표시된 것처럼 표시됩니다.

참고 항목

쿼리 편집기 연산자 옆에 정보 아이콘이 Was Ever 표시되며 절에 문제가 있음을 나타냅니다. 그러나 쿼리는 계속 실행되며 쿼리 차트를 만들 수 있습니다. 쿼리를 수정하려면 WIQL 편집기를 사용해야 합니다.

스프린트에서 이동한 쿼리 편집기 작업 항목을 보여 주는 스크린샷.

시작 날짜 이후 스프린트에 추가된 작업 항목 나열

시작 날짜 이후 스프린트에 새로 만든 작업 항목을 나열하려면 다음 이미지에 표시된 것과 유사한 쿼리를 사용합니다. 이 쿼리는 현재 스프린트에 할당된 작업 항목을 필터링하여 작동하지만 스프린트 날짜가 시작된 후에 만들어졌습니다. 절 created Date = @Today - 28을 사용합니다.

시작 날짜 이후 스프린트에 새로 만들어지고 스프린트에 추가된 쿼리 편집기 작업 항목을 보여 주는 스크린샷

스프린트 범위에 대한 변경 내용을 쿼리하는 다른 옵션은 스프린트 정보, 스크럼 및 프로젝트 관리, 스프린트 범위 변경을 참조 하세요.

날짜 및 반복 경로 필드

날짜 필드를 사용하여 쿼리를 필터링합니다. 이러한 필드 중 일부는 작업 항목이 한 상태에서 다른 상태로 진행됨에 따라 정보로 채워집니다. 이러한 필드 중 일부는 작업 항목 양식에 표시되지 않지만 다음 표에 나열된 작업 항목 유형에 대해 추적됩니다.

필드 이름

설명

작업 항목 유형

활성화된 날짜(참고 1 및 2)

작업 항목이 만들어진 날짜 및 시간 또는 해당 상태 변경된 ClosedNewCompletedDoneActive 날짜 및 시간입니다. 참조 이름=Microsoft.VSTS.Common.ActivatedDate, Data type=DateTime

버그, 변경 요청, 에픽, 기능, 문제, 제품 백로그 항목, 요구 사항, 검토, 위험, 공유 단계, 작업, 테스트 사례, 사용자 스토리

변경 날짜

작업 항목이 수정된 날짜 및 시간입니다. 참조 이름=System.ChangedDate, Data type=DateTime

모두

마감 날짜(참고 2)

작업 항목을 닫은 날짜 및 시간입니다. 참조 이름=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

모두

만든 날짜

작업 항목을 만든 날짜 및 시간입니다. Reference name=System.CreatedDate, Data type=DateTime

모두

기한

문제가 해결될 것으로 예상되는 기한입니다. 참조 이름=Microsoft.VSTS.Scheduling.DueDate, 데이터 형식=DateTime

문제(Agile)

완료 날짜(참고 3)

일정에 작업이 완료되었음을 나타내는 날짜와 시간입니다. 참조 이름=Microsoft.VSTS.Scheduling.FinishDate, Data type=DateTime

요구 사항, 작업, 테스트 계획, 사용자 스토리

반복 경로

명명된 스프린트 또는 기간별로 작업 항목을 그룹화합니다. 반복은 프로젝트 계층 구조에서 유효한 노드여야 합니다. 프로젝트의 반복 경로를 정의하고 팀의 반복 경로를 선택합니다. Reference name=System.IterationPath, Data type=TreePath

모두

해결된 날짜(참고 1 및 2)

작업 항목을 상태로 이동한 Resolved 날짜 및 시간입니다. 참조 이름=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

버그, 변경 요청, 에픽, 기능, 문제, 제품 백로그 항목, 요구 사항, 검토, 위험, 공유 단계, 작업, 테스트 사례, 사용자 스토리

시작 날짜(참고 3)

일정이 작업이 시작되었음을 나타내는 날짜와 시간입니다.

참고 항목

배달 계획은 시작 날짜 및 대상 날짜 필드를 사용하여 기능, 에픽 및 기타 포트폴리오 백로그 항목의 범위를 표시합니다.

참조 이름=Microsoft.VSTS.Scheduling.StartDate, Data type=DateTime

Epic, Feature, Requirement, Task, Test Plan, User Story

상태 변경 날짜

상태 필드의 값이 변경된 날짜 및 시간입니다. 참조 이름=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

모두

목표 날짜

기능, 작업 항목 또는 문제가 완료되거나 해결될 날짜입니다.

참고 항목

배달 계획은 시작 날짜 및 대상 날짜 필드를 사용하여 기능, 에픽 및 기타 포트폴리오 백로그 항목의 범위를 표시합니다.

참조 이름=Microsoft.VSTS.Scheduling.TargetDate, Data type=DateTime

에픽, 기능

참고:

할당 또는 워크플로 변경 내용, 날짜 및 ID 필드별 쿼리도 참조하세요.
이러한 필드를 작업 항목 형식에 대해 정의하려면 작업 항목 형식 정의 섹션에 포함되어 WORKFLOW 야 합니다. 예를 들어 이 구문은 상태로 전환할 FIELDSResolved 때 정의 내에 포함됩니다.
```
 <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
    <SERVERDEFAULT from="clock"  />  
 </FIELD >  
```
Project에서 프로젝트 계획을 만든 다음 해당 계획을 Azure Boards에 저장된 작업과 동기화하면 시작 날짜및 완료 날짜 값이 계산됩니다. 이러한 필드는 작업 항목 양식에 표시되지 않을 수 있지만 백로그 항목과 백로그 항목에 연결된 작업에 대해 계산됩니다. 쿼리 또는 Excel의 결과에서 해당 읽기 전용 값을 볼 수 있습니다.
Important

Microsoft 프로젝트 통합 및 TFSFieldMapping 명령은 다음에서 지원되지 않습니다.
- Visual Studio 2019 및 Azure DevOps Office Integration 2019.
- Azure DevOps Services를 포함한 Azure DevOps Server 2019 이상 버전
Microsoft Excel 통합에 대한 모든 지원은 기본 지원되며 작업 항목의 대량 가져오기 및 업데이트를 지원합니다. Microsoft 프로젝트 사용에 대한 대안은 다음과 같습니다.
- 배달 계획.
- Project 커넥트 또는 GANTT 차트와 같은 Marketplace 확장입니다.

REST API

프로그래밍 방식으로 쿼리와 상호 작용하려면 다음 REST API 리소스 중 하나를 참조하세요.

Azure Boards에서 날짜 또는 현재 반복별 쿼리

지원되는 연산자 및 매크로

날짜 및 시간 패턴

매크로 사용에 @CurrentIteration 대한 클라이언트 제한 사항

날짜 기반 쿼리

일, 주, 월 또는 연도 날짜 기반 쿼리의 시작 만들기

팀의 현재 반복에 대한 쿼리 만들기

팀 반복 쿼리의 슬라이딩 윈도우 만들기

스프린트에서 이동한 작업 항목 나열

시작 날짜 이후 스프린트에 추가된 작업 항목 나열

날짜 및 반복 경로 필드

REST API

피드백

피드백

추가 리소스

Azure Boards에서 날짜 또는 현재 반복별 쿼리

지원되는 연산자 및 매크로

날짜 및 시간 패턴

매크로 사용에 @CurrentIteration 대한 클라이언트 제한 사항

날짜 기반 쿼리

일, 주, 월 또는 연도 날짜 기반 쿼리의 시작 만들기

팀의 현재 반복에 대한 쿼리 만들기

팀 반복 쿼리의 슬라이딩 윈도우 만들기

스프린트에서 이동한 작업 항목 나열

시작 날짜 이후 스프린트에 추가된 작업 항목 나열

날짜 및 반복 경로 필드

관련된 문서

REST API

피드백

피드백

추가 리소스