Azure Boards 작업 항목 쿼리 정의

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

Visual Studio 2019 | Visual Studio 2022

작업 항목 쿼리는 사용자가 제공하는 필터 조건에 따라 작업 항목 목록을 생성합니다. 그런 다음 이러한 관리되는 쿼리를 저장하고 다른 사용자와 공유할 수 있습니다. 반면 의미 체계 검색은 작업 항목을 나열하지만 저장하거나 공유할 수는 없습니다.

웹 포털 또는 지원되는 클라이언트(예: Visual Studio 팀 탐색기 및 Team Explorer Everywhere)에서 쿼리를 만듭니다. WIQL 구문 및 .wiq 파일을 사용하여 작업 항목 쿼리를 정의하고 가져올 수도 있습니다. 대량 업데이트 또는 추가를 지원하려면 Excel 또는 .csv 파일을 사용하여 쿼리를 가져오거나 내보냅니다.

웹 포털 또는 지원되는 클라이언트(예: Visual Studio 팀 탐색기 및 Team Explorer Everywhere)에서 쿼리를 만듭니다. WIQL 구문 및 .wiq 파일을 사용하여 작업 항목 쿼리를 정의하고 가져올 수도 있습니다. 대량 업데이트 또는 추가를 지원하려면 Excel을 사용하여 쿼리를 가져오거나 내보냅니다.

쿼리 편집기, 웹 브라우저.

쿼리가 결과를 반환하는 데 너무 오래 걸리는 경우 지침을 검토하여 고성능 쿼리를 만듭니다.

이 문서에서는 다음을 알아봅니다.

  • 쿼리를 추가하거나 만드는 방법
  • 여러 프로젝트에서 쿼리하는 방법
  • 쿼리 절을 그룹화하고 그룹 해제하는 방법
  • 작업 항목의 트리 또는 직접 링크 쿼리를 만드는 방법

필드 데이터 형식 및 <>쿼리 예제를 기반으로 모든 쿼리 작업, 지원되는 연산자(예: ContainsInIn Group산자 아님)에 빠르게 액세스하려면 쿼리 빠른 참조를 참조하세요.

쿼리 필터 선택

쿼리 편집기 다음 필터 함수를 실행합니다. 샘플 쿼리를 사용하여 아티클로 이동할 필터를 선택합니다. 쿼리 필터와 함께 쿼리 결과에 필터를 대화형으로 적용할 수 있습니다.

참고

관리되는 쿼리는 근접 검색을 지원하지 않지만 의미 체계 검색은 지원됩니다. 또한 의미 체계 검색은 와일드카드 문자와 와일드카드 문자를 모두 *? 지원하며 둘 이상의 와일드카드 문자를 사용하여 둘 이상의 문자를 일치시킬 수 있습니다. 자세한 내용은 기능 작업 항목 검색을 참조하세요.


필터 기능

매크로



쿼리 편집기 사용하는 필터와 함께 Filter 함수를 사용하여 쿼리 결과를 대화형으로 필터링할 수 있습니다. 방법을 알아보려면 대화형으로 백로그, 보드, 쿼리 및 계획을 필터링합니다.

필수 조건

  • 기본적으로 이해 관계자 액세스 권한이 있는 모든 프로젝트 멤버와 사용자는 모든 공유 쿼리를 보고 실행할 수 있습니다. 공유 쿼리 폴더 또는 공유 쿼리에 대한 사용 권한 집합을 변경할 수 있습니다. 자세한 내용은 쿼리 권한 설정을 참조하세요.
  • 공유 쿼리에서 쿼리를 추가하고 저장하려면 기본 액세스 이상의 권한이 부여되어야 합니다. 또한 쿼리를 추가하려는 폴더에 대해 허용으로 설정된 참가 권한이 있어야 합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다.

참고

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

  • 기본적으로 이해 관계자 액세스 권한이 있는 모든 프로젝트 멤버와 사용자는 모든 공유 쿼리를 보고 실행할 수 있습니다. 공유 쿼리 폴더 또는 공유 쿼리에 대한 사용 권한 집합을 변경할 수 있습니다. 자세한 내용은 쿼리 권한 설정을 참조하세요.
  • 공유 쿼리에서 쿼리를 추가하고 저장하려면 기본 액세스 이상의 권한이 부여되어야 합니다. 또한 쿼리를 추가하려는 폴더에 대해 허용으로 설정된 참가 권한이 있어야 합니다. 기본적으로 기여자 그룹에는 이 권한이 없습니다.

