다음을 통해 공유

Microsoft Project 필드 매핑 파일 사용자 지정

  • 아티클

Team Foundation 맵에 정의된 작업 항목 필드가 Microsoft Project의 필드에 매핑되는 방식을 사용자 지정하고 특정 필드가 게시되는 방법을 변경할 수 있습니다. Microsoft Project에는 작업 이름 등의 미리 정의된 필드와 사용자 지정 필드가 포함되어 있습니다. Microsoft Project에서 작업 항목 데이터를 게시하거나 새로 고칠 때는 필드 맵이 작업 항목 데이터베이스의 필드와 일치하는 Microsoft Project의 필드를 확인합니다.

Project 및 TFS를 사용하여 작업을 추적하는 방법에 대한 자세한 내용은 Project를 사용하여 백로그 및 작업 만들기를 참조하세요.

팀 프로젝트에 대한 필드 매핑을 수정하려면 TFSFieldMapping 명령줄 도구를 사용하여 Microsoft Project 매핑 파일을 내보낸 다음 가져옵니다.

Mapping 요소

작업 항목 필드와 프로젝트 열 간의 매핑을 지정하려면 Mapping 요소를 사용합니다.

작업 항목 형식 필드와 Microsoft Project 필드 간의 매핑을 지정하려면 다음 XML 구문을 사용합니다. 그런 다음 Mapping 요소를 사용하여 필드 매핑을 지정합니다.

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly="">
         IfSummaryRefreshOnly=""/>

특성

다음 표에서는 Mapping 요소에 사용할 수 있는 특성에 대해 설명합니다.

특성

설명

WorkItemTrackingFieldReferenceName

필수 요소. 작업 항목 형식 내 필드의 참조 이름을 지정합니다.

ProjectField

필수 요소. Microsoft Project의 필드 이름을 지정합니다. 작업 이름 열의 경우 pjTaskName과 같이 이름 앞에 "pj" 접두사를 붙여 미리 정의된 필드 이름을 지정합니다. pjTaskText11과 같이 pjTaskText 뒤에 숫자를 붙이는 형식으로 사용자 지정 필드를 지정합니다.

ProjectName

선택 사항입니다. Microsoft Project에 열 이름으로 표시할 이름을 지정합니다. 이 특성을 지정하지 않으면 작업 항목 형식의 필드 이름이 사용됩니다.

ProjectUnits

선택 사항입니다. 필드 형식을 Microsoft Project에 매핑할 때 사용할 단위 유형을 지정합니다. pjMinute, pjHour, pjDay, pjWeek, pjMonthUnit 값을 지정할 수 있습니다.

참고

ProjectUnits는 기간 또는 기타 시간 단위를 지정하는 필드에 대해서만 지정할 수 있습니다.

PublishOnly

선택 사항입니다. true로 설정하면 필드가 작업 항목 데이터베이스에 게시는 되지만 새로 고쳐지지는 않습니다. 이 값은 대개 팀 탐색기에서 업데이트하면 안 되는 계산 필드에 사용됩니다. false로 설정하면 필드가 게시되며 새로 고쳐집니다. 기본값은 false입니다.

기본 매핑 파일에서 PublishOnly 특성이 true로 설정되는 두 필드는 시작 날짜와 완료 날짜입니다.

IfSummaryRefreshOnly

선택 사항입니다. true로 설정하면 필드가 작업 항목 데이터베이스에 게시되지는 않지만 다음 조건에도 해당하는 경우 작업 항목 데이터베이스에서 새로 고쳐집니다.

  • 필드의 행이 Office Project의 요약 작업인 경우

  • 요약 작업의 게시 및 새로 고침 값이 Yes로 설정된 경우

  • 요약 작업이 Team Foundation Server에 바인딩된 자식 작업을 하나 이상 포함하는 경우

Microsoft Project에서 수행하는 모든 업데이트 또는 계산은 프로젝트 계획의 작업 항목 데이터베이스에서 새로 고쳐지는 값을 덮어쓸 수 있습니다. 그러나 수정된 값이 작업 항목 데이터베이스에 저장되지는 않습니다. 이 특성은 작업 항목 데이터베이스에 게시하는 경우 데이터 불일치가 발생하는 요약 필드에 주로 사용됩니다.

false로 설정하면 필드가 게시되며 새로 고쳐질 수 있습니다. 값을 지정하지 않는 경우의 기본값은 false입니다.

참고

IfSummaryRefreshOnly 특성에 할당되는 값은 PublishOnly에 할당되는 값을 대체합니다.자세한 내용은 이 항목 뒷부분의 게시 및 새로 고침에 영향을 주는 필드를 참조하세요.

기본 매핑 파일에서 IfSummaryRefreshOnly 특성은 원래 예상 값, 남은 작업 시간 및 완료된 작업 필드에 대해 true로 설정됩니다.

다음 예제에서는 제목이 포함된 작업 항목 형식 필드를 Microsoft Project 작업 이름 필드에 매핑하는 방법을 보여 줍니다.

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

다음 XML 구문에서는 시작 날짜가 포함된 작업 항목 형식 필드를 Microsoft Project 시작 날짜 필드에 매핑하는 방법의 더 복잡한 예제를 보여 줍니다. 이 필드는 계산 필드이므로 팀 탐색기 업데이트로 인한 오류가 발생하지 않도록 게시되지만 새로 고쳐지지 않도록 지정됩니다.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

참고

