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 .gif "Rapport"){kind=icon}
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 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 |
|
É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 |
|
É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 |
|
É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 |
Chacun des attributs est défini comme suit :
Vous devez définir au moins le paramètre suivant pour que votre rapport utilise automatiquement le projet qui contient votre rapport : |
Élément enfant obligatoire de parameters. Spécifie le nom d'un paramètre de rapport et la valeur à lui assigner. |
parameters |
|
Élément enfant obligatoire de report. Définit une collection d'éléments parameter pour un rapport. |
properties |
|
Élément enfant facultatif de report. |
property |
Chacun des attributs est défini comme suit :
|
Élément enfant obligatoire de properties. |
reference |
Chacun des attributs est défini comme suit :
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 |
Chacun des attributs est défini comme suit :
|
É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 |
|
É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 |
|
É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 |
|
É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. |