다음을 통해 공유

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

  • 아티클

작업 항목 필드는 보고서에 사용되며 작업 항목 형식에 대한 데이터를 추적하고 쿼리에 대한 필터 조건을 정의하는 데에도 사용합니다. 시스템 필드 외에 보고서에 표시할 모든 필드를 해당 필드에서 추적할 작업 항목 형식에 대한 정의 파일에 정의해야 합니다. 시스템 필드는 모든 작업 항목 형식에 대해 자동으로 정의됩니다. 데이터 입력을 지원하려면 시스템 필드가 작업 항목 폼에 포함되어야 합니다.

보고를 지원하도록 필드를 추가하거나 기존 필드의 특성을 변경할 수 있습니다. 필드를 추가하거나 수정할 때 데이터가 SQL Server Analysis Services 큐브의 폴더로 논리적으로 그룹화되도록 체계적인 명명 규칙을 적용해야 합니다.

항목 내용

  • 최선의 구현 방법

  • 기존 필드 사용

  • 팀 프로젝트 컬렉션에 대해 정의되는 필드 나열

  • 보고 가능 필드 특성

  • 필드에 대한 보고 가능한 특성 변경

  • 보고 지원을 위해 필드 추가

  • 보고 가능 필드 특성에 대한 변경 내용 확인

  • 보고 참조 이름 할당을 위한 최선의 구현 방법

기본 프로세스 템플릿에 정의된 보고 가능 필드 목록은 Visual Studio ALM에 대한 보고 가능 필드 참조를 참조하십시오.

최선의 구현 방법

필드를 추가하거나 수정하기 전에 다음과 같은 최선의 구현 방법을 검토하십시오.

  • 팀 프로젝트를 포함하는 팀 프로젝트 컬렉션에 이미 정의되어 있는 필드를 사용할 수 있는지 여부를 확인합니다. 기존 필드를 사용하면 크로스 프로젝트 보고가 지원됩니다.

  • Visual Studio Team Foundation Server의 배포에서 다른 프로젝트 컬렉션에 이미 정의되어 있는 필드를 사용할 수 있는지 여부를 확인합니다. 기존 필드를 사용하면 크로스 프로젝트 보고가 지원됩니다.

  • Team Foundation Server의 전체 배포에서 각 프로젝트 컬렉션의 필드는 1,024개를 초과할 수 없으며 모든 프로젝트 컬렉션의 고유한 보고 가능 필드도 1,024개를 초과할 수 없습니다. 병합된 필드는 하나의 보고 가능 필드로 계산됩니다.

  • 프로세스 템플릿, 팀 프로젝트 또는 프로젝트 컬렉션에서 필드를 추가하고 수정하는 표준 절차 및 검토 프로세스를 설정합니다.

  • 보고할 필드의 레이블을 지정할 때 체계적인 명명 규칙을 사용하십시오. Team Foundation Server 배포에서 모든 팀 프로젝트 컬렉션에 대해 체계적인 방법으로 참조 이름을 할당하면 보다 일관되고 사용 가능한 웨어하우스 및 큐브 스키마가 보장될 뿐만 아니라 웨어하우스에서 스키마 충돌을 방지할 수 있습니다. 자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오.

    작업 항목 필드에 최대 네 개의 레이블 특성을 할당할 수 있습니다.

    참고

    Microsoft Solutions Framework에 대한 프로세스 템플릿에 정의된 필드에는 보고 이름 또는 보고 참조 이름이 할당되지 않습니다.기본적으로 참조 이름 및 이름 특성이 사용됩니다.

    • name. 작업 항목 쿼리의 드롭다운 메뉴에 표시되는 필드의 이름입니다. 이름은 팀 프로젝트에 정의되는 모든 필드에서 고유해야 합니다. 또한 이름은 작업 항목 폼의 필드에 할당되는 표시된 레이블과 다를 수 있습니다. 자세한 내용은 Control XML 요소 참조을 참조하십시오.

    • refname. 필드에 할당되어 팀 프로젝트 컬렉션에 정의되는 다른 모든 필드와 해당 필드를 구분하는 고유한 레이블입니다. refname에 할당되는 값은 변경할 수 없습니다.

      필드의 이름 및 참조 이름에 대한 요구 사항과 제한 사항은 작업 항목 추적 개체의 명명 규칙을 참조하십시오.

    • reportingname. 선택적 특성입니다. 보고서에서 필드를 식별하는 데 사용되는 이름입니다. 명시적으로 설정하지 않을 경우 name 특성에 할당된 값이 사용됩니다.

    • reportingrefname. 선택적 특성입니다. 보고 가능 필드에 할당되어 모든 팀 프로젝트 컬렉션에 정의되는 다른 모든 보고 가능 필드와 해당 필드를 구분하는 고유한 레이블입니다. 명시적으로 설정하지 않을 경우 refname 특성에 할당된 값이 사용됩니다. 권장 명명 규칙은 이 항목 뒷부분에 나오는 보고 참조 이름 할당을 위한 최선의 구현 방법을 참조하십시오.

      참고

      보고 참조 이름은 피벗 테이블 보고서 또는 Analysis Services 큐브에서만 표시됩니다.

