작업 항목 필드 관리

아티클
02/21/2013

다음 witadmin 명령을 사용하여 팀 프로젝트 컬렉션에 대해 정의된 작업 항목 형식 필드를 관리할 수 있습니다.

changefield: 필드의 특성을 하나 이상 변경합니다.다음 특성 중 하나를 변경하면 팀 프로젝트 컬렉션 내의 모든 작업 항목 형식과 팀 프로젝트에 대해 변경됩니다.

PlainText 또는 HTML 필드에 대한 데이터 형식.

중요
이전 버전에서 현재 버전으로 Team Foundation Server를 업그레이드하면 설명(System.Description) 필드에 대한 형식 할당이 자동으로 PlainText에서 HTML으로 변환됩니다.changefield 명령으로 이 필드의 내용을 복원하여 일반 텍스트로 표시할 수 있습니다.

작업 항목 쿼리에 표시되는 이름입니다.이 이름은 작업 항목 폼에 표시되는 이름과 다를 수 있습니다.
보고서, 참조 보고서 이름 및 보고 형식에 나타나는 대로 필드의 이름을 포함하는 보고 특성입니다.
Active Directory와 동기화 - 사용자 이름 필드의 동기화를 사용/사용하지 않도록 설정할 수 있습니다.

deletefield: 지정한 필드를 삭제합니다.
indexfield: 지정된 필드에 대한 인덱싱을 켜거나 끕니다.필드에 대한 인덱싱을 사용하도록 설정하면 해당 필드를 지정하는 쿼리가 있는 작업 항목의 찾기 성능을 향상시킬 수 있습니다.여러 작업 항목 쿼리에서 사용하는 사용자 지정 필드를 추가하는 경우 해당 필드에 대한 인덱싱을 사용할 수 있도록 설정할 수도 있습니다.
listfields: 모든 필드 또는 지정한 필드에 대한 특성을 나열합니다.

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

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

Team Foundation Server에서 제공하는 기본 프로세스 템플릿 내에 정의된 필드에 대한 개요는 Visual Studio ALM에 대한 작업 항목 필드 참조를 참조하십시오.

[!참고]

프로세스 편집기, Visual Studio용 강력한 도구를 사용하여 작업 항목 필드를 만들고 수정할 수 있습니다.이 도구는 지원되지 않습니다.자세한 내용은 Microsoft 웹 사이트에서 Team Foundation Server Power Tools 페이지에 나와 있다.

요구 사항

필드를 나열하려면 콜렉션에 있는 해당 팀 프로젝트에 대한 프로젝트 수준 정보 보기 권한을 허용으로 설정해야 합니다.
필드를 삭제하거나 필드 이름을 바꾸려면, 혹은 필드 속성을 변경하려면 Team Foundation 관리자 보안 그룹이나 프로젝트 컬렉션 관리자 보안 그룹의 멤버가 돼야 한다.

자세한 내용은 Team Foundation Server 권한 및 Team Foundation Server 기본 그룹, 권한 및 역할을 참조하십시오.

[!참고]

관리자 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 수행하려면 관리자 명령 프롬프트 창을 열어야 합니다.관리자 권한 명령 프롬프트 창을 열려면 시작을 선택하고 명령 프롬프트 바로 가기 메뉴를 연 다음 관리자 권한으로 실행을 선택합니다.자세한 내용은 Microsoft 웹 사이트, 사용자 액세스 컨트롤을 참조하십시오.

witadmin changefield /collection:CollectionURL /n:RefName
   [/name:NewName] 
   [/syncnamechanges:true | false]
   [/reportingname:ReportingName] 
   [/reportingrefname:ReportingRefName]
   [/reportingtype:Type]
   [/reportingformula:Formula]
   [/type:PlainText | HTML]
   [/noprompt]

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

매개 변수

