동기화에 사용 가능한 작업 항목 형식 정의
Visual Studio Team Foundation Server (TFS)과 Microsoft Project Server 간에 데이터를 동기화하려면 두 서버 제품의 통합을 구성해야 합니다. 구성 작업의 일환으로 Enterprise 프로젝트 계획을 팀 프로젝트에 연결하고 동기화에 참가할 작업 항목 형식을 지정해야 합니다. 초기 구성과 매핑 후에 매핑되는 작업 항목 형식을 변경할 수 있습니다.
TfsAdmin ProjectServer 명령줄 도구의 다음 옵션을 사용하여 동기화에 참여하는 작업 항목 형식을 관리할 수 있습니다.
/MapWorkItemTypes: 팀 프로젝트의 동기화에 참여할 수 있는 작업 항목 형식을 정의합니다. 여러 형식에 매핑할 수 있지만 게시용으로 제출된 작업 항목만 동기화됩니다.
/GetMappedWorkItemTypes: 팀 프로젝트의 동기화에 참여하도록 구성된 작업 항목 형식의 목록을 반환합니다.
/UnmapWorkItemTypes: 팀 프로젝트 동기화에 참여하지 않도록 작업 항목 형식을 제거합니다.
두 서버 제품을 통합하는 방법에 대한 개요는 TFS와 Project Server 통합 구성을 참조하십시오. Enterprise 프로젝트를 팀 프로젝트와 연결하는 방법에 대한 개요는 팀 프로젝트에 대한 Enterprise 프로젝트의 연결 관리을 참조하십시오.
TfsAdmin ProjectServer 명령줄 도구를 사용하려면 Visual Studio 또는 팀 탐색기 가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
32-비트 버전의 Windows에서는 %programfiles(x86)% 를 **%programfiles%.**로 바꿉니다.
요구 사항
이러한 명령을 사용하려면 Project Server 통합 관리 권한을 허용으로 설정해야 합니다. 그리고 Team Foundation Server 서비스 계정에 데이터 동기화에 참여할 PWA 인스턴스와 상호 작용하는 데 필요한 권한을 부여해야 합니다. 자세한 내용은 TFS와 Project Server 통합을 지원하기 위한 권한 할당을 참조하십시오.
구문
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName
TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]
매개 변수
Parameter |
설명 |
|---|---|
/collection:tpcUrl |
팀 프로젝트 컬렉션의 URL(Uniform Resource Locator)을 지정합니다. URL을 다음 형식으로 지정합니다. http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 지정하지 않을 경우 다음 형식으로 URL을 지정해야 합니다. http://ServerName:Port/CollectionName |
/teamProject:TeamProjectName |
프로젝트 컬렉션에 정의된 팀 프로젝트의 이름을 지정합니다. |
/workItemTypes:ListofWorkItemTypes |
하나 이상의 작업 항목 형식의 참조 이름을 쉼표로 구분된 목록으로 지정합니다. Project Professional에서 데이터를 추적하려는 작업 항목의 형식만 지정해야 합니다. 예를 들어 Agile 프로세스를 지원하는 “User Story,Task” 또는 “User Story”,Task 형식의 작업 항목을 지정할 수 있습니다. 쉼표 뒤에 공백을 넣으면 안 됩니다. |
/skipUIChanges |
작업 항목 폼에 있는 Project Server 탭은 사용자가 지정하는 형식에 대해 변경해서는 안 된다고 지정합니다. 사용자 지정한 경우에 플래그를 포함해야 하면 Project Server 영향을 받는 형식에 대 한 탭 또는 MapWorkItemTypes 명령을 완료할 수 없습니다. 형식 정의를 수동으로 업데이트할 수 있습니다. 자세한 내용은 작업 항목 형식에 대한 정의에 추가된 XML 요소을 참조하십시오. |
/force |
프로젝트에서 작업에 지정하는 형식의 작업 항목을 바인딩하는 모든 링크를 제거합니다. 이 옵션을 사용하면 현재 동기화 중인 해당 형식의 작업 항목이 하나 이상이더라도 데이터 동기화에 참여하는 작업 항목 형식을 제거할 수 있습니다. |
/? 또는 help |
명령에 대한 정보를 표시합니다. |
설명
명령을 실행하면 어떤 개체에서 어떤 작업을 수행 중인지 표시하는 메시지가 나타납니다. 예를 들어, 다음 메시지는 사용자 스토리와 작업이 데이터 동기화에 참여하도록 구성 중임을 나타냅니다.
Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .
명령이 완료되면 다른 메시지가 나타납니다. 예를 들어, 다음 메시지는 사용자 스토리 및 작업이 제대로 구성되었음을 나타냅니다.
You have successfully configured the following work item types for team project ProjA: User Story, Task.
동기화에 참여할 수 있는 작업 항목 형식을 구성하는 것 외에 /MapWorkItemTypes 명령은 다음 작업을 수행합니다.
사용자가 지정하는 작업 항목 형식을 데이터 동기화에 참가하는 형식 집합에 추가합니다. 즉, 명령은 기존의 매핑된 형식을 매핑 해제하지 않습니다.
사용자가 지정하는 작업 항목 형식에 대한 폼에 Project Server 탭을 추가합니다.
Project Server 탭이 지정한 작업 항목 형식에 대해 이미 정의되어 있으면 해당 형식이 무시되고 해당 형식의 작업 항목 폼은 변경되지 않습니다.
Enterprise 프로젝트 계획과 연결된 팀 프로젝트의 작업 항목 형식에 매핑을 시도하면 오류가 나타납니다. 동기화에 참여하도록 구성된 팀 프로젝트의 작업 항목 형식에만 매핑할 수 있습니다. 자세한 내용은 팀 프로젝트에 대한 Enterprise 프로젝트의 연결 관리을 참조하십시오.
작업 항목 형식에 대한 매핑을 제거하는 경우 사용자가 매핑하지 않은 팀 프로젝트의 해당 형식 폼에서 Project Server 탭이 제거됩니다.
팀 프로젝트의 작업 항목 형식을 매핑 해제하기 전에 Enterprise 프로젝트 계획에서 작업을 삭제하여 Team Foundation에서 작업 항목 형식과 작업 항목 간의 모든 연결을 제거해야 합니다. Enterprise 프로젝트 계획에서 작업을 삭제한 후에 그 것을 게시하고 동기화가 완료될 때까지 대기해야 합니다. 또는 /force 플래그를 지정하여 작업 항목을 팀 프로젝트의 작업에 바인딩하는 모든 링크를 제거할 수 있습니다. 사용자가 지정한 형식의 작업 항목만 동기화에 참여하지 못하도록 제거됩니다.
팁
작업을 삭제하는 경우 먼저 다른 계획으로 작업을 복사하여 해당 레코드를 유지할 수 있습니다.
예제
매핑된 작업 항목 형식 목록
다음 예제에서는 AdventureWorksServer에서 DefaultCollectionCollection의 Contoso 팀 프로젝트에 대한 동기화에 참여하도록 구성된 작업 항목 형식을 검색합니다.
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso
팀 프로젝트의 작업 항목 형식 매핑하세요.
다음 예제에서는 Contoso 프로젝트의 데이터 동기화에 참여하도록 사용자 스토리와 작업을 구성합니다.
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”
팀 프로젝트에 대한 작업 항목 형식의 매핑을 제거하세요.
다음 예제에서는 Contoso 프로젝트의 데이터 동기화에 참여하지 않도록 작업을 제거합니다.
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task
참고 항목
개념
통합 구성 요소 매핑[TfsAdmin ProjectServer]