Plug-in del modello di processo Reports

Aggiornamento: novembre 2007

Il plug-in Reports definisce i report iniziali di un progetto team. Il nome del plug-in è Microsoft.ProjectCreationWizard.Reporting. Il file XML relativo ai report è denominato ReportsTasks.xml ed è posizionato nella cartella Report nella gerarchia delle cartelle del modello di processo. Se necessario, è possibile modificare il nome del file XML e della cartella.

Specificare una o più attività e le relative dipendenze nel file XML. Per un esempio di attività in cui vengono specificati report semplici, vedere il file ReportsTasks.xml nel modello di processo MSF for Agile Software Development.

Nota:
Team Foundation Server non include un meccanismo per la distribuzione di plug-in, criteri o altre modifiche sul lato client. Se si desidera distribuire plug-in, criteri o altre modifiche a Team Explorer, è opportuno utilizzare il programma di distribuzione e installazione di cui si dispone.

Sito Report

Per l'esecuzione corretta dei report è necessario creare un sito per la loro generazione. Il sito per la generazione dei report disporrà di un collegamento con l'etichetta Report nella pagina iniziale del portale del progetto. Per creare il sito per la generazione dei report, utilizzare l'elemento site mostrato nell'esempio riportato di seguito.

<task 
   id="Site"
   plugin="Microsoft.ProjectCreationWizard.Reporting"
   completionMessage="Project Reporting site created.">
   <dependencies/>
   <taskXml>
      <ReportingServices>
         <site />
      </ReportingServices>
   </taskXml>
</task>

Cartelle

L'elemento folder consente di creare cartelle sul sito per la generazione dei report. Utilizzare 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.

<folder path=""/>

Nell'esempio riportato di seguito viene creata una cartella Public nel sito per la generazione dei report.

   <task id="Populate Reports"
          plugin="Microsoft.ProjectCreationWizard.Reporting"
          completionMessage="Project site created.">
        <dependencies>
            <dependency taskId="Site"/>
        </dependencies>
        <taskXml>
            <ReportingServices>
         <folders>
            <folder path="Public"/>
         </folders>
      </ReportingServices>
   </taskXml>
</task>

Report

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 utilizzare l'elemento report per descrivere le necessarie proprietà e origini dati per il report.

<report name=""
        filename=""
        folder=""
        cacheExpiration ="30">

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento report.

Attributo	Descrizione
name	Nome del report da visualizzare nel sito per la generazione dei report e in Team Explorer.
filename	Percorso relativo nella cartella locale Report da cui ottenere il file dei report RDL.
folder	Nome del percorso relativo in cui aggiungere il report nel sito per la generazione dei report.
cacheExpiration	Imposta il numero predefinito di minuti di memorizzazione del report nella cache.

In un report è possibile specificare valori relativi ai parametri. Questa funzionalità viene spesso impiegata per associare il parametro project al progetto team corrente. La maggior parte dei report non viene eseguita senza riferimenti al progetto team corrente. Per associare il parametro project al progetto team corrente, specificare il valore come $$PROJECTNAME$$.

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

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento property.

Attributo	Descrizione
name	Nome del parametro presente nel report da associare.
value	Valore a cui associare il parametro.

I nomi delle origini dati presenti in ciascun report devono essere associati a un'origine dati di un Team Foundation Server attivo. Utilizzare l'elemento reference per specificare un'origine dati.

<datasources>
   <reference name="" dsname=""/> 
</datasources>

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento reference.

Attributo	Descrizione
name	Nome dell'origine dati presente nel report.
dsname	Nome dell'origine dati di Team Foundation Server. In genere questo valore è TfsReportDS o TfsOlapReportDS.

Nell'esempio riportato di seguito viene illustrato come aggiungere un report Work Items. Il parametro project verrà associato al progetto team corrente e il report verrà associato all'origine dati TfsReportDS.

<report name="Work Items" 
        filename="Reports\Work Items.rdl" 
        folder="" 
        cacheExpiration ="30">
   <parameters>
      <parameter name="Project" value="$$PROJECTNAME$$"/>
   </parameters>
   <datasources>
      <reference name="/TfsOlapReportDS" dsname="TfsOlapReportDS"/> 
      <reference name="/TfsReportDS" dsname="TfsReportDS"/>
   </datasources>
</report>

Vedere anche

Attività

Procedura: verificare le modifiche ai report

Concetti

Plugin del modello di processo Windows SharePoint Services

Plugin del modello di processo del controllo delle versioni

Plug-in del modello di processo Gruppi e autorizzazioni

Altre risorse

Plug-in del modello di processo Gestione elementi di lavoro