다음을 통해 공유


프로세스 템플릿에 보고서 추가

보고 플러그 인을 사용하면 새 팀 프로젝트의 Report 보고서 노드 아래에 표시될 보고서 집합과 폴더 구조를 지정할 수 있습니다.

중요

보고 플러그 인을 사용하려면 팀 프로젝트를 만들 팀 프로젝트 컬렉션이 SQL Server Analysis Services 및 SQL Server Reporting Services로 구성된 상태여야 합니다.자세한 내용은 팀 프로젝트에 보고서 추가을 참조하십시오.

보고 플러그 인을 사용하여 두 가지 기본 작업을 지정합니다. 첫째, site 요소를 사용하여 보고 사이트를 만듭니다. 둘째, folderreport 요소를 사용하여 사이트에 업로드할 보고서와 폴더 구조를 지정합니다. 업로드하는 보고서는 확장명이 .rdl이며 Reporting Services와 함께 사용하도록 디자인되었습니다. TFS 프로세스 템플릿에서 제공하는 보고서의 개요는 보고서(SQL Server Reporting Services)를 참조하십시오.

프로세스 템플릿에서 팀 프로젝트를 만든 후 보고서의 폴더 구조를 추가, 제거, 이름 바꾸기 및 변경할 수 있습니다. 자세한 내용은 보고서 보기, 업로드 및 구성(Reporting Services 보고서)을 참조하십시오.

보고 플러그 인 이름 및 위치

다음 표에서는 MSF 프로세스 템플릿용 파일, 폴더 및 플러그 인의 이름을 보여 줍니다.

파일 이름

ReportsTasks.xml

폴더 이름

Reports

플러그 인 이름

Microsoft.ProjectCreationWizard.Reporting

참고

XML 파일과 폴더의 이름은 변경할 수 있지만 플러그 인 이름은 변경할 수 없습니다.Visual Studio Team Foundation Server에서는 클라이언트 쪽 플러그 인, 정책 또는 다른 수정 사항에 대한 배포 메커니즘을 제공하지 않습니다.이러한 종류의 기능을 배포하려면 고유한 배포 및 설치 프로그램을 사용해야 합니다.

XML 파일에서 하나 이상의 작업 및 해당 종속성을 지정합니다. 보고서 집합을 지정하는 작업 예제를 보려면 MSF for Agile Software Development 프로세스 템플릿의 ReportsTasks.xml 파일을 참조하십시오.

보고 플러그 인 구문 구조

보고 플러그 인 파일은 Rosetta.xsd 파일에 정의된 ReportingServices에 대한 스키마 정의를 준수해야 하며, 해당 파일에 지정되어 있어야 합니다.

다음 구문은 보고 플러그 인의 구조를 보여 줍니다. 각 요소에 대한 자세한 내용은 이 항목의 뒷부분에 있는 ReportingServices 자식 요소를 참조하십시오.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
    <dependencies />
    <taskXml>
      <ReportingServices>
        <site> </site>
      </ReportingServices>
    </taskXml>
  </task>
  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded.">
    <dependencies>
      <dependency taskId="Site" />
    </dependencies>
    <taskXml>
      <ReportingServices>
        <folders> . . . </folders>
        <reports> . . . </reports>
      </ReportingServices>
    </taskXml>
  </task>
</tasks>

보고서 사이트 만들기

보고서를 제대로 실행하려면 보고 사이트를 만들어야 합니다. 프로젝트 포털 홈 페이지에는 보고 사이트에 대한 링크가 Report 보고서라는 이름으로 표시됩니다. 보고 사이트를 만들려면 다음 예제와 같이 site 요소를 사용합니다.

<taskXml>
   <ReportingServices>
        <site></site>
   </ReportingServices>
</taskXml>

폴더 정의