쿼리 열기

웹 브라우저에서 (1) 올바른 프로젝트를 선택했는지 확인하고(2) 보드>쿼리를 선택한 다음(3) 모두 선택

보드>쿼리 열기, 세로 탐색

쿼리를 처음 여는 경우 페이지가 즐겨찾기로 열립니다. 이 페이지에는 즐겨찾기를 표시한 쿼리가 나열됩니다. 그렇지 않으면 모두 선택해 정의한 모든 쿼리와 프로젝트에 대해 정의된 공유 쿼리를 볼 수 있습니다.

사용자 또는 팀이 즐겨찾기로 선택한 쿼리가 즐겨찾기 페이지에 표시됩니다. 다른 개체와 함께 즐겨찾는 쿼리도 프로젝트 페이지에 표시됩니다. 자세한 내용은 개인 또는 팀 즐겨찾기 설정을 참조하세요.

웹 브라우저에서 Boards>쿼리를 엽니다.

웹 브라우저에서 Boards>쿼리 열기

플랫 목록 쿼리 정의

웹 포털의 쿼리 탭 또는 팀 탐색기의 작업 항목 탭에서 새 쿼리를 시작할 수 있습니다.

새 쿼리, 새 환경을 추가하는 스크린샷.

쿼리 편집기 기본 설정으로 표시됩니다. 작업 항목의 플랫 목록, 작업 항목 유형=[Any], State=[Any].

작업 항목의 플랫 목록이 선택된 쿼리 편집기 스크린샷

값을 수정하고 절을 추가하거나 제거할 수 있습니다. 또는 쿼리 유형을작업 항목으로 변경하고 링크를 직접 연결하거나 작업 항목의 트리로 변경합니다.

드롭다운 메뉴에서 [새 쿼리 선택]의 [쿼리] 페이지에 대한 스크린샷

쿼리 편집기 기본 설정으로 표시됩니다. 작업 항목의 플랫 목록, Team Project=@Project(현재 프로젝트), 작업 항목 유형=[Any], State=[Any].

작업 항목의 플랫 목록, TFS 2018 및 이전 버전이 선택된 쿼리 편집기 스크린샷

값을 수정하고 절을 추가하거나 제거할 수 있습니다. 또는 쿼리 유형을작업 항목으로 변경하고 링크를 직접 연결하거나 작업 항목의 트리로 변경합니다.

프로젝트 간 또는 프로젝트 내에서 쿼리

새 쿼리는 기본적으로 현재 프로젝트로 범위를 지정합니다. 그러나 쿼리를 만들어 조직 또는 프로젝트 컬렉션 내에서 정의된 작업 항목을 찾을 수 있습니다. 그러나 저장한 모든 쿼리는 특정 프로젝트에 저장됩니다.

둘 이상의 프로젝트에 정의된 작업 항목을 나열하려면 프로젝트 간에 쿼리를 표시합니다. 예를 들어 다음 쿼리는 지난 30일 이내에 모든 프로젝트에서 만든 모든 기능을 찾습니다.

프로젝트 간 쿼리가 선택된 쿼리 편집기 스크린샷

프로젝트 간 쿼리를 선택하면 팀 프로젝트 필드를 추가하여 선택한 수의 프로젝트로 필터링할 수 있습니다.

팀 프로젝트 및 필터링에 추가된 다른 필드가 있는 쿼리 편집기 스크린샷.

참고

클라이언트 컴퓨터에 대해 정의된 국가별 설정(예: 쉼표(,))에 해당하는 목록 구분 기호를 사용하여 여러 프로젝트 이름을 구분합니다.

팀 프로젝트 필드는 여러 프로젝트에서 쿼리를 확인한 후에만 사용할 수 있습니다. 또한 프로젝트 간 쿼리 를 선택 취소하면 현재 프로젝트에 정의된 대로 해당 작업 항목 형식의 필드만 필드 드롭다운 메뉴에 표시됩니다. 프로젝트 간 쿼리를 선택하면 컬렉션의 모든 프로젝트에 정의된 모든 작업 항목 유형의 모든 필드가 필드 드롭다운 메뉴에 표시됩니다.

