Programmabilité du composant WebPart Visionneuse de rapports dans l'intégration SharePoint

Le composant WebPart Visionneuse de rapports est un contrôle serveur ReportViewerWebPart qui contient un jeu d'interfaces de programmation d'applications publiques (API) permettant aux développeurs de créer des applications SharePoint personnalisées. Vous pouvez créer des composants WebPart personnalisés qui fournissent les paramètres et le chemin d'accès au composant WebPart Visionneuse de rapports à l'aide de connexions WebPart. Vous pouvez également incorporer le composant WebPart dans une page WebPart SharePoint personnalisée et le personnaliser en utilisant l'API publique.

Connexion au composant WebPart Visionneuse de rapports avec des composants WebPart personnalisés

Le composant WebPart Visionneuse de rapports est un consommateur de connexions aux composants WebPart SharePoint qui implémentent IWebPartRow ou IFilterValues. Un composant WebPart IWebPartRow, tel que le composant WebPart Documents, peut fournir un chemin d'accès de rapport à un composant WebPart Visionneuse de rapports s'il est placé dans la même page de composant WebPart que le composant WebPart Visionneuse de rapports. De la même façon, un composant WebPart IFilterValues, tel que le composant Filtre Texte ou Filtre Choix peut fournir un paramètre de rapport à un composant WebPart Visionneuse de rapports s'il est placé dans la même page de composant WebPart que le composant WebPart Visionneuse de rapports.

Implémentation d'un fournisseur de chemins d'accès au rapport avec IWebPartRow

Pour fournir un chemin d'accès au rapport au composant WebPart Visionneuse de rapports via des connexions WebPart, procédez comme suit :

  1. Créez un composant WebPart qui implémente l'interface IWebPartRow.

  2. Ajoutez le composant WebPart à la même page WebPart que celle du composant WebPart Visionneuse de rapports.

  3. Connectez votre composant WebPart au composant WebPart Visionneuse de rapports dans l'interface utilisateur du concepteur WebPart.

    Notes

    Vous ne pouvez connecter qu'un seul composant WebPart IWebPartRow à la fois au composant WebPart Visionneuse de rapports et vous ne pouvez pas connecter simultanément un composant WebPart IWebPartRow et un composant WebPart IFilterValues au composant WebPart Visionneuse de rapports.

Pour que le composant WebPart IWebPartRow fonctionne correctement avec le composant ReportViewerWebPart, procédez comme suit dans la méthode GetRowData(RowCallback)  :

  • Appelez la méthode de rappel avec un objet DataRowView en tant que paramètre d'entrée.

  • Assurez-vous que l'objet DataRowView contient une colonne appelée « DocUrl » qui inclut le chemin d'accès au rapport.

    Notes

    Le composant WebPart Visionneuse de rapports dans le complément pour Office SharePoint Server  2010 prend également en charge la réception des données de chemin d'accès au rapport par le biais de la colonne « FileRef ».

Implémentation d'un fournisseur de paramètres de rapport avec IFilterValues

Un composant WebPart qui implémente IFilterValues peut fournir une valeur de paramètre au composant WebPart Visionneuse de rapports. La valeur de paramètre envoyée au composant WebPart Visionneuse de rapports est soumise aux mêmes restrictions appliquées au paramètre de rapport comme indiqué dans la définition de rapport (type de données, valeurs valides, etc.).

Pour fournir un paramètre de rapport au composant WebPart Visionneuse de rapports, procédez comme suit :

  1. Créez un composant WebPart qui implémente l'interface IFilterValues.

  2. Ajoutez le composant WebPart à la même page que le [T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.]

  3. Connectez votre composant WebPart IFilterValues au composant WebPart Visionneuse de rapports dans l'interface utilisateur du concepteur WebPart.

    Notes

    Vous pouvez connecter plusieurs composants WebPart IFilterValues à la fois au composant WebPart Visionneuse de rapports. Toutefois, vous ne pouvez pas connecter simultanément un composant WebPart IWebPartRow et un composant WebPart IFilterValues au composant WebPart Visionneuse de rapports.