Personnalisation du composant WebPart de visionneuse de rapports
Nouveau : 12 décembre 2006
Le composant WebPart de visionneuse de rapports vous permet d'afficher des rapports qui s'exécutent sur un serveur de rapports SQL Server 2005 Reporting Services. Les rapports consultables comprennent des fichiers de définition de rapport (.rdl) et des rapports Générateur de rapports. Les rapports s'ouvrent automatiquement dans le composant WebPart de visionneuse de rapports dans une nouvelle page, mais vous pouvez aussi ajouter un composant WebPart de visionneuse de rapports à une page ou un site Web existant ou si vous souhaitez qu'un rapport particulier soit toujours visible sur cette page.
Vous pouvez personnaliser le composant WebPart de visionneuse de rapports comme suit :
- modifiez l'aspect du composant WebPart en définissant des propriétés ;
- choisissez quelles fonctionnalités de création de rapport interactives sont disponibles sur la barre d'outils Rapports ;
- spécifiez quelles zones d'affichage sont disponibles ; Le composant WebPart de visionneuse de rapports possède une zone d'affichage de rapport, une zone de paramètres, et une zone d'informations d'identification.
Vous ne pouvez pas étendre le composant WebPart de visionneuse de rapports pour prendre en charge d'autres types de fichiers et vous ne pouvez pas remplacer la barre d'outils Rapports par une barre d'outils personnalisée ou ajouter de nouvelles fonctionnalités à la barre d'outils existante. Si vous devez personnaliser les fonctionnalités standard, créez un composant WebPart personnalisé.
Définition des propriétés d'un composant WebPart
Un composant WebPart possède des propriétés personnalisées qui servent à configurer des fonctionnalités spécifiques. Un composant WebPart possède aussi des propriétés communes qui se retrouvent dans chaque composant.
Modifier les propriétés par défaut
Le composant WebPart de visionneuse de rapports possède des propriétés par défaut qui conviennent parfaitement à l'ouverture à la demande de rapports à partir d'un dossier ou d'une bibliothèque. Par défaut, tous les contrôles disponibles sont affichés dans la barre d'outils, et la hauteur et la largeur sont définis pour utiliser tout l'espace disponible sur la page Web. Si vous souhaitez modifier les propriétés par défaut, vous pouvez personnaliser le composant WebPart à l'aide des Paramètres du site.
- Dans le menu Actions de site, cliquez sur Paramètres du site.
- Sous Galeries, cliquez sur Composants Web.
- Cliquez sur ReportViewer.dwp.
- Ouvrez le volet Outils et définissez les propriétés de votre choix.
Personnaliser une Visionneuse de rapports intégrée dans une page Web
Vous pouvez définir des propriétés pour intégrer la Visionneuse de rapports dans une page Web. La Visionneuse de rapports peut utiliser le même style et les couleurs que la page qui la contient. Vous pouvez masquer tout ou une partie de la barre d'outils, de l'explorateur de document et de la zone des paramètres pour maximiser la zone d'affichage des rapports dans l'espace alloué. Le rapport utilise toujours les styles qui lui sont attribués à sa création ; vous ne pouvez pas personnaliser l'aspect des rapports après leur publication dans une bibliothèque SharePoint.
Si vous incorporez le composant WebPart de visionneuse de rapports dans une page Web, vous devez attribuer la propriété URL de rapport à un rapport spécifique. Dans le cas contraire, la Visionneuse de rapports affiche des instructions de liaison à un rapport. Vous ne pouvez pas personnaliser ou supprimer les instructions.
Propriétés personnalisées du composant WebPart Visionneuse de rapports
Lorsque vous définissez des propriétés personnalisées, sachez que certaines propriétés ne sont utilisées que si le composant WebPart de visionneuse de rapports est incorporé à une page. Les exemples comprennent le titre, la hauteur, la largeur, le style de cadre et la zone. D'autres propriétés, de barre d'outils et de paramètres par exemple, sont utilisées indépendamment de l'affichage de la Visionneuse de rapports dans une page ou de l'ouverture d'un rapport en mode page entière.
Les propriétés personnalisées du composant WebPart Visionneuse de rapports sont listées ci-dessous.
| Propriété | Description |
|---|---|
Rapport |
URL de chemin d'accès complet d'un rapport situé sur le site SharePoint actuel ou sur un site inclus dans la même batterie de serveurs ou d'application Web. Pour obtenir les meilleurs résultats possibles lors de la définition de propriétés supplémentaires, cliquez sur Appliquer après avoir spécifié l'URL de rapport. |
Cible du lien hypertexte |
Code HTML standard qui spécifie le cadre cible permettant d'afficher le contenu lié au sein du document actuel. Pour les rapports d'extraction et les rapports qui comportent des liens hypertexte vers des sites Web externes, vous pouvez spécifier si un document cible doit s'ouvrir à la place du rapport existant dans la fenêtre active, ou s'il doit s'ouvrir dans une nouvelle fenêtre de navigateur. Les valeurs valides sont _Top, _Blank et _Self. _Top utilise la fenêtre active, _Blank charge le document dans une nouvelle fenêtre de navigateur et _Self ouvre le document dans le cadre actif. Bien que _Parent soit une valeur valide pour l'attribut Target en langage HTML, ne l'utilisez pas pour un composant WebPart Visionneuse de rapports incorporé dans une page. |
Générer automatiquement le titre du composant WebPart |
Un titre généré inclut le nom du composant WebPart de visionneuse de rapports avec le nom du rapport séparé par un tiret. Si le rapport n'a pas de titre, le nom du fichier de rapport est utilisé. Le titre est visible lorsque vous ajoutez un composant WebPart à une page. Si cette case à cocher est activée, le titre est généré chaque fois que la page est actualisée. |
Générer automatiquement le lien des détails du titre du composant WebPart |
Lien hypertexte généré qui s'affiche au-dessus du composant WebPart. Vous pouvez cliquer sur le lien afin d'ouvrir le rapport dans une nouvelle page, en mode page entière. |
Barre d'outils |
Les valeurs valides sont Complète, Aucun et Navigation. Complète permet d'afficher l'intégralité de la barre d'outils. Aucun permet de masquer la barre d'outils. Navigation permet d'afficher uniquement les contrôles de navigation entre les pages, sans zoom, sans actualisation, ni menu Actions. |
Paramètres |
Les valeurs valides sont Affiché, Réduit et Caché. Affiché permet l'affichage de la zone Paramètres pour les rapports qui comportent des valeurs paramétrées et qui nécessitent une entrée utilisateur comme condition de leur exécution. Utilisez Caché, si tous les paramètres du rapport sont spécifiés et si vous ne souhaitez pas que la zone des paramètres soit visible par les utilisateurs. |
Largeur de la zone des paramètres |
Vous pouvez choisir l'unité de mesure et la valeur. La valeur par défaut est 200 pixels. Cette propriété doit respecter une seule exigence, elle doit être supérieure à zéro. |
Explorateur de documents |
Un Explorateur de documents est un contrôle de navigation entre les rapports qui est défini dans le rapport et qui permet d'accéder en un seul clic à des sections spécifiques d'un rapport. Il est disponible dans les rapports HTML. L'Explorateur de documents s'affiche dans une zone réductible en regard de la zone d'affichage du rapport. Les valeurs valides sont Affiché, Réduit et Caché. Si un Explorateur de documents est défini pour un rapport, la zone est développée par défaut, à moins qu'elle ne soit cachée ou réduite via les propriétés du composant WebPart. Si l'Explorateur de documents est réduit, vous pouvez cliquer sur la flèche pour le développer. |
Largeur de la zone de l'explorateur de documents |
Vous pouvez choisir l'unité de mesure et la valeur. La valeur par défaut est 200 pixels. Cette propriété doit respecter une seule exigence, elle doit être supérieure à zéro. |
Charger les paramètres |
Cliquez sur ce bouton pour récupérer les propriétés des paramètres du rapport. Tous les rapports n'ont pas des paramètres. Si le rapport n'a pas de paramètres, aucune valeur n'est retournée. Si vous définissez les propriétés d'un rapport que vous venez de télécharger, vous risquez de recevoir une erreur indiquant que la connexion à la source de données a été supprimée. Si cela se produit, réinitialisez la connexion, puis achevez de définir les propriétés des paramètres une fois la connexion spécifiée. Pour obtenir des instructions sur la définition de la connexion, consultez Comment : créer et gérer des sources de données partagées (mode intégré SharePoint). Pour obtenir des résultats optimaux, cliquez sur Appliquer avant de cliquer sur Charger les paramètres. Une fois que vous avez chargé les propriétés des paramètres, vous pouvez les définir de la même façon que dans les pages de propriétés des paramètres du rapport. Pour plus d'informations sur la définition des paramètres, consultez Procédure : définir des paramètres sur un rapport publié (mode intégré SharePoint). |
Personnalisation de la barre d'outils
La barre d'outils s'affiche sous le titre et s'étend sur toute la partie supérieure du rapport. La barre d'outils fournit un menu Actions, une fonction de navigation pour les rapports paginés, ainsi que des fonctions d'actualisation et de zoom. Elle inclut un contrôle d'Explorateur de documents pour les rapports qui disposent d'un Explorateur de documents. Le menu Actions comprend des commandes permettant d'exporter un rapport, de rechercher du texte ou des nombres dans un rapport, d'imprimer un rapport, et pour les rapports de modèle, d'ouvrir le rapport dans le Générateur de rapports.
Vous ne pouvez pas personnaliser le menu Actions, ni ajouter de nouvelles commandes à ce dernier ; toutefois, vous pouvez le masquer en définissant les propriétés requises dans la barre d'outils. Vous pouvez également supprimer la commande Imprimer ou des formats d'exportation spécifiques en rendant ces fonctionnalités inaccessibles sur le serveur de rapports. Les contrôles de navigation entre les pages sont disponibles pour les rapports qui comportent des sauts de page ; à défaut, le rapport est constitué d'une seule page de longueur variable. La commande Actualiser permet de traiter à nouveau le rapport à l'aide des paramètres actuels du rapport. Pour afficher tous les contrôles sur une ligne, attribuez au moins une valeur de 400 pixels à la largeur globale du composant WebPart.
Personnalisation de la zone d'affichage
Une zone d'affichage sert à afficher les rapports. La zone d'affichage du rapport est partagée avec les zones Paramètres et Informations d'identification, si celles-ci sont utilisées. Si des informations d'identification sont requises, la zone Informations d'identification s'affiche en regard d'une zone d'affichage du rapport vide. La zone Informations d'identification disparaît une fois que l'utilisateur fournit les informations d'identification et qu'il exécute le rapport. Pour personnaliser le texte invitant les utilisateurs à fournir des informations d'identification, modifiez les propriétés de connexion de la source de données. Pour plus d'informations, consultez Comment : créer et gérer des sources de données partagées (mode intégré SharePoint).
La zone Paramètres fournit des champs permettant d'entrer des valeurs avant l'exécution du rapport. Elle n'est utilisée que lorsqu'une définition de rapport comprend des paramètres. Lorsque la zone Paramètres ou Informations d'identification est visible, l'affichage du rapport est ajusté en fonction de la largeur restante du composant WebPart. Vous pouvez définir les propriétés du composant WebPart afin de personnaliser la largeur de la zone Paramètres. Vous pouvez également définir les étiquettes qui s'affichent en regard des paramètres individuels sur la page. Pour plus d'informations sur la modification des étiquettes de paramètres, consultez Procédure : définir des paramètres sur un rapport publié (mode intégré SharePoint).
Voir aussi
Tâches
Concepts
Utilisation du composant WebPart de Visionneuse de rapports sur un site SharePoint
Configuration de Reporting Services pour l'intégration de SharePoint 3.0
Intégration de Reporting Services et de la technologie SharePoint
Affichage et gestion d'éléments de serveur de rapports à partir d'un site SharePoint