Ajouter des rapports au modèle de processus

À l'aide du plug-in Rapports, vous pouvez spécifier la structure de dossiers et l'ensemble de rapports qui s'afficheront sous le nœud Rapports pour un nouveau projet d'équipe.

Vous spécifiez deux tâches principales à l'aide du plug-in Rapports.Tout d'abord, vous créez le site de création de rapports à l'aide de l'élément site.Ensuite, vous spécifiez la structure de dossiers et les rapports à télécharger sur le site à l'aide des éléments folder et report.Les rapports que vous téléchargez possèdent l'extension .rdl et sont conçus pour être utilisés avec Reporting Services.Pour obtenir une vue d'ensemble des rapports fournis par les modèles de processus Microsoft Solutions Framework (MSF), consultez Rapports (Agile) ou Rapports (CMMI).

Dans cette rubrique

• Nom et emplacement du plug-in Rapports

• Structure de la syntaxe du plug-in Rapports

• Création du site de création de rapports

• Définition des dossiers

• Spécification des rapports à télécharger

• Référence des éléments ReportingServices

Une fois un projet d'équipe créé à partir du modèle de processus, vous pouvez ajouter, supprimer, renommer et modifier la structure de dossiers des rapports.Pour plus d'informations, consultez Gérer des rapports.

Nom et emplacement du plug-in Rapports

Le tableau suivant récapitule les noms du fichier, du dossier et du plug-in pour les modèles de processus MSF.

[!REMARQUE]

Vous pouvez modifier les noms du fichier XML et du dossier, mais pas du plug-in.Visual Studio Team Foundation Server n'inclut aucun mécanisme de déploiement de plug-ins côté client, de stratégies ou d'autres modifications.Si vous ne voulez pas déployer ce genre de fonctionnalités, vous devez utiliser votre propre programme de distribution et d'installation.

Dans le fichier XML, vous spécifiez une ou plusieurs tâches et leurs dépendances.Pour obtenir un exemple de tâche qui spécifie un ensemble de rapports, consultez le fichier ReportsTasks.xml du modèle de processus MSF for Agile Software Development.

Retour au début

Structure de la syntaxe du plug-in Rapports

Le fichier du plug-in Rapports doit être conforme à la définition de schéma de ReportingServices, qui est spécifiée dans le fichier Rosetta.xsd, et être indiqué dans son propre fichier.Vous pouvez télécharger les fichiers de schéma de modèles de processus à partir de la page suivante du site Web Microsoft : Process Template and Work Item Schemas for Visual Studio Team Foundation.

La syntaxe suivante illustre la structure du plug-in Rapports.Pour obtenir une description de chaque élément, consultez Éléments enfants ReportingServices plus loin dans cette rubrique.

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

Retour au début

Création du site de création de rapports

Pour que les rapports s'exécutent correctement, vous devez créer un site de génération de rapports.Ce site dispose d'un lien sur la page d'accueil du portail du projet, qui s'intitule Rapports.Pour créer le site de création de rapports, utilisez l'élément site, comme illustré dans l'exemple suivant :

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

Retour au début

Définition des dossiers

Vous pouvez créer des dossiers sur le site de génération de rapports à l'aide de l'élément folder.Utilisez l'attribut de chemin d'accès pour spécifier le nom du chemin d'accès relatif du nouveau dossier.Le dossier s'affiche sur le site du projet et dans le dossier Reports de Team Explorer.

L'exemple suivant crée quatre dossiers de niveau supérieur et deux sous-dossiers sur le site de création de rapports.Les dossiers de niveau supérieur s'intitulent Bugs, Builds, Project Management et Tests.Les deux sous-dossiers se trouvent sous Project Management et s'intitulent Visual Studio et 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>

Retour au début

Spécification des rapports à télécharger

Les rapports sont définis par les fichiers .rdl.Pour ajouter des rapports au site de génération de rapports, copiez les fichiers .rdl dans un dossier sous le dossier Reports du modèle de processus.Ensuite, utilisez l'élément rapport pour décrire les propriétés et les sources de données nécessaires au rapport.

L'exemple suivant spécifie que le fichier Work.rdl restant sera téléchargé vers le dossier Project Management.Vous devez spécifier le paramètre ExplicitProject et les sources de données pour chaque rapport.Les sources de données présentées dans l'exemple suivant correspondent aux noms qui sont assignés automatiquement au cube Analysis Services et à la base de données relationnelle de l'entrepôt de données pour Team Foundation Server 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>

Retour au début

Référence des éléments ReportingServices

La syntaxe suivante illustre la structure de l'élément ReportingServices et de ses éléments enfants.Vous spécifiez ces éléments dans l'élément conteneur taskXml et uniquement pour le plug-in Rapports.

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

Le tableau suivant décrit les éléments que vous utilisez pour spécifier un rapport à télécharger vers un projet d'équipe et accessibles via 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>

Retour au début

Voir aussi

Concepts

Personnaliser des modèles de processus

Processus étape par étape de personnalisation

Utilisation de fichiers de modèles de processus

Personnaliser les domaines fonctionnels au sein d'un modèle de processus