다음을 통해 공유

영역 또는 반복 경로별 쿼리

  • 아티클

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

영역 경로 및 반복 경로는 모든 작업 항목 형식에 대한 작업 추적 양식에 표시되는 두 개의 필드입니다. 프로젝트(영역 경로 및 반복 경로)에 대해 정의한 다음 팀과 연결할 경로를 선택합니다.

영역 및 반복 경로를 사용하는 방법을 더 잘 이해하려면 팀 및 Agile 도구에 대해 참조하세요.

참고 항목

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

지원되는 연산자 및 매크로

쿼리를 만들고 영역 경로 및 반복 경로 필드를 지정할 때 다음 연산자를 사용할 수 있습니다.

연산자 사용하려는 경우...
= 특정 영역 또는 반복 경로 하나 지정
<> 특정 영역 또는 반복 경로 하나를 필터링합니다.
In 영역 또는 반복 경로 집합을 필터링합니다.
Not In 영역 또는 반복 경로 집합에 할당된 항목을 제외합니다.
Under 선택 영역 또는 반복 경로 아래에 있는 모든 경로를 지정합니다.
Not Under 특정 영역 또는 반복 경로 아래에 할당된 항목을 제외합니다.

이러한 연산자와 함께 반복 경로를 선택할 때 다음 매크로를 사용할 수 있습니다. 예를 들어 날짜 또는 현재 반복별 쿼리를 참조 하세요.

Macro 사용하려는 경우...
@CurrentIteration 선택한 팀 컨텍스트와 연결된 현재 반복을 지정합니다.
@CurrentIteration +/- n 선택한 팀 컨텍스트와 연결된 스프린트의 슬라이딩 윈도우에 할당을 기준으로 항목을 필터링합니다.
@TeamAreas 특정 팀에 할당된 영역 경로를 기준으로 항목을 필터링합니다.

참고 항목

@CurrentIteration +/- n @TeamAreas 및 매크로는 Azure DevOps Server 2019 이상 버전에서 지원됩니다. 이러한 매크로는 웹 포털에서만 지원됩니다. 이러한 매크로가 포함된 쿼리는 Visual Studio/팀 탐색기, Microsoft Excel 또는 Microsoft Project에서 열면 작동하지 않습니다.

영역 경로 쿼리

다음 예제와 같이 In 연산자를 사용하여 여러 영역 경로에 할당된 작업 항목을 필터링하도록 지정할 수 있습니다.

여러 영역에 대한 영역 경로 쿼리

노드 이름 및 키워드(keyword) 기반 쿼리

노드 이름 필드를 사용하여 Contains 연산자를 사용하여 키워드(keyword) 따라 영역 경로에 할당된 작업 항목을 필터링합니다. 노드 이름은 트리 계층 구조의 마지막 노드에 해당하는 영역 경로의 마지막 노드를 지정합니다.

다음 쿼리는 이전 예제와 동일한 결과를 생성합니다.

여러 영역에 대한 노드 이름 쿼리

이 예제에서 필터는 마지막 노드에 "Azure"라는 단어가 포함된 영역 경로에 할당된 작업 항목을 반환합니다.

여러 스프린트 쿼리

다음은 노드 이름 및 In 연산자를 사용하는 또 다른 예제입니다.

여러 영역에 대한 노드 이름 쿼리

팀 영역 경로 쿼리

@TeamAreas 매크로를 사용하여 특정 팀에 할당된 영역 경로에 할당된 항목을 빠르게 찾을 수 있습니다. 연산자를 지정합니다 = . 쿼리 편집기 팀 이름을 입력하라는 메시지가 자동으로 표시됩니다. 팀의 이름을 입력하고 검색 필터 조건에 표시되는 팀 값을 선택하여 추가할 수 있습니다.

팀에 할당된 영역 경로에 대한 쿼리

분류 필드 참조

필드 이름 설명 참조 이름
영역 경로 작업 항목을 제품 기능 또는 팀 영역으로 그룹화합니다. 이 영역은 프로젝트 계층 구조에서 유효한 노드여야 합니다. System.AreaPath
반복 경로 명명된 스프린트 또는 기간별로 작업 항목을 그룹화합니다. 반복은 프로젝트 계층 구조에서 유효한 노드여야 합니다. System.IterationPath

각 필드에 대해 data path=TreePath, reportable type=Dimension, index attribute=True.

256자보다 긴 경로 이름을 정의하는 경우 Microsoft Project에서 지정할 수 없습니다. 이 문제를 방지하려면 10자 이하의 경로 이름을 정의하고 14개 수준 이하의 노드를 중첩하지 마세요.

System.AreaPath 및 System.IterationPath 필드와 같은 시스템 필드에는 대부분의 필드 규칙을 적용할 수 없습니다. 자세한 내용은 규칙 및 규칙 평가를 참조하세요.

다음 필드는 작업 항목 양식에 표시되지 않지만 각 작업 항목 유형에 대해 추적됩니다. 이러한 필드는 프로젝트에 대해 정의된 각 분류 값에 대한 숫자 값을 제공합니다. 이러한 필드를 사용하여 쿼리를 필터링하고 보고서를 만들 수 있습니다.

필드 이름 설명 참조 이름 데이터 형식
영역 ID 이 작업 항목이 할당된 영역의 고유 ID입니다. System.AreaId 정수
반복 ID 이 작업 항목이 할당된 반복의 고유 ID입니다. System.IterationId 정수
노드 이름 영역 경로의 마지막 노드 이름입니다. 예를 들어 영역 경로가 Project\A1\B2\C3이면 노드 이름은 C3입니다. System.NodeName 문자열

보고 가능한 기본 형식은 없음입니다. 영역 ID 및 반복 ID가 인덱싱되고 노드 이름은 인덱싱되지 않습니다. 필드 특성에 대한 자세한 내용은 작업 항목 필드 및 특성을 참조하세요.

REST API

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