Configuration de sous-rapports et de rapports d'extraction (Concepteur de rapports Visual Studio)

Vous pouvez utiliser des sous-rapports et des rapports d'extraction pour lier ensemble des rapports associés.

• Un sous-rapport est un contrôle incorporé à l'intérieur du corps d'un rapport parent. D'un point de vue conceptuel, un sous-rapport est similaire à un cadre dans une page Web qui reçoit le contenu d'une autre page Web. Le sous-rapport est rendu à l'intérieur du rapport parent qui le contient. Les deux rapports sont traités et affichés simultanément.

• Un rapport d'extraction s'ouvre en tant que résultat d'une action d'extraction définie sur un élément de rapport. Cette action ouvre généralement un rapport associé ou le même rapport avec des paramètres différents dans le même espace que le rapport parent. En général, le rapport d'extraction est associé au rapport parent par l'intermédiaire de données. Un exemple courant de rapport d'extraction est un rapport de ventes mensuelles contenant des liens vers des commandes individuelles de ce mois. Lorsque vous cliquez sur un lien d'extraction, le rapport parent est remplacé par un autre rapport fournissant les détails concernés.

Les rapports d'extraction et les sous-rapports prennent en charge de la notion de rapport parent et de rapport enfant. Pour relier les rapports, vous devez créer des paramètres de rapport pouvant être utilisés pour passer des données établissant la relation. Pour lier les rapports au moment de l'exécution, vous devez écrire un code prenant en charge la connexion. Lors du déploiement de rapports associés, assurez-vous que les fichiers de définition de rapport client (.rdlc) sont stockés ensemble dans le même dossier sur le système de fichiers.

Les événements suivants incluent un exemple de code qui illustre comment implémenter des sous-rapports et des actions d'extraction pour le contrôle ReportViewer :

• Microsoft.Reporting.WebForms.ReportViewer.Drillthrough

• Microsoft.Reporting.WebForms.LocalReport.SubreportProcessing

• Microsoft.Reporting.WinForms.ReportViewer.Drillthrough

• Microsoft.Reporting.WinForms.LocalReport.SubreportProcessing

Pour des informations sur l'inclusion d'une interactivité d'extraction à votre rapport, consultez Procédure : masquer ou définir Activer/désactiver la visibilité sur un élément de rapport (Concepteur de rapports Visual Studio).

Ajout de sous-rapports

Un sous-rapport et son rapport parent peuvent être associés au moyen de paramètres partagés. Vous devez ajouter des paramètres à chaque rapport. Les paramètres doivent être configurés avant que vous ajoutiez un sous-rapport au rapport parent. Lorsque vous ajoutez le sous-rapport, vous configurez le rapport parent pour passer des paramètres au sous-rapport.

Pour ajouter un sous-rapport

1. Ouvrez le fichier de définition de rapport client (.rdlc) en mode de conception graphique.

2. Dans la boîte à outils, cliquez sur Sous-rapport.

3. Sur la surface de conception, faites glisser une zone de la taille souhaitée pour le sous-rapport. Une autre solution consiste à cliquer sur la surface de conception pour créer un sous-rapport de taille fixe.

   Remarque
   Si le sous-rapport existe dans le projet, vous pouvez faire glisser le rapport depuis l'Explorateur de solutions afin de créer un sous-rapport.

4. Cliquez avec le bouton droit sur le sous-rapport, puis sur Propriétés.

5. Dans Sous-rapport, sélectionnez le rapport devant apparaître dans la zone du sous-rapport.

6. Sous l'onglet Paramètres, procédez comme suit :

   • Dans Nom du paramètre, tapez le nom d'un paramètre dans le sous-rapport. Ce nom doit correspondre à un paramètre de rapport présent dans le rapport désigné par la propriété ReportName.

   • Dans Valeur du paramètre, tapez une valeur à passer au sous-rapport. Cette valeur peut être du texte statique ou une expression pointant vers un champ ou un autre objet situé dans le rapport parent.