절 정의

하나 이상의 절을 정의하여 쿼리를 만듭니다. 각 절은 단일 필드에 대한 필터 조건을 정의합니다.

샘플 쿼리 절

및/또는 필드 연산자
And 할당 대상 = @Me

필드 데이터 형식에 따라 사용 가능한 연산자 목록은 쿼리 인덱스 빠른 참조를 참조하세요.

추가하는 모든 절은 And 문으로 추가됩니다. 그룹을 변경하려면 또는 선택합니다. 절을 그룹화하여 절 문이 필요한 시퀀스에서 실행되도록 합니다.

새 절 추가를 선택하여 쿼리 끝에 다른 절을 추가한 다음 해당 절의 필드, 연산자값을 선택합니다.

절을 추가하는 방법을 보여 주는 쿼리 편집기 스크린샷

예를 들어 할당 대상 필드, 등호(=) 연산자 및 사용자 ID를 나타내는 @Me 매크로를 지정하여 할당된 모든 작업 항목을 검색합니다.

쿼리에 대한 WIQL 구문과 괄호를 사용하여 절을 그룹화하려면 Marketplace Wiql 편집기를 설치합니다. 이 확장은 WIQL 구문을 보고 REST API 호출에 사용할 WIQL 파일로 내보낼 수 있도록 지원합니다. 자세한 내용은 WIQL(작업 항목 쿼리 언어)의 구문을 참조하세요.

쿼리 절을 정의하는 방법에 대한 검사 목록

  1. 첫 번째 빈 행의 필드 열 머리글 아래에서 아래쪽 화살표를 선택하여 사용 가능한 필드 목록을 표시하고 목록에서 항목을 선택합니다.

    자세한 내용은 쿼리 필드 및 값을 참조하세요.

  2. 같은 행의 연산자 열 머리글 아래에서 아래쪽 화살표를 선택하여 사용 가능한 연산자 목록을 표시하고 목록에서 항목을 선택합니다.

    자세한 내용은 연산자를 참조하세요.

  3. 같은 행의 열 머리글 아래에 값을 입력하거나 아래쪽 화살표를 선택하고 목록에서 항목을 선택합니다.

    매크로 또는 변수를 사용하여 현재 프로젝트, 사용자, 날짜 또는 기타 선택을 지정하는 방법에 대한 자세한 내용은 변수를 참조하세요.

  4. 절을 추가하려면 새 절 추가를 선택합니다.

    쿼리의 끝에 절을 추가하거나 해당 아이콘을 사용하여 다음 작업을 수행할 수 있습니다.

    • 새 필터 줄 삽입
    • 이 필터 줄 제거
    • 선택한 절 그룹화
    • 그룹 해제 절

작업 항목 트리를 사용하여 계층 구조 보기

작업 항목 트리 쿼리를 사용하여 작업 항목의 다중 계층 중첩 목록을 볼 수 있습니다. 예를 들어, 모든 백로그 항목과 연결된 작업을 볼 수 있습니다. 트리의 여러 부분에 초점을 맞추려면 모두 확장 또는 모두 축소를 선택합니다.

참고

Test Plans, Test Suites 및 테스트 사례의 계층적 보기를 보여 주는 쿼리를 생성할 수 없습니다. 이러한 항목은 부모-자식 링크 형식을 사용하여 함께 연결되지 않습니다. 그러나 테스트 관련 작업 항목을 나열하는 직접 링크 쿼리를 만들 수 있습니다. 또한 Test Plans 페이지를 통해 계층 구조를 볼 수 있습니다.

트리 쿼리를 보여 주는 쿼리 결과 목록의 스크린샷

트리 쿼리, TFS 2018 보기를 보여 주는 쿼리 결과 목록의 스크린샷

부모 및 자식 작업 항목 모두에 대한 필터 조건을 정의합니다. 연결된 자식을 찾으려면 먼저 최상위 작업 항목 일치를 선택합니다. 연결된 부모를 찾으려면 먼저 연결된 작업 항목 일치를 선택합니다.

작업 항목 트리의 쿼리 편집기 보기 스크린샷

