Partager via


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 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 un serveur de rapports à une collection de projets 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.

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

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. Pour plus d'informations, consultez Localisation des rapports après la mise à niveau vers 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.

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

É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, consultez Localisation des 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éé.

Retour au début

Voir aussi

Tâches

Vérifier les modifications apportées aux rapports

Concepts

Processus étape par étape de personnalisation

Utilisation de fichiers de modèles de processus

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

Autres ressources

Personnalisation des modèles de processus

Historique des modifications

Date

Historique

Motif

Avril 2011

Ajout de la structure de la syntaxe des éléments ReportingServices pris en charge par le plug-in Rapports.

Améliorations apportées aux informations.