프로세스 템플릿에 추가할 작업 항목 쿼리 정의

아티클
08/10/2011

업데이트: 2011년 4월

팀 탐색기에서 작업 항목 쿼리 파일(.wiq)을 쉽게 만들 수 있습니다. 기존 팀 프로젝트에서 팀 탐색기를 사용하여 프로세스 템플릿에 추가하려는 작업 항목 쿼리를 모두 만든 다음 이 항목의 단계에 따라 각 쿼리를 .wiq 파일로 저장할 수 있습니다. 작업 항목 쿼리를 만드는 방법에 대한 자세한 내용은 쿼리 필터 조건 지정을 참조하십시오.

항목 내용

.wiq 파일로 작업 항목 쿼리 저장
반복 경로를 참조하는 작업 항목 쿼리 만들기
반복 관련 작업 항목 쿼리의 예
WorkItemQuery 요소 참조

필요한 권한

쿼리를 만들려면 Readers 그룹의 멤버이거나 쿼리에 있는 각 팀 프로젝트에 대해 이 노드의 작업 항목 보기 권한이 허용으로 설정되어 있어야 합니다. 쿼리를 팀 쿼리로 저장하려면 적절한 권한이 있어야 합니다. 자세한 내용은 작업 항목 쿼리에 대한 권한 구성 및 설정을 참조하십시오.

.wiq 파일로 작업 항목 쿼리 저장

작업 항목 쿼리를 .wiq 파일에 저장하려면

팀 탐색기에서 쿼리를 마우스 오른쪽 단추로 클릭하고 쿼리 보기를 클릭합니다.
파일 메뉴에서 다른 이름으로 <name of query> [쿼리] 저장을 클릭합니다.
다른 이름으로 쿼리 저장 대화 상자에서 파일을 클릭하고 .wiq 파일의 위치와 파일 이름을 지정합니다. 또는 찾아보기를 클릭하고 파일 이름을 지정하고, 파일을 저장할 위치로 이동한 다음 저장을 클릭합니다.
프로세스 템플릿을 다운로드한 폴더에 있는 \WorkItem Tracking\Queries 폴더에 파일을 복사합니다.
텍스트 편집기에서 .wiq 파일을 엽니다.
다음 예제와 같이 Visual Studio Team Foundation Server를 실행하는 특정 서버 및 특정 팀 프로젝트와 쿼리를 연결하는 <TeamFoundationServer> 및 <TeamProject> 요소를 제거합니다.
```
<TeamFoundationServer>CollectionURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>
```
참고

텍스트 편집기에서 .wiq 파일을 편집한 다음, 특정 서버 및 팀 프로젝트와 쿼리를 연결하는 <TeamFoundationServer> 및 <TeamProject> 요소를 제거해야 합니다. 그렇지 않으면 프로세스 템플릿이 다른 서버에 업로드된 경우 쿼리가 제대로 작동하지 않습니다. 또는 현재 팀 프로젝트의 명시적 이름 또는 특정 환경에 고유한 기타 값이 쿼리에 포함되지 않도록 가능한 경우 매크로를 사용하십시오.
사용자에게 고유한 추가 요소를 제거합니다.

맨 위로 이동

반복 경로를 참조하는 작업 항목 쿼리 만들기

팀 프로젝트 $$PROJECTNAME$$의 매크로와 분류 플러그인 파일에서 정의되는 반복 경로의 이름을 포함하여 특정 반복 경로를 참조하는 쿼리를 정의할 수 있습니다. 예를 들어 다음 구문은 반복 1 아래에 반복 경로가 있는 작업 항목만 포함하는 쿼리를 지정합니다.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

팀 프로젝트가 만들어지면 매크로는 팀 프로젝트의 이름으로 대체됩니다.

이 매크로를 사용하여 특정 반복 경로를 참조하는 통합 문서를 정의할 수 있습니다. MSF Agile Software Development용 프로세스 템플릿에는 반복 관련 통합 문서 Iteration Backlog.xlsm를 지원하는 반복 관련 쿼리 Iteration1Backlog.wiq가 포함됩니다.

반복 관련 쿼리를 업로드할 때는 Classification.xml 파일을 처리하는 작업이 쿼리 파일을 처리하는 작업보다 먼저 완료되어야 합니다. 자세한 내용은 분류 플러그 인에서 초기 영역 및 반복 정의 및 프로세스 템플릿 플러그 인 파일을 사용하여 루트 작업 정의를 참조하십시오.

맨 위로 이동

반복 관련 작업 항목 쿼리의 예

다음 예제에서는 반복 백로그 통합 문서를 지원하는 Iteration1Backlog 작업 항목 쿼리를 보여 줍니다.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

맨 위로 이동

WorkItemQuery 요소 참조

다음 구문은 WorkItemQuery 요소 및 해당 자식 요소의 구조를 보여 줍니다.