기존 필드 사용

추적하여 보고하려는 정보와 필드가 일치하는 경우 이미 정의된 필드를 사용해야 합니다. 기존 필드를 사용하려면 다음 단계를 수행하십시오.

  • 사용할 필드를 식별합니다. witadmin listfields 명령을 사용하여 모든 프로젝트 컬렉션에 대해 정의된 필드와 필드의 특성을 식별합니다. 자세한 내용은 이 항목의 뒷부분에 나오는 팀 프로젝트 컬렉션에 대해 정의된 필드 나열을 참조하십시오.

  • 필드가 보고 가능하고 보고 가능한 특성이 보고 요구 사항을 충족하는지 여부를 확인합니다.

  • 보고 가능하지 않은 경우 witadmin changefield를 사용하여 필드가 사용되는 프로젝트 컬렉션에 대한 보고 가능한 특성을 변경합니다. 자세한 내용은 이 항목의 뒷부분에 나오는 필드에 대한 보고 가능한 특성 변경을 참조하십시오.

  • 필드가 정의되지 않은 프로젝트 컬렉션의 경우 데이터를 추적하는 데 사용할 작업 항목 형식에 대한 XML 정의 파일에 필드를 추가합니다. 자세한 내용은 이 항목의 뒷부분에 나오는 보고 지원을 위해 필드 추가를 참조하십시오.

팀 프로젝트 컬렉션에 대해 정의되는 필드 나열

witadmin listfields 명령을 사용하여 필드와 필드의 특성을 나열할 수 있습니다. 프로젝트 컬렉션에 정의된 지정된 필드 또는 모든 필드를 나열할 수 있습니다. witadmin listfields 명령의 구문은 다음과 같습니다.

witadmin listfields /collection:CollectionURL /n:RefName

자세한 내용은 작업 항목 필드 관리[witadmin]을 참조하십시오.

보고 가능 필드 특성

