작업 항목 쿼리 보기, 실행 또는 전자 메일 보내기

  • 아티클

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

Visual Studio 2019 | Visual Studio 2022

사용자 또는 팀에 할당된 작업 항목을 찾으려면 쿼리를 실행합니다. 많은 작업 항목 쿼리가 프로세스에 미리 정의되어 있습니다. 팀 구성원이 보고 실행할 수 있는 공유 쿼리를 만들었을 수 있습니다. 이미 사용할 수 있는 쿼리 정의를 빌드하여 새 쿼리를 정의하는 것이 더 쉬운 경우가 많습니다.

필수 조건

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

참고 항목

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

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

쿼리 열기

웹 브라우저에서 (1) 올바른 프로젝트를 선택한 검사 (2) 보드 쿼리를 선택한 다음(3) 모두 선택 >

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

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

팁

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

Azure Boards에서 쿼리 실행

쿼리를 실행하려면 폴더를 확장하고 쿼리 제목을 선택합니다. 뷰가 열리면 쿼리 결과가 표시됩니다.

Azure DevOps 명령줄 인터페이스를 사용하여 쿼리를 실행할 수도 있습니다.

팁

다른 웹 포털 페이지와 마찬가지로 쿼리 페이지는 마지막으로 이동한 보기를 기억하고 해당 보기로 돌아갑니다.

  1. [모두]를 선택하여 정의했거나 프로젝트 내에서 공유된 모든 쿼리를 볼 수 있는 페이지를 엽니다.

    웹 포털, 보드>쿼리>모든 페이지 선택

  2. 필요에 따라 내 쿼리를 선택합니다.

    • 할당된 모든 작업 항목을 보려면 나에게 할당됨을 선택합니다. 이 쿼리는 @Me 매크로를 사용하여 할당된 모든 작업 항목을 나열합니다.
    • 팔로우 중인 모든 작업 항목을 보려면 팔로우한 작업 항목을 선택합니다. 이 쿼리는 @Follows 매크로(ID를 @Follows) 사용하여 팔로우하도록 선택한 모든 작업 항목을 나열합니다. 자세한 내용은 작업 항목 또는 끌어오기 요청 팔로우를 참조하세요.

  3. 공유 쿼리를 선택하여 폴더를 확장하고 공유 쿼리로 저장된 쿼리에 액세스합니다.

  4. 이동 경로 내에서 폴더를 선택하여 쿼리 폴더를 엽니다.

    쿼리 이동 경로 예제의 스크린샷.

명령줄에서 쿼리 실행

az boards query 명령을 사용하여 CLI에서 쿼리를 실행할 수 있습니다. 시작하려면 Azure DevOps CLI 시작을 참조하세요.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql]

매개 변수

  • id: 기존 쿼리의 ID입니다. path 또는--wiql을 지정하지 않는 한 필수입니다.
  • wiql: 작업 항목 쿼리 언어 형식의 쿼리입니다. id 또는--path가 지정된 경우 무시됩니다.
  • path: 기존 쿼리의 경로입니다. id가 지정된 경우 무시됩니다.
  • org: Azure DevOps 조직 URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config. 예: --org https://dev.azure.com/MyOrganizationName/
  • project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config.

예시

다음 명령은 지정된 ID를 사용하여 쿼리를 실행하고 결과를 테이블 형식으로 표시합니다.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0

다음 명령은 지정된 WIQL을 사용하여 쿼리를 실행하고 결과를 테이블 형식으로 표시합니다.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in

쿼리 디렉터리, 쿼리 폴더 및 이동 경로

참고 항목

내 즐겨찾기 또는 팀 즐겨찾기 폴더는 추가할 수 없습니다.

쿼리 페이지에는 특정 쿼리를 찾기 위해 필터링할 수 있는 디렉터리 중심 보기가 포함되어 있습니다. 쿼리 페이지에서 작업하는 경우 하위 폴더, 폴더 또는 페이지로 이동하면 됩니다.

