작업 항목 필드 관리[witadmin]

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

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

  • PlainText 또는 HTML 필드의 데이터 형식

    중요

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

  • 작업 항목 쿼리에 표시되는 이름. 이 이름은 작업 항목 폼에 표시되는 이름과 다를 수 있습니다.

  • 보고서에 표시되는 필드 이름, 참조 보고서 이름 및 보고 형식을 포함하는 보고 특성

  • Active Directory와의 동기화 - 사람 이름 필드 동기화를 사용/사용 안 함으로 설정할 수 있습니다.

• deletefield: 지정된 필드를 삭제합니다.

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

• listfields: 모든 필드 또는 지정된 필드에 대한 특성을 나열합니다.

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

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

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

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

요구 사항

• 필드를 나열하려면 컬렉션에서 팀 프로젝트에 대한 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.

• 필드를 삭제하거나 필드의 이름을 바꾸거나 필드의 특성을 변경하려면 Team Foundation Administrators 보안 그룹 또는 Project Collection Administrators 보안 그룹의 멤버여야 합니다.

자세한 내용은 Team Foundation Server에 대한 사용 권한 참조을 참조하십시오.

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]

매개 변수

설명

인덱싱된 필드

쿼리 인덱스는 인덱싱이 사용하도록 설정된 필드를 기준으로 만들어집니다. 이 인덱스는 인덱싱된 필드를 포함하는 쿼리를 실행할 때 응답 시간을 단축합니다.

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

Active Directory와 사람 이름 동기화

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

사람 이름을 표시하는 모든 시스템 참조 필드는 syncnamechanges 특성이 true로 설정되어 있습니다. 이러한 필드로는 System.AuthorizedAs, System.AssignedTo, System.ChangedBy 및 System.CreatedBy가 있습니다. 동기화는 기본 프로세스 템플릿 중 하나에 정의된 각 사람 이름 필드에 대해 사용하도록 설정됩니다. 자세한 내용은 할당 및 워크플로 필드 참조을 참조하십시오.

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

syncnamechanges 특성을 String 필드에 할당하면 이 필드가 항상 유효한 사용자 이름을 수락합니다. 그러나 다음 조건 중 하나가 true인 경우 이 필드는 Team Foundation Server 또는 Active Directory에 저장된 그룹 이름을 허용하지 않습니다.

• VALIDUSER 규칙이 모든 작업 항목 형식에 걸쳐 지정된 경우

• VALIDUSER 규칙이 작업 항목 형식 하나에 대해 지정된 경우

• ALLOWEDVALUES 규칙이 작업 항목 형식 하나에 대해 지정되고, 해당 규칙에 그룹을 제외하는 필터 조건이 포함된 경우

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

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

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

• 작업 항목 폼에 표시되는 이름. Control XML 요소 참조을 참조하세요.

• 도움말 텍스트. 작업 항목 필드에 규칙 적용을 참조하세요.

• 선택 목록 또는 드롭다운 메뉴 내의 허용 값 또는 항목. 선택 목록 정의을 참조하세요.

예제

달리 지정하지 않은 경우 각 예제에 다음과 같은 값이 적용됩니다.

• 팀 프로젝트 컬렉션 URI: 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
  

필드 이름 바꾸기

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

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

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

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

2. 명령 프롬프트에서 y를 입력한 다음 Enter 키를 누릅니다. 다음 메시지가 표시될 때까지 기다립니다.

   Field renamed.

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

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

   방금 필드 이름에 대해 수행한 변경 내용을 포함한 최신 업데이트가 서버에서 다운로드됩니다. 새로 고침이 완료될 때까지 몇 초간 기다립니다.

2. 새 쿼리를 선택하여 쿼리를 만듭니다.

3. 쿼리 편집기에서 절을 추가하려면 여기를 클릭하십시오. 링크를 선택하여 행을 추가하고 빈 필드 셀을 선택한 다음 해당 셀에 Rank를 입력합니다. 결과 목록 위에 다음 메시지가 표시됩니다. 이 메시지는 Rank를 찾을 수 없음을 나타냅니다.

   쿼리 결과를 보려면 쿼리를 실행하십시오. TF51005: 쿼리에서 존재하지 않는 필드를 참조합니다. 오류의 원인은 <<Rank>>입니다.

4. 필드 셀에서 Rank 값을 삭제하고 해당 셀에 Important Rank를 입력합니다.

5. 연산자 셀에서 **<>**를 선택하고 값 셀에 1을 입력합니다.

6. 쿼리 도구 모음에서 실행을 선택합니다.