보고 가능 필드의 reportable 특성 값은 Detail, Dimension 또는 Measure입니다. 다음 특성에 따라 작업 항목 필드가 데이터 웨어하우스 데이터베이스로 내보내지고 처리되는 방법이 결정됩니다.

  • reportingtype. 보고서에 필드를 포함하려면 reportable 특성에 다음 값 중 하나를 할당해야 합니다.

    • 필드를 관계형 웨어하우스 데이터베이스에 내보내고 큐브에는 내보내지 않으려면 Detail을 할당합니다. 다음 예와 같이 Detail 형식은 Integer, Double, String 또는 DateTime 필드에만 사용합니다.

      <FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

    • 필드를 관계형 웨어하우스 데이터베이스와 큐브 모두에 내보내려면 Dimension을 할당합니다. 다음 예와 같이 Dimension은 Integer, String 또는 DateTime 필드에만 사용합니다. 이 값은 보고서를 필터링하는 데 사용되는 필드(예: 유효한 값 목록이 있는 필드)를 포함하는 데 유용합니다.

      <FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

    • 큐브에서 미리 계산된 값을 처리하도록 지원하려면 Measure를 할당합니다. Measure 형식은 Integer 및 Double 필드에만 사용합니다.

      다음 예와 같이 Measure를 reportingtype으로 할당할 경우 sum을 formula로 할당해야 합니다.

      <FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

  • reportingrefname. 보고 가능으로 표시되는 필드에 다른 참조 이름을 할당할 수 있습니다. 값을 지정하지 않은 경우 refname 특성에 할당된 값이 사용됩니다.

    이 특성을 사용하여 보고서에 포함되는 필드를 병합하거나 분기할 수 있습니다. 서로 다른 프로젝트 컬렉션에 정의되어 있고 고유한 참조 이름을 가진 두 필드를 병합하려면 두 필드에 동일한 reportingrefname을 할당해야 합니다. 참조 이름이 같지만 서로 다른 프로젝트 컬렉션에 정의되어 있는 두 필드를 분기하려면 각 필드에 서로 다른 reportingrefname을 할당합니다.

    가능하면 두 필드를 병합하여 웨어하우스의 필드 수를 최소화하고 보고 가능 필드 수를 최대 제한인 1024개 미만으로 유지해야 합니다. 병합된 필드를 사용하여 그룹 간 보고서를 생성할 수 있습니다.

  • reportingname. 보고서에서 데이터를 표시하는 데 사용하는 필드에 다른 레이블을 할당할 수 있습니다. 값을 지정하지 않은 경우 name 특성에 대해 할당된 이름이 사용됩니다. reportingname에 할당되는 값이 큐브에 표시됩니다. reportingrefname에 할당되는 값은 표시되지 않습니다.

    중요

    보고 필드가 피벗 테이블 보고서에 함께 분류되도록 최선의 구현 방안을 사용하여 보고 필드 레이블을 지정해야 합니다.자세한 내용은 보고 참조 이름 할당을 위한 최선의 구현 방법을 참조하십시오.

작업 항목 필드에 대한 보고 가능한 특성 변경

프로젝트 컬렉션에 대해 정의되는 필드의 특성 할당을 변경하여 기존 필드를 보고 가능 필드로 만들 수 있습니다. 기존 필드는 하나 이상의 작업 항목 형식 정의에 정의됩니다. 또한 데이터 웨어하우스에서 필드가 처리되는 방법을 결정하는 모든 특성을 변경할 수 있습니다.

다음 단계를 순서대로 수행하여 필드의 특성 할당을 변경할 수 있습니다.

  1. witadmin changefield 명령을 사용하여 필드에 대한 특성 할당을 변경할 수 있습니다. 팀 프로젝트 컬렉션에 대해 이 명령을 시험합니다. 다음 구문을 사용합니다.

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

    기존 필드를 보고 가능 필드로 만들려면 reportingtype을 변경합니다. 예를 들어 AW.Common.TeamPriority 필드를 보고서를 필터링하는 데 사용하려면 Dimension 값을 할당합니다.

    witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension

    자세한 내용은 작업 항목 필드 관리[witadmin]을 참조하십시오.

  2. (선택 사항) 프로젝트 컬렉션이 두 개 이상 있는 경우 해당 컬렉션에 정의되는 작업 항목 필드를 비슷하게 변경할 수 있습니다. 데이터를 데이터 웨어하우스 데이터베이스에 보내서 처리할 때 스키마 충돌을 방지하려면 모든 컬렉션에서 이러한 특성에 동일한 값을 할당해야 합니다.

    • 필드 형식(기존 필드에 대해 이 필드의 값을 변경할 수 없음)

    • 보고 형식

    • 보고 이름

    자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오.

  3. 보고에 사용할 작업 항목 필드에 대한 변경 작업을 마친 후 데이터 웨어하우스 데이터베이스를 처리해야 합니다. WarehouseControlWebService를 통해 ProcessWarehouse 및 ProcessAnalysis 웹 서비스를 사용할 수 있습니다.

    이 단계를 수행하면 필드 특성을 변경할 때 보고서 사용자에게 오류가 표시되지 않습니다.

    자세한 내용은 작업 항목 필드 관리[witadmin]을 참조하십시오.

