연습: 작업 항목 형식의 필드 관리
업데이트: 2007년 11월
이 연습에서는 Team Foundation Server의 작업 항목 형식에 사용되는 필드를 표시하고, 이름을 바꾸고, 삭제합니다. 필드에는 팀 프로젝트 간의 여러 작업 항목 형식이 포함될 수 있습니다.
이 단원에서는 다음과 같은 작업 절차를 설명합니다.
필드 보기 이 절차에서는 작업 항목 형식의 필드를 출력하여 표시합니다.
필드 이름 바꾸기 이 절차에서는 필드의 이름을 변경하고 폼에서 변경 내용이 반영되는 위치를 살펴 봅니다.
필드 삭제 이 절차에서는 이전 절차에서 작업 항목 폼에 추가한 필드를 삭제합니다.
사전 요구 사항
연습: 기본적인 작업 항목 형식 사용자 지정 및 연습: 작업 항목 형식 고급 사용자 지정에서 설명하는 단계를 완료해야 합니다.
Team Foundation Server에 연결할 수 있고 적절한 권한이 있는 경우 명령 프롬프트, 배치 파일 또는 스크립트 파일에서 작업 항목 형식의 필드를 관리할 수 있습니다. 이렇게 하려면 Visual Studio 2008 명령 프롬프트 유틸리티를 사용하거나 다음 예제와 같이 vsvars32를 사용하여 현재 명령 프롬프트에서 몇 가지 환경 변수를 설정해야 합니다. 팀 프로젝트에 참가하는 방법에 대한 자세한 내용은 연습: 팀 프로젝트 참가를 참조하십시오.
명령 프롬프트에서 Team Foundation 명령을 사용하려면
- 시작, 모든 프로그램을 클릭하고 Microsoft Visual Studio 2008, Visual Studio Tools를 차례로 가리킨 다음 Visual Studio 2008 명령 프롬프트를 클릭합니다.
또는 Visual Studio 설치 경로(일반적으로 DriveLetter:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools)에서 vsvars32를 실행할 수도 있습니다.
필수 권한
이 절차를 수행하려면 Team Foundation Administrators 그룹의 멤버이거나 프로젝트에 대한 Project Administrators 그룹의 멤버여야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.
필드 보기
필드를 보려면
Visual Studio 명령 프롬프트를 엽니다.
명령 프롬프트에서 다음과 같이 입력하고 Enter 키를 눌러 Team Foundation Server에 정의된 모든 필드를 텍스트 파일로 출력합니다.
witfields view /s:"Team Foundation Server 이름"
다음과 같은 정보가 포함된 필드 목록이 표시됩니다.
필드:
필드의 참조 이름입니다.
이름:
필드의 이름입니다.
형식:
필드의 데이터 형식입니다.
보고 가능 형식:
필드의 보고 관련 설정입니다.
용도:
이 필드가 사용되는 팀 프로젝트와 이 필드가 표시되는 작업 항목 형식입니다.
필드 이름 바꾸기
필드 이름을 바꾸려면
Visual Studio 명령 프롬프트에 다음과 같이 입력하고 Enter 키를 누릅니다.
witfields rename /s:"Team Foundation Server 이름" Microsoft.VSTS.Common.Rank Importance
이 명령을 실행하면 Rank 필드의 이름이 Importance로 바뀝니다.
이름을 바꿀지 확인하는 메시지가 나타나면 y를 입력하고 Enter 키를 누릅니다. 다음 메시지가 표시될 때까지 기다립니다.
Field renamed.
Visual Studio의 팀 탐색기 창에서 새로 고침을 클릭하여 서버의 최신 업데이트를 다운로드합니다.
모든 노드가 로드될 때까지 몇 초 동안 기다리십시오. 로드되고 있는 노드는 작업 중으로 표시됩니다.
작업 항목 노드를 마우스 오른쪽 단추로 클릭하고 쿼리 추가를 선택하여 새 쿼리를 만듭니다.
절을 추가하려면 여기를 클릭하십시오.라고 표시된 영역을 클릭하여 새 행을 추가합니다. 그런 다음 빈 필드 셀을 선택합니다. 셀에 Rank를 입력합니다. 결과 목록 위에 다음과 같은 메시지가 나타납니다. 이 메시지는 Rank를 찾을 수 없음을 의미합니다.
쿼리 결과를 보려면 쿼리를 실행하십시오. TF51005: 쿼리에서 존재하지 않는 필드를 참조합니다. <<Rank>>로 인해 오류가 발생합니다.
필드 셀에서 Rank 값을 삭제한 다음 셀에 Importance를 입력합니다.
연산자 셀에서 <>를 선택하고 값 셀에 1을 입력합니다.
팀 메뉴에서 쿼리 실행을 선택합니다.
결과에서 임의의 행을 마우스 오른쪽 단추로 클릭하고 열 옵션을 선택합니다. 사용 가능한 열 목록을 아래로 스크롤합니다. Rank 필드가 더 이상 표시되지 않고 Importance 필드가 대신 추가된 것을 확인할 수 있습니다.
사용 가능한 열 상자에서 Importance를 선택한 다음 선택한 열 추가 단추(>)를 클릭합니다. 확인을 클릭합니다.
쿼리 작성기와 결과 목록 전체에서 Microsoft.VSTS.Common.Rank의 이름이 Rank에서 Importance로 바뀐 것을 확인할 수 있습니다.
닫기를 클릭하여 쿼리를 닫습니다. 쿼리를 저장할 것인지 묻는 메시지가 나타나면 아니요를 클릭합니다.
새 Special Task 작업 항목을 만듭니다. 이렇게 하려면 작업 항목 노드를 마우스 오른쪽 단추로 클릭하고 작업 항목 추가를 가리킨 다음 SpecialTask를 클릭합니다.
이 작업 항목은 변경하여 가져온 작업 항목 형식에서 만들어집니다.
Rank 필드의 이름을 변경해도 상태 상자에서 이 필드의 레이블은 변경되지 않습니다. 이는 작업 항목 폼의 필드 레이블 범위에는 부모 팀 프로젝트도 포함되며 이 레이블은 방금 지정한 서버측 필드 이름에 대해 독립적이기 때문입니다.
.gif "참고")
참고:작업 항목 폼의 필드 레이블 변경을 변경하는 방법에 대한 자세한 내용은 연습: 작업 항목 형식 고급 사용자 지정에서 "필드 레이블 사용자 지정" 절차를 참조하십시오.
닫기를 클릭하여 새 Special Task를 닫습니다. 작업 항목을 저장할 것인지 묻는 메시지가 나타나면 아니요를 클릭합니다.
필드 삭제
전제 조건: 연습: 기본적인 작업 항목 형식 사용자 지정에서 설명하는 "필드 추가" 절차를 완료해야 합니다.
필드를 삭제하려면
필드 추가 절차에서 추가했던 Category 필드를 삭제해 봅니다. 이렇게 하려면 Visual Studio 명령 프롬프트에 다음 명령을 입력한 후 Enter 키를 누릅니다.
witfields delete /s:"Team Foundation Server 이름" MyCompany.MyProcess.Category
해당 필드가 팀 프로젝트에 사용되고 있으므로 이 필드를 삭제할 수 없다는 오류 메시지가 반환됩니다.
다음 명령을 입력하고 Enter 키를 누릅니다.
witexport /f "File Path\specialtask.xml" /t "Team Foundation Server name" /p WITLab /n "Special Task"
이렇게 하면 필드 이름 바꾸기 절차에서 바뀐 새 이름을 사용하는 Microsoft.VSTS.Common.Rank 필드의 새 정의가 포함된 Special Task 작업 항목 형식 정의를 Team Foundation Server에서 XML 파일로 다시 내보냅니다.
참고:Windows Vista를 실행 중인 경우에는 특정 폴더에 액세스하지 못할 수도 있습니다. 작업 항목 형식을 액세스 권한이 없는 위치로 내보내려는 경우 레지스트리 가상화 기술을 통해 내보낸 파일이 자동으로 리디렉션되어 가상 저장소에 저장됩니다. 자세한 내용은 https://go.microsoft.com/fwlink/?LinkId=92325 및 https://go.microsoft.com/fwlink/?LinkId=92323을 참조하십시오. 이러한 리디렉션이 발생하지 않도록 하려면 파일을 액세스 권한이 있는 위치로 내보냅니다.
내보내기 작업이 완료되면 다음 메시지가 표시됩니다.
Work item type export complete.
Visual Studio에서 파일을 클릭하고 열기를 가리킨 다음 파일을 클릭합니다.
파일 열기 대화 상자가 나타납니다.
참고:SpecialTask.xml이 열리면 Visual Studio에서 파일을 다시 로드할지 묻는 메시지가 표시될 수 있습니다. 예를 클릭하여 파일을 다시 로드합니다.
찾는 위치에서 파일을 내보낸 위치로 이동합니다.
specialtask.xml 파일을 클릭한 다음 열기를 클릭합니다.
줄 끝에 대한 메시지가 나타나면 아니요를 클릭합니다.
다음 XML에 표시된 Category 필드 정의를 찾아 삭제합니다.
<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT> <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst"> <ALLOWEDVALUES> <LISTITEM value="Planning" /> <LISTITEM value="Review" /> </ALLOWEDVALUES> </WHEN> <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst"> <ALLOWEDVALUES> <LISTITEM value="Process Management" /> <LISTITEM value="Planning" /> <LISTITEM value="Execution" /> <LISTITEM value="Review" /> </ALLOWEDVALUES> </WHENNOT></FIELD><Layout> 섹션에서 아래 XML을 찾은 다음 강조 표시된 섹션을 삭제하여 필드를 제거합니다.
<Group Label="Classification"> <Column PercentWidth="50"> <Group> <Column PercentWidth="100"> <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" /> <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" /> </Column> </Group> </Column> <Column PercentWidth="50"> <Group> <Column PercentWidth="100"> <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" /> </Column> </Group> </Column> </Group>저장을 클릭하여 XML 파일의 변경 내용을 저장합니다.
변경된 Special Task 작업 항목 형식을 Team Foundation Server로 가져옵니다. 이렇게 하려면 Visual Studio 명령 프롬프트에 다음 명령을 입력한 후 Enter 키를 누릅니다.
witimport /f "File Path\specialtask.xml" /t "Team Foundation Server name" /p WITLab
이 명령은 Special Task 작업 항목 형식을 Team Foundation Server로 가져옵니다. 가져오기 작업이 완료되면 다음 메시지가 표시됩니다.
Work item type import complete.
명령 프롬프트에 다음과 같이 입력하고 Enter 키를 눌러 Category 필드가 어떠한 작업 항목 형식에도 더 이상 사용되지 않음을 확인합니다.
witfields view /s:"Team Foundation Server 이름" MyCompany.MyProcess.Category
witfields 도구를 실행하면 Category가 "사용 중이 아님"으로 표시됩니다.
Field: MyCompany.MyProcess.Category
Name: Category
Type: String
Reportable As: dimension
Use: Not In Use
Category 필드가 어떠한 작업 항목 형식에도 더 이상 사용되지 않으므로 명령 프롬프트에 다음 텍스트를 입력하고 Enter 키를 눌러 Team Foundation Server에서 필드를 영구적으로 삭제합니다. 명령 프롬프트에 y를 입력하여 이 단계를 완료합니다.
witfields delete /s:"Team Foundation Server 이름" MyCompany.MyProcess.Category