기능을 구성할 때 받은 오류 해결
기능 구성 마법사가 표시하는 오류 및 경고를 해결할 수 있습니다. 이러한 문제는 팀 프로젝트의 정의가 팀 프로젝트 컬렉션에 업로드된 프로세스 템플릿의 정의와 충돌하기 때문에 발생합니다. 이 오류를 해결하고 마법사를 다시 실행하려면 프로세스 템플릿을 변경해야 합니다. 또는 팀 프로젝트를 변경한 다음 마법사를 다시 실행할 수 있습니다.
항목 내용
기능 구성 마법사에서 보고된 오류 해결
프로세스 템플릿을 수정하여 오류 해결
팀 프로젝트 또는 팀 프로젝트 컬렉션을 수정하여 오류 해결
문제 및 해결
기능 구성 마법사에서 보고된 경고 해결
작업 항목 형식에 ACTION 문 추가에 대한 경고 해결
스토리보드 링크 컨트롤 추가
참고
다음 절차를 수행하는 중에 문제가 발생하는 경우 Microsoft 웹 사이트의 작업 항목 추적 및 프로세스 템플릿 페이지에서 Team Foundation Server(TFS) 포럼의 해결 방법을 찾을 수 있습니다.
필요한 권한
프로세스 템플릿을 다운로드 및 업로드하려면 Project Collection Administrators 그룹의 멤버여야 합니다. 보안 권한이 명시적으로 설정된 경우 팀 프로젝트 컬렉션에 대한 프로세스 템플릿 관리 권한을 허용으로 설정해야 합니다.
witadmin 명령줄 도구를 실행하려면 팀 프로젝트에 대해 Team Foundation Administrators, Project Collection Administrators 또는 Project Administrators 그룹 중 하나의 멤버여야 합니다.
자세한 내용은 Team Foundation Server에 대한 사용 권한 참조을 참조하십시오.
기능 구성 마법사에서 보고된 오류 해결
새 기능을 구성하는 데 사용된 프로세스 템플릿을 수정하거나 팀 프로젝트를 수정하여 오류를 해결할 수 있습니다. 오류를 해결한 후 마법사를 다시 실행합니다.
프로세스 템플릿을 수정하여 오류 해결
다음 단계를 수행하여 프로세스 템플릿을 수정합니다.
Team Foundation Server에서 프로세스 템플릿을 다운로드합니다. 최신 버전의 프로세스 템플릿 다운로드을 참조하세요.
작업 항목 형식, 범주 또는 프로세스 구성에 대한 정의 파일을 수정합니다. 팀 프로세스를 지원하도록 작업 추적 개체 사용자 지정을 참조하세요.
프로세스 템플릿을 Team Foundation Server로 업로드합니다. 팀 프로젝트 컬렉션의 프로세스 템플릿 업로드, 다운로드 및 삭제을 참조하세요.
사용자 지정된 프로세스 템플릿을 새 기능에 액세스할 수 있도록 업데이트을 참조하십시오.
팀 프로젝트 또는 팀 프로젝트 컬렉션을 수정하여 오류 해결
오류나 경로를 해결하기 위해 witadmin 명령을 사용하여 팀 프로젝트 또는 팀 프로젝트 컬렉션을 수정할 수 있습니다. witAdmin: 작업 추적을 위한 개체 사용자 지정 및 관리을 참조하세요.
형식 정의를 내보내고 필드 정의를 변경한 다음 필요에 따라 형식 정의를 가져올 수 있습니다. 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin]을 참조하세요.
문제 및 해결
다음 표에 나열된 오류를 해결하려면 프로세스 템플릿 또는 팀 프로젝트에 해당하는 수정 조치를 수행한 다음 마법사를 다시 실행합니다.
오류 |
문제 |
프로세스 템플릿 해결 |
팀 프로젝트 해결 |
|---|---|---|---|
TF400613: '{0}' 범주에서 지정한 '{1}' 작업 항목 형식이 없습니다. |
이름이 바뀌었거나, 제거되었거나, 추가되지 않아 팀 프로젝트에서 필요한 작업 항목 형식이 누락되었습니다. 지정한 작업 항목 형식 정의의 이름을 바꾸거나 TFS 업그레이드로 설치된 최신 버전의 프로세스 템플릿에서 누락된 작업 항목 형식을 가져옵니다. |
지정한 범주에 정의된 작업 항목 형식을 변경하여 기존 작업 항목 형식을 지정합니다. |
작업 항목 형식의 이름을 바꾸려면 witadmin renamewitd를 사용합니다. 누락된 작업 항목 형식을 추가하려면 최신 프로세스 템플릿에서 찾은 다음 witadmin importwitd를 사용하여 가져옵니다. 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin]을 참조하세요. |
TF400614: '{0}' 범주가 없습니다. |
팀 프로젝트를 업데이트하기 위해 선택한 프로세스 템플릿의 범주 정의 파일에서 필요한 범주가 누락되었습니다. 누락된 범주를 추가합니다. |
프로세스 템플릿에 누락된 범주를 추가합니다. 범주를 사용하여 작업 항목 형식 그룹화을 참조하세요. |
witadmin importcategories를 사용하여 팀 프로젝트에 누락된 범주를 추가합니다. I범주 가져오기 및 내보내기[witadmin]을 참조하세요. |
TF400617: '{1}' 작업 항목 형식의 '{0}' 필드 형식이 기존 필드의 형식과 충돌합니다. |
추가되는 작업 항목 형식에 정의된 필드의 데이터 형식이 팀 프로젝트 컬렉션에 정의된 데이터 형식과 일치하지 않습니다. 작업 항목 형식 정의에서 할당을 수정한 다음 마법사를 다시 실행합니다. 참고 Visual Studio Team Foundation Server 2012를 업그레이드하면 텍스트 서식 지정과 이미지 및 하이퍼링크 삽입을 지원하기 위해 설명 필드(System.Description)의 필드 형식이 일반 텍스트에서 HTML로 변경됩니다.최신 버전의 Team Foundation Server에서는 PlainText와 HTML 간에 데이터 형식을 전환할 수 있습니다. |
프로세스 템플릿을 다운로드하고 형식 정의를 열어 FIELD 할당을 찾은 다음 해당 컬렉션에 대해 정의된 특성과 일치하도록 type 특성을 수정하고 프로세스 템플릿을 업로드합니다. FIELD(정의) 요소 참조를 참조하십시오. 팁 필드에 할당된 형식을 확인하려면 witadmin listsfields를 실행합니다. |
witadmin changefield를 사용하고 type 특성을 지정합니다. 작업 항목 필드 관리[witadmin]을 참조하세요. 참고 형식이 PlainText 또는 HTML인 경우에만 팀 프로젝트 컬렉션의 형식 정의를 변경할 수 있습니다. |
TF400618: '{1}' 작업 항목 형식의 '{0}' 필드 보고 형식이 기존 필드의 보고 형식과 충돌합니다. |
작업 항목 형식 정의의 필드에 할당된 보고 특성이 팀 프로젝트 컬렉션에 정의된 특성과 일치하지 않습니다. |
프로세스 템플릿을 다운로드하고 형식 정의를 열어 FIELD 할당을 찾은 다음 해당 컬렉션에 대해 정의된 특성과 일치하도록 reportable 특성을 수정합니다. 그런 다음 프로세스 템플릿을 업로드합니다. FIELD(정의) 요소 참조를 참조하십시오. |
witadmin changefield를 사용하고 reportingtype 특성을 지정합니다. 작업 항목 필드 관리[witadmin]을 참조하세요. |
TF400619: '{1}' 작업 항목 형식의 '{0}' 필드 SyncNameChanges 가 기존 필드의 SyncNameChanges와 충돌합니다. |
작업 항목 형식 정의의 필드에 할당된 syncnamechanges 특성이 팀 프로젝트 컬렉션에 정의된 특성과 일치하지 않습니다. 이 특성은 Active Directory에서 해당 이름이 변경될 때 사용자 이름 필드를 업데이트할지 여부를 지정합니다. |
프로세스 템플릿을 다운로드하고 형식 정의를 열어 FIELD 할당을 검색한 다음 해당 컬렉션의 정의와 일치하도록 할당을 수정하고 프로세스 템플릿을 업로드합니다. FIELD(정의) 요소 참조을 참조하세요. |
witadmin changefield 명령을 사용하고 /syncnamechanges 매개 변수를 지정합니다. 작업 항목 필드 관리[witadmin]을 참조하세요. |
TF400620: '{1}' 작업 항목 형식의 '{0}' 필드 이름이 기존 필드의 이름과 충돌합니다. |
작업 항목 형식 정의의 필드에 할당된 이름은 팀 프로젝트 컬렉션에 정의된 이름과 일치해야 합니다. |
프로세스 템플릿을 다운로드하고 형식 정의를 열어 FIELD 할당을 찾은 다음 해당 컬렉션에 대해 정의된 할당과 일치하도록 할당을 수정합니다. 그런 다음 프로세스 템플릿을 업로드합니다. |
팀 프로젝트 컬렉션의 이름을 변경하려면 witadmin changefield 명령을 사용하고 /name 매개 변수를 지정합니다. 작업 항목 필드 관리[witadmin]을 참조하세요. |
TF400621: '{1}' 작업 항목 형식의 '{0}' 필드 참조 이름이 이미 링크 형식에서 사용 중입니다. |
필드 및 링크 형식에 할당된 각 참조 이름은 팀 프로젝트 컬렉션 내에서 고유해야 합니다. |
링크 형식이 활성 상태이며 작업 항목 연결에 사용 중인 경우 프로세스 템플릿을 다운로드하고 형식 정의를 열어 FIELD 할당을 찾은 다음 컬렉션에 대해 정의된 할당과 일치하도록 refname 할당을 수정합니다. 그런 다음 프로세스 템플릿을 업로드합니다. 팁 링크 형식이 사용 중인지 확인하려면 직접 링크 쿼리를 만든 다음 해당 링크 형식을 사용하여 다른 작업 항목에 연결된 모든 작업 항목을 필터링합니다. |
링크 형식이 활성 상태가 아니고 팀 프로젝트 컬렉션 내의 작업 항목 연결에 사용되고 있지 않은 경우 삭제합니다. witadmin deletelinktype을 사용하여 링크 형식을 삭제할 수 있습니다. 링크 형식 관리[witadmin]을 참조하세요. |
TF400624: '{0}' 범주의 이름이 '{1}' 범주와 충돌합니다. |
팀 프로젝트의 각 범주에 고유한 참조 이름과 이름을 할당해야 합니다. 프로세스 템플릿 또는 팀 프로젝트에서 기존 범주 '{1}'의 이름을 바꾸면 이 오류를 해결할 수 있습니다. |
프로세스 템플릿을 다운로드하고 범주 파일을 수정하여 범주의 이름을 바꾼 다음 프로세스 템플릿을 업로드합니다. 범주를 사용하여 작업 항목 형식 그룹화을 참조하세요. |
witadmin exportcategories를 사용하여 범주 파일을 내보내고, '{1}' 범주에 할당된 이름을 수정한 다음 파일을 가져옵니다. I범주 가져오기 및 내보내기[witadmin]을 참조하세요. |
TF400654: 계획 도구를 구성할 수 없습니다. |
CommonConfiguration 파일에 정의된 매핑이 팀 프로젝트에 대해 정의된 작업 항목 형식에 없는 필드 또는 상태를 지정합니다. |
프로세스 템플릿을 다운로드하고 CommonConfiguration 파일을 수정하여 매핑을 수정한 다음 프로세스 템플릿을 업로드합니다. 프로세스 구성 사용자 지정을 참조하십시오. |
witadmin exportwitd를 사용하여 작업 항목 형식을 내보내고 누락된 필드 또는 상태를 추가한 다음 작업 항목 형식을 가져옵니다. 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin]을 참조하세요. |
자세한 내용은 다음 항목을 참조하십시오.
기능 구성 마법사에서 보고된 경고 해결
다음 표에 나열된 경고를 해결하려면 해결 단계를 따른 후 마법사를 다시 실행합니다.
경고 |
문제 |
해결 방법 |
|---|---|---|
TF400609: '{2}' 상태가 없어 '{0}' 작업을 '{1}' 작업 항목 형식에 추가할 수 없습니다. |
필수 STATE가 없습니다. |
ACTION 문을 작업 항목 형식에 추가할 때의 오류 해결을 참조하십시오. |
TF400610: '{2}' 상태에서 '{3}' 상태로의 전환이 없어 '{0}' 작업을 '{1}' 작업 항목 형식에 추가할 수 없습니다. |
필수 TRANSITION 문이 없습니다. |
ACTION 문을 작업 항목 형식에 추가할 때의 오류 해결을 참조하십시오. |
스토리보딩: '{2}' 범주의 '{1}' 작업 항목 형식에 탭을 삽입할 수 없습니다. |
형식 정의에 TabGroup 요소가 없습니다. |
스토리보드 링크 컨트롤 추가를 참조하십시오. |
작업 항목 형식에 ACTION 문 추가에 대한 경고 해결
내 작업 기능을 지원하기 위해 기능 구성 마법사는 ACTION 문 두 개를 작업 항목 형식 정의의 워크플로 전환 섹션에 삽입합니다. 상태가 누락되거나 새 상태에서 활성 상태로 또는 활성 상태에서 새 상태로 이동하는 전환이 누락된 경우 경고를 받게 됩니다.
경고를 해결하려면 표시된 작업 항목 형식의 워크플로를 검토합니다. 필요한 경우 팀 프로젝트를 만드는 데 사용된 것과 일치하는 업그레이드된 TFS에 설치된 최신 버전의 프로세스 템플릿에 대해 정의된 워크플로 상태 및 전환과 일치하도록 워크플로를 수정합니다. 그런 다음 마법사를 다시 실행합니다. Agile 프로세스 템플릿을 기준으로 작성된 팀 프로젝트의 경우 Agile 팀 프로젝트의 워크플로 업데이트를 참조하십시오.
자세한 내용은 다음 항목을 참조하십시오.
스토리보드 링크 컨트롤 탭 추가
이제 스토리보딩을 추가하여 스토리보드에 작업 항목을 연결할 수 있습니다. 이렇게 하려면 작업 항목 형식 정의에 스토리보드 링크 컨트롤 탭을 추가합니다. 구성 기능 마법사가 탭을 추가하지 않았거나 추가하지 못한 경우 수동으로 탭을 추가할 수 있습니다. 업그레이드된 TFS에 설치된 최신 버전의 프로세스 템플릿에서 Storyboard 링크 컨트롤 탭은 제품 백로그, 사용자 스토리, 요구 사항 등 모든 백로그 작업 항목 형식에 나타납니다.
참고
FORM 작업 항목 섹션에 TabGroup 요소가 없으면 기능 구성 마법사에서 스토리보드 링크 컨트롤 탭을 추가할 수 없습니다.다음 절차는 스토리보드 탭만 추가합니다.백로그 작업 항목 형식에 필요한 표준 탭 집합을 추가하는 경우 팀 프로젝트용 프로세스 템플릿의 최신 버전에 있는 형식 정의를 참조하십시오.최신 버전의 프로세스 템플릿 다운로드을 참조하세요.
witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.
표시된 인수를 사용자 데이터로 대체하여 백로그 항목의 형식 정의 파일을 내보냅니다.
witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:"TypeName" /f:"DirectoryPath\FileName.xml" Where: CollectionURL specifies the URL of the team project collection ProjectName specifies the name of your team project defined within the collection TypeName specifies the name of your backlog item, for example User Story or Product Backlog Item. Use the following format for CollectionURL: http://ServerName:Port/VirtualDirectoryName/CollectionName For example: http://srvalm:8080/tfs/DefaultCollection.메모장 같은 텍스트 편집기를 사용하여 파일을 엽니다.
백로그 형식의 </Layout> 종료 태그 바로 앞에 다음 코드 조각을 추가합니다.
<TabGroup> <Tab Label="Storyboards"> <Control Name="StoryboardsControl" Type="LinksControl"> <LinksControlOptions> <WorkItemLinkFilters FilterType="excludeAll" /> <ExternalLinkFilters FilterType="include"> <Filter LinkType="Storyboard" /> </ExternalLinkFilters> <LinkColumns> <LinkColumn RefName="System.Title" /> <LinkColumn LinkAttribute="System.Links.Comment" /> </LinkColumns> </LinksControlOptions> </Control> </Tab> </TabGroup>파일을 저장한 후 닫습니다.
표시된 인수를 사용자 데이터로 대체해서 다음 명령을 입력하여 형식 정의 파일을 가져옵니다.
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"백로그 항목에 탭이 표시되는지 확인합니다.