보고 지원을 위해 필드 추가

작업 항목 형식 정의에 필드를 추가할 수 있습니다. 필드를 추가할 경우 필드에서 보고를 지원할 모든 작업 항목 형식에 동일한 필드 요소 정의를 추가해야 합니다. 필드에서 크로스 프로젝트 보고를 지원하게 하려면 보고할 모든 팀 프로젝트의 모든 작업 항목 형식에 필드를 추가해야 합니다.

자세한 내용은 작업 항목 필드 정의 및 수정을 참조하십시오.

보고 가능 필드 특성에 대한 변경 내용 확인

요청 시 데이터 웨어하우스를 처리한 다음 보고서가 업데이트되는지 확인하여 보고 가능 필드 특성에 대한 변경 내용을 확인할 수 있습니다. 웨어하우스 어댑터 작업이 실행될 때까지 기다릴 수도 있습니다. 기본적으로 몇 분마다 관계형 데이터베이스가 처리됩니다. 하지만 큐브는 기본적으로 두 시간마다 처리됩니다.

참고

WarehouseControlWebService에 대한 자세한 내용은 Team Foundation Server에 대한 데이터 웨어하우스 및 분석 서비스 큐브 수동 처리를 참조하십시오.

  1. ProcessWarehouse WarehouseControlWebService를 사용하여 요청 시 관계형 데이터 웨어하우스를 처리합니다.

  2. ProcessAnalysisDatabase WarehouseControlWebService를 사용하여 요청 시 큐브를 처리합니다.

  3. 보고서가 업데이트되는지 확인합니다. 대시보드 또는 보고서 관리자를 통해 보고서를 봅니다. 자세한 내용은 대시보드 또는 보고서(SQL Server Reporting Services)를 참조하십시오.

보고 참조 이름 할당을 위한 최선의 구현 방법

피벗 테이블 보고서 및 큐브에서 필드를 쉽게 찾을 수 있도록 보고 참조 이름에 대해 레이블을 할당할 수 있습니다. 이를 위해 필드가 논리적인 순서로 그룹화되도록 체계적인 명명 규칙을 적용할 수 있습니다. 또한 필드가 유용한 방법으로 그룹화되지 않을 경우 필드의 보고 참조 이름을 변경할 수 있습니다.

모든 프로젝트 컬렉션에 정의되는 모든 팀 프로젝트의 모든 보고 가능 데이터는 단일 관계형 데이터 웨어하우스에 기록되므로 체계적인 명명 규칙을 적용하는 것이 중요합니다. 그러면 해당 웨어하우스의 데이터가 처리되어 큐브에 기록됩니다. 작업 항목 필드는 각 프로젝트 컬렉션에 대해 개별적으로 관리되기 때문에 서로 다른 레이블이 적용되어 보고서 작성을 지원하도록 필드 집합이 올바르게 구성되지 않을 수 있습니다.

