Team Foundation Server 및 Project Server의 통합을 위한 필드 매핑 관리

아티클
08/10/2011

필드 매핑 파일을 수정하여 Visual Studio Team Foundation Server 2010 및 Project Server 간의 데이터를 동기화하는 방법을 사용자 지정할 수 있습니다. 이 파일은 동기화되는 데이터 필드 및 Team Foundation Server와 프로젝트 서버의 통합을 지원하기 위해 동기화하는 방법을 정의합니다. TFSAdmin ProjectServer 명령줄 도구의 다음 옵션을 사용하여 이 파일을 관리할 수 있습니다.

/DownloadFieldMappings: 팀 프로젝트 컬렉션에 대해 정의된 필드 매핑 파일을 다운로드합니다.
/UploadFieldMappings: 필드 매핑 파일의 XML 구문 유효성을 검사하고 컬렉션에 업로드합니다. 파일은 업로드하지 않고 구문의 유효성을 확인하려면 /validateonly 옵션을 사용하면 됩니다.

참고

Team Foundation Server와 Project Server의 통합을 위한 필드 매핑 파일은 Microsoft Project의 필드 매핑 파일과 구별됩니다. 두 번째 파일을 다운로드 또는 업로드하는 방법에 대한 자세한 내용은 TFSFieldMapping을 참조하십시오.

필드 매핑 파일의 내용과 이를 사용자 지정하는 방법에 대한 자세한 내용은 Team Foundation Server와 Project Server의 통합을 위한 필드 매핑 XML 요소 참조 및 Project Server와 Team Foundation Server 간의 필드 매핑 사용자 지정을 참조하십시오.

TFSAdmin ProjectServer 명령줄 도구를 사용하려면 팀 탐색기 및 Visual Studio Team Foundation Server 2010 서비스 팩 1을 실행하는 컴퓨터에서 명령 프롬프트 창을 엽니다. Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 디렉터리에서 도구를 실행합니다. 64비트 컴퓨터의 경우 이 도구는 드라이브:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE에 있습니다.

필요한 권한

이러한 명령을 사용하려면 팀 프로젝트 컬렉션에 대한 팀 프로젝트 컬렉션에 대한 사용자의 Administer Project Server integration 권한을 허용으로 설정해야 합니다. 그리고 Team Foundation Server 서비스 계정에 데이터 동기화에 참여할 PWA(Project Web Access 또는 Project Web App) 인스턴스와 상호 작용하는 데 필요한 권한을 부여해야 합니다. 자세한 내용은 Project Server와 Team Foundation Server의 통합을 지원하기 위한 권한 할당을 참조하십시오.

참고

관리자 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 수행하려면 관리자 명령 프롬프트 창을 열어야 합니다. 관리자 권한 명령 프롬프트를 열려면 시작을 클릭하고 명령 프롬프트를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. 자세한 내용은 Microsoft 웹 사이트의 사용자 계정 컨트롤 페이지를 참조하십시오.

구문

TFSAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TFSAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

매개 변수

Parameter	설명
/collection:tpcURL	팀 프로젝트 컬렉션의 URL(Uniform Resource Locator)을 지정합니다. URL을 다음 형식으로 지정합니다. http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 지정하지 않을 경우 다음 형식으로 URI를 지정해야 합니다. http://ServerName:Port/CollectionName
/filePath:mappingFile	필드 매핑이 들어 있는 XML 정의 파일의 경로와 파일 이름을 지정합니다. 참고 Windows Vista를 사용 중인 경우 사용자에게 특정 폴더에 대한 액세스 권한이 없을 수도 있습니다.작업 항목 형식을 권한이 없는 위치로 내보내려는 경우 레지스트리 가상화 기술을 통해 내보낸 파일이 자동으로 리디렉션되어 가상 저장소에 저장됩니다.이 리디렉션이 발생하지 않도록 하려면 파일을 사용 권한이 설정된 위치로 내보냅니다. 자세한 내용은 Microsoft 웹 사이트에서 Registry Virtualization 및 Windows Vista의 일반 파일 및 레지스트리 가상화 문제를 참조하십시오.
/encoding:encoding	.NET Framework 2.0용 인코딩 형식의 이름 지정합니다. 명령은 지정하는 인코딩 형식으로 XML 데이터를 내보내거나 가져옵니다. 예를 들어, /e:utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 지정하지 않을 경우 검색이 실패하면 명령은 인코딩과 UTF-8 검색을 시도합니다.
/validateOnly	매핑 파일의 유효성은 확인하지만 업로드하지는 않습니다.
/useDefaultFieldMappings	사용자 지정 매핑 파일 대신 기본 필드 매핑을 업로드합니다. 자세한 내용은 Team Foundation Server와 Project Server의 통합을 위한 필드 매핑 XML 요소 참조을 참조하십시오.
/force	기존 매핑 파일을 덮어씁니다. 기존 매핑을 다른 매핑으로 바꾸는 경우 이 옵션을 지정해야 합니다.