Parameter	설명
/collection:CollectionURL	팀 프로젝트 컬렉션의 URI를 지정합니다.URI에 대한 형식: http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다. http://ServerName:Port/CollectionName
/n:RefName /n:Name	작업 항목 형식 필드의 참조 이름입니다.
/index	지정된 필드에 대한 인덱싱 사용 가능 여부를 지정합니다.인덱싱을 사용하려면 on을 지정하고 인덱싱을 사용하지 않으려면 off를 지정합니다.
/name:NewName	필드의 새 이름을 지정합니다.
/syncnamechanges	Active Directory 또는 작업 그룹이 변경될 때 작업 항목 필드를 사용하여 이름을 저장하고 업데이트하도록 지정합니다.이 옵션은 문자열 데이터 형식을 가진 필드가 typename에 대해 지정되었을 때만 유효합니다. 데이터 필드에 대한 동기화를 사용하도록 true를 지정하고 데이터 필드에 대한 동기화를 사용하지 않도록 false를 지정합니다.
/reportingname:ReportingName	보고에 사용되는 데이터 웨어하우스의 필드의 이름을 지정합니다.
/reportingrefname:ReportingRefName	보고에 사용되는 데이터 웨어하우스의 필드 참조 이름을 지정합니다.
/reportingtype:Type	보고를 위해 필드를 웨어하우스에서 사용하는 방법을 지정합니다.유효한 값은 다음과 같습니다. dimension: Integer, String 또는 DateTime 필드에 사용됩니다. detail: Integer, Double, String 또는 DateTime 필드에 사용됩니다. measure: Integer와 Double 필드에 사용됩니다.기본 집계 형식은 sum입니다.formula 매개 변수를 사용하여 다른 집계 형식을 지정할 수 있습니다. disable: 필드에서 보고 가능 형식을 사용할 수 없도록 설정하는 데 사용됩니다. 자세한 내용은 작업 항목 필드 사용을 참조하십시오.
/reportingformula:Formula	measure로 필드가 보고될 때 사용할 집계 수식을 지정합니다.지원되는 유일한 형식은 sum입니다.
/type:HTML \| PlainText	PlainText에서 HTML로 또는 HTML에서 PlainText로 필드의 콘텐츠 변환을 지정합니다.PlainText 또는 HTML 유형이 할당된 필드에 대해서만 이 옵션을 지정할 수 있습니다.자세한 내용은 FIELD(정의) 요소를 참조하십시오.
/unused	팀 프로젝트 컬렉션에 정의된 모든 팀 프로젝트에 사용되지 않는 모든 필드를 나열합니다.
/noprompt	확인 프롬프트를 비활성화합니다.
/?or help	명령 프롬프트 창에 명령에 대한 도움말을 표시합니다.

설명

인덱싱된 필드

쿼리 인덱스는 인덱싱이 활성화된 필드를 기반으로 만들어집니다.이 인덱스는 인덱싱된 필드를 포함하는 쿼리를 실행할 때 응답 시간을 향상시킵니다.

기본적으로 담당자, 만든 날짜, 변경한 사람, 상태, 이유, 영역 ID, 반복 ID 및 작업 항목 형식 필드가 인덱싱됩니다.팀이 쿼리에 자주 사용하는 다른 필드가 있을 경우 쿼리 인덱스에 추가할 수 있습니다.

Active Directory와 사용자 이름 동기화

Active Directory를 참조하는 개인 이름을 할당하는 데 사용된 사용자 지정 작업 항목 필드의 동기화를 수동으로 설정해야 합니다.사용자 지정 필드가 있는 각 팀 프로젝트 컬렉션의 각 필드에 대한 동기화를 설정해야 합니다.

개인 이름을 표시하는 모든 시스템 참조 필드의 특성 syncnamechanges는 true로 설정되었습니다. 이러한 필드는 System.AuthorizedAs, System.AssignedTo, System.ChangedBy 및 System.createdby를 포함합니다. 기본 프로세스 템플릿 중 하나에 정의된 각 개인 이름 필드에 활성화된 동기화입니다.자세한 내용은 할당 및 워크플로 필드 참조을 참조하십시오.