작업 항목 및 직접 링크 쿼리를 사용하여 작업, 버그, 문제 또는 기능과 같이 추적된 다른 작업에 종속된 작업 항목을 추적합니다. 예를 들어, 구현 중인 다른 항목 또는 수정 중인 버그에 종속된 백로그 항목을 볼 수 있습니다.

직접 링크 쿼리를 사용하여 팀 전체의 종속성을 추적합니다. 또한 쿼리를 통해 팀이 하는 약정을 관리할 수 있습니다. 상위 및 연결된 작업 항목에 대한 필터 조건을 선택합니다. 또한 링크 유형을 선택하여 종속성을 필터링합니다.

직접 링크 쿼리 결과의 스크린샷.

쿼리 편집기 Direct Links 쿼리의 스크린샷

다음 옵션 중 하나를 선택하여 작업 항목의 첫 번째 계층 목록을 필터링합니다.

  • 일치하는 링크가 있는 항목만 반환합니다. 첫 번째 계층 작업 항목은 연결된 작업 항목 필터 조건으로 지정된 작업 항목에 대한 링크가 있는 경우에만 반환됩니다.

  • 모든 최상위 항목 반환: 연결된 작업 항목 필터 조건에도 불구하고 모든 첫 번째 계층 작업 항목이 반환됩니다. 첫 번째 계층에 연결된 두 번째 계층 작업 항목은 연결된 작업 항목 필터 조건과 일치하는 경우 반환됩니다.

  • 일치하는 링크가 없는 항목만 반환합니다. 첫 번째 계층 작업 항목은 연결된 작업 항목 필터 조건으로 지정된 작업 항목에 대한 링크가 없는 경우에만 반환됩니다.

각 링크 유형에 대한 자세한 내용은 연결, 추적 가능성 및 종속성 관리를 참조하세요.

및/또는 논리 식

And 또는 Or를 지정하여 쿼리 절의 논리적 식을 만듭니다. 지정 현재 절과 이전 절 모두에서 조건을 충족하는 작업 항목을 찾습니다. 지정 또는 현재 절 또는 이전 절의 조건을 충족하는 작업 항목을 찾습니다.

각 작업 항목 필드에 대해 하나의 새 절을 추가하여 검색 조건을 구체화합니다. 원하는 작업 항목 집합만 반환하는 절을 추가합니다. 쿼리에서 예상한 결과를 받지 못한 경우 구체화합니다. 쿼리 절을 추가, 제거, 그룹화 또는 그룹 해제하여 쿼리 결과를 개선할 수 있습니다.

쿼리 절을 그룹화하여 쿼리의 나머지 부분과는 별도로 단일 단위로 작동합니다. 그룹화 절은 수학적 수식 또는 논리 문에서 식 주위에 괄호를 배치하는 것과 유사합니다. 절을 그룹화하면 그룹의 첫 번째 절에 대한 AND 또는 OR 가 전체 그룹에 적용됩니다.

그룹 절

그룹화된 절은 쿼리의 나머지 부분과 별도로 단일 단위로 작동합니다. 그룹화 절은 수학 방정식 또는 논리 식 주위에 괄호를 배치하는 것과 유사합니다. 그룹의 첫 번째 절에 대한 And 또는 Or 연산자는 전체 그룹에 적용됩니다.

다음 예제와 같이 그룹화된 절은 해당 논리 식으로 변환됩니다.

쿼리에 대한 WIQL 구문을 보려면 쿼리 UI 항목의 WIQL 버전을 볼 수 있도록 WIQL 쿼리 편집기 확장을 설치합니다. 이 확장을 사용하면 AND/OR 그룹화된 절을 처리하는 방법을 확인할 수 있습니다.