맨 위로 이동

설명

Enterprise 사용자 지정 필드 또는 Project Server에 기본 제공된 필드에만 매핑할 수 있습니다. Project에서 유효한 필드의 이름을 지정해야 합니다. 기본 제공 필드의 이름을 확인하려면 친숙한 이름에서 공백을 제거하고 결과에 "pj"를 접두사로 붙입니다. 예를 들어 Status Manager의 필드 이름은 pjStatusManager이고 Custom 01의 필드 이름은 pjCustom01입니다. 기본 제공 및 사용자 지정 필드를 매핑하는 방법에 대한 제한이 있으며 필드의 데이터 형식을 일치시켜야 합니다. 자세한 내용은 Team Foundation Server와의 통합을 위한 Project Server 필드 매핑의 제한 사항을 참조하십시오.

TFSAdmin ProjectServer 명령을 실행하면 메시지는 수행 중인 작업과 영향을 받는 개체를 표시합니다. 예를 들어, 다음 메시지는 필드 매핑 파일을 다운로드하고 있음을 보여줍니다.

Download field mappings from Collection0

명령 작업을 완료한 후 다른 메시지가 나타납니다. 예를 들어, 필드 매핑 파일을 다운로드할 때 다음 메시지가 나타납니다.

You have downloaded field mappings to C:MappingFile. . . Done.

필드 매핑 업로드에 대한 참고 사항

/UploadFieldMappings 옵션을 실행하면 다음 작업이 수행됩니다.

팀 프로젝트 컬렉션에 대해 필드 매핑을 정의하고 /useDefaultFieldMappings 옵션을 지정하지 않을 경우 기본 필드 매핑을 만들 것인지 묻는 메시지가 나타납니다.
필드 매핑이 존재하고 /useDefaultFieldMappings 옵션을 지정할 경우 기존 매핑을 덮어쓸 것인지 확인하는 메시지가 나타납니다.
컬렉션에 이미 업로드한 필드 매핑을 덮어쓰려면 /force 옵션을 지정해야 합니다.
필드 매핑 파일을 업로드하기 전에 유효성을 검사합니다. 구문 오류가 있거나 유효하지 않은 필드를 지정한 경우 오류 메시지가 나타납니다.

필드 매핑 파일을 업로드한 경우 다음 사항이 변경됩니다.

Team Foundation의 각 미러 필드는 매핑된 필드를 따르도록 구성됩니다.
컬렉션 또는 팀 프로젝트에 매핑된 작업 항목 형식의 경우 새 매핑이 작업 항목 형식의 Project Server 탭에 나타납니다.

중요

Team Foundation Server의 필드를 Project Server에 매핑하는 경우에는 이러한 필드의 데이터 형식이 일치하는지 확인합니다. 일치하지 않으면 필드 매핑을 업로드하려고 할 때 다음 오류가 나타날 수 있습니다.

0에서 시작하는 인덱스는 0보다 크거나 같아야 하며 인수 목록의 크기보다 작아야 합니다.

자세한 내용은 데이터 형식 및 필드 매핑 조건을 참조하십시오.

맨 위로 이동

예제

팀 프로젝트 컬렉션에 대해 정의된 필드 매핑 파일 다운로드

다음 예제에서는 AdventureWorksCollection에 대해 정의된 필드 매핑을 AWMappingFile.xml로 다운로드합니다.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

팀 프로젝트 컬렉션의 필드 매핑 파일 업로드

다음 예제에서는 AWMappingFile.xml을 AdventureWorksCollection으로 업로드하고 이전에 정의한 필드 매핑을 덮어씁니다.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

맨 위로 이동