동기화가 설정되면 필드에 더 이상 정적 문자열이 표시되지 않습니다.대신 이 필드에는 사용자 계정과 연결된 이름이 표시됩니다.Active Directory나 작업 그룹에서 사용자 이름을 변경하면 syncnamechanges가 true로 설정된 필드에 새 이름이 자동으로 표시됩니다.

syncnamechanges 특성을 문자열 필드에 지정할 경우 필드는 항상 올바른 사용자 이름을 받아들입니다.그러나 다음 조건 중 하나가 true인 경우 필드는 Team Foundation Server 또는 Active Directory에 저장된 그룹 이름을 허용하지 않습니다.

VALIDUSER 규칙은 모든 작업 항목 형식에 지정됩니다.
VALIDUSER 규칙은 작업 항목 형식에 대해 지정됩니다
ALLOWEDVALUES 규칙은 작업 항목 형식에 대해 지정되고 해당 규칙은 그룹을 제외하는 필터 조건이 있습니다.

자세한 내용은 모든 FIELD XML 요소 참조을 참조하십시오.

각 작업 항목 형식에 대해 변경할 수 있는 특성

필드가 나타나는 작업 항목 형식 정의를 변경하여 필드에 정의된 다음 특성 또는 값을 변경합니다.

작업 항목 폼에 표시되는 이름입니다.자세한 내용은 Control XML 요소 참조를 참조하십시오.
도움말 텍스트.자세한 내용은 작업 항목 필드에 대한 도움말 텍스트 정의를 참조하십시오.
허용되는 값 또는 선택 목록이나 드롭다운 메뉴 내의 항목입니다.자세한 내용은 사용자 목록, 선택 목록 및 전역 목록 정의를 참조하십시오.

예제

별도로 지정하지 않으면 각 예제에서는 다음과 같은 값이 적용됩니다.

팀 프로젝트 컬렉션 URL: http://AdventureWorksServer:8080/tfs/DefaultCollection
작업 항목 필드 이름: AdventureWorks.Field
기본 인코딩: UTF-8

필드 나열

witadmin listfields를 사용하여 사용 중인 필드 집합을 확인하고 작업 항목 형식을 추가할 필드를 선택합니다.또한 특정 필드에 대해 정의된 속성 할당을 나열하고 어떤 팀 프로젝트에서 어떤 필드를 사용할지를 결정할 수 있습니다.

작업 항목 필드의 속성 보기

다음 명령을 입력하여 Microsoft.VSTS.Common.Issue 같이 지정된 필드에 대해 정의된 특성을 나열합니다.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
이 예제와 같이 명명된 필드에 대한 필드 및 속성 정보가 나타납니다.
```
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
```
Use 매개변수는 필드가 사용되는 작업 항목 형식 및 각 프로젝트의 이름을 나타냅니다.필드 특성에 대한 자세한 내용은 Visual Studio ALM에 대한 작업 항목 필드 참조을 참조하십시오.

팀 프로젝트 컬렉션의 모든 필드 나열

다음 명령을 사용하여 팀 프로젝트 컬렉션에 대해 정의된 모든 필드를 나열합니다.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
명명된 프로젝트 컬렉션의 모든 필드에 대한 필드 정보가 나타납니다.자세한 내용은 Visual Studio ALM에 대한 작업 항목 필드 참조를 참조하십시오.

사용되지 않는 필드 나열

명령 프롬프트에 다음과 같이 입력하여 팀 프로젝트 컬렉션에서 더 이상 어떠한 작업 항목 형식도 사용하지 않는 필드를 나열합니다.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

이 예제와 같이 더 이상 사용되지 않는 각 필드에 대한 필드 및 특성 정보가 나타납니다.

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

필드 이름 바꾸기

