TFS와 Project Server의 통합을 위한 필드 매핑 관리

아티클
06/10/2015

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

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

참고

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

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

TfsAdmin ProjectServer 명령줄 도구를 사용하려면 Visual Studio 또는 팀 탐색기 가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.

요구 사항

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

구문

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 웹 사이트에서 레지스트리 가상화 및 Windows Vista의 일반 파일 및 레지스트리 가상화 문제 페이지를 참조하십시오.
/encoding:encoding	.NET Framework 2.0용 인코딩 형식의 이름 지정합니다. 명령은 지정하는 인코딩 형식으로 XML 데이터를 내보내거나 가져옵니다. 예를 들어, /e:utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 지정하지 않을 경우 검색이 실패하면 명령은 인코딩과 UTF-8 검색을 시도합니다.
/validateOnly	매핑 파일의 유효성은 확인하지만 업로드하지는 않습니다.
/useDefaultFieldMappings	사용자 지정 매핑 파일 대신 기본 필드 매핑을 업로드합니다. 자세한 내용은 TFS와 Project Server 통합을 위한 필드 매핑 XML 요소 참조을 참조하십시오.
/force	기존 매핑 파일을 덮어씁니다. 기존 매핑을 다른 매핑으로 대체할 때 /useDefaultFieldMappings 스위치를 지정하는 경우 이 옵션을 지정해야 합니다.

설명

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

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

Download field mappings from DefaultCollection

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

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

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

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

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

중요

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

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

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

예제

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

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

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

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

다음 예제에서는 AWMappingFile.xml를 AdventureWorksCollection에 업로드합니다.

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

참고 항목

Share via