Microsoft Project 필드 매핑 파일

업데이트: 2010년 10월

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

매핑 파일에 각 팀 프로젝트에 대한 필드를 지정합니다. 매핑 파일을 가져오려면 팀 프로젝트에서 이를 다운로드합니다. 이 파일을 수정한 후에는 팀 프로젝트에 업로드하여 해당 팀 프로젝트의 모든 사용자에게 변경 내용을 적용할 수 있습니다. Microsoft Project용 필드 매핑 파일을 다운로드 또는 업로드하는 방법에 대한 자세한 내용은 Microsoft Project 필드 매핑 파일 다운로드 또는 업로드를 참조하십시오.

항목 내용

• Mapping 요소

• ReservedField 요소

• SyncField 요소

• ResourceNameSeparator 요소

• 계층적 링크 형식

• 종속성 링크 형식

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

Mapping 요소

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

다음 XML 구문을 사용하여 작업 항목 형식 필드와 Microsoft Project 필드 간의 매핑을 지정합니다. 그런 다음 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"/>

맨 위로 이동

ReservedField 요소

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

이 요소가 매핑에 지정되지 않은 경우 Microsoft Project에서는 기본 pjNumber20 필드를 사용합니다.

맨 위로 이동

SyncField 요소

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

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

<SyncField ProjectField="" />

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

<SyncField ProjectField="pjTaskText25" />

Office Project에서 동기화 필드를 사용하는 방법에 대한 자세한 내용은 Office Project에서 작업 항목 게시 또는 새로 고침를 참조하십시오.

맨 위로 이동

ResourceNameSeparator 요소

ResourceNameSeparator를 사용하면 문자열에서 리소스 이름을 구분하는 문자를 정의할 수 있습니다. Team Foundation 사용자 및 리소스는 Active Directory 디렉터리 서비스의 사용자와 동기화됩니다. 사용자 및 리소스 이름에는 성, 이름 및 리소스의 중간 이니셜 등을 구분하기 위해 쉼표와 같은 구분 기호가 포함될 수 있습니다.

이 요소는 선택적입니다. 이 요소가 매핑에 지정되지 않은 경우 Microsoft 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에 게시된 자식 작업이 최소한 하나 이상 있는 작업입니다.

작업 항목이 요약 작업이 아닌 경우

다음 표에서는 요약 또는 부모 작업이 아닌 작업 항목이 매핑 필드 특성 및 해당 항목의 게시 및 새로 고침에 할당된 값을 기반으로 게시 또는 새로 고쳐지는지 여부를 나타냅니다.

작업 항목이 요약 작업인 경우

요약 작업 조건이 충족되고 IfSummaryRefreshOnly가 true이면 해당 값이 PublishOnly 값을 대체합니다. 다음 표에서는 요약 또는 부모 작업이 해당 항목의 게시 및 새로 고침에 할당된 값과 매핑 필드 특성을 기반으로 게시 또는 새로 고쳐지는지 여부를 나타냅니다.

맨 위로 이동

참고 항목

개념

링크 형식 작업

기타 리소스

Microsoft Project 필드 매핑 사용자 지정

변경 기록