이동 경로 탐색을 쿼리합니다.

또한 선택기 메뉴에서 즐겨찾기한 쿼리를 선택하거나 모든 쿼리를 찾아보도록 선택할 수 있습니다. 그러면 모든 쿼리 페이지로 돌아갑니다.

쿼리, 쿼리 선택기의 스크린샷

자세한 내용은 쿼리 FAQ, 탐색 및 폴더를 참조 하세요.

지원되는 모든 작업 및 즐겨찾기 작업

다음 표에 표시된 대로 각 쿼리 목록 페이지에서 쿼리를 보고 실행하기 위해 대부분의 작업을 수행할 수 있습니다. 내 쿼리 아래에 저장하고 즐겨찾기를 사용한 쿼리만 내 즐겨찾기 아래에 표시됩니다. 공유 쿼리 아래에 저장된 쿼리 만 팀에서 즐겨찾기를 사용할 수 있습니다.


작업		 Favorites
(브라우저)		 모두
(브라우저)		 작업 항목
(팀 탐색기)
즐겨찾는 모든 쿼리, 사용자 또는 소속 팀 보기 ✔️ ✔️
현재 프로젝트에 대한 모든 쿼리 또는 공유 쿼리 보기 ✔️ ✔️
쿼리 실행, 쿼리에 대한 상황에 맞는 메뉴 열기 ✔️ ✔️ ✔️
컨테이너 폴더 또는 쿼리 폴더 확장 또는 축소 ✔️ ✔️ ✔️
쿼리 목록 필터링 ✔️ ✔️
즐겨찾기 쿼리(웹 포털의 경우 선택 Favorite) ✔️
쿼리 취소(웹 포털의 경우 선택 ) ✔️ ✔️ ✔️
새 쿼리 추가: 선택 ✔️ ✔️ ✔️

쿼리 목록 필터링

필터 상자에 키워드(keyword) 입력하여 즐겨찾기 또는 모든 페이지에 표시되는 쿼리 집합을 필터링합니다. 필터링에 대한 자세한 내용은 필터 백로그, 보드, 쿼리 및 계획을 참조하세요.

WIT IQ 키워드(keyword) 조건으로 필터링된 프로젝트의 모든 쿼리를 보여 주는 스크린샷

자세한 내용은 쿼리 FAQ, 탐색 및 폴더를 참조 하세요.

쿼리 항목을 전자 메일로 보내거나 쿼리 URL 공유

쿼리 편집기 또는 결과 보기에서 서식이 지정된 쿼리 항목 목록을 전자 메일로 보내거나 쿼리 URL을 복사할 수 있습니다.

작업 아이콘을 선택하여 메뉴를 열고 나열된 옵션, 메일 쿼리 또는 쿼리 URL 복사 중에서 선택합니다.

웹 포털, 쿼리 편집기/결과, 작업 열기 메뉴, 전자 메일 쿼리 선택 또는 쿼리 URL 복사
시스템에서 인식하는 프로젝트 멤버의 개별 주소로만 전자 메일을 보낼 수 있습니다. 팀 그룹 또는 보안 그룹을 줄에 추가하는 것은 지원되지 않습니다. 시스템에서 인식하지 못하는 전자 메일 계정을 추가하면 전자 메일의 받는 사람 중 한 명 이상에게 메일로 보낸 작업 항목을 읽을 수 있는 권한이 없다는 메시지가 표시됩니다.

참고 항목

프로젝트 멤버가 아닌 사용자에게 서식이 지정된 목록을 전자 메일로 보내려면 작업 항목 목록 복사에 설명된 HTML로 복사 옵션을 사용해야 합니다. 온-프레미스 Azure DevOps의 경우 모든 전자 메일 작업을 수행하려면 SMTP 서버를 구성해야 합니다. SMTP 서버를 구성하지 않은 경우 HTML로 복사를 사용하여 이 작업을 수행할 수 있습니다.

다음 단계

쿼리 정의