팀에서 사용하는 명명 규칙에 맞게 작업 항목 필드의 이름을 변경할 수 있습니다.새 이름은 프로젝트 컬렉션에 있는 모든 팀 프로젝트의 변경된 필드를 참조하는 모든 작업 항목 형식에 적용됩니다.작업 항목 쿼리에 필터 조건을 정의하면 이름이 표시됩니다.작업 항목 폼에 나타나는 이름은 필드에 정의된 이름과 다를 수 있습니다.

작업 항목 필드 이름을 바꾸려면

다음 명령을 입력하여 Microsoft.VSTS.Common.Rank에 할당된 이름을 Important Rank로 바꿉니다.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

이름을 바꿀지 확인하는 메시지가 나타나면 y를 입력하고 Enter 키를 누릅니다.다음 메시지가 표시될 때까지 기다립니다.

Field renamed.

단일 프로젝트로 가져온 변경 내용을 확인하려면

팀 탐색기에서 새로 고침을 선택합니다.

필드 이름에 대해 방금 변경한 내용을 포함한 최신 업데이트가 서버에서 다운로드됩니다.새로 고침을 마칠 때까지 몇 초 동안 기다립니다.
새 쿼리를 선택하여 쿼리를 만듭니다.
쿼리 편집기에서 절을 추가하려면 여기를 클릭하십시오. 링크를 선택하여 행을 추가하고 비어 있는 필드 셀을 선택한 다음 셀에 Rank를 입력합니다.결과 목록 위에 다음과 같은 메시지가 나타납니다.이 메시지는 Rank를 찾을 수 없음을 의미합니다.

쿼리 결과를 보려면 쿼리를 실행하십시오. TF51005: 쿼리에서 존재하지 않는 필드를 참조합니다.<<Rank>>로 인해 오류가 발생합니다.
필드 셀에서 Rank 값을 삭제한 다음 셀에 Important Rank를 입력합니다.
연산자 셀에서 **<>**을 선택하고 값 셀에 1을 입력합니다.
쿼리 도구 모음에서 실행을 선택합니다.
결과에서 임의의 행의 바로 가기 메뉴를 열고 열 옵션을 선택합니다.사용 가능한열 목록을 아래로 스크롤합니다.Rank 필드가 더 이상 표시되지 않고 Important Rank 필드가 대신 추가된 것을 확인할 수 있습니다.
사용 가능한 열 상자에서 Important Rank를 선택한 다음 > 단추(선택한 열 추가)를 클릭합니다.확인을 선택합니다.

쿼리 작성기와 결과 목록 전체에서 Microsoft.VSTS.Common.Rank의 이름이 Rank에서 Important Rank로 바뀐 것을 확인할 수 있습니다.
쿼리를 닫습니다.쿼리를 저장할 것인지 묻는 메시지가 나타나면 아니요를 선택합니다.
새로운 작업 항목 "작업"을 만듭니다.새 작업 항목 링크를 선택한 다음 작업을 선택합니다.

이 작업 항목은 변경하여 가져온 작업 항목 형식에서 만들어집니다.
Rank 필드의 이름을 변경해도 상태 상자에서 이 필드의 레이블은 변경되지 않습니다.이는 작업 항목 폼의 필드 레이블 범위에는 부모 팀 프로젝트도 포함되며 이 레이블은 방금 지정한 서버 쪽 필드 이름에 대해 독립적이기 때문입니다.

[!참고]

작업 항목 폼의 필드 레이블을 변경하는 방법에 대한 자세한 내용은 필드의 레이블 변경을 참조하십시오.
새 작업을 닫고 작업 항목을 저장할 것인지 묻는 메시지가 나타나면 아니오를 선택합니다.

보고서를 필드 값으로 변경

다음 명령은 AdventureWorks.CreatedOn이라는 DateTime 필드의 보고 가능 형식을 dimension으로 보고하는 기능을 지정합니다.이 필드의 데이터는 웨어하우스와 Analysis Services 데이터베이스에 입력되어 보고서 필터링에 사용됩니다.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

