Aggiungere rapporti al modello di processo

Con il plug-in Generazione dei report è possibile specificare la struttura di cartelle e il set di report che verranno visualizzati nel nodo Report per un nuovo progetto team.

Con il plug-in Generazione dei report è possibile specificare due attività principali. La prima consiste nel creare cartelle nel sito di generazione dei report usando l'elemento site. In secondo luogo sarà necessario specificare la struttura di cartelle e i report da caricare nel sito usando gli elementi folder e report. I report caricati presentano estensioni rdl e sono progettati per l'utilizzo con Reporting Services. Per una panoramica sui report forniti dai modelli di processo TFS, vedere Rapporti (SQL Server Reporting Services).

Dopo aver creato un progetto team dal modello di processo, sarà possibile aggiungere, rimuovere, rinominare e modificare la struttura di cartelle per i report. Per altre informazioni, vedere Visualizzare, caricare e organizzare rapporti (rapporti Reporting Services).

Nome e percorso del plug-in Creazione report

Nella tabella seguente è incluso un riepilogo dei nomi del file, della cartella e del plug-in per i modelli di processo MSF.

Nel file XML specificare una o più attività e le relative dipendenze. Per un esempio di un'attività che consente di specificare un set di report, vedere il file ReportsTasks.xml nel modello di processo MSF for Agile Software Development.

Struttura della sintassi del plug-in Creazione report

Il file di plug-in Generazione dei report deve essere conforme alla definizione dello schema per ReportingServices, inclusa nel file Rosetta.xsd, e deve essere specificato nel proprio file.

Nella sintassi indicata di seguito viene illustrata la struttura del plug-in Generazione dei report. Per una descrizione di ogni elemento, vedere Elementi figlio di ReportingServices più avanti in questo argomento.

<?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>

Creazione del sito Report

Per l'esecuzione corretta dei report è necessario creare un sito per la loro generazione. Un collegamento al sito di generazione dei report sarà disponibile nella home page del portale del progetto e sarà contrassegnato Report. Per creare il sito di generazione dei report, usare l'elemento site, come illustrato nell'esempio indicato di seguito.

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

Definizione di cartelle

È possibile creare cartelle nel sito di generazione dei report usando l'elemento folder. Usare l'attributo path per specificare il percorso relativo della nuova cartella. La cartella viene visualizzata nel sito del progetto e nella cartella Report in Team Explorer.

Nell'esempio seguente vengono create quattro cartelle di livello superiore e due sottocartelle nel sito di generazione dei report. Le cartelle di livello superiore sono denominate Bug, Builds, Project Management e Tests. Le due sottocartelle si trovano in Project Management e sono etichettate Visual Studio e 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>

Determinazione dei report da caricare

I report vengono definiti da file RDL. Per aggiungere report al sito per la generazione dei report, copiare i file RDL del report in una cartella al di sotto della cartella Report nel modello di processo, quindi usare l'elemento report per descrivere le necessarie proprietà e origini dati per il report.

Nell'esempio indicato di seguito il file Remaining Work.rdl verrà caricato nella cartella Project Management. È necessario specificare il parametro ExplicitProject e le origini dati per ogni report. Le origini dati nell'esempio seguente corrispondono ai nomi che vengono automaticamente assegnati al cubo di Analysis Services e al database relazionale del data warehouse.

<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>

Riferimento di elementi ReportingServices

Nella sintassi indicata di seguito viene illustrata la struttura dell'elemento ReportingServices e dei relativi elementi figlio. Questi elementi vengono specificati all'interno dell'elemento contenitore taskXml e solo per il plug-in Generazione dei report.

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

Nella tabella seguente vengono descritti gli elementi usati per specificare un report da caricare in un progetto team e a cui è possibile accedere tramite SQL Server Reporting Services.

<datasources>
   <reference />
</datasources>

<folder path="FolderName" />

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

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

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

<parameters>
   <parameter />
</parameters>

< properties >
   < property />
</ properties >

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

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

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

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

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

<site> </site>

Vedere anche

Concetti

Personalizzare un modello di processo

Cenni preliminari sui file di modello di processo