작업 항목 쿼리

  • 아티클

쿼리를 사용하면 보고서를 검토, 심사, 업데이트 또는 생성할 작업 항목을 쉽게 찾을 수 있습니다.

검색 상자를 사용하여 작업 항목을 찾습니다. ID를 입력하거나 필터를 사용합니다. 작업 항목의 단순 목록, 트리 쿼리를 사용하는 계층 목록 또는 직접 링크 쿼리를 사용하여 종속성 표시 목록을 사용하려면 쿼리 편집기를 사용하여 쿼리 형식을 선택합니다.

Visual Studio Online, TWA(Team Web Access) 또는 팀 탐색기에서 쿼리를 만들 수 있습니다. 또한 Excel 또는 Project에서 쿼리를 열어 대량 수정 작업을 수행할 수 있습니다.

검색 상자를 사용해서 해당 ID로 작업 항목을 찾습니다.

작업 항목 검색 상자에 ID를 입력한 후 검색 아이콘을 선택합니다.

작업 항목 검색 텍스트 상자

상황에 맞는 메뉴 아이콘 상황에 맞는 메뉴를 사용하여 할당, 상태, 키워드 또는 작업 항목 형식에 따라 목록 항목에 필터를 추가할 수 있습니다.

예를 들어, A=@Me T=Task을 입력하여 사용자에게 할당된 모든 작업을 나열합니다.

단순 목록 쿼리 열기 및 편집

쿼리를 정의하는 가장 쉬운 방법은 기존 공유 쿼리를 시작하는 것입니다. 다음 예제에서는 Agile 프로세스 템플릿과 함께 제공된 활성 버그 공유 쿼리를 수정하여 닫힌 버그를 모두 검색하는 방법을 보여 줍니다. 예제는 웹 브라우저를 통해 제공되는 사용자 인터페이스를 기반으로 합니다.

  1. 공유 쿼리를 엽니다. 예를 들어, 활성 버그 또는 유사한 평면 목록 쿼리를 엽니다.

    공유 쿼리(예: 활성 버그) 열기

       

  2. 닫힌 버그를 찾은 다음 쿼리를 실행하도록 쿼리를 편집합니다. 첨부 파일 추가(새 필터 라인 삽입)을 사용하여 현재 절 위에 절을 삽입합니다. 절 삭제(필터 라인 제거)를 사용하여 절을 삭제합니다.

    단순 목록 쿼리의 편집기 뷰

       

  3. 쿼리를 내 쿼리 폴더에 저장합니다.

    다른 이름으로 쿼리 저장, 폴더=내 쿼리

       

    공유 쿼리 폴더에 쿼리를 저장하려면 팀 관리자, Project Administrators 그룹의 멤버이거나 폴더 집합에 대한 참가 권한이 허용으로 설정되어 있어야 합니다.

쿼리 만들기

TWA의 쿼리 페이지 또는 팀 탐색기의 작업 항목 페이지에 있는 새로 만들기 메뉴에서 시작합니다.

새 쿼리 열기

절 그룹화하여 목록을 구체화

그룹화된 절은 쿼리의 나머지 부분과 독립된 하나의 단위로 작동합니다. 이는 방정식이나 논리 식을 괄호로 묶는 것과 비슷합니다. 그룹에서 첫 번째 절에 대한 And 또는 Or 연산자는 전체 그룹에 적용됩니다.

다음 예에서 첫 번째 식은 우선 순위 1의 작업 항목과 모든 우선 순위의 활성 버그를 모두 반환합니다. 두 번째 식은 우선 순위 1의 모든 활성 작업 항목과 우선 순위 1의 모든 활성 및 비활성 버그를 반환합니다.

그룹화된 절

논리 식
Or/And 논리 식을 사용하여 필터링

우선 순위=1 OR (작업 항목 형식=버그 AND 상태=활성)
And/Or 논리 식을 사용하여 필터링

우선 순위=1 AND (작업 항목 형식=버그 OR 상태=활성)

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

선택한 쿼리 절 그룹화