folder 요소를 사용하여 보고 사이트에 폴더를 만들 수 있습니다. 새 폴더의 상대 경로 이름을 지정하려면 path 특성을 사용합니다. 이 폴더는 프로젝트 사이트에서 팀 탐색기의 Reports 폴더 아래에 나타납니다.

다음 예제에서는 보고 사이트의 최상위 폴더 4개와 하위 폴더 2개를 만듭니다. 최상위 폴더에는 Bugs, Builds, Project Management 및 Tests라는 레이블이 지정됩니다. 두 개의 하위 폴더는 Project Management 아래에 있으며 Visual Studio 및 Visual Studio ALM이라는 레이블이 지정됩니다.

<taskXml>
   <ReportingServices>
      <folders>
         <folder path="Bugs" />
          <folder path="Builds" />
          <folder path="Project Management" />
          <folder path="Project Management/Visual Studio" />
          <folder path="Project Management/Visual Studio ALM" />
          <folder path="Tests" />
      </folders>
   </ReportingServices>
</taskXml>

업로드할 보고서 지정

보고서는 .rdl 파일로 정의됩니다. 보고 사이트에 보고서를 추가하려면 프로세스 템플릿에서 Reports 폴더 아래의 하위 폴더에 보고서 .rdl 파일을 복사합니다. 그런 다음 report 요소를 사용하여 보고서에 대해 필요한 속성 및 데이터 소스를 기술합니다.

다음 예제에서는 Remaining Work.rdl 파일을 Project Management 폴더로 업로드하도록 지정합니다. 각 보고서의 데이터 소스와 ExplicitProject 매개 변수를 지정해야 합니다. 다음 예제의 데이터 소스는 Analysis Services 큐브 및 데이터 웨어하우스 관계형 데이터베이스에 자동으로 할당되는 이름에 해당합니다.

참고

Reporting Services 데이터 소스의 이름은 Tfs2010ReportsDS 및 Tfs2010OlapReportsDS입니다.TFS 2012 또는 TFS 2013을 설치하거나 해당 버전으로 업그레이드한 경우에도 TFS 2010을 설치할 때 데이터 소스에 할당된 이름이 계속 사용됩니다.

<taskXml>
   <ReportingServices>
     <reports>
        <report name="Remaining Work" filename="Reports\Remaining Work.rdl" folder="Project Management" cacheExpiration="30">
       <parameters>
          <parameter name="ExplicitProject" value="" />
       </parameters>
       <datasources>
          <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" />
          <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" />
       </datasources>
    </report>
 . . . 
     </reports>
   </ReportingServices>
</taskXml>

ReportingServices 요소 참조

다음 구문은 ReportingServices 요소 및 해당 자식 요소의 구조를 보여 줍니다. 보고 플러그 인에 대해서만 taskXml 컨테이너 요소 내에서 이러한 요소를 지정합니다.

<ReportingServices>
   <folders>
      <folder />
 . . . 
   </folders>
   <reports>
      <report>
         <parameters>
            <parameter />
         </parameters>
         <datasources>
            <reference />
         </datasources>
      </report>
 . . . 
   </reports>
</ReportingServices>

다음 표에서는 SQL Server Reporting Services를 통해 액세스할 수 있고 팀 프로젝트로 업로드할 보고서를 지정하는 데 사용하는 요소에 대해 설명합니다.

요소

구문

설명

datasources

<datasources>
   <reference />
</datasources>

report의 필수적 자식 요소입니다.

각각 보고서에 사용되는 데이터 소스를 지정하는 reference 요소의 컬렉션을 포함합니다.

folder

<folder path="FolderName" />

folders의 필수적 자식 요소입니다.

팀 프로젝트에 대한 보고서 노드 아래에 만들려는 폴더 이름을 정의합니다.

folders

<folders>
   <folder path="FolderName" />
</folders>

ReportingServices의 선택적 자식 요소입니다.

각각 만들려는 폴더의 이름을 지정하는 folder 요소의 컬렉션을 포함합니다.

parameter