다음 명령은 AdventureWorks.Field라는 Double 필드의 보고 가능 형식을 measure로 보고하는 기능을 지정합니다.모든 측정값은 합계로 집계됩니다.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

사용자 지정 사람 이름 필드의 동기화를 활성화합니다.

다음 명령은 AdventureWorksServer의 Collection1에 대해 정의된 AW.CustomerName 작업 항목 필드에 대해 동기화를 사용하도록 설정합니다.

변환할 필드의 데이터 형식 확인

MyCompany.CustomerName 같이 다음 명령을 입력하여 동기화하려는 필드에 할당된 데이터 형식을 확인합니다.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

동기화 사용

개인이 명명한 형식에 대한 동기화를 설정하려면 다음에 표시된 인수를 사용자 데이터로 대체하는 다음 명령을 입력합니다.
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
다음 확인 프롬프트가 표시됩니다.

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
0을 입력하여 필드 변경을 확인하거나 1을 입력하여 요청을 취소합니다.

변경 요청이 성공적으로 수행되면 다음과 같은 확인 메시지가 표시됩니다.

The field was updated.

변경 요청이 실패하게 되면 오류 메시지가 표시됩니다.이 오류는 일반적으로 시스템 참조 필드를 변경하거나 String이 아닌 데이터 형식의 필드를 변경하려고 할 때 발생합니다.이러한 작업은 지원되지 않습니다.

필드 삭제

필드를 삭제하기 전에 필드가 사용 중이 아닌지 확인하십시오.필드가 사용 중인 경우 이 필드를 사용하는 작업 항목 형식에서 해당 필드를 제거해야 팀 프로젝트 컬렉션에서 삭제할 수 있습니다.다음 명령은 Collection1에서 AdventureWorks.Field 필드를 삭제합니다.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

필드가 사용 중이 아닌지 확인

다음 명령을 입력하여 MyCompany.MyProcess.MyField 같은 작업 항목 필드의 참조 이름을 지정합니다.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField

이 예와 같이 필드에 대해 표시되는 정보의 Use 값이 "Not In Use"인지 확인합니다.

Field: MyCompany.MyProcess.MyField
Name: MyField
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Use 필드에 필드가 사용 중이라고 표시되는 경우 나열되는 각 팀 프로젝트의 각 작업 항목 형식에서 해당 필드를 삭제해야 합니다.예를 들어 Microsoft.VSTS.TCM.SystemInfo 필드에 Arroyo, Desert, Palm, Springs라는 네 프로젝트의 버그 및 코드 오류 작업 항목 형식에서 필드를 사용 중이라고 표시된다고 가정합니다.
```
Field: Microsoft.VSTS.TCM.SystemInfo
Name: System Info
Type: Html
Reportable As: None
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
Indexed: False
```
이 필드를 삭제하려면 정의된 각 팀 프로젝트에 대해 나열되는 각 작업 항목 형식에서 해당 필드를 삭제해야 합니다.필드를 제거하려면 필드 참조 이름을 포함하는 FIELD 및 Control 요소를 삭제하여 작업 항목 형식에 대한 정의를 수정합니다.작업 항목 형식 사용자 지정 및 관리[witadmin], FIELD(정의) 요소 및 Control XML 요소 참조를 참조하십시오.

팀 프로젝트 컬렉션에서 필드 삭제

다음 명령을 입력하여 MyCompany.MyProcess.MyField 필드를 삭제한 다음 Enter를 선택합니다.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
명령 프롬프트에 y를 입력하여 이 단계를 완료합니다.

참고 항목

개념

데이터 웨어하우스에서 발생하는 스키마 충돌 해결

보고를 지원하도록 작업 항목 필드 추가 및 수정

Visual Studio ALM에 대한 작업 항목 필드 참조

Visual Studio ALM에 대한 보고 가능 필드 참조

기타 리소스

witAdmin: 작업 항목 추적을 위한 개체 사용자 지정 및 관리

다음을 통해 공유