<WorkItemQuery Version="1">
   <TeamFoundationServer>collectionURL </TeamFoundatonServer>
   <TeamProject>TeamProjectName </TeamProject>
   <Wiql>
      WorkItemQueryLanguage
   </Wiql>
</WorkItemQuery>

요소	구문	설명
TeamFoundationServer	`<TeamFoundationServer>collectionURL </TeamFoundatonServer>`	WorkItemQuery의 선택적 자식 요소입니다. 중요 일반적으로 이 요소는 프로세스 템플릿에 추가하는 쿼리에서 제거합니다. 팀 프로젝트 컬렉션의 URI를 다음과 같은 형식으로 지정합니다. http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 사용하지 않는 경우 다음과 같은 URI 형식을 사용하십시오. http://ServerName:Port/CollectionName 특성 형식은 ServerNameType이고 최대 길이는 2047입니다.
TeamProject	`<TeamProject>TeamProjectName</TeamProject>`	WorkItemQuery의 선택적 자식 요소입니다. 중요 일반적으로 이 요소는 프로세스 템플릿에 추가하는 쿼리에서 제거합니다. 쿼리를 실행할 대상 팀 프로젝트를 지정합니다. 특성 형식은 ProjectNameType이고 최대 길이는 255자입니다.
Wiql	`<Wiql>WorkItemQueryLanguage</Wiql>`	WorkItemQuery의 필수적 자식 요소입니다. 팀 프로젝트에서 작업 항목 집합을 찾고 설정된 개수의 필드에 할당되는 값을 반환하도록 필터 조건 역할을 하는 SQL(Structured Query Language) 명령 시퀀스를 지정합니다. MSF 프로세스 템플릿은 Wiql 요소가 지원하는 SQL 명령의 몇 가지 예제를 제공합니다. 이러한 파일은 WorkItem Tracking 폴더의 Queries 폴더에 있습니다. 쿼리를 정의하는 방법에 대한 자세한 내용은 버그, 작업 및 기타 작업 항목 찾기를 참조하십시오.

요소

구문

설명

TeamFoundationServer

<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

WorkItemQuery의 선택적 자식 요소입니다.

중요

일반적으로 이 요소는 프로세스 템플릿에 추가하는 쿼리에서 제거합니다.

팀 프로젝트 컬렉션의 URI를 다음과 같은 형식으로 지정합니다.

http://ServerName:Port/VirtualDirectoryName/CollectionName

가상 디렉터리를 사용하지 않는 경우 다음과 같은 URI 형식을 사용하십시오.

http://ServerName:Port/CollectionName

특성 형식은 ServerNameType이고 최대 길이는 2047입니다.

TeamProject

<TeamProject>TeamProjectName</TeamProject>

WorkItemQuery의 선택적 자식 요소입니다.

중요

일반적으로 이 요소는 프로세스 템플릿에 추가하는 쿼리에서 제거합니다.

쿼리를 실행할 대상 팀 프로젝트를 지정합니다.

특성 형식은 ProjectNameType이고 최대 길이는 255자입니다.

Wiql

<Wiql>WorkItemQueryLanguage</Wiql>

WorkItemQuery의 필수적 자식 요소입니다.

팀 프로젝트에서 작업 항목 집합을 찾고 설정된 개수의 필드에 할당되는 값을 반환하도록 필터 조건 역할을 하는 SQL(Structured Query Language) 명령 시퀀스를 지정합니다.

MSF 프로세스 템플릿은 Wiql 요소가 지원하는 SQL 명령의 몇 가지 예제를 제공합니다. 이러한 파일은 WorkItem Tracking 폴더의 Queries 폴더에 있습니다. 쿼리를 정의하는 방법에 대한 자세한 내용은 버그, 작업 및 기타 작업 항목 찾기를 참조하십시오.

맨 위로 이동

참고 항목

개념

버그, 작업 및 기타 작업 항목 찾기

기타 리소스

작업 항목 추적 플러그 인을 사용하여 작업 항목 추적을 위한 개체 정의 및 사용자 지정

변경 기록

날짜	변경 내용	이유
2011년 4월	각 WorkItemQuery 요소가 설명되었으며 삭제된 항목에 대한 링크가 제거되었습니다.	향상된 기능 관련 정보

2011년 4월

각 WorkItemQuery 요소가 설명되었으며 삭제된 항목에 대한 링크가 제거되었습니다.

향상된 기능 관련 정보

다음을 통해 공유

프로세스 템플릿에 추가할 작업 항목 쿼리 정의

.wiq 파일로 작업 항목 쿼리 저장

작업 항목 쿼리를 .wiq 파일에 저장하려면

반복 경로를 참조하는 작업 항목 쿼리 만들기

반복 관련 작업 항목 쿼리의 예

WorkItemQuery 요소 참조

참고 항목

개념

기타 리소스

변경 기록

추가 리소스