Ajouter des rapports au modèle de processus

Article
06/09/2015

À 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 Rapport Rapports pour un nouveau projet d'équipe.

Important

Le plug-in Rapports requiert que la collection de projets d'équipe où vous allez créer un projet d'équipe ait été configurée avec SQL Server Analysis Services et SQL Server Reporting Services.Pour plus d'informations, consultez Ajouter des rapports à un 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 TSF, voir Rapports (Agile).

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 Afficher, télécharger et organiser des rapports (rapports Reporting Services).

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.

Nom du fichier :	ReportsTasks.xml
Nom du dossier :	Rapports
Nom du plug-in :	Microsoft.ProjectCreationWizard.Reporting

Notes

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, voir le fichier ReportsTasks.xml du modèle de processus MSF for Agile Software Development.

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.

La syntaxe suivante illustre la structure du plug-in Rapports. Pour obtenir une description de chaque élément, voir É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>

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

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>

Spécifier les 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.

Notes

Les noms des sources de données Reporting Services sont Tfs2010ReportsDS et Tfs2010OlapReportsDS.Même si vous avez installé ou effectué une mise à niveau vers TFS 2012 ou TFS 2013, ces noms, assignés aux sources de données pour une installation TFS 2010, continuent à être utilisés.

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

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.

Élément	Syntaxe	Description
datasources	`<datasources> <reference /> </datasources>`	Élément enfant obligatoire de report. Contient une collection d'éléments reference qui spécifient chacun une source de données utilisée par le rapport.
folder	`<folder path="FolderName" />`	Élément enfant obligatoire de folders. Définit le nom d'un dossier à créer sous le nœud Rapports pour un projet d'équipe.
folders	`<folders> <folder path="FolderName" /> </folders>`	Élément enfant facultatif de ReportingServices. Contient une collection d'éléments folder qui spécifient chacun le nom d'un dossier à créer.
parameter	`<parameter name="ParameterName" value="ParameterValue" />` Chacun des attributs est défini comme suit : name : nom d'un paramètre que vous souhaitez spécifier. value : valeur à assigner au paramètre. Vous devez définir au moins le paramètre suivant pour que votre rapport utilise automatiquement le projet qui contient votre rapport : `<parameter name="ExplicitProject" value="" />`	Élément enfant obligatoire de parameters. Spécifie le nom d'un paramètre de rapport et la valeur à lui assigner.
parameters	`<parameters> <parameter /> </parameters>`	Élément enfant obligatoire de report. Définit une collection d'éléments parameter pour un rapport.
properties	`< properties > < property /> </ properties >`	Élément enfant facultatif de report.
property	`<property name="PropertyName" value="PropertyValue" />` Chacun des attributs est défini comme suit : name : nom d'une propriété que vous souhaitez spécifier. Pour plus d'informations, consultez Afficher, organiser et configurer des rapports à l'aide du Gestionnaire de rapports. value : valeur à assigner à la propriété.	Élément enfant obligatoire de properties.
reference	`<reference name="RelationalDBName" dsname="OLAPDBName" />` Chacun des attributs est défini comme suit : name : nom de la source de données dans Team Foundation Server. Pour Team Foundation Server 2010, cette valeur est soit Tfs2010OlapReportDS pour le cube Analysis Services, soit Tfs2010ReportsDS pour l'entrepôt de données relationnelles. dsname : nom de la ressource de base de données. Spécifiez TfsOlapReportDS pour le cube Analysis Services et TfsReportsDS pour l'entrepôt de données relationnelles. Pour plus d'informations sur les noms des sources de données de création de rapports, voir Accéder aux rapports après la mise à niveau vers Team Foundation Server 2010.	Élément enfant obligatoire de datasources. Spécifie les noms qui sont assignés dans Team Foundation Server pour la base de données relationnelle de l'entrepôt de données et le cube Analysis Services.
report	`<report name="ReportName" filename="ReportFilePathName" folder="FolderName" cacheExpiration="CacheDuration"> <folders> <parameters>. . .</parameters> <datasources>. . .</datasources> <properties>. . .</properties > </report>` Chacun des attributs est défini comme suit : name : nom du rapport à afficher sur le site de création de rapports et dans Team Explorer. filename : chemin d'accès relatif sous le dossier local Reports où vous pouvez obtenir le fichier de rapport .rdl. folder : nom de chemin d'accès relatif de l'emplacement où ajouter le rapport sur le site de création de rapports. cacheExpiration : nombre de minutes par défaut pendant lesquelles le rapport est mis en cache.	Élément enfant obligatoire de reports. Spécifie le rapport, le fichier qui contient la définition .rdl et le dossier dans lequel le rapport est téléchargé. Team Foundation Server
reports	`<reports> <report /> . . . </reports>`	Élément enfant obligatoire de ReportingServices. Contient une collection d'éléments report qui spécifient chacun le nom d'un fichier de rapport à télécharger.
ReportingServices	`<ReportingServices> <folders>. . .</folders> <reports>. . .</reports> </ReportingServices>`	Élément enfant obligatoire de l'élément taskXml pour le plug-in Rapports. Décrit les tâches qui sont requises pour définir les rapports et les dossiers pour SQL Server Reporting Services.
site	`<site> </site>`	Élément requis pour le plug-in Rapports. Spécifie qu'un site de création de rapports pour le projet d'équipe sera créé.

Voir aussi

Concepts

Personnaliser un modèle de processus

Vue d'ensemble des fichiers de modèle de processus

Partager via