쿼리 결과가 예상한 작업 항목 집합을 반환하지 않으면 다음 단계를 수행합니다.

  • 각 절이 의도한 대로 정의되었는지 확인합니다.

  • 각 절에 대한 And/Or 할당을 확인합니다. 예상한 것보다 더 많은 작업 항목이 결과에 포함되어 있으면 또는 절이 그리고 절 대신 사용되었을 가능성이 높습니다.

  • 쿼리 절의 그룹화 및 그룹화된 각 절의 And/Or 할당을 그룹화하거나 변경해야 하는지 판별합니다.

  • 더 많은 쿼리 절을 추가하여 쿼리 필터 조건을 구체화합니다.

  • 필드, 연산자 및 값을 지정하는 데 사용할 수 있는 옵션을 검토합니다.

트리 쿼리를 사용하여 계층적 목록 보기

트리 쿼리(트리 쿼리)를 사용해서 다중 계층의 중첩된 작업 항목 목록을 봅니다. 예를 들어, 모든 백로그 항목과 연결된 작업을 볼 수 있습니다.

트리 쿼리를 나타내는 결과 목록

리프 노드를 확장(확장 노드(Team Web Access)) 또는 축소(축소 노드(Team Web Access))하여 트리의 다른 부분에 집중할 수 있습니다.

부모 및 자식 작업 항목 모두에 대한 필터 조건을 정의합니다.

트리 쿼리 필터

링크된 하위 항목을 찾으려면 최상위 작업 항목 먼저 일치를 선택합니다. 연결된 부모 항목을 찾으려면 링크된 작업 항목 먼저 일치를 선택합니다.

직접 링크 쿼리를 사용하여 종속성 보기

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

직접 링크 쿼리 결과

직접 링크 쿼리를 사용하여 다른 팀 작업에 대한 팀의 종속성을 추적하거나 팀에서 다른 팀에 대해 수행한 사항을 관리합니다. 상단 및 연결된 작업 항목에 대한 필터 기준을 지정하고 종속성을 필터링하는 데 사용되는 링크 형식을 선택합니다.

직접 링크 쿼리 편집기

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

  • 지정한 링크가 있는 항목만 반환: 연결된 작업 항목 필터 조건으로 지정된 작업 항목에 대한 링크가 없는 경우에만 첫 번째 작업 항목이 반환됩니다.

  • 최상위 작업 항목 모두 반환: 연결된 작업 항목 필터 조건에 관계없이 첫 번째 계층 작업 항목이 모두 반환됩니다. 링크된 작업 항목 필터 조건과 일치할 경우 첫 번째 계층에 링크된 두 번째 계층 작업 항목이 반환됩니다.

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

Q & A

Q: 사용할 수 있는 쿼리 연산자 및 변수는 무엇입니까?

A: 선택을 위해 사용할 수 있는 연산자 및 변수는 선택한 필드에 따라 달라집니다. 변수 네 가지는 프로젝트 이름 필드의 @Project, 사용자 이름 필드의 @Me, 날짜/시간 필드의 @Today 및 **[모두]**입니다. 쿼리 필드, 연산자, 값 및 변수을 참조하세요.

Q: 다른 쿼리 예제는 무엇입니까?

Q: 작업 항목 쿼리 예제 및 검색 상자 쿼리 예제를 참조하십시오.

Q: 쿼리 결과 차트는 어떻게 만듭니까?

A: Visual Studio Online 및 TWA에서 단순 목록 쿼리 결과를 차트로 작성할 수 있습니다. 사용자가 TWA에서 고급 액세스 권한 그룹의 멤버여야 합니다.

또는 Excel에서 쿼리를 열고 Excel의 기능을 사용하여 차트를 생성합니다.

Q: 현재 스프린트 또는 반복을 기반으로 쿼리를 자동으로 업데이트하려면 어떻게 해야 합니까?