7. 결과에서 아무 행이나 해당 바로 가기 메뉴를 열고 열 옵션을 선택합니다. 사용 가능한 열 목록에서 아래로 스크롤합니다. Rank 필드는 더 이상 표시되지 않지만 Important Rank 필드는 표시됩니다.

8. 사용 가능한 열 상자에서 Important Rank를 선택한 다음 > 단추(선택한 열 추가)를 선택합니다. 확인을 선택합니다.

   Microsoft.VSTS.Common.Rank의 이름이 전체 쿼리 작성기 및 결과 목록에서 Rank에서 Important Rank로 바뀌었습니다.

9. 쿼리를 닫습니다. 쿼리를 저장할 것인지 묻는 메시지가 나타나면 아니요를 선택합니다.

10. 새 작업(Task) 작업 항목을 만듭니다. 새 작업 항목 링크를 선택한 다음 작업을 선택합니다.

    이 작업 항목은 변경해서 가져온 작업 항목 형식에서 만들어집니다.

11. 상태 상자에서 이름이 바뀐 필드 Rank의 레이블은 변경되지 않았습니다. 작업 항목 폼에 대한 필드 레이블이 부모 팀 프로젝트로 범위가 지정되고 방금 지정한 서버 전체 필드 이름과는 별개이기 때문입니다.

    참고

    작업 항목 폼에 대한 필드 레이블을 변경하는 방법에 대한 자세한 내용은 Control XML 요소 참조을 참조하세요.

12. 새 작업을 닫고 작업 항목을 저장할 것인지 묻는 메시지가 나타나면 아니요를 선택합니다.

필드의 값으로 보고서 변경

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

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

다음 명령은 Double 필드 AdventureWorks.Field의 형식을 measure로 보고하는 기능을 지정합니다. 모든 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
  

동기화 사용

1. 사람 이름이 있는 필드에 대해 동기화를 사용하도록 설정하려면 다음 명령을 입력하고 여기에 표시된 인수를 사용자의 데이터로 대체합니다.

   witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
   

2. 다음과 같은 확인 프롬프트가 표시됩니다.

   This will change properties for field {0} on the Team Foundation Server. Do you want to continue?

3. 필드를 변경할 것임을 확인하려면 0을 입력하고, 요청을 취소하려면 1을 입력합니다.

   변경 요청에 성공하면 다음과 같은 확인 메시지가 표시됩니다.

   The field was updated.

   변경 요청에 실패하면 오류 메시지가 표시됩니다. 가장 흔히 하는 실수는 시스템 참조 필드를 변경하려고 하거나 String이 아닌 데이터 형식의 필드를 변경하려고 하는 것입니다. 이러한 작업은 지원되지 않습니다.

필드 삭제

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

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

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

1. 다음 명령을 입력하고 작업 항목 필드(예: 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
   

2. Use 필드가 해당 필드가 사용 중임을 나타내는 경우 나열된 각 팀 프로젝트의 각 작업 항목 형식에서 해당 필드를 삭제해야 합니다. 예를 들어 Microsoft.VSTS.TCM.SystemInfo 필드가 해당 필드가 4개 프로젝트 Arroyo, Desert, Palm 및 Springs의 Bug 및 Code Defect 작업 항목 형식에서 사용되고 있음을 나타냅니다.

   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 요소를 삭제하여 작업 항목 형식에 대한 정의를 수정합니다. See 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin], FIELD(정의) 요소 참조 및 Control XML 요소 참조을 참조하십시오.

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

• 다음 명령을 입력하여 MyCompany.MyProcess.MyField 필드를 삭제한 다음 Enter 키를 선택합니다.

  witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
  

  명령 프롬프트에서 y를 입력하여 이 단계를 완료합니다.

Q & A

Q: TFS 업그레이드 후에 어떤 사용자 지정을 수행할 수 있으며 기능 구성 마법사를 계속 사용하여 팀 프로젝트를 업데이트할 수 있나요?

A: 사용자 지정 필드를 추가하고, 선택 목록을 사용자 지정하며, 필드에 규칙을 추가할 수 있습니다. 기능 구성 마법사에서는 팀 프로젝트를 업데이트하며, 그러면 최신 기능에 액세스할 수 있게 됩니다.

필드 특성은 변경하지 않는 것이 좋습니다. 수행해도 안전한 사용자 지정 작업과 수행하지 않아야 하는 작업에 대한 자세한 내용은 작업 추적 환경 사용자 지정: 사용자 지정 전에 유지 관리 및 업그레이드의 영향 파악을 참조하세요.

참고 항목

개념

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

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

Visual Studio ALM의 작업 항목 필드 참조

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

기타 리소스

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