7. Répétez l'étape 2 pour ajouter des paramètres supplémentaires à passer au sous-rapport.

Remarque
Tous les paramètres qui sont requis par le sous-rapport doivent figurer dans la liste Paramètres. S'il manque un paramètre obligatoire, le sous-rapport ne s'affiche pas correctement à l'intérieur du rapport parent.

Pour fournir des données pour des sous-rapports, votre application doit traiter l'événement SubreportProcessing de l'objet LocalReport. L'un des arguments passés à la méthode de gestionnaire d'événements SubreportProcessing est SubreportProcessingEventArgs. Dans le gestionnaire d'événements, l'application peut examiner les valeurs des paramètres passés aux sous-rapport à l'aide de la propriété Parameters de SubreportProcessingEventArgs. L'application doit ensuite fournir les données du sous-rapport en utilisant la propriété DataSources de SubreportProcessingEventArgs.

Configuration de rapports d'extraction

Vous pouvez configurer des rapports d'extraction en définissant des actions d'extraction assurant une navigation d'un rapport parent à un rapport secondaire contenant des données pertinentes.

Un rapport d'extraction comprend généralement des paramètres qui lui sont passés par le rapport parent. Dans l'exemple de rapport de synthèse sur les ventes, le rapport d'extraction comporte un paramètre qui prend pour valeur la commande. Le rapport de synthèse comprend un lien vers un rapport d'extraction pour chaque numéro de commande. Lorsque l'utilisateur clique sur l'un de ces liens, le rapport détaillé cible s'affiche, et le numéro de commande lui est passé.

Tout rapport stocké sur le serveur de rapports peut être un rapport d'extraction. Vous pouvez ajouter des liens d'extraction aux zones de texte et aux images uniquement.

Pour ajouter un lien de rapport d'extraction

1. Ouvrez le fichier de définition de rapport client (.rdlc) en mode de conception graphique.

2. Cliquez avec le bouton droit sur la zone de texte ou l'image à laquelle ajouter un lien, puis cliquez sur Propriétés.

3. Sous l'onglet Navigation, sélectionnez Aller au rapport.

4. Tapez ou sélectionnez un nom de rapport. Le rapport doit être un fichier .rdlc faisant partie du même projet.

5. Pour définir les paramètres à passer au rapport d'extraction, cliquez sur Paramètres, puis procédez comme suit :

   • Dans Nom du paramètre, tapez les noms des paramètres de rapport dans le rapport d'extraction.

     Remarque
     Les noms dans la liste des paramètres doivent correspondre de façon exacte aux paramètres du rapport cible. Si les noms ne correspondent pas, ou si un paramètre attendu ne figure pas dans la liste, la génération du rapport d'extraction échoue.

   • Dans Valeur du paramètre, tapez ou sélectionnez les valeurs à passer aux paramètres dans le rapport d'extraction.

     Remarque
     Ces valeurs peuvent contenir une expression qui correspond à une valeur à passer au paramètre de rapport. Les expressions de la liste de valeurs incluent la liste des champs du rapport en cours.

Pour fournir des données pour des rapports d'extraction, votre application doit traiter l'événement Drillthrough de l'objet ReportViewer. L'un des arguments passés à la méthode du gestionnaire d'événements Drillthrough est DrillthroughEventArgs. DrillThroughEventArgs a une propriété Report qui représente le rapport d'extraction. Dans le gestionnaire d'événements, l'application hôte peut examiner les valeurs des paramètres passés au rapport d'extraction en appelant la méthode GetParameters(). L'application hôte doit ensuite fournir les données du rapport d'extinction en utilisant la propriété DataSources du rapport d'extraction.

Voir aussi

Concepts

Définition de paramètres de rapport dans un rapport (Concepteur de rapports Visual Studio)
Ajout d'interactivité, de visibilité et de navigation à un rapport (Concepteur de rapports Visual Studio)

Autres ressources

Exemples et procédures pas à pas