보고 가능한 차원 형식을 가진 작업 항목 필드는 큐브의 차원 특성에 해당합니다. 차원 특성은 프로세스 템플릿 또는 작업 항목 형식 정의에서 할당된 보고 참조 이름을 기반으로 하는 폴더로 구성됩니다. 다음과 같이 매핑이 실행됩니다.

  • "시스템" 접두사가 있는 필드는 내장 형식이고 작업 항목 차원 바로 아래에 "작업 항목"이 추가된 상태로 나열됩니다.

  • 다른 필드는 이름이 참조 이름의 접두사에 해당하는 폴더 아래에 표시됩니다. 예를 들어 "Microsoft.VSTS.Common" 접두사가 있는 필드는 "Microsoft VSTS Common"이라는 폴더 아래에 나열됩니다.

다음 그림과 같이 공통 접두사를 공유하는 필드의 각 접두사 그룹에 대해 폴더가 추가됩니다.

OLAP 데이터 큐브의 폴더 구조

다음 표에서는 참조 이름이 "System"으로 시작하고 피벗 테이블 보고서에 "Work Item" 접두사가 붙은 상태로 나열되는 필드를 보여 줍니다. 이러한 필드는 작업 항목 차원 바로 아래에 배치됩니다. 다른 모든 필드는 이름이 참조 이름의 접두사에 해당하는 폴더 아래에 배치됩니다.

참고

SQL Server Analysis Services Enterprise 버전을 사용하지 않는 배포에서는 해당 버전에 제공되는 변환 기능에 액세스할 수 없습니다.이러한 배포에서 필드는 큐브의 전체 참조 이름으로 식별되고 '.'가 '_'로 대체됩니다(예: "System_Id" 및 "System_Title").

피벗 테이블 보고서 및 큐브에서의 이름

참조 이름

데이터 형식

Work Item.Area Path

System.AreaPath

TreeType

Work Item.Assigned To

System.AssignedTo

String

Work Item.Changed By

System.ChangedBy

String

Work Item.Changed Date

System.ChangedDate

DateTime

Work Item.Created By

System.Created By

String

Work Item.Created Date

System.CreatedDate

DateTime

Work Item.ID

System.Id

정수

Work Item.Iteration Path

System.IterationPath

TreeType

Work Item.Previous State

System.PreviousState

String

Work Item.Reason

System.Reason

String

Work Item.Rev

System.Rev

정수

Work Item.State

System.State

String

Work Item.Title

System.Title

String

Work Item.Work Item Type

System.WorkItemType

String

다음 표에서는 작업 항목 차원 아래에 있는 "Microsoft.VSTS.Common" 폴더의 피벗 테이블 보고서에 표시되는 필드를 나열합니다. 이러한 필드의 참조 이름은 "Microsoft.VSTS.Common"으로 시작합니다.

피벗 테이블 보고서 및 큐브에서의 이름

참조 이름

데이터 형식

Work Item.Activated By

Microsoft.VSTS.Common.ActivatedBy

String

Work Item.Activated Date

Microsoft.VSTS.Common.ActivatedDate

DateTime

Work Item.Closed By

Microsoft.VSTS.Common.ClosedBy

String

Work Item.Closed Date

Microsoft.VSTS.Common.ClosedDate

DateTime

Work Item.Created By

Microsoft.VSTS.Common.CreatedBy

String

Work Item.Created Date

Microsoft.VSTS.Common.CreatedDate

DateTime

Work Item.Resolved By

Microsoft.VSTS.Common.ResolvedBy

String

Work Item.Resolved Date

Microsoft.VSTS.Common.ResolvedDate

DateTime

Work Item.Resolved Reason

Microsoft.VSTS.Common.ResolvedReason

String

Work Item.Priority

Microsoft.VSTS.Common.Priority

정수

Work Item.Severity

Microsoft.VSTS.Common.Severity

String

Work Item.Stack Rank

Microsoft.VSTS.Common.StackRank

Double

참고 항목

참조

작업 항목 필드 관리[witadmin]

개념

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

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

Visual Studio ALM 보고서 만들기, 사용자 지정 및 관리

기타 리소스

쿼리, 보고서 및 워크플로를 지원하도록 필드 수정 또는 추가