작업 항목 필드 관리
다음 witadmin 명령을 사용하여 팀 프로젝트 컬렉션에 대해 정의된 작업 항목 형식 필드를 관리할 수 있습니다.
deletefield: 지정한 필드를 삭제합니다.
listfields: 모든 필드 또는 지정한 필드에 대한 특성을 나열합니다.
indexfield: 지정된 필드에 대한 인덱싱을 켜거나 끕니다. 필드에 대한 인덱싱을 사용하도록 설정하면 해당 필드를 지정하는 쿼리가 있는 작업 항목의 찾기 성능을 향상시킬 수 있습니다. 여러 작업 항목 쿼리에서 사용하는 사용자 지정 필드를 추가하는 경우 해당 필드에 대한 인덱싱을 사용할 수 있도록 설정할 수도 있습니다.
changefield: 친숙한 필드 이름, 데이터 웨어하우스 보고의 특성 또는 사람 이름이 들어 있는 필드를 동기화하는 기능 등 필드의 특성을 하나 이상 변경합니다. 동기화가 사용되면 Active Directory 또는 작업 그룹을 업데이트할 때 필드가 업데이트됩니다. 보고에 필드를 사용하는 방법에 대한 자세한 내용은 작업 항목 필드 사용을 참조하십시오.
중요
이전 버전에서 현재 버전으로 업그레이드할 경우 개인 이름이 포함된 모든 문자열 필드에 대한 모든 기본 제공 필드는 syncnamechanges 특성이 true로 설정되어 있습니다. 그러나 사람 이름을 저장하는 데 사용하고 동기화하려는 사용자 지정 필드에 특성을 수동으로 할당해야 합니다. 자세한 내용은 사용자 지정 개인 이름 필드를 업데이트하여 Active Directory 또는 작업 그룹과 동기화을 참조하십시오.
witadmin 명령줄 도구는 팀 탐색기를 실행하는 클라이언트 컴퓨터의 Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE에 있습니다.
필드에 대한 자세한 내용은 작업 항목 필드 정의을 참조하십시오.
참고
프로세스 편집기, Visual Studio용 강력한 도구를 사용하여 작업 항목 필드를 만들고 수정할 수 있습니다. 이 도구는 지원되지 않습니다. 자세한 내용은 Microsoft 웹 사이트의 Team Foundation Server Power Tools April 2010 페이지를 참조하십시오.
필요한 권한
작업 항목 형식 필드가 정의된 팀 프로젝트 컬렉션의 경우 다음 사용 권한이 설정되어 있어야 합니다.
필드를 나열하려면 Readers 그룹의 멤버이거나 이 노드의 작업 항목 보기 권한이 허용으로 설정되어 있어야 합니다.
필드를 삭제하거나 이름을 변경하거나 필드의 보고 특성을 변경하려면 Team Foundation Administrators 보안 그룹 또는 Project Administrators 보안 그룹의 멤버여야 합니다.
자세한 내용은 Team Foundation Server 권한 및 Team Foundation Server 기본 그룹, 권한 및 역할을 참조하십시오.
참고
관리자 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 수행하려면 관리자 명령 프롬프트 창을 열어야 합니다. 관리자 권한 명령 프롬프트를 열려면 시작을 클릭하고 명령 프롬프트를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. 자세한 내용은 Microsoft 웹 사이트, 사용자 액세스 컨트롤을 참조하십시오.
witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]
witadmin listfields /collection:CollectionURL /n:RefName [/unused]
witadmin indexfield /collection:CollectionURL /n:Name /index:on|off
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
매개 변수
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 |
보고를 위해 필드를 웨어하우스에서 사용하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.
자세한 내용은 작업 항목 필드 사용을 참조하십시오. |
/reportingformula:Formula |
measure로 필드가 보고될 때 사용할 집계 수식을 지정합니다. 지원되는 유일한 형식은 sum입니다. |
/unused |
팀 프로젝트 컬렉션에 정의된 모든 팀 프로젝트에 사용되지 않는 모든 필드를 나열합니다. |
/noprompt |
확인 프롬프트를 비활성화합니다. |
/? or help |
명령 프롬프트 창에 명령에 대한 도움말을 표시합니다. |
설명
syncnamechanges 특성을 문자열 필드에 지정할 경우 필드는 항상 올바른 사용자 이름을 받아들입니다. 그러나 다음 조건 중 하나가 true인 경우 필드는 Team Foundation Server 또는 Active Directory에 저장된 그룹 이름을 허용하지 않습니다.
VALIDUSER 규칙은 모든 작업 항목 형식에 지정됩니다.
VALIDUSER 규칙은 작업 항목 형식에 대해 지정됩니다
ALLOWEDVALUES 규칙은 작업 항목 형식에 대해 지정되고 해당 규칙은 그룹을 제외하는 필터 조건이 있습니다.
자세한 내용은 모든 FIELD XML 요소 참조을 참조하십시오.
인덱싱된 시스템 필드 요약은 MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용을 참조하십시오.
예제
별도로 지정하지 않으면 각 예제에서는 다음과 같은 값이 적용됩니다.
팀 프로젝트 컬렉션에 대한 URI: http://AdventureWorksServer:8080/AWTeam/Collection1
작업 항목 필드 이름: AdventureWorks.Field
기본 인코딩: UTF-8
목록 필드
다음 명령은 AdventureWorksServer 서버의 Collection1에 대해 정의된 각 필드에 대한 정보를 표시합니다.
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
다음 명령은 Collection1에서 사용하는 지정한 AdventureWorks.Field 필드에 대한 필드 정보를 표시합니다.
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field
다음 명령은 Collection1이 사용하지 않는 모든 필드를 표시합니다.
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused
필드 이름 바꾸기
다음 명령은 참조되는 AdventureWorks.Field 필드의 이름을 Collection1의 NewFieldName으로 변경합니다.
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName
필드 값으로 보고서 변경
다음 명령은 AdventureWorks.CreatedOn이라는 DateTime 필드의 보고 가능 형식을 dimension으로 보고하는 기능을 지정합니다. 이 필드의 데이터는 웨어하우스와 Analysis Services 데이터베이스에 입력되어 보고서 필터링에 사용됩니다.
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension
다음 명령은 AdventureWorks.Field라는 Double 필드의 보고 가능 형식을 measure로 보고하는 기능을 지정합니다. 모든 측정값은 합계로 집계됩니다.
witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure
사용자 지정 이름 필드의 동기화 사용
다음 명령은 AdventureWorksServer의 Collection1에 대해 정의된 AW.CustomerName 작업 항목 필드에 대해 동기화를 사용하도록 설정합니다.
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true
필드 삭제
다음 명령은 Collection1에서 AdventureWorks.Field 필드를 삭제합니다.
witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field
참고 항목
작업
개념
MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용