<parameter name="ParameterName" value="ParameterValue" />

여기서 각 특성에 대해 다음과 같은 정의가 사용됩니다.

  • name: 지정할 매개 변수의 이름입니다.

  • value: 매개 변수에 할당할 값입니다.

적어도 보고서를 포함하는 프로젝트가 보고서에서 자동으로 사용되도록 하려면 다음 매개 변수를 정의해야 합니다.

<parameter name="ExplicitProject" value="" />

parameters의 필수적 자식 요소입니다.

보고서 매개 변수의 이름과 이 매개 변수에 할당할 값을 지정합니다.

parameters

<parameters>
   <parameter />
</parameters>

report의 필수적 자식 요소입니다.

보고서에 대한 parameter 요소의 컬렉션을 정의합니다.

properties

< properties >
   < property />
</ properties >

report의 선택적 자식 요소입니다.

property

<property name="PropertyName" value="PropertyValue" />

여기서 각 특성에 대해 다음과 같은 정의가 사용됩니다.

properties의 필수적 자식 요소입니다.

reference

<reference name="RelationalDBName" dsname="OLAPDBName" />

여기서 각 특성에 대해 다음과 같은 정의가 사용됩니다.

  • name: Team Foundation Server의 데이터 소스 이름입니다. Team Foundation Server 2010의 경우 이 값은 Analysis Services 큐브를 나타내는 Tfs2010OlapReportDS 또는 관계형 데이터 웨어하우스를 나타내는 Tfs2010ReportsDS입니다.

  • dsname: 데이터베이스 리소스의 이름입니다. Analysis Services 큐브의 경우 TfsOlapReportDS를 지정하고 관계형 데이터 웨어하우스의 경우 TfsReportsDS를 지정합니다.

보고 데이터 소스의 이름에 대한 자세한 내용은 Team Foundation Server 2010으로 업그레이드한 후 보고서 찾기를 참조하십시오.

datasources의 필수적 자식 요소입니다.

데이터 웨어하우스 관계형 데이터베이스와 Analysis Services 큐브에 대해 Team Foundation Server에서 할당되는 이름을 지정합니다.

report

<report name="ReportName" filename="ReportFilePathName" 
folder="FolderName" cacheExpiration="CacheDuration">   <folders>
   <parameters>. . .</parameters>
   <datasources>. . .</datasources>
   <properties>. . .</properties >
</report>

여기서 각 특성에 대해 다음과 같은 정의가 사용됩니다.

  • name: 보고 사이트 및 팀 탐색기에서 표시할 보고서의 이름입니다.

  • filename: 가져올 .rdl 보고서 파일이 포함된 로컬 Reports 폴더 아래의 상대 경로입니다.

  • folder: 보고 사이트에서 보고서를 추가할 위치의 상대 경로 이름입니다.

  • cacheExpiration: 보고서가 캐시되는 기본 시간(분)입니다.

reports의 필수적 자식 요소입니다.

보고서의 이름, .rdl 정의를 포함하는 파일 및 보고서가 업로드되는 폴더를 지정합니다. Team Foundation Server

reports

<reports>
   <report />
   . . .
</reports>

ReportingServices의 필수적 자식 요소입니다.

각각 업로드할 보고서 파일의 이름을 지정하는 report 요소의 컬렉션을 포함합니다.

ReportingServices

<ReportingServices>
   <folders>. . .</folders>
   <reports>. . .</reports>
</ReportingServices>

보고 플러그 인에 대한 taskXml 요소의 필수적 자식 요소입니다.

SQL Server Reporting Services에 대한 보고서와 폴더를 정의하는 데 필요한 작업에 대해 설명합니다.

site

<site> </site>

보고 플러그 인의 필수적 요소입니다.

팀 프로젝트의 보고 사이트를 만들도록 지정합니다.

참고 항목

개념

프로세스 템플릿 사용자 지정

프로세스 템플릿 파일 개요