쿼리 그룹화된 절 논리 식
1 그룹 절 쿼리를 보여 주는 스크린샷 작업 항목 유형 필드와 상태 필드 또는 할당 대상 필드에 대해 필터가 설정됩니다. 논리 식의 스크린샷 AND 연산자는 작업 항목 유형, 상태 및 할당된 필드를 그룹화합니다. OR 연산자는 상태를 그룹화하고 필드에 할당합니다.
2 작업 항목 유형 필드와 상태 필드 또는 할당 대상 필드 중 하나에 대한 필터가 있는 그룹 절 쿼리를 보여 주는 스크린샷. 논리 식의 스크린샷 AND 연산자는 OR 연산자를 통해 그룹화된 상태 또는 할당된 필드를 사용하여 작업 항목 형식을 그룹화합니다.
3 그룹 절 쿼리를 보여 주는 스크린샷 필터는 작업 항목 유형 필드 또는 상태 필드와 할당 대상 필드 모두에 대해 설정됩니다. 논리 식의 스크린샷 OR 연산자는 작업 항목 형식을 AND 연산자에 의해 연결된 상태 및 할당된 필드 모두에 연결합니다.

이러한 쿼리는 버그 형식의 작업 항목을 반환하고 다음 논리 식을 충족합니다.

  • 쿼리 1: AND State=Active OR Assigned to @Me
  • 쿼리 2: AND (State=Active OR Assigned to @Me)
  • 쿼리 3: OR (State=Active AND Assigned to @Me)

하나 이상의 절을 그룹화하려면 절을 선택한 다음 그룹 절 아이콘을 선택합니다.

웹 포털, 쿼리 편집기, 선택한 쿼리 절 그룹 스크린샷

여러 그룹화된 절을 그룹화할 수도 있습니다. 이미 그룹화된 각 절의 확인란을 선택합니다. 그런 다음 그룹 절 아이콘을 선택합니다 .

웹 포털, 쿼리 편집기, 여러 쿼리 절 그룹화 스크린샷

쿼리 결과가 예상된 결과를 반환하지 않는 경우 다음 단계를 수행합니다.

  • 각 절이 의도한 대로 정의되었는지 확인합니다.
  • 각 절에 대한 And/Or 할당을 확인합니다. 예상한 것보다 더 많은 작업 항목이 결과에 포함되어 있으면 또는 절이 그리고 절 대신 사용되었을 가능성이 높습니다.
  • 쿼리 절의 그룹화 및 그룹화된 각 절의 And/Or 할당을 그룹화하거나 변경해야 하는지 판별합니다.
  • 더 많은 쿼리 절을 추가하여 쿼리 필터 조건을 구체화합니다.
  • 필드, 연산자 및 값을 지정하는 데 사용할 수 있는 옵션을 검토합니다.

절 그룹 해제

절을 그룹 해제하려면 그룹화된 절의 그룹 해제 절 아이콘을 선택합니다.

대시보드에서 쿼리 결과 보기

다음 두 위젯은 쿼리 결과를 표시합니다. 이러한 위젯에서 직접 작업 항목을 열 수 있습니다.

  • 나에게 할당된 작업: 로그인한 사용자에게 할당된 모든 제안 또는 활성 작업 항목을 나열합니다. ID, 상태 및 제목 필드를 나열합니다.
  • 쿼리 결과 위젯: 플랫, 트리 또는 직접 링크 쿼리의 결과를 표시합니다. 위젯을 통해 표시되는 필드를 구성하고, 열 필드의 크기를 조정하고, 트리 및 직접 링크 쿼리를 확장 및 축소할 수 있습니다.

대시보드에 위젯을 추가하는 방법에 대한 자세한 내용은 대시보드에 위젯 추가를 참조하세요.

부모 제목을 사용하여 쿼리 결과 위젯 보기

부모 제목이 표시된 쿼리 결과를 볼 수 있습니다. 이렇게 하려면 다음 단계를 수행합니다.

  1. 관심 있는 작업 항목을 필터링하는 쿼리를 만듭니다. 쿼리는 플랫 목록, 트리 또는 직접 링크 쿼리일 수 있습니다.
  2. 부모 필드를 열로 추가합니다.
  3. 쿼리를 공유 쿼리 또는 팀 즐겨찾기로 저장합니다.
  4. 대시보드에 쿼리 결과 위젯 을 추가하고 쿼리를 구성합니다. 부모 필드가 표시되도록 설정되어 있는지 확인합니다.

다음 이미지는 부모 필드를 표시하는 쿼리 결과 위젯을 보여 줍니다.

부모 열 필드를 보여 주는 쿼리 결과 위젯의 스크린샷

이것이 쿼리 정의에 대한 기본 사항입니다. 쿼리 예제의 인덱스는 쿼리 빠른 참조를 참조하세요.