Personnaliser le composant WebPart Visionneuse de rapports
S’applique à : 
SQL Server 2016 (13.x) Reporting Services et versions ultérieures Power BI Report Server SharePoint 2013 et versions ultérieures ❌ SharePoint Online
Pour obtenir du contenu lié aux versions précédentes de SQL Server Reporting Services (SSRS), consultez Présentation de SQL Server Reporting Services.
Vous pouvez utiliser le composant WebPart Visionneuse de rapports pour afficher les rapports qui s’exécutent sur un serveur de rapports configuré pour l’intégration SharePoint. 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 Visionneuse de rapports dans une nouvelle page. Vous pouvez aussi ajouter un composant WebPart Visionneuse de rapports à une page ou un site web existant si vous voulez qu’un rapport déterminé soit toujours visible dans cette page.
Notes
Même si leurs noms sont identiques, le composant WebPart Visionneuse de rapports installé via le complément Reporting Services est différent du composant WebPart Visionneuse de rapports inclus dans le fichier RSWebParts.cab. Les instructions de cette rubrique sont spécifiques au composant WebPart Visionneuse de rapports installé via le complément Reporting Services.
Vous pouvez personnaliser le composant WebPart 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 Visionneuse de rapports compte 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 Report Viewer 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éfinir des propriétés d’un composant WebPart
Un composant WebPart a des propriétés personnalisées qui servent à configurer des fonctionnalités spécifiques. Un composant WebPart a aussi des propriétés communes qui se retrouvent dans chaque composant.
Modifier les propriétés par défaut
Le composant WebPart Visionneuse de rapports a des propriétés par défaut qui conviennent parfaitement à l’ouverture de rapports à la demande à 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. La hauteur et la largeur sont définies de façon à utiliser tout l’espace disponible dans la page web. Si vous voulez modifier les propriétés par défaut, vous pouvez personnaliser le composant WebPart via Paramètres du site.
Sur le menu Actions du site, sélectionnez Paramètres du site.
Sous Galeries, sélectionnez Composants WebPart.
Sélectionnez ReportViewer.dwp.
Ouvrez le volet Outils et définissez les propriétés de votre choix.
Personnaliser une Visionneuse de rapports incorporé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 que vous avez définis pour celui-ci au moment de le créer. Vous ne pouvez pas personnaliser l’apparence du rapport après l’avoir publié dans une bibliothèque SharePoint.
Si vous incorporez le composant WebPart Report Viewer dans une page web, vous devez attribuer à la propriété URL de rapport un rapport spécifique. Dans le cas contraire, la Report Viewer 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 Visionneuse de rapports est incorporé dans 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 Report Viewer sont listées dans le tableau suivant :
| Propriété | Description |
|---|---|
| État | 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 application Web. Pour obtenir les résultats optimaux lors de la définition de propriétés supplémentaires, sélectionnez Appliquer après avoir spécifié l'URL du 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 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, _Blanket _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 Report Viewer incorporé dans une page. |
| Générer automatiquement le titre du composant WebPart | Titre généré qui inclut le nom du composant WebPart Visionneuse de rapports et le nom du rapport, séparés par un tiret. Si le rapport n'a pas de titre, le nom de 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 sélectionner le lien afin d’ouvrir le rapport dans une nouvelle page, en mode page entière. |
| Afficher l'élément de menu Générateur de rapports | Affiche ou masque l’option de menu Actions pour ouvrir le Générateur de rapports. |
| Afficher l'élément de menu Abonnement | Affiche ou masque l’option de menu Actions pour créer un abonnement pour le rapport. |
| Afficher l'élément de menu Imprimer | Affiche ou masque l’option de menu Actions pour imprimer le rapport. |
| Afficher l'élément de menu Exporter | Affiche ou masque l’option de menu Actions pour exporter le rapport. |
| Afficher le bouton Actualiser | Affiche ou masque le bouton Actualiser sur la barre d'outils. |
| Afficher les commandes de navigation entre les pages | Affiche ou masque les boutons de navigation dans les rapports sur la barre d'outils. Cette option modifie la visibilité de tous les contrôles de navigation. |
| Afficher le bouton Précédente | Affiche ou masque le bouton Précédente sur la barre d'outils. |
| Afficher les commandes de recherche | Affiche ou masque les commandes de recherche sur la barre d'outils. Les commandes de recherche autorisent un utilisateur à rechercher le texte dans le rapport rendu. Cette option modifie la visibilité de toutes les commandes de recherche. |
| Afficher le contrôle de zoom | Affiche ou masque le contrôle de zoom sur la barre d'outils. |
| Afficher le bouton Flux Atom | Affiche ou masque le bouton Flux Atom sur la barre d'outils. |
| Emplacement de la barre d'outils | Détermine l'emplacement de la barre d'outils dans la visionneuse de rapports. Les valeurs possibles sont Top et Bottom. |
| Zone de message | Les valeurs valides sont Affiché, Réduitet Caché. Affiché affiche de la zone Paramètres pour les rapports qui comportent des valeurs paramétrables et qui nécessitent une entrée utilisateur avant l’exécution du rapport. Utilisez Caché si tous les paramètres du rapport sont spécifiés et si vous ne voulez 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 | 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éduitet 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 sélectionner 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 | Récupérez les propriétés de paramètre pour le 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 avez téléchargé, vous risquez de recevoir une erreur indiquant que la connexion à la source de données est supprimée. Si cette erreur se produit, réinitialisez la connexion, puis terminez la définition des propriétés des paramètres une fois la connexion spécifiée. Pour plus d’informations sur la définition de la connexion, consultez Créer et gérer des sources de données partagées (Reporting Services en mode intégré SharePoint). Pour obtenir des résultats optimaux, sélectionnez 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 Définir les paramètres sur un rapport publié (Reporting Services en mode intégré SharePoint). |
Personnaliser 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 , la navigation entre les pages pour les rapports paginés, l’actualisation et le 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 d’ouvrir le rapport dans le Générateur de rapports.
Vous ne pouvez pas ajouter de nouvelles commandes au menu Actions, mais vous pouvez le personnaliser en modifiant les options visibles aux utilisateurs. Pour modifier la visibilité des boutons et des contrôles de la barre d’outils, modifiez les options dans la section Visibilité des éléments de barre d’outils du composant WebPart. 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.
Personnaliser 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 Créer et gérer des sources de données partagées (Reporting Services en 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 Définir les paramètres sur un rapport publié (Reporting Services en mode intégré SharePoint).