다음을 통해 공유

영역 또는 반복 경로별 쿼리

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

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

Prerequisites

Category Requirements
액세스 수준 - 공유 쿼리를 보고 실행하려면 프로젝트 멤버.
- 공유 쿼리를 추가하고 저장하려면: 최소 기본 액세스입니다.
Permissions 기여 권한이 허용으로 설정된 폴더에 쿼리를 추가합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다.

Note

공용 프로젝트에 대한 관련자 액세스 권한이 있는 사용자는 Basic 액세스 권한이 있는 사용자와 마찬가지로 쿼리 기능에 대한 모든 권한을 가 갖습니다. 자세한 내용은 이해 관계자 액세스 빠른 참조를 참조하세요.

Category Requirements
액세스 수준 - 공유 쿼리를 보고 실행하려면 프로젝트 멤버.
- 공유 쿼리를 추가하고 저장하려면 적어도 기본 권한 액세스가 필요합니다.
Permissions 기여 권한이 허용으로 설정된 폴더에 쿼리를 추가합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다.

Note

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

지원되는 연산자 및 매크로

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

Operator 원하는 경우 사용하세요...
= 특정 영역 또는 반복 경로 하나 지정
<> 특정 영역 또는 반복 경로 하나 필터링
In 영역 또는 반복 경로 집합에 대한 필터
Not In 영역 또는 반복 경로 집합에 할당된 항목 제외
Under 선택한 영역 또는 반복 경로 아래에 모든 경로 지정
Not Under 특정 영역 또는 반복 경로에 할당된 항목 제외

반복 경로 필드를 선택할 때 다음 매크로를 사용할 수 있습니다. 예제는 이 페이지의 쿼리 예제를 참조하세요.

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

Note

Azure DevOps 웹 포털은 @CurrentIteration, @CurrentIteration +/- n, 및 @TeamAreas(서비스 및 서버)와 같은 매크로를 평가합니다. 웹이 아닌 클라이언트(Visual Studio/Team Explorer, Excel, Project) 및 직접 WIQL/REST 호출에는 명시적 영역/반복 경로가 필요하며 원시 매크로 토큰을 허용하지 않습니다. 웹 UI에 쿼리를 저장할 때 포털은 일반적으로 매크로를 저장된 WIQL의 구체적인 값으로 확장합니다. 웹 UI 외부에서 쿼리를 사용해야 하는 경우 사용자 환경에서 이 동작을 확인합니다.

영역 경로 쿼리

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

여러 영역에 대한 영역 경로에 대한 쿼리를 보여 주는 스크린샷

노드 이름 및 키워드 기반 쿼리

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

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

여러 영역에 대한 노드 이름에 대한 쿼리를 보여 주는 스크린샷

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

여러 스프린트에 대한 쿼리를 보여 주는 스크린샷

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

여러 영역에 대한 노드 이름에 대한 쿼리를 보여 주는 스크린샷

팀 영역 경로 쿼리

@TeamAreas 매크로를 사용하여 특정 팀이 사용하는 영역 경로에 할당된 항목을 찾습니다. = 연산자를 지정합니다. 쿼리 편집기에서 팀 이름을 입력하라는 메시지가 표시됩니다. 제안된 목록에서 팀을 선택합니다.

팀에 할당된 영역 경로에 대한 쿼리를 보여 주는 스크린샷

분류 필드 참조

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

각 필드에 대해 데이터 경로=TreePath, 보고 가능한 형식=Dimension, 인덱스 특성=True.

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

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

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

필드 이름 Description 참조 이름 데이터 형식
영역 ID 이 작업 항목을 할당하는 영역의 고유 ID입니다. System.AreaId Integer
이터레이션 ID 이 작업 항목을 할당하는 반복의 고유 ID입니다. System.IterationId Integer
노드 이름 영역 경로의 마지막 노드 이름입니다. 예를 들어 영역 경로가 Project\A1\B2\C3이면 노드 이름은 C3입니다. System.NodeName String

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

관련 콘텐츠

REST API

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

  • Last updated on