Microsoft Project의 계산 필드는 Team Foundation의 읽기 전용 필드에 매핑하는 것이 가장 좋습니다.이렇게 하면 혼동을 방지할 수 있으므로 팀 멤버가 계산 필드 변경을 시도하지 않습니다.

ReservedField 요소

ReservedField 요소는 작업 간에 정의된 계층적 링크를 지원하는 선택적 요소입니다.

매핑에서 이 요소를 지정하지 않으면 Microsoft Project에서는 기본 pjNumber20 필드를 사용합니다.

SyncField 요소

동기화 필드를 사용하면 각 작업의 게시 및 새로 고침 동작을 제어할 수 있습니다. 이 필드는 Team System 작업 시트 뷰를 사용할 때 제목이 게시 및 새로 고침인 열로 표시됩니다.

Microsoft Project 필드 매핑 파일에서 동기화 필드를 지정해야 합니다. 동기화 필드를 지정하려면 다음 XML 구문을 사용합니다. 동기화 필드를 지정하려면 SyncField 요소를 사용합니다. ProjectField 특성은 유효한 Office Project 필드로 설정해야 합니다.

<SyncField ProjectField="" />

다음 예제에서는 pjTaskText25를 동기화 필드로 지정하는 방법을 보여 줍니다.

<SyncField ProjectField="pjTaskText25" />

Office Project에서 동기화 필드를 사용하는 방법에 대한 자세한 내용은 Project에서 작업 항목 게시 또는 새로 고침[리디렉션]을 참조하세요.

ResourceNameSeparator 요소

ResourceNameSeparator를 사용하여 문자열의 리소스 이름을 구분하는 문자를 정의할 수 있습니다. Team Foundation 사용자와 리소스는 Active Directory 디렉터리 서비스의 사용자와 동기화됩니다. 사용자와 리소스의 이름은 리소스의 성, 이름, 가운데 머리 글자를 구분하기 위한 쉼표와 같은 구분 기호를 포함할 수 있습니다.

이 요소는 선택 사항입니다. 매핑에서 이 요소를 지정하지 않으면 Microsoft Project에서는 다음 테이블에 정의된 기본 매핑을 사용하여 리소스 이름을 구분합니다.

Active Directory 및 팀 프로젝트 목록 구분 기호

Office Project에서 대체되는 기호

,

;

;

:

.

:

위의 표에 나와 있는 것과 다른 문자를 지정하려면 다음 구문을 사용해 ResourceNameSeparator를 정의할 수 있습니다.

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

다음 예제에서는 Team Foundation의 문자가 "-"일 때 Office Project에서 사용할 구분 기호로 "*"를 지정하는 방법을 보여 줍니다.

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

계층 링크 형식

Microsoft Project에서 요약 작업을 만들면 요약 작업, 부모 및 하위/자식 작업 간에 트리 링크가 작성됩니다. Office Project에서는 기본 System.LinkTypes.Hierarchy를 사용하여 이러한 링크를 만듭니다.

종속성 링크 형식

Microsoft Project에서 작업 간에 링크를 만들 때는 작업 간 종속성 링크가 작성됩니다. 선행 작업에는 선행 작업 링크가, 후속 작업에는 후속 작업 링크가 할당됩니다. 이러한 할당은 System.LinkTypes.Dependency 링크 형식에 대해 정의되는 기본 지정입니다.

게시 및 새로 고침에 영향을 주는 매핑 특성

다음 매핑 필드 및 Microsoft Project 필드 값에 따라 작업 항목의 값이 게시되는지 아니면 새로 고쳐지는지 결정됩니다.

  • 각 작업 항목의 게시 및 새로 고침 값

  • 특정 매핑 필드의 PublishOnly 특성 값

  • 특정 매핑 필드의 IfSummaryRefreshOnly 값

  • 작업 분류(요약 또는 부모 작업)

    부모 작업은 Team Foundation Server에 게시된 자식 작업을 하나 이상 포함하는 작업입니다.

요약 작업이 아닌 작업 항목

다음 표에는 요약 작업 또는 부모 작업이 아닌 작업 항목이 매핑 필드 특성과 해당 항목의 게시 및 새로 고침 값에 대한 할당을 기준으로 하여 게시되는지 아니면 새로 고쳐지는지가 나와 있습니다.

게시 및 새로 고침

(작업 수준)

PublishOnly 특성

필드 게시 여부

필드 새로 고침 여부

아니요

True 또는 False

아니요

아니요

새로 고침만

True 또는 False

아니요

예

예

True

예

아니요

예

False

예

예

요약 작업인 작업 항목

요약 작업 조건이 충족되며 IfSummaryRefreshOnly가 true이면 해당 값이 PublishOnly 값을 대체합니다. 다음 표에는 게시 및 새로 고침 값에 대한 할당과 매핑 필드 특성을 기준으로 하여 요약/부모 작업이 게시되는지 아니면 새로 고쳐지는지가 나와 있습니다.

게시 및 새로 고침

(작업 수준)

PublishOnly 특성

IfSummaryRefreshOnly

특성

필드 게시 여부

필드 새로 고침 여부

아니요

True 또는 False

True 또는 False

아니요

아니요

새로 고침만

True

True

아니요

예

새로 고침만

True

False

아니요

예

새로 고침만

False

True 또는 False

아니요

예

예

True 또는 False

True

아니요

예

예

True

False

예

아니요

예

False

False

예

예

참고 항목

개념

링크 형식 요소 참조

프로젝트 필드가 TFS 필드에 매핑되는 방법 추가 또는 변경