Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
쿼리를 사용하여 지정한 필드 조건에 따라 버그, 사용자 스토리 또는 기타 작업 항목을 나열합니다. Teams는 이러한 목록을 실행하여 작업을 심사하거나 항목을 대량 업데이트하거나 계층 구조를 검토합니다. 의미 체계 검색은 탐색할 가치가 있는 겹치고 보완적인 기능을 제공합니다.
관리되는 쿼리를 사용하여 다음을 수행합니다.
- 웹 포털을 사용하여 작업 항목 대량 업데이트
- 작업 항목 심사 및 업데이트
- 작업 항목의 계층 구조 검토
- 팀 동료와 작업 항목 목록 공유
웹 포털 또는 Visual Studio 팀 탐색기에서 쿼리 및 쿼리 폴더를 만들 수 있습니다. 모든 변경 내용이 작업 추적 데이터 저장소에 저장되므로 한 클라이언트에서 변경한 내용이 다른 클라이언트에 표시됩니다.
쿼리 사용 시작
시작하려면 작업 항목 쿼리 보기, 실행 또는 전자 메일로 보내기를 읽어보세요. 쿼리 편집기 작업 및 샘플 쿼리에 대한 빠른 참조는 쿼리 빠른 참조를 참조하세요.
- 할당된 작업 항목을 찾으려면 @Me 매크로를 할당 대상 필드의 값으로 절에서 사용합니다.
- 표준 액세스 권한이 있는 모든 유효한 사용자는 내 쿼리 아래에 쿼리 및 폴더를 만들 수 있습니다. 공유 쿼리에서 쿼리 또는 폴더를 만들려면 참가 권한이 있어야 합니다. 쿼리에 대한 사용 권한 설정을 참조하세요.
- 제품 영역, 반복 또는 다른 필드에 초점을 맞추는 조건을 추가하여 쿼리를 수정합니다. 쿼리를 수정하려면 쿼리 편집기를 엽니다.
- Excel에서 쿼리를 열어 필드를 업데이트하고 데이터베이스에 변경 내용을 게시합니다.
- 플랫 목록 쿼리에 대한 원형, 열 또는 추세 차트를 만들어 상태 또는 진행률을 시각화합니다. 자세한 내용은 차트를 참조 하세요.
쿼리 기능
다음 섹션에서는 작업 항목 쿼리를 정의하고 관리하는 데 사용하는 함수를 요약합니다.
- 쿼리 편집기를 사용하여 쿼리 필터를 정의합니다.
- 절에서 쿼리 매크로를 사용하여 필드를 동적으로 대상으로 지정합니다.
- 쿼리 결과 페이지에서 쿼리 결과 및 폴더를 관리합니다.
쿼리 필터
다음 표에는 각 Azure DevOps 버전에서 지원하는 쿼리 필터 함수가 요약되어 있습니다.
참고 항목
관리되는 쿼리는 근접 검색을 지원하지 않지만 의미 체계 검색은 지원됩니다. 또한 의미 체계 검색은 와일드카드 문자와 와일드카드 문자를 모두 *? 지원하며 둘 이상의 와일드카드 문자를 사용하여 둘 이상의 문자를 일치시킬 수 있습니다. 자세한 내용은 기능 작업 항목 검색을 참조하세요.
필터 함수
쿼리 지원
지원되는 버전
텍스트 문자열 검색 (단일 텍스트, 여러 줄 텍스트, 서식 있는 텍스트)
검색은 대/소문자를 구분하지 않습니다.
모든 버전
와일드 카드 = *
모든 버전
직접 링크 또는 토폴로지/계층적 링크 유형을 기반으로 작업 항목을 찾습니다.
연결된 작업 항목 필터링(MODEWIQL 구문)
모든 버전
AND 및 OR 부울 연산자를 사용하여 절을 그룹화하고 중첩합니다.
모든 버전
이전 값과 일치하는 필드를 기반으로 작업 항목을 찾습니다.
지원되는 연산자: Was Ever 특정 날짜에 정의된 값을 기반으로 작업 항목을 찾습니다.
지원되는 연산자: ASOF (WIQL 구문)
모든 버전
매크로를 사용하여 날짜, 팀 영역 경로, 팀 반복 등과 같은 다른 도구를 기준으로 쿼리를 만듭니다.
모든 버전
조직 또는 컬렉션의 하나 이상의 프로젝트에서 작업 항목을 찾습니다. 기본값은 현재 프로젝트입니다. 팀 프로젝트 필드를 사용하여 둘 이상의 프로젝트를 쿼리합니다.
모든 버전
두 필드가 서로 비교하는 방법에 따라 작업 항목을 찾습니다.
지원되는 연산자: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
모든 버전
태그가 포함되어 있는지 여부에 따라 작업 항목을 찾습니다.
지원되는 연산자: Contains, Does Not Contain
모든 버전
비어 있거나 비어 있지 않은 HTML/서식 있는 텍스트 필드를 기반으로 작업 항목을 찾습니다.
지원되는 연산자: Is Empty, Is Not Empty
모든 버전
작업 항목 형식, 워크플로 상태 또는 선택 목록 값 집합과 같이 필드 값이 구분된 집합의 모든 값과 일치하는 작업을 찾습니다. 클라이언트 컴퓨터에 대해 정의된 국가별 설정에 해당하는 목록 구분 기호를 사용하여 값을 구분합니다. 예를 들어 쉼표(,)를 사용할 수 있습니다.
모든 버전
부울 필드 값을 기반으로 작업 항목을 찾습니다.
모든 버전
토론을 통해 추가된 핵심 단어 또는 구를 기반으로 작업 항목을 찾습니다.
모든 버전
열, 스윔 레인 또는 작업/완료 상태에 따라 작업 항목을 찾습니다.
모든 버전
키워드를 기반으로 쿼리 결과를 필터링하거나 필드를 선택합니다.
모든 버전
쿼리 절을 대량으로 이동, 복사 또는 붙여넣려면 WIQL 편집기를 설치하고 사용합니다.
지원되는 매크로
다음 표에는 Azure DevOps 버전에서 지원하는 쿼리 매크로 또는 변수가 요약되어 있습니다. 이러한 매크로 중 일부를 사용하여 알림을 필터링할 수 있습니다.
참고 항목
웹 포털에서만 특정 매크로를 사용할 수 있습니다. 여기에는 @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity 및 @TeamAreas 매크로가 포함됩니다. 이러한 매크로는 쿼리를 Excel로 내보내거나, 알림 필터를 내보내거나, 팀 탐색기 또는 REST API에서 실행할 때 지원되지 않습니다.
예제에 대한 자세한 설명 및 링크는 쿼리 필드, 연산자 및 매크로를 참조 하세요.
매크로
쿼리 지원
지원되는 버전
작업 항목 유형 또는 Work Item Type=[Any]상태를 State=[Any]찾습니다.
모든 버전
여기에서 Identity field=logged in user작업을 찾습니다.
모든 버전
여기에서 Date-Time field=today작업을 찾습니다.
모든 버전
하나 이상의 프로젝트에 정의된 작업을 찾습니다.
모든 버전
팀의 현재 반복에 정의된 작업을 찾습니다.
모든 버전
팀에 대한 현재 반복의 +/- n에 정의된 작업을 찾습니다.
모든 버전
현재 로그인한 작업 시간을 찾으려면 다음을 수행 ID In @Follows합니다.
모든 버전
최근에 변경된 ID In @MyRecentActivity 작업 항목을 찾습니다. 작업 항목 보기 및 추가 페이지도 참조하세요.
모든 버전
선택한 날짜-시간 필드가 현재 일, 월, 주 또는 연도 내에 더하기/빼기 오프셋이 있는 작업을 찾습니다. 예: Closed Date>=@StartOfDay-7
모든 버전
지정된 팀의 영역 경로 또는 반복 경로에 할당된 작업을 찾습니다. 예를 들어 영역별 쿼리 또는 반복 경로를 참조하세요.
모든 버전
쿼리 결과 및 쿼리 관리 기능
다음 기능은 쿼리 결과 작업, 쿼리 저장 및 공유 등을 지원합니다.
-
대시보드에 쿼리 차트 추가
-
대화형 필터 적용
-
열 정렬 선택
-
쿼리 열 옵션 선택
-
쿼리 결과 복사
-
쿼리 URL 복사
-
쿼리 차트 만들기
-
쿼리 폴더 만들기
-
쿼리 정의 및 편집
-
WIQL 구문 정의
-
전자 메일 쿼리 결과
-
쿼리 즐겨찾기
-
쿼리 필터링
-
쿼리 가져오기/내보내기(csv)
-
쿼리 가져오기/내보내기(.wiq)
-
쿼리 열기 및 실행
-
쿼리 게시/새로 고침(Excel)
-
REST API 쿼리 실행
쿼리 복사 및 저장
-
쿼리 권한 설정
지원되지 않는 기능
쿼리는 작업 항목과 다른 작업 항목에 연결된 작업 항목만 지원합니다. 관리되는 쿼리는 다음을 지원하지 않습니다.
- 테스트 계획, 테스트 도구 모음 및 테스트 사례의 계층적 보기(이러한 항목은 부모-자식 링크를 사용하지 않음). 대신 테스트 > 계획 페이지를 통해 계층 구조를 봅니다.
- 빌드, 릴리스, 코드 또는 기타 작업 항목이 아닌 개체와 같은 연결된 개체를 표시하는 뷰입니다.
- 한 프로젝트에서 다른 프로젝트로 연결된 작업 항목을 나열합니다.
- 프로젝트 간 쿼리를 Excel로 내보내기(직접 링크 쿼리는 플랫 목록으로 내보내기).
쿼리 형식(플랫, 직접 링크, 트리)
Azure Boards는 세 가지 쿼리 유형을 지원합니다. 쿼리 옆에 있는 아이콘은 해당 형식을 나타냅니다. 필요한 결과에 따라 유형을 선택합니다.
쿼리 유형
사용 지침
작업 항목의 플랫 목록
- 대량 업데이트를 수행할 항목 나열
- 작업 항목 목록 심사
- 쿼리 차트를 만들고 대시보드에 추가
- 항목 개수를 계산하거나 숫자 필드의 합계를 계산하는 차트 만들기
- Excel로 목록을 내보내 필드를 업데이트합니다.
작업 항목 및 직접 링크
- 다른 작업 항목에 의존하는 항목 나열
- 관련 항목 또는 종속 항목 찾기
- 대량 업데이트를 수행할 연결된 작업 항목 나열
- 테스트 관련 링크를 포함하여 연결된 작업 항목들 분류
- 부모 항목이 없는 고아 백로그 항목 찾기
참고 항목
작업 항목 및 직접 링크 쿼리는 Excel로 플랫 목록으로 내보냅니다. Excel에서는 여러 링크 형식 수정을 지원하지 않으므로 플랫 목록으로 가져옵니다.
작업 항목 트리
- Parent-Child 관련 작업 항목 또는 기타 트리 토폴로지 링크 형식의 트리 나열
- 작업 항목의 계층적 목록 우선 순위 지정
- 계층 목록을 Excel로 내보내 필드를 업데이트하거나 계층 구조를 수정합니다.
링크 형식에 대한 자세한 내용은 링크 형식 참조를 참조하세요.
내 쿼리, 공유 쿼리 및 즐겨찾기
당신만이 내 쿼리에 저장된 쿼리를 보고 실행할 수 있습니다. 쿼리 선택기에서 표시되도록 쿼리를 즐겨찾기합니다.
공유 쿼리 아래에 저장된 쿼리는 프로젝트 액세스 권한이 있는 모든 사용자에게 표시됩니다. 폴더에 공유 쿼리를 정리하고 빠른 액세스를 위해 즐겨찾기에 추가하세요. 폴더 및 쿼리에 대한 사용 권한을 설정하여 다른 사용자가 폴더를 이동하거나 편집하지 못하도록 할 수 있습니다.
자세한 내용은 다음을 참조하세요.
- 쿼리 및 쿼리 폴더 관리
- 쿼리 권한 설정
- 쿼리 즐겨찾기 및 개인 또는 팀 즐겨찾기 설정
쿼리 디렉터리, 쿼리 폴더 및 이동 경로
쿼리 페이지에서는 즐겨찾기 및 모든 탭을 제공합니다. 각 탭에는 특정 쿼리를 찾기 위해 필터링할 수 있는 디렉터리 보기가 표시됩니다.
쿼리 페이지를 탐색할 때 폴더, 하위 폴더 또는 쿼리 페이지를 열 수 있습니다.
선택할 때 브레드크럼이 페이지 맨 위에 표시됩니다. 이를 사용하여 폴더, 하위 폴더 또는 쿼리 페이지로 이동합니다.
즐겨 찾는 쿼리를 선택하거나 열려 있는 쿼리의 드롭다운 메뉴에서 모든 쿼리 페이지로 돌아갈 수도 있습니다.
자세한 내용은 쿼리 FAQ, 탐색 및 폴더를 참조 하세요.
차트 및 위젯 쿼리
플랫 목록 쿼리에서 원형, 가로 막대형, 피벗 및 추세 차트를 만듭니다(쿼리는 1000개 이하의 작업 항목을 반환해야 합니다). 대시보드에 쿼리 차트를 추가하고, 제목을 다시 지정하며, 필요에 따라 재구성합니다.
쿼리 기반 위젯은 대시보드에 쿼리 정보를 표시합니다(예: 활성 버그 수 또는 작업 항목의 대화형 목록). 자세한 내용은 다음을 참조하세요.
쿼리를 지원하는 사용자 지정 필드 추가
쿼리에 대한 사용자 지정 필드를 추가하려면 작업 추적 환경 사용자 지정을 참조하세요.
작업 보드 및 쿼리 목록 항목
작업 보드 내용이 만든 쿼리의 결과와 다른 경우 자세한 내용은 작업 보드 항목과 쿼리 목록 항목을 참조하세요.
전체 텍스트 검색 쿼리 및 데이터 정렬 설정
단어 포함 또는 포함 연산자와 함께 전체 텍스트 검색 쿼리를 사용하는 경우 SQL Server 데이터 정렬이 등록된 단어 분리기가 있는 언어에 해당하는지 확인합니다. 지원되지 않는 언어는 예기치 않은 결과를 생성할 수 있습니다.
자세한 내용은 다음을 참조하세요.
REST API
프로그래밍 방식으로 쿼리와 상호 작용하려면 다음 REST API 리소스 중 하나를 참조하세요.