Plug-in de modèle de processus Rapports

Mise à jour : novembre 2007

Le plug-in de rapports définit les rapports initiaux d'un projet d'équipe. Le nom du plug-in est Microsoft.ProjectCreationWizard.Reporting. Le fichier XML Reports est nommé ReportsTasks.xml et se trouve dans le dossier Reports de la hiérarchie de dossiers des modèles de processus. Si nécessaire, vous pouvez modifier le fichier XML et le nom du dossier.

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

Remarque :
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 des plug-ins, des stratégies ou d'autres modifications sur Team Explorer, vous devez utiliser votre propre programme de distribution et d'installation.

Site de rapports

Pour que les rapports s'exécutent correctement, vous devez créer un site de génération de rapports. La page d'accueil du portail du projet Reports devra contenir un lien vers le site de génération de rapports. Pour créer le site de génération de rapports, utilisez l'élément site de l'exemple suivant :

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

Dossiers

Vous pouvez créer des dossiers sur le site de génération de rapports à l'aide de l'élément dossier. 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.

<folder path=""/>

L'exemple suivant permet de créer un dossier public sur le site de génération de rapports.

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

Rapports

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.

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

Le tableau suivant décrit les attributs de l'élément rapport.

Attribut	Description
name	Nom du rapport à afficher sur le site de génération de rapports et dans Team Explorer.
filename	Chemin d'accès relatif sous le dossier local Report où vous pouvez obtenir le fichier de rapport .rdl.
folder	Nom de chemin d'accès relatif de l'emplacement dans lequel ajouter le rapport sur le site de génération de rapports.
cacheExpiration	Définit le nombre de minutes par défaut pendant lesquelles le rapport est mis en cache.

Vous pouvez spécifier des valeurs pour les paramètres d'un rapport. Cette tâche est souvent utilisée pour associer le paramètre Project au projet d'équipe en cours. Sans référence au projet d'équipe actuel, la plupart des rapports ne s'exécutent pas correctement. Pour associer le paramètre Project au projet d'équipe actuel, attribuez-lui la valeur $$PROJECTNAME$$.

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

Le tableau suivant décrit les attributs de l'élément propriété.

Attribut	Description
name	Nom du paramètre du rapport à lier.
value	Valeur à laquelle lier le paramètre.

Vous devez associer chaque nom de source de données dans chaque rapport à une source de données Team Foundation Server dynamique. Utilisez l'élément référence pour spécifier une source de données.

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

Le tableau suivant décrit les attributs de l'élément référence.

Attribut	Description
name	Nom de la source de données dans le rapport.
dsname	Nom de la source de données Team Foundation Server. En général, cette valeur est TfsReportDS ou TfsOlapReportDS.

L'exemple suivant indique comment ajouter un rapport Work Items. Le paramètre Project sera lié au projet d'équipe actuel et le rapport à la source de données 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>

Voir aussi

Tâches

Comment : vérifier les modifications des rapports

Concepts

Plug-in de modèle de processus Windows SharePoint Services

Plug-in de modèle de processus du contrôle de version

Plug-in de modèle de processus Groupes et Autorisations

Autres ressources

Plug-in de modèle de processus Suivi des éléments de travail