A: 이를 자동으로 수행할 수 있는 방법은 없습니다. 현재 스프린트를 지정하도록 쿼리를 수동으로 업데이트해야 합니다. 팀 프로젝트가 Scrum 또는 Agile을 기반으로 하는 경우 현재 스프린트 또는 현재 반복 폴더 아래에서 쿼리 집합을 찾습니다. 각 쿼리에서 현재 스프린트에 대해 정의된 항목을 반환하도록 하려면 반복 경로를 날짜에 따라 최신 상태인 반복으로 업데이트해야 합니다.

.wiq 파일로 저장하여 많은 쿼리를 변경할 수 있습니다. 팀 탐색기에서 쿼리를 열고 쿼리 편집을 선택한 후 파일, 다른 이름으로 저장을 선택하여 각 쿼리를 .wiq 파일로 저장합니다. 다음은 릴리스 2\스프린트 59를 지원하도록 업데이트된 진행 중인 작업 쿼리의 예입니다.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.AssignedTo],
           [System.State],
           [Microsoft.VSTS.Scheduling.RemainingWork],
    FROM WorkItems 
      WHERE [System.TeamProject] = @project and 
            [System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and 
            [System.WorkItemType] in group 'Microsoft.TaskCategory' and 
            [System.State] = 'In Progress' 
      ORDER BY [System.AssignedTo],
               [Microsoft.VSTS.Common.BacklogPriority],
               [System.Id] 
   </Wiql>
</WorkItemQuery>

Q: 결과 목록에서 열을 추가하거나 변경하려면 어떻게 할까요?

A: 열 옵션을 열어 열을 추가 또는 제거하고 열 순서를 변경하며 열 내의 정렬 순서를 변경합니다.

열 옵션 대화 상자에 열 탭 표시

또한 결과 목록에서 열을 새로운 위치로 끌고 열 제목을 선택하여 정렬 순서를 열순으로 변경할 수 있습니다.

Q: 태그를 사용하여 쿼리를 필터링할 수 있습니까?

A: Visual Studio Online을 사용 중이거나 온-프레미스 TFS에 TFS 2013 업데이트 2에 추가된 업데이트가 포함되어 있는 경우에 가능하며 그 이외의 온-프레미스 배포에 대해서는 가능하지 않습니다.

Visual Studio Online 및 Visual Studio 2013 업데이트 2의 경우 필터링할 태그를 필드로 선택할 수 있습니다. 또한 Excel에서 쿼리를 열고 작업 항목에 할당된 태그를 대량으로 수정할 수 있습니다. 또한 Visual Studio를 사용하여 작업 항목에 태그를 추가할 수 있습니다.

Eclipse용 팀 탐색기 플러그 인에서 태그를 기준으로 쿼리를 필터링할 수는 있지만 사용자 인터페이스에서 태그를 추가하거나 수정할 수는 없습니다. 태그를 추가하고 수정하려면 웹 포털을 사용해야 합니다.

TFS 2013 업데이트 2가 포함되어 있지 않은 온-프레미스 TFS의 경우 쿼리 결과에 태그를 열로 표시하고 태그를 기반으로 목록을 필터링할 수는 있지만 태그를 필터 조건에 절로 추가할 수는 없습니다.

Q: 쿼리 결과를 사용하여 연결된 관계를 빠르게 수정할 수 있습니까?

A: Visual Studio용 팀 탐색기 플러그 인에서 작업 항목을 들여쓰기(Indent), 내어쓰기(내어쓰기) 및 끌어와서 계층 구조를 수정할 수 있습니다.

또한 Excel 또는 Project에서 쿼리를 열어 부모-자식 및 선행 작업-후속 작업 링크 관계를 일괄 수정할 수 있습니다.

Q: 팀과 공유하는 쿼리를 누군가가 변경하지 못하도록 하려면 어떻게 할까요?

A: 읽을 쿼리에 대한 권한을 설정합니다.

Q: 공유 쿼리 또는 팀 즐겨찾기에 쿼리를 추가하려면 어떻게 할까요?

A: 쿼리를 공유 쿼리 폴더에 저장하려면 자신을 Project Administrators 그룹에 추가하거나 공유 쿼리 아래의 폴더에 대해 설정된 권한을 가지고 있어야 합니다.

쿼리를 팀 즐겨찾기로 추가하려면 쿼리에 대한 상황에 맞는 메뉴 아이콘 상황에 맞는 메뉴를 열고 팀 즐겨찾기로 추가합니다. 팀 즐겨찾기에 쿼리를 추가하려면 팀 관리자여야 합니다.

팀 즐겨찾기에는 공유 쿼리만 추가할 수 있으며 이렇게 하려면 팀 관리자 권한이 있어야 합니다.

Q: 팀 즐겨찾기에 폴더를 추가할 수 있습니까?

대답: 아니요. 내 쿼리 및 공유 쿼리 아래에만 폴더를 추가할 수 있습니다.

Q: 쿼리를 전자 메일로 보낼 수 있습니까?

A: 예. TFS 작업 항목 및 쿼리의 URL 링크를 전자 메일로 보내기을 참조하세요.

Q: 쿼리를 여는 하이퍼링크를 정의할 수 있습니까?

A: 예. 하이퍼링크를 가장 쉽게 정의하는 방법은 원하는 항목과 일치하는 쿼리를 생성한 다음 쿼리의 URL을 복사하는 것입니다. 하이퍼링크는 Transact-SQL와 유사한 작업 항목 쿼리 언어(WIQL)를 사용하며 다음 구문과 일치됩니다.

**http://ServerName:**Port/ /tfs/CollectionName/TeamProjectName/**q.aspx?pname=Project&wiql=**WorkItemQueryLanguage

예를 들어, 다음 하이퍼링크는 AdventureWorksProject 프로젝트에 대해 정의된 빌드 번호 9.0.30304이 있는 모든 버그의 ID, 제목 및 상태를 나열합니다.

http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035

Q: 쿼리를 내보낼 수 있습니까?

A: 예. 팀 탐색기의 쿼리 편집기에서 파일 메뉴를 사용하여 쿼리를 .wiq 파일로 저장합니다. 팀 프로젝트를 만드는 경우 공유 쿼리는 프로세스 템플릿에서 정의되는 .wiq 파일을 기반으로 만들어집니다.

Q: 작업 보드의 콘텐츠와 작업 보드에서 만들어진 쿼리와 함께 나열된 콘텐츠가 다른 이유는 무엇인가요?

A: 작업을 반복에 할당할 수는 있지만 해당 작업을 부모 백로그 항목에 연결할 수는 없습니다. 이러한 항목은 만든 쿼리에는 표시되지만 작업 보드 자체에는 표시되지 않습니다. TFS는 쿼리를 실행한 다음 작업 보드 항목을 표시하기 전에 백그라운드 프로세스 몇 개를 적용합니다.

다음 세 가지 이유는 작업 범주에 속한 작업 항목이 스프린트 백로그 또는 작업 보드에 나타나지 않도록 하는 원인이 될 수 있습니다.

  • 작업을 부모 백로그 항목에 연결할 수는 없습니다. 반복 경로가 스프린트로 설정된 부모 제품 백로그 항목(Scrum), 사용자 스토리(Agile) 또는 요구 사항(CMMI)에 연결한 버그 및 작업만 스프린트 백로그 페이지에 나타납니다.

  • 작업은 또 다른 작업의 부모입니다. 작업 계층 구조를 만든 경우 계층 구조 아래쪽의 자식 수준 작업만 나타납니다.

  • 작업의 링크된 부모는 또 다른 팀에 대해 정의된 백로그 항목에 해당합니다. 또는 작업의 부모 백로그 항목 영역 경로는 작업의 영역 경로와는 다릅니다.

Q: 작업 항목에 대해 프로그래밍 방식으로 쿼리할 수 있습니까?동적 쿼리를 만들 수 있나요?

A: 예. 버그, 작업 및 기타 작업 항목에 대한 쿼리을 참조하세요.

참고 항목

개념

작업을 지원할 Team Foundation 클라이언트 선택