SAP version développeur pour Microsoft Visual Studio Manuel utilisateur

PDF
ドキュメント
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio
Version du document : Support Package 10 - 2014-06-23
SAP Crystal Report pour le Guide du
d&eacute;veloppeur de SAP SDK Visual
Studio .NET
Table des mati&egrave;res
1
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1
D&eacute;marrage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1
Pr&eacute;sentation de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio
............................................................................4
1.1.2
1.2
1.3
Migration de l'application SAP Crystal Reports .Net. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Configuration de l'environnement de d&eacute;veloppement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.1
Configuration du syst&egrave;me. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
1.2.2
Configuration d'un projet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Principes fondamentaux du SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.3.1
Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.3.2
Contr&ocirc;le CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.3.3
Quelle m&eacute;thode de persistance utiliser avec SAP Crystal Reports ?. . . . . . . . . . . . . . . . . . . . 53
1.3.4
Evolutivit&eacute; de l'application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
1.3.5
Utilisation de SAP Crystal Reports dans une batterie de serveurs Web ou un jardin Web
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
1.4
1.5
1.6
1.7
2
1.3.6
Utilisation de Crystal Reports en tant que service Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
1.3.7
Consid&eacute;rations de s&eacute;curit&eacute;. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
Utilisation du SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
1.4.1
Impression d'un rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
1.4.2
Exportation d'un rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
1.4.3
Filtrage de donn&eacute;es avec des param&egrave;tres ou des formules. . . . . . . . . . . . . . . . . . . . . . . . . .136
1.4.4
D&eacute;finition de la source de donn&eacute;es. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
1.4.5
Visualisation d'un rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
1.4.6
Personnalisation du contr&ocirc;le CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
1.4.7
Utilisation des rapports SAP Crystal Reports Read-Only (RPTR). . . . . . . . . . . . . . . . . . . . . 243
Tutoriels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
1.5.1
Tutoriels du mod&egrave;le d'objet CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
1.5.2
Tutoriels du mod&egrave;le d'objet ReportDocument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
1.5.3
Tutoriels de programmation all&eacute;g&eacute;e dans Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . 508
1.5.4
Tutoriels sur la connectivit&eacute; des donn&eacute;es. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549
1.5.5
Tutoriels suppl&eacute;mentaires. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
D&eacute;ploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
1.6.1
Composants de d&eacute;ploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .618
1.6.2
D&eacute;ploiement pour Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
Cr&eacute;ation des rapports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
1.7.1
Utilisation du SAP Crystal Reports Designer incorpor&eacute;. . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
1.7.2
Formules - R&eacute;f&eacute;rence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
1.7.3
Interface utilisateur - R&eacute;f&eacute;rence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Table des mati&egrave;res
1.8
Glossaire. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1009
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Table des mati&egrave;res
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
3
1
Guide du d&eacute;veloppeur du SAP SDK
Crystal Reports .NET
1.1
D&eacute;marrage
Cette aide en ligne est con&ccedil;ue pour vous aider &agrave; d&eacute;velopper vos propres applications Web ou Windows &agrave; l'aide du
SDK SAP Crystal Reports .NET. Elle comprend des tutoriels et des r&eacute;f&eacute;rences de programmation qui vous
aideront &agrave; impl&eacute;menter le SDK SAP Crystal Reports .NET.
1.1.1
Pr&eacute;sentation de SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio permet de cr&eacute;er des rapports complexes
de qualit&eacute; professionnelle dans un programme bas&eacute; sur une interface utilisateur graphique. Vous pouvez alors
connecter votre rapport &agrave; pratiquement n'importe quelle source de base de donn&eacute;es ou &agrave; des donn&eacute;es proxy,
comme un ensemble de r&eacute;sultats (par exemple, un objet DataSet ADO.NET). A l'aide des assistants du
concepteur d'interface utilisateur, vous pouvez d&eacute;finir la mise en forme, le regroupement, les diagrammes et
d'autres crit&egrave;res.
Vous pouvez h&eacute;berger votre rapport dans une application Web ou Windows avec l'un des contr&ocirc;les visualiseur de
rapports de SAP Crystal Reports. La pr&eacute;sentation des rapports dans les clients Windows et HTML 4.0 est
hautement interactive et offre des fonctionnalit&eacute;s telles que l'exploration de diagrammes, la navigation dans les
rapports et la recherche de texte.
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio est fourni avec un SDK complet. Ce SDK
vous permet d'interagir avec le rapport par programmation au moment de l'ex&eacute;cution, gr&acirc;ce &agrave; l'emploi de l'un des
quatre mod&egrave;les d'objet suivants :
●
CrystalReportViewer, le mod&egrave;le d'objet le plus simple.
●
ReportDocument, le mod&egrave;le d'objet le plus complet.
●
ReportClientDocument, le mod&egrave;le d'objet le plus complet. Ce mod&egrave;le d'objet est disponible avec un serveur
RAS.
●
InfoObject, un mod&egrave;le d'objet puissant con&ccedil;u pour la planification et la configuration de rapports dans la
structure SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.
Remarque
Les mod&egrave;les d'objet CrystalReportViewer et ReportDocument sont disponibles avec toutes les versions
de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio. Les mod&egrave;les d'objet
ReportClientDocument et InfoObject n&eacute;cessitent une licence mise &agrave; niveau. Voir Solutions de reporting de
SAP BusinessObjects Business Intelligence [page 65].
Vous pouvez associer des rapports &agrave; un projet Visual Studio de nombreuses fa&ccedil;ons :
●
Incorporez les rapports directement dans le projet.
●
Acc&eacute;dez aux rapports &agrave; partir d'un r&eacute;pertoire de fichiers.
4
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Acc&eacute;dez aux rapports en tant que service Web de rapports &agrave; partir d'un serveur distant.
●
Connectez vos rapports en tant que services Crystal.
●
Avec une mise &agrave; niveau vers SAP Crystal Reports Server, acc&eacute;dez aux rapports via le serveur RAS.
●
Avec une mise &agrave; niveau vers la plateforme SAP BusinessObjects Business Intelligence, acc&eacute;dez aux rapports
via le Page Server ou le serveur RAS pr&eacute;sent dans la structure de la plateforme SAP BusinessObjects
Business Intelligence.
1.1.1.1
Fonctionnalit&eacute;s disponibles dans
SAP Crystal Report Designer
SAP Crystal Reports Designer propose plusieurs fonctionnalit&eacute;s qui ne sont pas disponibles avec
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio :
Fonction
Description
Membres calcul&eacute;s dans des diagrammes de tableau crois&eacute;
Vous pouvez ajouter des lignes ou des colonnes &agrave; un
diagramme de Tableau crois&eacute; en ins&eacute;rant un membre
calcul&eacute;. Ces lignes ou colonnes peuvent contenir des calculs
personnalis&eacute;s (par exemple, la diff&eacute;rence de ventes entre
deux r&eacute;gions) ou peuvent &ecirc;tre enti&egrave;rement utilis&eacute;es &agrave; des fins
de mise en forme (par exemple, en ins&eacute;rant une ligne vide
toutes les trois lignes pour am&eacute;liorer la clart&eacute;). Vous disposez
d'une enti&egrave;re souplesse dans la conception de vos propres
formules de calcul et pouvez choisir si elles apparaissent
seulement une fois ou se r&eacute;p&egrave;tent r&eacute;guli&egrave;rement dans le
Tableau crois&eacute;.
Objets Flash incorpor&eacute;s
Vous pouvez incorporer un objet Flash ou cr&eacute;er un lien vers
un objet Flash dans une section quelconque de rapport
SAP Crystal Reports.
R&eacute;sum&eacute;s incorpor&eacute;s dans des tableaux crois&eacute;s
Vous pouvez ajouter un calcul suppl&eacute;mentaire &agrave; votre
diagramme de Tableau crois&eacute; en ins&eacute;rant un r&eacute;sum&eacute;
incorpor&eacute;. Les r&eacute;sum&eacute;s incorpor&eacute;s n'ajoutent pas de lignes
ou de colonnes &agrave; votre Tableau crois&eacute;. Ils entra&icirc;nent plut&ocirc;t
l'apparition de calculs suppl&eacute;mentaires dans chacune des
cellules du Tableau crois&eacute;. Par exemple, dans un rapport
affichant les ventes r&eacute;gionales, vous pouvez ins&eacute;rer un calcul
pour chaque r&eacute;gion, qui affiche le pourcentage des ventes
totales du pays.
Aper&ccedil;u modifiable
Avec SAP Crystal Reports Designer, vous pouvez visualiser
un rapport dans l'onglet de conception ou l'onglet d'aper&ccedil;u.
Vous disposez des m&ecirc;mes possibilit&eacute;s de mise en forme
dans l'onglet Aper&ccedil;u que dans l'onglet Conception.
N&eacute;anmoins, dans l'onglet Aper&ccedil;u, vous travaillez avec les
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
5
Fonction
Description
donn&eacute;es r&eacute;elles. Au lieu d'un cadre de champ de donn&eacute;es
repr&eacute;sentant plusieurs valeurs de champ de donn&eacute;es, les
valeurs r&eacute;elles apparaissent dans le rapport.
Code-barres mis en forme
SAP Crystal Reports Designer comprend les formules et
polices n&eacute;cessaires &agrave; la prise en charge des code-barres
Code39. Vous pouvez utiliser l'option Mettre en forme le
champ pour modifier l'apparence d'un code-barres.
Il existe de nombreuses raisons pour modifier l'apparence
d'un code-barres, dont les suivantes :
●
Pour changer la taille de sorte que le code-barres ne soit
ni trop grand ni trop petit pour &ecirc;tre lu par un scanneur.
●
Champs de tri interactifs
Pour afficher le code-barres dans une autre couleur.
Vous pouvez concevoir votre rapport de sorte que les
utilisateurs puissent modifier un champ de tri ou un sens de
tri sans actualiser les informations de la base de donn&eacute;es.
Pour ce faire, ajoutez un Contr&ocirc;le de tri &agrave; votre rapport.
Un Contr&ocirc;le de tri est particuli&egrave;rement utile pour plusieurs
raisons :
●
Il permet aux utilisateurs de trier les donn&eacute;es du rapport
pour une analyse plus approfondie sans quitter la zone
de dessin du rapport.
●
Il &eacute;limine la demande de traitement sur la base de
donn&eacute;es.
●
Il r&eacute;duit le temps d'attente des utilisateurs pendant le tri
des donn&eacute;es.
●
Il permet aux utilisateurs de trier les champs du rapport,
m&ecirc;me s'ils ne disposent pas d'une connexion ou des
droits d'acc&egrave;s &agrave; la base de donn&eacute;es au moment de
l'affichage.
Workbench
Sur le Workbench, vous pouvez cr&eacute;er des projets contenant
un ou plusieurs rapports. Les options de la barre d'outils vous
permettent d'ajouter, supprimer ou renommer les dossiers,
rapports et packages d'objets. Vous pouvez r&eacute;organiser les
fichiers dans un dossier ou des dossiers en les faisant glisser
et en les d&eacute;posant o&ugrave; vous souhaitez qu'ils apparaissent.
Vous pouvez &eacute;galement faire glisser des fichiers de rapport
de l'Explorateur Windows et les d&eacute;poser dans le dossier de
votre choix sur le Workbench.
6
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.1.2
Migration de l'application SAP Crystal Reports .Net
Cette section contient des informations sur la migration de l'application SAP Crystal Reports .Net vers
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
Remarque
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio est dot&eacute; d'un ensemble complet de
fonctionnalit&eacute;s et est disponible en t&eacute;l&eacute;chargement gratuit s'int&eacute;grant &agrave; Visual Studio 2010 ou version
ult&eacute;rieure. SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio n'est pas fourni avec
l'application SAP Crystal Reports Designer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
7
Options de migration dans les diff&eacute;rentes versions de SAP Crystal Reports
Ce diagramme repr&eacute;sente les diff&eacute;rents chemins de migration entre les versions de SAP Crystal Reports.
8
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Migration vers SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio met automatiquement &agrave; niveau vos
anciens projets vers la version actuelle. Si un projet contient des r&eacute;f&eacute;rences &agrave; d'anciens composants, l'utilisateur
est invit&eacute; &agrave; effectuer une mise &agrave; niveau.
Si vous cliquez sur le bouton Oui, les projets et les fichiers associ&eacute;s sont mis &agrave; niveau vers la version actuelle de
SAP Crystal Reports. Si vous cliquez sur le bouton Non, le projet est adapt&eacute; de mani&egrave;re &agrave; utiliser les r&eacute;f&eacute;rences
d'origine. Certaines fonctionnalit&eacute;s r&eacute;centes sont d&eacute;sactiv&eacute;es si elles ne sont pas prises en charge par les
composants plus anciens.
Remarque
Si le fichier de projet (tout fichier ASPX poss&eacute;dant des composants SAP Crystal Reports ou le fichier
web.config) est verrouill&eacute;, la mise &agrave; niveau ou l'adaptation &eacute;choue.
Informations associ&eacute;es
Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65]
1.1.2.1
Probl&egrave;mes de migration
Un rapport bas&eacute; sur une source de donn&eacute;es ADO.NET ne fonctionnera pas si le
projet vise .NET 4.x Framework
Les rapports bas&eacute;s sur une source de donn&eacute;es ADO.NET ne fonctionneront pas si le projet vise .NET 4.x
Framework. L'erreur suivante se produit : &quot;Additional information: Mixed mode assembly is built against version
'v2.0.50727' of the runtime and cannot be loaded in the 4.x runtime without additional configuration information
(Informations compl&eacute;mentaires : la liaison d'assembly en mode mixte a &eacute;t&eacute; cr&eacute;&eacute;e avec la version v2.0.50727 du
programme d'ex&eacute;cution et ne peut pas &ecirc;tre charg&eacute;e dans le programme d'ex&eacute;cution 4.0 sans informations de
configuration suppl&eacute;mentaires)&quot;.
Pour r&eacute;soudre ce probl&egrave;me, vous pouvez mettre &agrave; jour le fichier .config de votre projet. Ajoutez les lignes de
code suivantes dans la section &lt;configuration&gt;&lt;/configuration&gt; du fichier :
&lt;startup useLegacyV2RuntimeActivationPolicy=&quot;true&quot;&gt;
&lt;supportedRuntime version=&quot;v4.x&quot;/&gt;
&lt;/startup&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
9
1.1.2.2
Limites en 64 bits
L'architecture 64 bits est prise en charge dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio x 64 (AMD64). Toutefois, l'architecture IA64 (Itanium) n'est pas prise en charge &agrave; ce jour.
Fonctionnalit&eacute;s actuellement non prises en charge dans les sc&eacute;narios 64 bits :
●
Exportation de rapports au format HTML.
●
Composants de cr&eacute;ation de cartes g&eacute;ographiques.
●
Composants de police de codes &agrave; barres Azalea.
1.2
Configuration de l'environnement de d&eacute;veloppement
Cette section fournit des instructions d&eacute;taill&eacute;es sur l'installation et la configuration de votre environnement de
d&eacute;veloppement, ainsi que sur la cr&eacute;ation d'un site Web ou d'un projet Windows dans SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio.
1.2.1
Configuration du syst&egrave;me
Cette section indique comment configurer votre environnement de d&eacute;veloppement pour tester et d&eacute;velopper des
applications Windows ou des sites Web utilisant le SDK de SAP Crystal Reports .NET.
1.2.1.1
El&eacute;ments &agrave; installer
Vous devez installer SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio avant de pouvoir
cr&eacute;er des applications Web ou Windows utilisant SAP Crystal Reports.
1.2.1.1.1
Versions de Visual Studio prises en charge
Si vous envisagez d'utiliser SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, v&eacute;rifiez que la
version de Visual Studio que vous avez install&eacute;e prend en charge SAP Crystal Reports.
Les &eacute;ditions Visual Studio Ultimate, Premium et Professional sont prises en charge pour Visual Studio 2010 et
ult&eacute;rieure. Les &eacute;ditions Visual Studio Express ne sont pas prises en charge par SAP Crystal Reports.
Informations associ&eacute;es
Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65]
10
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.2.1.1.2
Versions SAP Crystal Reports
Plusieurs versions de SAP Crystal Reports sont disponibles. De nombreuses proc&eacute;dures d&eacute;crites dans ce
document s'appliquent &agrave; une version sp&eacute;cifique. Pour utiliser au mieux ce document, d&eacute;terminez d'abord quelle
version de SAP Crystal Reports est install&eacute;e sur votre syst&egrave;me.
1.2.1.1.2.1
Pour d&eacute;terminer la version de
SAP Crystal Reports que vous utilisez
Proc&eacute;dure
1.
Acc&eacute;dez au cache GAC (Global Assembly Cache) &agrave; l'emplacement C:\WINNT\Assembly ou C:\Windows
\Assembly.
2.
Recherchez le fichier CrystalDecisions.CrystalReports.Engine.
Remarque
Si vous avez install&eacute; diff&eacute;rentes versions de SAP Crystal Reports, plusieurs versions de ces fichiers se
trouvent dans le Global Assembly Cache. Le fichier CrystalDecisions.CrystalReports.Engine est s&eacute;lectionn&eacute;
car il est inclus dans chaque version de SAP Crystal Reports.
3.
Recherchez la colonne Version affich&eacute;e dans la fen&ecirc;tre.
Il s'agit de la &quot;version de l'assembly&quot;.
4.
Recherchez le num&eacute;ro d'assembly le plus &eacute;lev&eacute;.
5.
Comparez la version de l'assembly avec le num&eacute;ro de version indiqu&eacute; dans le tableau des versions de
SAP Crystal Reports.
1.2.1.1.2.2
Versions SAP Crystal Reports
Produit
Version de l'assembly
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio (.NET 4.0 Framework)
13.0.2000.0
SAP Crystal Reports 2008 (.NET 2.0 Framework)
12.0.2000.0
SAP Crystal Reports 2008 (.NET 1.1 Framework)
12.0.1100.0
SAP Crystal Reports XI Release 2
11.5.3300.0
SAP Crystal Reports XI Release 1
11.0.3300.0
SAP Crystal Reports Basic pour Visual Studio 2008
10.5.3600.0
SAP Crystal Reports pour Visual Studio 2005
10.2.3600.0
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
11
Produit
Version de l'assembly
SAP Crystal Reports 10
10.0.3300.0
SAP Crystal Reports 9
9.2.3300
SAP Crystal Reports pour Visual Studio 2003
9.1.5000
SAP Crystal Reports 2008 et SAP Crystal Reports 2008 SP1 utilisent le m&ecirc;me num&eacute;ro de version d'assembly. Si
SAP Crystal Reports 2008 SP1 est install&eacute;, la version du fichier doit commencer par 12.1 et non par 12.0.
1.2.1.1.3
Installation du service de mise &agrave; jour de
SAP Crystal Reports
Contexte
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio fournit d&eacute;sormais en option un service de
mise &agrave; jour de SAP Crystal Reports qui recherche les mises &agrave; jour et les correctifs de SAP Crystal Reports.
Le service de mise &agrave; jour de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio n'est pas
fourni en tant que composant du programme d'installation. Vous devez le t&eacute;l&eacute;charger et l'installer s&eacute;par&eacute;ment.
Proc&eacute;dure
1.
Apr&egrave;s avoir install&eacute; SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, d&eacute;marrez
Visual Studio et cr&eacute;ez un site Web ou un projet Windows.
2.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom de projet affich&eacute; en gras,
puis cliquez sur
Ajouter
Nouvel &eacute;l&eacute;ment .
3.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, s&eacute;lectionnez Rapport Crystal.
4.
Dans le champ Nom, saisissez Test.rpt, puis cliquez sur Ajouter.
Remarque
Si vous utilisez le SAP Crystal Report Designer incorpor&eacute; pour la premi&egrave;re fois, un message vous invite &agrave;
accepter les termes du Contrat de licence utilisateur. Ensuite, la bo&icirc;te de dialogue Service de mise &agrave; jour
s'ouvre. Si vous avez d&eacute;j&agrave; utilis&eacute; le SAP Crystal Report Designer incorpor&eacute; auparavant, vous devrez ouvrir
la bo&icirc;te de dialogue Service de mise &agrave; jour manuellement.
Le SAP Crystal Reports Designer incorpor&eacute; s'ouvre et affiche le nouveau rapport.
5.
Si la bo&icirc;te de dialogue Service de mise &agrave; jour n'appara&icirc;t pas, cliquez sur Rechercher les mises &agrave; jour dans le
menu Crystal Reports.
Si le service de mise &agrave; jour de SAP Crystal Reports n'est pas install&eacute;, un message vous invite &agrave; le faire.
6.
Dans la bo&icirc;te de dialogue Service de mise &agrave; jour, cliquez sur Oui.
Le site Web du service de mise &agrave; jour de SAP Crystal Reports s'affiche avec un lien permettant de t&eacute;l&eacute;charger
ce service.
12
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
T&eacute;l&eacute;chargez et installez le service de mise &agrave; jour de SAP Crystal Reports.
8.
D&eacute;marrez &agrave; nouveau Visual Studio.
9.
Ouvrez Test.rpt.
Le SAP Crystal Report Designer incorpor&eacute; d&eacute;marre et affiche le rapport.
10. Dans le menu Crystal Reports, cliquez sur Rechercher les mises &agrave; jour.
Le service de mise &agrave; jour d&eacute;marre et recherche les mises &agrave; jour. Vous pouvez accepter ou refuser toutes les
mises &agrave; jour disponibles.
1.2.1.1.4
Code cl&eacute; de produit SAP Crystal Reports
Le code cl&eacute; consiste en une cha&icirc;ne alphanum&eacute;rique comportant 19 chiffres ou caract&egrave;res. Dans
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, lorsque vous cr&eacute;ez des projets de
d&eacute;ploiement utilisant le programme Windows Installer, il peut &ecirc;tre n&eacute;cessaire d'indiquer un code cl&eacute; de produit
pour valider les informations de licence des applications Web ou Windows.
1.2.1.2
El&eacute;ments &agrave; v&eacute;rifier
Pour d&eacute;velopper un site Web ou une application Windows qui utilise le SDK de SAP Crystal Reports .NET, vous
devez v&eacute;rifier que les composants de Crystal Reports Developer ont &eacute;t&eacute; correctement install&eacute;s et int&eacute;gr&eacute;s &agrave;
Visual Studio. Pour d&eacute;velopper un site Web, vous devez &eacute;galement v&eacute;rifier que le r&eacute;pertoire virtuel des
visualiseurs a &eacute;t&eacute; correctement install&eacute; sur les serveurs Web de d&eacute;veloppement et de d&eacute;ploiement.
Cette section d&eacute;taille les param&egrave;tres &agrave; v&eacute;rifier avant la cr&eacute;ation d'une application SAP Crystal Reports .NET.
Informations associ&eacute;es
Versions de Visual Studio prises en charge [page 10]
1.2.1.2.1
V&eacute;rification de l'installation de SAP Crystal Reports
Contexte
Pour v&eacute;rifier que le composant SAP Crystal Reports de Visual Studio est install&eacute;, assurez-vous que son nom est
affich&eacute; dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment de l'application Visual Studio.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
13
Proc&eacute;dure
1.
Lancez Visual Studio.
2.
Cr&eacute;ez un projet Web ou Windows (dans le langage de votre choix), ou ouvrez un projet Web ou Windows
existant.
3.
Dans le menu Projet, cliquez sur Ajouter un nouvel &eacute;l&eacute;ment.
Remarque
Les nouveaux fichiers de rapport doivent &ecirc;tre ajout&eacute;s directement &agrave; un projet. Vous ne pouvez pas cr&eacute;er un
rapport Crystal dans Visual Studio via le menu Fichier.
4.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, faites d&eacute;filer la liste des &eacute;l&eacute;ments disponibles pour
v&eacute;rifier que Crystal Reports y figure bien.
1.2.1.2.2
R&eacute;pertoire des visualiseurs
SAP Crystal Reports utilise un r&eacute;pertoire virtuel pour acc&eacute;der aux visualiseurs &agrave; afficher. Le nom du r&eacute;pertoire
virtuel et le chemin d'acc&egrave;s aux fichiers associ&eacute;s diff&egrave;rent dans chaque version de SAP Crystal Reports. Cela &eacute;vite
les risques de conflit si vous installez plusieurs versions de SAP Crystal Reports sur le m&ecirc;me ordinateur.
1.2.1.2.2.1
Emplacement par d&eacute;faut du r&eacute;pertoire virtuel des
visualiseurs
Si vous avez install&eacute; SAP Crystal Reports avec les param&egrave;tres et chemins d'acc&egrave;s par d&eacute;faut, les visualiseurs se
trouvent dans le r&eacute;pertoire virtuel indiqu&eacute; ci-dessous.
Version
Structure
SAP Crystal Reports, 4.x Framework
version d&eacute;veloppeur
pour Microsoft Vi&shy;
sual Studio
Chemin d'acc&egrave;s
Chemin d'acc&egrave;s au fichier lors de l'utilisation du serveur de d&eacute;ve&shy;
loppement ASP.NET :
\Windows\Microsoft.NET\Framework
\v4.0.30319\ASP.NETClientFiles
\crystalreportviewers13
Chemin d'acc&egrave;s au fichier lors de l'utilisation d'IIS :
\inetpub\wwwroot\aspnet_client\system_web
\4_0_30319\crystalreportviewers13
SAP Crystal Reports, 2.0 Framework
version d&eacute;veloppeur
pour Microsoft Vi&shy;
sual Studio
14
Chemin d'acc&egrave;s au fichier lors de l'utilisation du serveur de d&eacute;ve&shy;
loppement ASP.NET :
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Version
Structure
Chemin d'acc&egrave;s
\Windows\Microsoft.NET\Framework
\v2.0.50727\ASP.NETClientFiles
\crystalreportviewers13
Chemin d'acc&egrave;s au fichier lors de l'utilisation d'IIS :
\inetpub\wwwroot\aspnet_client\system_web
\2_0_50727\crystalreportviewers13
1.2.1.2.2.2
Pour rechercher le r&eacute;pertoire des visualiseurs
Proc&eacute;dure
1.
Dans le Panneau de configuration, cliquez deux fois sur Outils d'administration, puis sur Internet Information
Services.
2.
Dans la bo&icirc;te de dialogue Internet Information Services, d&eacute;veloppez le nœud Site Web, puis le nœud Site Web
par d&eacute;faut.
3.
Localisez tous les dossiers contenant un dossier crystalreportsviewers13.
4.
Cliquez avec le bouton droit de la souris sur chaque dossier crystalreportsviewers13, puis s&eacute;lectionnez
Propri&eacute;t&eacute;s.
5.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s, v&eacute;rifiez que le chemin d'acc&egrave;s local est correctement configur&eacute; pour
votre version de SAP Crystal Reports ou de Visual Studio.
1.2.1.2.3
R&eacute;pertoire d'exemples de rapports
Certains exemples de fonctionnalit&eacute;s, sc&eacute;narios de liaison de rapports et tutoriels reposent sur des exemples de
rapports fournis avec SAP Crystal Reports.
Vous pouvez t&eacute;l&eacute;charger les exemples de rapports &agrave; partir de l'adresse suivante : http://
www.sdn.sap.com/irj/boc/downloads
1.2.2
Configuration d'un projet
Cette section pr&eacute;sente des informations essentielles pour les d&eacute;veloppeurs ayant un niveau avanc&eacute; ou
interm&eacute;diaire. Elle indique les meilleures pratiques &agrave; suivre pour cr&eacute;er et configurer un projet Windows ou un
projet/site Web &agrave; l'aide de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
En outre, le projet que vous allez cr&eacute;er sera utilis&eacute; dans les tutoriels pr&eacute;sent&eacute;s dans cette aide en ligne.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
15
1.2.2.1
Configuration d'un site Web dans Visual Studio
Cette section d&eacute;crit la configuration d'un site Web dans Visual Studio. Le site Web que vous allez ainsi cr&eacute;er
servira de pr&eacute;requis aux tutoriels de programmation classique fournis dans cette aide en ligne.
1.2.2.1.1
Cr&eacute;ation d'un site Web dans Visual Studio
Proc&eacute;dure
1.
Lancez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau Site Web.
3.
Dans la bo&icirc;te de dialogue Nouveau site Web, cliquez sur Site Web ASP.NET.
4.
Dans la liste d&eacute;roulante Emplacement, s&eacute;lectionnez Syst&egrave;me de fichiers.
5.
Dans la liste d&eacute;roulante Langage, s&eacute;lectionnez le langage de programmation que vous souhaitez utiliser.
6.
Dans le champ de texte Emplacement, saisissez le chemin d'acc&egrave;s du r&eacute;pertoire C:\WebSites\, suivi du nom
de votre projet.
C:\WebSites\NomMonProjet
7.
Cliquez sur OK.
1.2.2.1.2
1.2.2.1.2.1
Pr&eacute;paration du Web Form
Pour cr&eacute;er le Web Form
Contexte
Dans cette section, vous allez configurer la classe code-behind pour le Web Form.
Remarque
Les termes &quot;Web Form&quot;, &quot;page ASPX&quot; et &quot;Default.aspx&quot; sont utilis&eacute;s de mani&egrave;re interchangeable.
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez deux fois sur le fichier Default.aspx pour ouvrir le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
16
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
La classe code-behind s'ouvre. Cette classe s'appelle classe _Default. Le fichier de classe s'appelle
Default.aspx.cs ou Default.aspx.vb.
Remarque
Si votre page Default.aspx a &eacute;t&eacute; cr&eacute;&eacute;e avec un code incorpor&eacute;, son code n'a pas &eacute;t&eacute; plac&eacute; dans un fichier
s&eacute;par&eacute;. Dans ce cas, supprimez la page ASPX et recr&eacute;ez-la. Lorsque vous cr&eacute;ez la page ASPX, activez la
case &agrave; cocher &quot;Placer le code dans un fichier distinct&quot;.
3.
Si vous &eacute;crivez cette classe en langage Visual Basic, tapez &quot;Option Strict On&quot; au d&eacute;but de la classe.
Remarque
Il est recommand&eacute; de d&eacute;finir Option Strict sur On au d&eacute;but de chaque classe Visual Basic de votre site
Web. Ainsi, vous serez tenu de respecter les conventions d'&eacute;criture du code, &agrave; savoir l'emploi de
d&eacute;clarations de variables fortement typ&eacute;es et la d&eacute;finition d'un cast valide, deux conventions qui sont
v&eacute;rifi&eacute;es au moment de la compilation du code. Cette pr&eacute;caution aide &agrave; r&eacute;duire les exceptions g&eacute;n&eacute;r&eacute;es &agrave;
l'ex&eacute;cution du code.
1.2.2.1.2.2
Pour ajouter des instructions Imports et Using
aux espaces de noms de r&eacute;f&eacute;rence
Proc&eacute;dure
1.
Ouvrez la page Default.aspx.
2.
Dans le menu Affichage, cliquez sur Code.
La classe code-behind du Web Form s'affiche.
3.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au
d&eacute;but de la classe contenant les espaces de noms SAP Crystal Reports suivants.
Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
Remarque
Les classes de ces deux assemblies sont couramment utilis&eacute;es dans tous les tutoriels. En ce qui concerne
les assemblies suppl&eacute;mentaires dont vous pourriez avoir besoin dans des tutoriels sp&eacute;cifiques, vous
trouverez des instructions pour les ajouter tout au long de ce tutoriel.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
17
1.2.2.1.2.3
Pour ajouter une m&eacute;thode d'assistance priv&eacute;e
pour le code de configuration de SAP Crystal Reports
Proc&eacute;dure
Dans la classe, ajoutez une nouvelle m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e ConfigureCrystalReports(),
sans valeur renvoy&eacute;e.
Private Sub ConfigureCrystalReports()
End Sub
private void ConfigureCrystalReports()
{
}
La m&eacute;thode ConfigureCrystalReports() permet aux utilisateurs d'interagir avec le rapport au moment
de l'ex&eacute;cution. De plus, elle contr&ocirc;le l'interaction par programme avec le rapport.
&Eacute;tapes suivantes
Ensuite, vous allez ajouter un gestionnaire d'&eacute;v&eacute;nements Page_Init &agrave; partir duquel appeler la m&eacute;thode
ConfigureCrystalReports(). Le fait d'appeler la m&eacute;thode ConfigureCrystalReports() &agrave; partir de ce
gestionnaire d'&eacute;v&eacute;nements garantit que le code de configuration du rapport Crystal s'ex&eacute;cutera durant
l'&eacute;v&eacute;nement d'initialisation de la page.
1.2.2.1.2.4
Pour ajouter un gestionnaire d'&eacute;v&eacute;nements
Page_Init &agrave; la classe code-behind
Contexte
G&eacute;n&eacute;ralement, le gestionnaire d'&eacute;v&eacute;nements Page_Load permet de saisir le code de configuration du Web Form
dans une application Web ASP.NET de mani&egrave;re &agrave; ce que ce programme soit appel&eacute; pendant l'&eacute;v&eacute;nement
Page.Load. Mais le code de configuration du rapport Crystal doit &ecirc;tre appel&eacute; plus t&ocirc;t, pendant l'&eacute;v&eacute;nement
Page.Init.
Proc&eacute;dure
1.
Ajoutez l'&eacute;v&eacute;nement Page_Init &agrave; votre code.
18
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
○
Si vous codez dans Visual Basic, s&eacute;lectionnez Page Events dans la liste d&eacute;roulante sup&eacute;rieure gauche et
l'&eacute;v&eacute;nement Init dans la liste d&eacute;roulante sup&eacute;rieure droite. Le gestionnaire d'&eacute;v&eacute;nements Page_Init
sera ajout&eacute; &agrave; votre classe code-behind.
Private Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
Handles Me.Init
End Sub
○
Si vous codez en C#, saisissez le gestionnaire d'&eacute;v&eacute;nements Page_Init &agrave; l'aide de la syntaxe exacte
indiqu&eacute;e.
private void Page_Init(object sender, EventArgs e)
{
}
Remarque
Dans un Web Form C# de Visual Studio 2005 ou version suivante, les gestionnaires d'&eacute;v&eacute;nements
Page_Init, Page_Load ou Page_PreRender de la classe code-behind sont connect&eacute;s
automatiquement &agrave; l'&eacute;v&eacute;nement Init, Load ou PreRender. La signature de gestionnaire d'&eacute;v&eacute;nements
doit correspondre exactement pour pouvoir &ecirc;tre appel&eacute;e.
Cette fonctionnalit&eacute; est disponible lorsque le param&egrave;tre AutoEventWireup de la directive Page, qui se
trouve au d&eacute;but de la page ASPX en mode HTML, est d&eacute;fini sur True.
Les versions pr&eacute;c&eacute;dentes de Visual Studio .NET d&eacute;finissaient toujours la directive Page
AutoEventWireup sur False, mais dans les Web Form C# de Visual Studio 2005 ou version suivante,
la directive Page AutoEventWireup est d&eacute;finie sur True par d&eacute;faut.
2.
dans le gestionnaire d'&eacute;v&eacute;nements Page_Init de Visual Basic ou C#, ajoutez un appel &agrave; la m&eacute;thode
d'assistance ConfigureCrystalReports().
ConfigureCrystalReports()
ConfigureCrystalReports();
3.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.2.2.1.3
site Web
Pour ajouter un contr&ocirc;le CrystalReportViewer &agrave; un
Proc&eacute;dure
1.
Ouvrez la page Default.aspx.
2.
Cliquez sur le bouton Design au bas du formulaire.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
19
3.
Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
Remarque
Dans les versions pr&eacute;c&eacute;dentes de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio,
le contr&ocirc;le CrystalReportViewer apparaissait dans le nœud Crystal Reports.
4.
Faites glisser le contr&ocirc;le CrystalReportViewer sur le Web Form.
5.
Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Si vous ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application, les r&eacute;f&eacute;rences aux assemblies
SAP Crystal Reports seront automatiquement ajout&eacute;es &agrave; votre rapport.
1.2.2.1.4
Configuration du fichier Web.Config
Un fichier Web.Config dans une application Web ASP.NET stocke les param&egrave;tres globaux, tels que les
informations de connexion &agrave; la base de donn&eacute;es, les r&eacute;f&eacute;rences d'assembly et la gestion des erreurs. Ce fichier est
&eacute;crit en langage XML et son &eacute;l&eacute;ment racine doit toujours &ecirc;tre &lt;configuration&gt;. Il s'agit d'une configuration
avanc&eacute;e qui est facultative.
Les &eacute;l&eacute;ments suivants sont sp&eacute;cifiques &agrave; SAP Crystal Reports et peuvent &ecirc;tre ajout&eacute;s &agrave; votre fichier Web.Config.
Remarque
Les num&eacute;ros de version peuvent changer en fonction du produit dont vous disposez.
Remarque
Dans .NET 2.0 et versions ult&eacute;rieures, la balise section du fichier Web.Config doit utiliser la syntaxe suivante :
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;printControl&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
CrystalImageCleaner
Le processus CrystalImageCleaner supprime automatiquement les images g&eacute;n&eacute;r&eacute;es dynamiquement
rendues par le contr&ocirc;le CrystalReportViewer. Ce param&egrave;tre vous permet de d&eacute;finir l'intervalle entre les analyses
20
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
du r&eacute;pertoire d'images et l'&acirc;ge minimal des fichiers avant suppression. Cet &eacute;l&eacute;ment est automatiquement ajout&eacute;
au fichier Web.Config lorsque vous ajoutez le contr&ocirc;le CrystalReportViewer &agrave; votre site Web. Il correspond &agrave; la
classe CrystalImageCleaner.
●
CrystalImageCleaner-Sleep initialise la dur&eacute;e en millisecondes pendant laquelle le nettoyeur d'image
reste en veille avant d'analyser et de nettoyer les fichiers image dans le r&eacute;pertoire des images dynamiques.
●
CrystalImageCleaner-Age initialise l'&acirc;ge minimal d'un fichier, en millisecondes, avant sa suppression.
●
CrystalImageCleaner-AutoStart contr&ocirc;le le processus CrystalImageCleaner. Le nettoyeur d'image
nettoie les images temporaires qui sont cr&eacute;&eacute;es lors de la visualisation d'un rapport.
Remarque
Un seul nettoyeur d'image peut &ecirc;tre d&eacute;marr&eacute; dans un processus de traitement ASP.NET unique.
&lt;appSettings&gt;
&lt;add key=&quot;CrystalImageCleaner-AutoStart&quot; value=&quot;true&quot; /&gt;
&lt;add key=&quot;CrystalImageCleaner-Sleep&quot; value=&quot;60000&quot; /&gt;
&lt;add key=&quot;CrystalImageCleaner-Age&quot; value=&quot;120000&quot; /&gt;
&lt;/appSettings&gt;
CrystalImageHandler
L'&eacute;l&eacute;ment CrystalImageHandler affiche toutes les images dynamiques dans le contr&ocirc;le CrystalReportViewer.
Ce param&egrave;tre configure le processus de traitement ASP.NET pour rediriger les requ&ecirc;tes adress&eacute;es &agrave;
CrystalImageHandler.aspx vers une classe de traitement d'image interne uniquement. Si le param&egrave;tre
CrystalImageHandler ne figure pas dans votre fichier Web.Config, les images de votre site Web ne
s'afficheront pas. Cet &eacute;l&eacute;ment est automatiquement ajout&eacute; au fichier Web.Config lorsque vous ajoutez le contr&ocirc;le
CrystalReportViewer &agrave; votre site Web.
&lt;system.web&gt;
&lt;httpHandlers&gt;
&lt;add verb=&quot;GET&quot; path=&quot;CrystalImageHandler.aspx&quot;
type=&quot;CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web,
Version=13.0.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304&quot;/&gt;
&lt;/httpHandlers&gt;
&lt;/system.web&gt;
documentView
L'&eacute;l&eacute;ment documentView contr&ocirc;le l'apparence du rapport dans la trame du rapport. Deux param&egrave;tres sont
fournis :
●
Si la valeur est d&eacute;finie sur printlayout, une bordure grise s'affiche autour du rapport et une ombre port&eacute;e
s'affiche dans la trame. Il s'agit de la valeur par d&eacute;faut.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
21
●
Si la valeur est d&eacute;finie sur weblayout le rapport remplit la trame.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;documentView&quot; value=&quot;weblayout&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
EnableTextClipping
L'&eacute;l&eacute;ment EnableTextClipping contr&ocirc;le si le texte du champ est tronqu&eacute;. Une fois d&eacute;fini sur true, le texte
contenu dans un champ ne chevauchera pas le texte dans le champ situ&eacute; en regard..
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;EnableTextClipping&quot; value=&quot;true&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
globalResourcePath
L'&eacute;l&eacute;ment globalResourcePath est la r&eacute;f&eacute;rence au chemin du r&eacute;pertoire de fichiers pour les ressources
globales. Ce r&eacute;pertoire de fichiers contient vos ressources de langue personnalis&eacute;es dans un emplacement
central et peut &ecirc;tre partag&eacute; par plusieurs applications Web. Ce param&egrave;tre vous permet d'acc&eacute;der aux ressources
globales d'un site Web sp&eacute;cifique. Dans SAP CrystalReports.NET, les fichiers de ressources par d&eacute;faut ne sont
pas fournis lors de l'installation du produit, mais peuvent &ecirc;tre t&eacute;l&eacute;charg&eacute;s &agrave; partir du site Web de support
technique de SAP BusinessObjects : http://help.sap.com. Cet &eacute;l&eacute;ment doit &ecirc;tre manuellement ajout&eacute; au fichier
Web.Config de votre site Web.
&lt;appSettings&gt;
22
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&lt;add key=&quot;globalResourcePath&quot; value=&quot;c:\CrystalReportViewer_resource_files\&quot;/&gt;
&lt;/appSettings&gt;
maxNumberListOfValues
L'&eacute;l&eacute;ment maxNumberListOfValues contr&ocirc;le le nombre d'&eacute;l&eacute;ments LOV qui seront envoy&eacute;s au client. Contr&ocirc;le
le nombre de valeurs affich&eacute;es dans le panneau des param&egrave;tres. Si cette valeur est d&eacute;finie, seules les n premi&egrave;res
valeurs apparaissent dans la liste de valeurs. La bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s permet de paginer
plusieurs ensembles de valeurs en fonction de la taille de la liste et de la valeur de l'&eacute;l&eacute;ment
maxNumberListOfValues. Si vous disposez, par exemple, de 180 valeurs et que vous d&eacute;finissez l'&eacute;l&eacute;ment
maxNumberListOfValues sur 50, vous pourrez afficher les 50 premi&egrave;res valeurs du panneau des param&egrave;tres.
Vous pourrez paginer les 180 valeurs dans la bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s et afficher ainsi trois groupes
de 50 valeurs et un groupe de 30 valeurs.
Il est recommand&eacute; de d&eacute;finir syst&eacute;matiquement une valeur sup&eacute;rieure &agrave; 0. La valeur par d&eacute;faut est 200.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;maxNumberListOfValues&quot; value=&quot;50&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
printControl
L'&eacute;l&eacute;ment printControl vous permet d'imprimer le rapport directement sur votre imprimante locale. Le
r&eacute;pertoire d'installation par d&eacute;faut est C:\Program Files (x86)\SAP BusinessObjects\Crystal
Reports for .NET Framework 4.0\Common\Crystal Reports 2011\crystalreportviewers.
Ce param&egrave;tre rend le fichier .cab visible par votre site Web .NET SAP Crystal Reports. Cet &eacute;l&eacute;ment doit &ecirc;tre
manuellement ajout&eacute; au fichier Web.Config de votre site Web.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;printControl&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
23
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;printControl&gt;
&lt;add key=&quot;url&quot; value=&quot;http://localhost/PrintControl.cab&quot; /&gt;
&lt;/printControl&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
processingIndicatorDelay
L'&eacute;l&eacute;ment processingIndicatorDelay contr&ocirc;le le d&eacute;lai pr&eacute;alable &agrave; l'apparition de l'indicateur de traitement de
rapport. La valeur est sp&eacute;cifi&eacute;e en millisecondes. Le fait de d&eacute;finir cette valeur sur 0 d&eacute;sactive l'indicateur de
traitement de rapport. La valeur par d&eacute;faut est de 200 ms.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorDelay&quot; value=&quot;20&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
processingIndicatorText
L'&eacute;l&eacute;ment processingIndicatorText contr&ocirc;le le texte affich&eacute; dans l'indicateur de traitement de rapport. Le
texte par d&eacute;faut est : Veuillez patienter pendant le traitement du document.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorText&quot; value=&quot;Thank you for waiting.&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
24
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
reportMappings
L'&eacute;l&eacute;ment reportMappings met &agrave; jour les sites Web cr&eacute;&eacute;s dans Visual Studio 2003 qui utilisent des rapports
incorpor&eacute;s et les convertit en sites Web non incorpor&eacute;s lorsqu'ils sont ouverts dans Visual Studio 2005 ou version
suivante. Ce param&egrave;tre convertit le fichier .dll cr&eacute;&eacute; dans Visual Studio 2003 en fichier disque. Visual Studio 2005
et 2008 ne prennent pas en charge les sites Web incorpor&eacute;s et vous devez donc modifier votre fichier Web.Config
pour vous assurer que votre rapport sera toujours fonctionnel avec la nouvelle version de Visual Studio. Cet
&eacute;l&eacute;ment doit &ecirc;tre manuellement ajout&eacute; au fichier Web.Config de votre site Web. Le param&egrave;tre reportMappings
n&eacute;cessite un chemin absolu.
Remarque
Cet &eacute;l&eacute;ment est valide pour Visual Studio 2005 et Visual Studio 2008 uniquement.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;reportMappings&quot;
type=&quot;CrystalDecisions.Shared.ReportMappingHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;reportMappings&gt;
&lt;add reportName=&quot;World Sales Report.rpt&quot; path=&quot;C:\Report\World Sales
Report.rpt&quot; /&gt;
&lt;/reportMappings&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
resourceURI
L'&eacute;l&eacute;ment resourceURI d&eacute;finit l'emplacement du r&eacute;pertoire crystalreportviewers dans l'application Web.
Le r&eacute;pertoire crystalreportviewers contient tous les fichiers requis par le visualiseur.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;resourceURI&quot; value=&quot;~/crystalreportviewers12&quot; /&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
25
serverFileReportManager
L'&eacute;l&eacute;ment serverFileReportManager est un service Web qui &eacute;num&egrave;re les fichiers serveur situ&eacute;s sur le serveur.
Ce param&egrave;tre vous permet d'obtenir une liste d'objets (dossiers et rapports) depuis un ordinateur distant. Il a
pour valeur la racine du r&eacute;pertoire de fichiers du serveur. Dans cet exemple, la racine d&eacute;finie est c:\inetpub
\wwroot. Cet &eacute;l&eacute;ment doit &ecirc;tre manuellement ajout&eacute; au fichier Web.Config de votre site Web.
Remarque
Il correspond &agrave; la classe serverFileReportManager.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;crystalDecisions&quot;&gt;
&lt;section name=&quot;serverFileReportManager&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;crystalDecisions&gt;
&lt;serverFileReportManager&gt;
&lt;add key=&quot;rootDirectory&quot; value=&quot;c:\inetpub\wwwroot&quot; /&gt;
&lt;/serverFileReportManager&gt;
&lt;/crystalDecisions&gt;
UseAsynchronousRequests
Les requ&ecirc;tes asynchrones sont autoris&eacute;es par d&eacute;faut dans le visualiseur DHTML. Pour activer le bouton Retour
dans le navigateur afin d'utiliser le visualiseur DHTML, vous devez d&eacute;sactiver les requ&ecirc;tes asynchrones en
d&eacute;finissant ce param&egrave;tre sur false.
Remarque
Il est recommand&eacute; de ne pas d&eacute;finir l'&eacute;l&eacute;ment UseAsynchronousRequests sur false. Cette action d&eacute;sactive
en effet la bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s dans le panneau des param&egrave;tres ainsi que certaines
am&eacute;liorations au niveau de la performance du visualiseur et certaines fonctionnalit&eacute;s qui permettent
d'am&eacute;liorer l'apparence.
&lt;context-param&gt;
&lt;param-name&gt;crystal_use_asynchronous_requests&lt;/param-name&gt;
&lt;param-value&gt;false&lt;/param-value&gt;
&lt;/context-param&gt;
UseBrowserLocale
L'&eacute;l&eacute;ment UseBrowserLocale extrait les param&egrave;tres de langue de votre navigateur pour le contr&ocirc;le
CrystalReportViewer. Lorsqu'il est d&eacute;fini sur true, ce param&egrave;tre configure le contr&ocirc;le CrystalReportViewer pour
observer les param&egrave;tres r&eacute;gionaux du navigateur. Lorsqu'il est d&eacute;fini sur false, il limite les param&egrave;tres r&eacute;gionaux
26
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
qui sont affich&eacute;s page par page. Cet &eacute;l&eacute;ment doit &ecirc;tre manuellement ajout&eacute; au fichier Web.Config de votre site
Web.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;UseBrowserLocale&quot; value=&quot;true&quot; /&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
Exemple
Exemple de fichier Web.Config
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;configuration&gt;
&lt;appSettings&gt;
&lt;add key=&quot;CrystalImageCleaner-AutoStart&quot; value=&quot;true&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Sleep&quot; value=&quot;60000&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Age&quot; value=&quot;120000&quot;/&gt;
&lt;/appSettings&gt;
&lt;connectionStrings/&gt;
&lt;system.web&gt;
&lt;compilation debug=&quot;true&quot;&gt;
&lt;assemblies&gt;
&lt;add assembly=&quot;CrystalDecisions.Web, Version=13.0.2000,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.Shared, Version=13.0.2000,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.ReportSource, Version=13.0.2000,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.CrystalReports.Engine,
Version=13.0.2000, Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;/assemblies&gt;
&lt;/compilation&gt;
&lt;authentication mode=&quot;Windows&quot;/&gt;
&lt;httpHandlers&gt;
&lt;add verb=&quot;GET&quot; path=&quot;CrystalImageHandler.aspx&quot;
type=&quot;CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web,
Version=12.1.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304&quot;/&gt;
&lt;/httpHandlers&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;
Informations associ&eacute;es
Impression
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
27
Web : configuration de la localisation bas&eacute;e sur le navigateur
Web : configuration des ressources personnalis&eacute;es globales ou locales
Comment ajouter ou supprimer des r&eacute;f&eacute;rences dans Visual Studio
Versions SAP Crystal Reports
1.2.2.2
Configuration d'un projet Windows dans
Visual Studio
Cette section pr&eacute;sente des informations essentielles pour les d&eacute;veloppeurs ayant un niveau avanc&eacute; ou
interm&eacute;diaire. Elle indique les m&eacute;thodes &agrave; suivre pour cr&eacute;er et configurer un projet Windows &agrave; l'aide de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
La configuration d'un projet Windows pr&eacute;sent&eacute;e dans cette section fait appel &agrave; un mod&egrave;le de programmation
classique. Au cours de cette proc&eacute;dure, vous serez amen&eacute; &agrave; acc&eacute;der &agrave; la classe Form1 et &agrave; entrer du code. Ce
projet Windows que vous allez ainsi cr&eacute;er servira de condition pr&eacute;requise aux tutoriels de programmation
classique fournis dans cette aide en ligne.
1.2.2.2.1
Cr&eacute;ation d'un projet Windows dans Visual Studio
Proc&eacute;dure
1.
Lancez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau, puis cliquez sur Projet.
3.
Dans la bo&icirc;te de dialogue Nouveau projet, dans la liste Types de projets, s&eacute;lectionnez un dossier de langage
pour C# ou Visual Basic.
4.
Dans la liste Mod&egrave;les, cliquez sur Application Windows Forms.
5.
Dans le champ Nom, remplacez le nom de projet par d&eacute;faut par le nom de votre projet.
Respectez la convention d'affectation de noms Pascal selon laquelle la premi&egrave;re lettre du nom du projet doit
&ecirc;tre une majuscule car le nom du projet sera &eacute;galement utilis&eacute; comme nom de l'espace de noms de
l'assembly g&eacute;n&eacute;r&eacute; &agrave; partir du projet.
6.
28
Cliquez sur OK.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.2.2.2.2
Application des param&egrave;tres de projet Visual Basic
standard (facultatif)
Contexte
Pour configurer un projet Visual Basic de mani&egrave;re &agrave; pouvoir l'utiliser avec les tutoriels fournis dans cette
documentation, vous devez apporter une modification mineure &agrave; ses param&egrave;tres.
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet en gras affich&eacute;
sous le nom de la solution, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
2.
Dans la vue Propri&eacute;t&eacute;s, cliquez sur l'onglet Compiler.
3.
Dans la liste Option Strict, cliquez sur On.
4.
Fermez la vue Propri&eacute;t&eacute;s.
5.
Dans le menu Fichier, cliquez sur Enregistrer tout.
Remarque
Il est recommand&eacute; d'activer OptionStrict d&egrave;s le d&eacute;but de la cr&eacute;ation d'un projet Visual Basic. Ainsi, vous
serez tenu de respecter les conventions d'&eacute;criture du code, &agrave; savoir l'emploi de d&eacute;clarations de variables
fortement typ&eacute;es et la d&eacute;finition d'un cast valide, deux conventions qui sont v&eacute;rifi&eacute;es au moment de la
compilation du code. Cette pr&eacute;caution aide &agrave; r&eacute;duire les exceptions g&eacute;n&eacute;r&eacute;es &agrave; l'ex&eacute;cution du code.
1.2.2.2.3
1.2.2.2.3.1
Pr&eacute;paration du Windows Form dans Visual
Pour cr&eacute;er le Windows Form
Contexte
Dans les applications Visual Basic 6 pour Windows, un formulaire par d&eacute;faut est g&eacute;n&eacute;ralement toujours d&eacute;fini par
le nom Form1. Sur ce mod&egrave;le, vous cr&eacute;ez un projet Windows en lui attribuant le m&ecirc;me nom de formulaire par
d&eacute;faut, Form1, et l'extension .cs ou .vb selon le langage utilis&eacute;.
Proc&eacute;dure
1.
Si le formulaire Form1 n'est pas affich&eacute; dans la fen&ecirc;tre principale, cliquez deux fois sur Form1 dans
l'Explorateur de solutions.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
29
Le formulaire Form1 s'ouvre dans le Designer.
2.
Dans le menu Affichage, cliquez sur Code.
Le mode code de la classe Form1 s'affiche. Il varie selon que votre application Windows est &eacute;crite en langage
Visual Basic ou C#.
En langage C#, la classe Form1 affiche les &eacute;l&eacute;ments suivants :
○
La signature de classe.
○
Un constructeur (Form1).
En langage Visual Basic, la classe Form1 affiche les &eacute;l&eacute;ments suivants :
○
La signature de classe (classe Form1).
Remarque
Des m&eacute;thodes et variables suppl&eacute;mentaires de la classe Form1 sont contenues dans une classe
&quot;partielle&quot; s&eacute;par&eacute;e. (Ceci vaut pour C# et Visual Basic.) Les classes partielles sont expliqu&eacute;es
ult&eacute;rieurement dans Configuration d'un projet Windows.
1.2.2.2.3.2
Pour ajouter une m&eacute;thode d'assistance priv&eacute;e
pour le code de configuration de SAP Crystal Reports
Proc&eacute;dure
1.
Ajoutez &agrave; cette classe Form1 une nouvelle m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e
ConfigureCrystalReports(), sans valeur renvoy&eacute;e.
Private Sub ConfigureCrystalReports()
End Sub
private void ConfigureCrystalReports()
{
}
Ajoutez ensuite un gestionnaire d'&eacute;v&eacute;nements Form_Load, puis ins&eacute;rez un appel de la m&eacute;thode
ConfigureCrystalReports() dans le gestionnaire d'&eacute;v&eacute;nements Form_Load. La m&eacute;thode
ConfigureCrystalReports() s'ex&eacute;cutera ainsi automatiquement lors du chargement du formulaire.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur Form1.
Vous repassez en mode code. Comme vous avez cliqu&eacute; deux fois sur Form1, un gestionnaire d'&eacute;v&eacute;nements
Form1_Load est automatiquement g&eacute;n&eacute;r&eacute; dans la classe Form1.
4.
Dans le gestionnaire d'&eacute;v&eacute;nements Form1_Load, saisissez un appel &agrave; la m&eacute;thode
ConfigureCrystalReports().
ConfigureCrystalReports()
30
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ConfigureCrystalReports();
5.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.2.2.2.4
Ajout d'un contr&ocirc;le CrystalReportViewer
1.2.2.2.4.1
Pour ajouter un contr&ocirc;le CrystalReportViewer &agrave;
une application Windows
Proc&eacute;dure
1.
Ouvrez un Windows Form dans l'onglet Conception.
2.
Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
Remarque
Dans les versions pr&eacute;c&eacute;dentes de Visual Studio, le contr&ocirc;le CrystalReportViewer apparaissait dans le
nœud Crystal Reports.
3.
Faites glisser le contr&ocirc;le CrystalReportViewer sur le formulaire.
4.
Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Si vous ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application, les r&eacute;f&eacute;rences aux assemblies
SAP Crystal Reports seront automatiquement ajout&eacute;es &agrave; votre rapport.
1.2.2.2.4.2
Pour ajouter des instructions Imports et Using
aux espaces de noms de r&eacute;f&eacute;rence
Proc&eacute;dure
1.
Si le dossier R&eacute;f&eacute;rences n'est pas affich&eacute; dans l'Explorateur de solutions, cliquez sur Afficher tous les fichiers
dans la barre d'outils de l'Explorateur de solutions afin d'afficher tous les fichiers de projet.
2.
Dans l'Explorateur de solutions, d&eacute;veloppez le dossier R&eacute;f&eacute;rences.
3.
V&eacute;rifiez que les assemblies SAP Crystal Reports suivantes ont &eacute;t&eacute; ajout&eacute;es :
○
CrystalDecisions.CrystalReports.Engine
○
CrystalDecisions.Shared
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
31
4.
S&eacute;lectionnez Form1, puis dans le menu Affichage, cliquez sur Code.
5.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au
d&eacute;but de la classe contenant les espaces de noms SAP Crystal Reports suivants.
Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
1.3
Principes fondamentaux du SDK
1.3.1
1.3.1.1
Architecture
Choisir le mod&egrave;le d'objet correct pour votre projet
Pour choisir le mod&egrave;le d'objet appropri&eacute; &agrave; votre projet, vous devez comprendre les conventions relatives &agrave;
l'utilisation du contr&ocirc;le CrystalReportViewer, ainsi que la mani&egrave;re dont ce contr&ocirc;le interagit avec les autres
mod&egrave;les d'objet.
Remarque
Dans cette documentation, un mod&egrave;le d'objet fait r&eacute;f&eacute;rence &agrave; une classe principale et aux classes qui lui sont
associ&eacute;es, le tout formant un mod&egrave;le de programmation. Dans SAP Crystal Reports, ces mod&egrave;les d'objet sont
ax&eacute;s sur une classe principale qui encapsule un fichier de d&eacute;finition de rapport. Cette classe principale et le
mod&egrave;le d'objet associ&eacute; permettent d'interagir avec le rapport en le programmant.
Conventions relatives &agrave; l'utilisation du contr&ocirc;le CrystalReportViewer
Une application Web efficace &eacute;tablit une s&eacute;paration nette entre sa couche pr&eacute;sentation et sa couche logique
m&eacute;tier sous-jacente.
La structure du contr&ocirc;le ASP.NET va naturellement dans le sens de ce mod&egrave;le de conception. Il encapsule les
informations de pr&eacute;sentation dans le contr&ocirc;le, puis lie ce contr&ocirc;le &agrave; un objet ou un mod&egrave;le d'objet sous-jacent qui
cr&eacute;e la logique m&eacute;tier.
CrystalReportViewer est un contr&ocirc;le .NET conforme &agrave; cette architecture. Il fonctionne comme un objet
d'affichage dans le Web Form ou le Windows Form (couche pr&eacute;sentation) et peut &ecirc;tre li&eacute; &agrave; n'importe lequel des
mod&egrave;les d'objet suivants :
●
Mod&egrave;le d'objet ReportDocument
●
Mod&egrave;le d'objet ReportClientDocument (Report Application Server)
32
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Mod&egrave;le d'objet InfoObject (fourni avec SAP Crystal Reports Server ou la plateforme SAP BusinessObjects
Business Intelligence)
Dans un sc&eacute;nario qui respecte les conventions, le contr&ocirc;le CrystalReportViewer se lie &agrave; l'un des mod&egrave;les d'objet
qui cr&eacute;ent la logique m&eacute;tier, g&eacute;n&eacute;ralement pour la manipulation des rapports.
Dans ce sc&eacute;nario, l'interaction par programmation du contr&ocirc;le CrystalReportViewer se limite &agrave; modifier les
param&egrave;tres d'affichage (masquer ou afficher la barre d'outils du visualiseur ou l'un des boutons qui la composent
par exemple).
Mod&egrave;le d'objet CrystalReportViewer
Le contr&ocirc;le CrystalReportViewer contient des propri&eacute;t&eacute;s et des m&eacute;thodes qui permettent d'interagir sur la
mani&egrave;re dont ce dernier affiche les rapports. Il comporte &eacute;galement un petit nombre de propri&eacute;t&eacute;s et de
m&eacute;thodes qui permettent d'interagir avec les rapports auxquels il est li&eacute;. Ces propri&eacute;t&eacute;s et m&eacute;thodes constituent
un mod&egrave;le d'objet limit&eacute;.
Certains sc&eacute;narios de liaison de rapports font appel au mod&egrave;le d'objet CrystalReportViewer. Dans ces sc&eacute;narios,
le contr&ocirc;le CrystalReportViewer est directement li&eacute; &agrave; un rapport (en indiquant le chemin d'acc&egrave;s au rapport dans
un r&eacute;pertoire de fichiers par exemple) sans avoir pr&eacute;alablement encapsul&eacute; ce rapport dans un mod&egrave;le d'objet.
Dans ce cas, &eacute;tant donn&eacute; que le contr&ocirc;le CrystalReportViewer encapsule directement le rapport, vous devez
utiliser son mod&egrave;le d'objet limit&eacute; pour interagir avec le rapport.
Toutefois, dans la plupart des sc&eacute;narios de liaison de rapports, l'utilisation de CrystalReportViewer en tant que
mod&egrave;le d'objet est d&eacute;conseill&eacute;e. Il est pr&eacute;f&eacute;rable de faire appel au mod&egrave;le d'objet ReportDocument pour les
raisons suivantes :
●
Le mod&egrave;le d'objet CrystalReportViewer peut engendrer des conflits entre mod&egrave;les d'objet. Ne m&eacute;langez pas
le mod&egrave;le d'objet CrystalReportViewer avec d'autres mod&egrave;les d'objet.
●
Le mod&egrave;le d'objet CrystalReportViewer ne permet qu'une interaction limit&eacute;e avec les rapports. Il ne contient
que quelques-uns unes des fonctionnalit&eacute;s disponibles dans le mod&egrave;le d'objet ReportDocument.
●
Dans le mod&egrave;le d'objet CrystalReportViewer, la s&eacute;paration entre la couche pr&eacute;sentation et la logique m&eacute;tier
sous-jacente n'est pas clairement &eacute;tablie.
Mod&egrave;le d'objet ReportDocument
ReportDocument est un mod&egrave;le d'objet plus puissant et plus complet que CrystalReportViewer. Il fait partie du
SDK de Crystal Reports .NET et permet une manipulation &eacute;tendue du code des rapports.
Quel mod&egrave;le d'objet utiliser ?
Si vous n'envisagez pas de mise &agrave; niveau vers SAP Crystal Reports Server ou vers la plateforme SAP
BusinessObjects Business Intelligence, il est recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument pour vos
t&acirc;ches de d&eacute;veloppement avec le SDK de SAP Crystal Reports.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
33
Remarque
Dans SAP Crystal Reports 10 ou versions ult&eacute;rieures et dans SAP Crystal Reports pour Visual Studio 2005 et
versions ult&eacute;rieures, le mod&egrave;le d'objet ReportDocument a &eacute;t&eacute; associ&eacute; au mod&egrave;le d'objet
ReportClientDocument pour faciliter la mise &agrave; niveau vers une solution de reporting g&eacute;r&eacute;e.
1.3.1.2
Eviter de m&eacute;langer les mod&egrave;les d'objet
Ne m&eacute;langez pas le mod&egrave;le d'objet CrystalReportViewer avec d'autres mod&egrave;les d'objet.
Utilis&eacute; en tant que mod&egrave;le d'objet limit&eacute;, CrystalReportViewer fonctionne correctement, &agrave; condition qu'il soit
directement li&eacute; au rapport par le biais du chemin d'acc&egrave;s &agrave; ce dernier.
En revanche, si vous encapsulez le rapport dans un autre mod&egrave;le d'objet (tel que ReportDocument ou
ReportClientDocument), puis si vous liez le contr&ocirc;le &agrave; ce mod&egrave;le d'objet, n'utilisez plus le mod&egrave;le d'objet
CrystalReportViewer. Le mod&egrave;le d'objet fourni par le contr&ocirc;le CrystalReportViewer devient alors redondant par
rapport au mod&egrave;le d'objet plus puissant auquel il est li&eacute;. Par ailleurs, les param&egrave;tres appliqu&eacute;s au mod&egrave;le d'objet
CrystalReportViewer sont visibles par l'autre mod&egrave;le d'objet, ce qui peut engendrer des comportements
inattendus et des exceptions.
Supposons que vous utilisiez le mod&egrave;le d'objet ReportDocument pour exporter ou imprimer un rapport mensuel &agrave;
partir du serveur. Si vous avez d&eacute;fini un param&egrave;tre de mois dans ce rapport &agrave; l'aide du mod&egrave;le d'objet
CrystalReportViewer, il se peut que vous rencontriez des probl&egrave;mes. Le mod&egrave;le d'objet ReportDocument ne peut
pas voir les param&egrave;tres appliqu&eacute;s dans le mod&egrave;le d'objet CrystalReportViewer. Il tente d'exporter ou d'imprimer le
rapport sans avoir connaissance du param&egrave;tre de mois d&eacute;fini, et affiche ensuite le mauvais mois ou g&eacute;n&egrave;re une
exception.
La meilleure solution consiste donc &agrave; limiter l'utilisation du contr&ocirc;le CrystalReportViewer aux param&egrave;tres
d'affichage du rapport uniquement lorsque ce contr&ocirc;le a &eacute;t&eacute; li&eacute; &agrave; l'un des mod&egrave;les d'objet sous-jacents.
1.3.1.3
SAP Crystal Reports Designer incorpor&eacute;
Le SAP Crystal Reports Designer incorpor&eacute; permet de cr&eacute;er ou de modifier des rapports. Il se compose d'une
interface utilisateur graphique pour la conception de rapports en WYSIWYG et d'une s&eacute;rie d'experts con&ccedil;us pour
simplifier la connectivit&eacute; entre les donn&eacute;es, leur tri, leur regroupement et d'autres op&eacute;rations complexes de
conception de rapports. SAP Crystal Reports Developer contient une version am&eacute;lior&eacute;e du concepteur incorpor&eacute;
qui permet de cr&eacute;er des rapports et des applications de reporting performants. Le concepteur incorpor&eacute; inclus
dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio contient plusieurs fonctionnalit&eacute;s
pr&eacute;sentes dans SAP Crystal Reports Designer.
R&ocirc;le du SAP Crystal Reports Designer incorpor&eacute; dans l'architecture
Le SAP Crystal Reports Designer incorpor&eacute; est inclus dans la description de l'architecture, car il joue un r&ocirc;le
primordial dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio : il permet en effet de
34
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
cr&eacute;er les fichiers de rapport &agrave; afficher. Toutefois, le SAP Crystal Reports Designer incorpor&eacute; n'intervient qu'au
moment de la conception. L'interaction avec les rapports et leur affichage, qui interviennent au moment de
l'ex&eacute;cution, sont assur&eacute;s par le SDK de SAP Crystal Reports. Par cons&eacute;quent, si le concepteur incorpor&eacute; permet
de cr&eacute;er des rapports qui sont utilis&eacute;s dans l'architecture, il ne fait pas partie de l'architecture elle-m&ecirc;me.
Informations associ&eacute;es
Utilisation du SAP Crystal Reports Designer incorpor&eacute; [page 647]
1.3.1.4
Contr&ocirc;les du visualiseur de rapports
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio inclut des contr&ocirc;les de format standard
pour l'affichage des rapports. Chaque contr&ocirc;le encapsule des informations complexes li&eacute;es &agrave; la pr&eacute;sentation des
rapports dans un objet GUI, dans la bo&icirc;te &agrave; outils.
Deux contr&ocirc;les sont fournis :
Le contr&ocirc;le CrystalReportViewer.
Ce contr&ocirc;le affiche le rapport en utilisant une pr&eacute;sentation de type page,
avec la possibilit&eacute; de naviguer entres les pages.
Le contr&ocirc;le
CrystalReportPartsViewer.
Ce contr&ocirc;le affiche les informations de r&eacute;sum&eacute; sur le rapport dans une
petite fen&ecirc;tre de type portail, avec la possibilit&eacute; d'explorer le rapport en
profondeur par le biais d'une s&eacute;rie de parties li&eacute;es.
Pour afficher un rapport, il suffit de faire glisser le contr&ocirc;le de la bo&icirc;te &agrave; outils vers le Web Form ou le Windows
Form, puis d'affecter la propri&eacute;t&eacute; ReportSource de ce contr&ocirc;le &agrave; un rapport.
Informations associ&eacute;es
Comment utiliser les contr&ocirc;les visualiseur de rapports ? [page 43]
1.3.1.5
Mod&egrave;les d'objet
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, inclut un SDK qui contient deux mod&egrave;les
d'objets. Avec un suppl&eacute;ment de licence, le SDK peut &ecirc;tre &eacute;tendu &agrave; quatre mod&egrave;les d'objet.
Les contr&ocirc;les du visualiseur de rapports fournissent le point d'entr&eacute;e dans le SDK. Cela est d&ucirc; au fait que le
visualiseur de rapports affiche les rapports en les liant &agrave; un objet de rapport. Tous les mod&egrave;les d'objet contenus
dans le SDK exposent et manipulent des objets de rapport.
Chaque mod&egrave;le d'objet offre un degr&eacute; de puissance et de complexit&eacute; croissant :
●
Le mod&egrave;le d'objet le plus simple est CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
35
Le contr&ocirc;le CrystalReportViewer d'un Web Form ou d'un Windows Form poss&egrave;de par d&eacute;finition une classe
sous-jacente du m&ecirc;me nom. Cette classe CrystalReportViewer expose les propri&eacute;t&eacute;s et les m&eacute;thodes qui
permettent de modifier la fonctionnalit&eacute; d'affichage du contr&ocirc;le et d'interagir avec les classes qui g&egrave;rent les
connexions &agrave; la base de donn&eacute;es, les param&egrave;tres et les formules de s&eacute;lection. Cet ensemble de classes
constitue le mod&egrave;le d'objet le plus simple. La classe CrystalReportViewer se pr&eacute;sente sous deux formes
diff&eacute;rentes : l'une dans un espace de noms Windows et l'autre dans un espace de noms Web. De nombreux
&eacute;l&eacute;ments de ce mod&egrave;le d'objet se retrouvent par cons&eacute;quent en double dans les deux espaces de noms, avec
certaines diff&eacute;rences propres aux plates-formes Windows et Web.
Les classes de ce mod&egrave;le d'objet sont contenues dans l'espace de noms CrystalDecisions.Web pour la
version Web Form de ce contr&ocirc;le, et dans l'espace de noms CrystalDecisions.Windows pour la version
Windows Form du contr&ocirc;le.
●
ReportDocument est un mod&egrave;le d'objet plus complet.
La classe ReportDocument constitue une passerelle vers un ensemble de classes contenues dans l'espace
de noms Engine et qui incluent Database, DataDefinition, ExportOptions, PrintOptions,
ReportDefinition, ReportOptions et SummaryInfo. Il s'agit d'un ensemble complet de classes qui offre
des fonctionnalit&eacute;s plus puissantes de personnalisation et d'interaction avec le rapport.
Les classes de ce mod&egrave;le d'objet sont contenues dans l'espace de noms
CrystalDecisions.CrystalReports.Engine.
●
Les mod&egrave;les d'objet suivants sont disponibles par le biais d'une mise &agrave; niveau :
○
ReportClientDocument, mod&egrave;le d'objet offrant des fonctionnalit&eacute;s de modification de rapport plus
avanc&eacute;es.
Cette classe sert de passerelle vers un mod&egrave;le d'objet plus volumineux constitu&eacute; de nombreuses classes
contenues dans plusieurs espaces de noms. Elle expose la structure du rapport dans son int&eacute;gralit&eacute; via le
SDK, ce qui permet de cr&eacute;er ou de modifier par programmation chaque aspect du rapport au moment de
l'ex&eacute;cution.
Les classes de ce mod&egrave;le d'objet sont contenues dans le groupe d'espaces de noms
CrystalDecisions.ReportAppServer.
Le mod&egrave;le d'objet ReportClientDocument est fourni avec un RAS (Report Application Server) qui
n&eacute;cessite l'acquisition d'une licence suppl&eacute;mentaire. Un Report Application Server est fourni avec
SAP Crystal Reports Server et la plateforme SAP BusinessObjects Business Intelligence.
○
InfoObject, un mod&egrave;le d'objet complet pour interagir avec les fonctions de niveau plateforme de
SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence est
&eacute;galement disponible. Ce mod&egrave;le est fourni avec la licence SAP Crystal Reports Server ou de plateforme
SAP BusinessObjects Business Intelligence.
Cette classe sert de passerelle vers le mod&egrave;le d'objet de plateforme complet de
SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.
Les classes de ce mod&egrave;le d'objet sont contenues dans le groupe d'espaces de noms
CrystalDecisions.Enterprise.
Remarque
Le mod&egrave;le d'objet InfoObject est fourni uniquement avec SAP Crystal Reports Server et la plateforme
SAP BusinessObjects Business Intelligence, qui n&eacute;cessitent l'acquisition d'une licence suppl&eacute;mentaire.
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
36
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Comparaison des solutions de reporting de SAP BusinessObjects Business Intelligence [page 66]
1.3.1.5.1
Mod&egrave;le d'objet CrystalReportViewer
La classe CrystalReportViewer a deux r&ocirc;les :
●
Dans un Web Form ou un Windows Form, la classe CrystalReportViewer est expos&eacute;e comme un contr&ocirc;le .NET
et peut &ecirc;tre ajout&eacute;e au formulaire pour afficher un rapport. Pour avoir des informations sp&eacute;cifiques sur le r&ocirc;le
de cette classe en tant que contr&ocirc;le .NET, voir Contr&ocirc;les du visualiseur de rapports [page 35].
●
Dans le code sous-jacent du Web Form ou du Windows Form, la classe CrystalReportViewer fournit le mod&egrave;le
d'objet le plus simple du SDK. Ce mod&egrave;le d'objet sera examin&eacute; plus loin dans cette section.
La mani&egrave;re la plus simple d'ins&eacute;rer un rapport dans un Web Form ou Windows Form consiste &agrave; ajouter le contr&ocirc;le
CrystalReportViewer au formulaire, puis, dans la classe code-behind, &agrave; affecter &agrave; la propri&eacute;t&eacute; ReportSource de la
classe CrystalReportViewer le chemin d'acc&egrave;s au rapport sous forme de cha&icirc;ne.
En affectant le chemin du rapport directement au contr&ocirc;le (plut&ocirc;t que de placer le rapport dans un mod&egrave;le d'objet
plus complexe tel que ReportDocument ou ReportClientDocument), vous limitez l'interface au mod&egrave;le d'objet le
plus simple : CrystalReportViewer.
Comparaison de mod&egrave;les d'objet CrystalReportViewer
CrystalReportViewer poss&egrave;de deux diagrammes de mod&egrave;le d'objet, car le m&ecirc;me nom de classe et de contr&ocirc;le (et
par cons&eacute;quent son mod&egrave;le d'objet sous-jacent) est utilis&eacute; pour les applications Windows et Web. Ainsi, le mod&egrave;le
d'objet CrystalReportViewer se r&eacute;p&egrave;te-t-il (&agrave; quelques diff&eacute;rences pr&egrave;s) dans deux espaces de noms diff&eacute;rents.
La version Windows du mod&egrave;le d'objet CrystalReportViewer comporte les principales classes et les principaux
&eacute;v&eacute;nements partag&eacute;s par les versions Windows et Web du mod&egrave;le d'objet.
La version Web du mod&egrave;le d'objet CrystalReportViewer contient les m&ecirc;mes classes et &eacute;v&eacute;nements que la version
Windows, auxquels s'ajoutent les &eacute;v&eacute;nements suivants relatifs au mode de chargement des pages ASPX.
Informations associ&eacute;es
Contr&ocirc;les du visualiseur de rapports [page 35]
Liaison de rapports &agrave; l'aide du mod&egrave;le d'objet CrystalReportViewer [page 172]
1.3.1.5.2
Mod&egrave;le d'objet ReportDocument
La classe ReportDocument fournit un mod&egrave;le d'objet plus complet pour le SDK que le mod&egrave;le d'objet
CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
37
La classe ReportDocument fait partie de l'espace de noms CrystalDecisions.CrystalReports.Engine.
Elle sert de passerelle vers un ensemble de classes contenues dans l'espace de noms Engine, ce qui offre une
palette d'outils de programmation plus large pour manipuler un rapport.
Mod&egrave;le d'objet ReportDocument
Dans la section pr&eacute;c&eacute;dente, vous avez appris &agrave; utiliser le mod&egrave;le d'objet de base CrystalReportViewer en
affectant directement au contr&ocirc;le CrystalReportViewer le chemin d'acc&egrave;s &agrave; un rapport.
Au niveau suivant, vous allez utiliser le mod&egrave;le d'objet ReportDocument pour encapsuler le rapport dans une
instance de ReportDocument avant de l'affecter au contr&ocirc;le. Vous acc&eacute;dez ainsi au mod&egrave;le d'objet plus
complexe et puissant fourni par ReportDocument.
Remarque
Etant donn&eacute; que les mod&egrave;les d'objet CrystalReportViewer et ReportDocument sont tous deux impliqu&eacute;s
dans ce processus (le premier pour charger et afficher le rapport, le second pour encapsuler et manipuler le
rapport), il est fr&eacute;quent de confondre leur r&ocirc;le respectif. Une fois le rapport encapsul&eacute; &agrave; l'aide du mod&egrave;le
d'objet ReportDocument, toutes les manipulations portant sur le rapport doivent &ecirc;tre limit&eacute;es &agrave; ce mod&egrave;le. Si
vous essayez d'utiliser les propri&eacute;t&eacute;s et les m&eacute;thodes de CrystalReportViewer pour manipuler le rapport,
les deux mod&egrave;les d'objet entrent en conflit et se comportent de mani&egrave;re impr&eacute;visible.
Une fois que vous avez ajout&eacute; un mod&egrave;le d'objet, limitez l'utilisation du code de CrystalReportViewer &agrave; la
d&eacute;finition des propri&eacute;t&eacute;s d'affichage.
ReportDocument et ReportClientDocument (RAS)
Dans SAP Crystal Reports 9, ces deux mod&egrave;les &eacute;taient compl&egrave;tement s&eacute;par&eacute;s. Dans SAP Crystal Reports 10 et
versions ult&eacute;rieures, cette s&eacute;paration essentielle entre les deux mod&egrave;les d'objet a &eacute;t&eacute; supprim&eacute;e. Le mod&egrave;le
d'objet ReportDocument fonctionne d&eacute;sormais comme un proxy vers un sous-ensemble de fonctionnalit&eacute;s &agrave;
partir du mod&egrave;le d'objet ReportClientDocument.
SAP Crystal Reports 2008 permet d'acc&eacute;der &agrave; une version limit&eacute;e du mod&egrave;le d'objet ReportClientDocument
via la propri&eacute;t&eacute; ReportDocument.ReportClientDocument.
Informations associ&eacute;es
Tutoriels du mod&egrave;le d'objet ReportDocument [page 340]
Cette section pr&eacute;sente divers tutoriels bas&eacute;s sur le mod&egrave;le d'objet ReportDocument.
Liaison de rapports &agrave; l'aide du mod&egrave;le d'objet ReportDocument [page 200]
Mod&egrave;le d'objet CrystalReportViewer [page 37]
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
38
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.3.1.5.3
Mod&egrave;le d'objet ReportClientDocument (RAS)
ReportClientDocument est le mod&egrave;le d'objet le plus puissant et le plus complet pour manipuler les rapports. Ce
mod&egrave;le d'objet n'est fourni qu'avec un RAS (Report Application Server), disponible sous la forme d'un RAS
BusinessObjects Enterprise g&eacute;r&eacute; ou non g&eacute;r&eacute;.
Le mod&egrave;le d'objet ReportClientDocument est constitu&eacute; de nombreuses classes contenues dans divers espaces
de noms. Chaque espace de noms a pour pr&eacute;fixe CrystalDecisions.ReportAppServer. Ce mod&egrave;le d'objet
expose la structure du rapport dans son int&eacute;gralit&eacute; dans le SDK. Ainsi, vous pouvez cr&eacute;er et modifier par
programmation chaque aspect du rapport au moment de l'ex&eacute;cution, ainsi qu'en enregistrer les modifications.
Une instance de ReportClientDocument comprend un rapport qui peut &ecirc;tre modifi&eacute; par programmation en
fonction de ses propri&eacute;t&eacute;s de classe. Ces propri&eacute;t&eacute;s sont li&eacute;es &agrave; une s&eacute;rie d'autres biblioth&egrave;ques dans le SDK qui
contiennent des contr&ocirc;leurs, des mod&egrave;les de d&eacute;finition de donn&eacute;es et des mod&egrave;les de d&eacute;finition de rapport :
●
ReportDefinition correspond &agrave; la pr&eacute;sentation du rapport, tel qu'indiqu&eacute; dans le
●
DataDefinition correspond &agrave; l'Explorateur de champs dans le SAP Crystal Reports Designer.
●
RowsetController correspond aux valeurs de donn&eacute;es trait&eacute;es de chaque ligne de d&eacute;tails, lors de la
SAP Crystal Reports Designer.
visualisation du rapport au moment de l'ex&eacute;cution.
Les instances de ReportClientDocument peuvent &ecirc;tre des instanciations :
●
d'un fichier .rpt existant charg&eacute; &agrave; partir d'un r&eacute;pertoire, puis modifi&eacute; avec les classes de d&eacute;finition de rapport
et de d&eacute;finition de donn&eacute;es du SDK ReportClientDocument ;
●
d'un nouveau rapport enti&egrave;rement vide cr&eacute;&eacute; avec les classes de d&eacute;finition de rapport et de d&eacute;finition de
donn&eacute;es du SDK ReportClientDocument.
Cette instance de classe ReportClientDocument peut &ecirc;tre charg&eacute;e uniquement durant le temps n&eacute;cessaire
pour transmettre l'instance au visualiseur pour affichage, avant qu'elle ne soit mise hors de port&eacute;e. Toutefois,
vous pouvez &eacute;galement modifier l'instance de classe, puis l'enregistrer en tant que rapport (.rpt) dans un
r&eacute;pertoire avec l'une des classes du contr&ocirc;leur.
Pour obtenir des informations d&eacute;taill&eacute;es sur le mod&egrave;le d'objet ReportClientDocument, consultez la
documentation du SDK .NET RAS de SAP BusinessObjects.
ReportClientDocument dans SAP Crystal Reports 9
Avec l'application SAP Crystal Reports 9 (version Advanced) fournie avec le RAS non g&eacute;r&eacute; et les assemblys
RAS .NET, il &eacute;tait n&eacute;cessaire de programmer le mod&egrave;le d'objet ReportClientDocument. Les d&eacute;veloppeurs
pouvaient ainsi cr&eacute;er des projets .NET qui exploitaient le mod&egrave;le d'objet ReportClientDocument.
Toutefois, cela impliquait &eacute;galement que les projets initialement cr&eacute;&eacute;s avec le mod&egrave;le d'objet ReportDocument
fourni avec SAP Crystal Reports devaient &ecirc;tre int&eacute;gralement reprogramm&eacute;s pour &ecirc;tre utilis&eacute;s avec le mod&egrave;le
d'objet ReportClientDocument inclus dans le RAS. Cela tenait au fait que les deux mod&egrave;les d'objet &eacute;taient
compl&egrave;tement s&eacute;par&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
39
ReportClientDocument dans SAP Crystal Reports 10 et versions ult&eacute;rieures
Dans SAP Crystal Reports 10, cette s&eacute;paration essentielle entre les deux mod&egrave;les d'objet a &eacute;t&eacute; supprim&eacute;e. Pour
ce faire, le mod&egrave;le d'objet ReportDocument a &eacute;t&eacute; r&eacute;&eacute;crit de fa&ccedil;on &agrave; ce qu'il fonctionne comme un proxy vers un
sous-ensemble de fonctionnalit&eacute;s &agrave; partir du mod&egrave;le d'objet ReportClientDocument. Les classes du mod&egrave;le
d'objet ReportDocument exposent les m&ecirc;mes signatures de propri&eacute;t&eacute; et de m&eacute;thode qu'avant, mais la
fonctionnalit&eacute; sous-jacente a &eacute;t&eacute; modifi&eacute;e de mani&egrave;re &agrave; rediriger chaque propri&eacute;t&eacute; et chaque m&eacute;thode vers les
propri&eacute;t&eacute;s et les m&eacute;thodes du mod&egrave;le d'objet ReportClientDocument plus puissant.
Cela ne signifie pas pour autant qu'une version de base de SAP Crystal Reports Developer offre un acc&egrave;s int&eacute;gral
&agrave; un serveur RAS non g&eacute;r&eacute; ou au mod&egrave;le d'objet ReportClientDocument. La version de base de
SAP Crystal Reports permet toujours de n'acc&eacute;der qu'au mod&egrave;le d'objet ReportDocument (m&ecirc;me si le mod&egrave;le
d'objet ReportDocument fonctionne comme un proxy vers un sous-ensemble du mod&egrave;le d'objet
ReportClientDocument). Le moteur de cr&eacute;ation de rapports d'origine fourni dans les pr&eacute;c&eacute;dentes versions de
SAP Crystal Reports a &eacute;t&eacute; remplac&eacute; par une version limit&eacute;e et incorpor&eacute;e du moteur de cr&eacute;ation de rapports RAS.
Vous ne pouvez installer le mod&egrave;le d'objet ReportClientDocument et y acc&eacute;der directement qu'en acqu&eacute;rant
une licence mise &agrave; niveau du serveur RAS non g&eacute;r&eacute;. A ce stade, tout le code correspondant au mod&egrave;le d'objet
ReportDocument peut &ecirc;tre facilement redirig&eacute; vers le serveur RAS distinct en d&eacute;finissant deux propri&eacute;t&eacute;s de
n'importe quelle instance de rapport donn&eacute;e, et le mod&egrave;le d'objet ReportClientDocument sous-jacent est
d&eacute;sormais accessible directement, lorsque vous l'extrayez de la propri&eacute;t&eacute; de la classe ReportDocument.
1.3.1.5.4
Mod&egrave;le d'objet InfoObject (BOE)
Le mod&egrave;le d'objet InfoObject est fourni avec les mises &agrave; niveau de SAP Crystal Reports Server et de la plateforme
SAP BusinessObjects Business Intelligence.
Remarque
Pour en savoir plus, voir Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65].
InfoObject offre un mod&egrave;le d'objet de niveau plateforme pour le SDK. InfoObject fonctionne comme une
classe de base dans laquelle de nombreux objets Enterprise sont encapsul&eacute;s dans des classes d&eacute;riv&eacute;es. La
classe d&eacute;riv&eacute;e qui repr&eacute;sente les rapports est la classe CrystalDecisions.Enterprise.Desktop.Report.
Le SDK de la plateforme SAP BusinessObjects Business Intelligence est construit autour de la classe d'objet
InfoObject et des classes assurant sa prise en charge.
Classe InfoObject
La classe InfoObject est utilis&eacute;e dans le SDK pour repr&eacute;senter un large &eacute;ventail d'entit&eacute;s d'informations. Cela
inclut &agrave; la fois des entit&eacute;s physiques, telles que des fichiers de rapport ou des fichiers PDF, et des entit&eacute;s du
r&eacute;seau, telles que les utilisateurs, les serveurs ou les connexions FTP.
40
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
La classe InfoObject est une classe de base pour de nombreuses classes &eacute;tendues correspondant &agrave; ces entit&eacute;s
d'informations de fa&ccedil;on plus d&eacute;taill&eacute;e. Les classes &eacute;tendues qui h&eacute;ritent d'InfoObject sont les suivantes :
Report, User, Server, Folder, Program, Ftp, Smtp, Word, Excel et Pdf.
La manipulation des instances de classes &eacute;tendues et de classes InfoObject vous permet de cr&eacute;er une application
cliente ou une application de bureau.
Classes assurant la prise en charge
Deux autres classes prennent en charge la classe InfoObject.
La classe InfoStore La classe InfoStore fait office de contr&ocirc;leur, ou passerelle, vers le r&eacute;f&eacute;rentiel CMS (Central
Management Server) (qui est une base de donn&eacute;es), o&ugrave; sont stock&eacute;es toutes les instances
d'InfoObject. La classe InfoStore est utilis&eacute;e pour instancier, extraire et valider toutes les
instances de classe InfoObject stock&eacute;es dans le r&eacute;f&eacute;rentiel CMS.
La classe index&eacute;e
InfoObjects
La classe index&eacute;e InfoObjects contient plusieurs instances d'InfoObject. Elle est utilis&eacute;e par
InfoStore pour d&eacute;placer les instances InfoObject vers et depuis le r&eacute;f&eacute;rentiel CMS.
La classe Infostore ne peut pas g&eacute;rer directement les instances InfoObject. Elles doivent &ecirc;tre d'abord encapsul&eacute;es
dans la classe index&eacute;e InfoObjects. Par le biais de cette classe index&eacute;e, chaque instance d'InfoObject peut &ecirc;tre
ajout&eacute;e, extraite, mise &agrave; jour ou planifi&eacute;e.
Remarque
Pour en savoir plus sur le SDK de SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects
Business Intelligence, consultez la documentation correspondante.
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
1.3.1.6
Comparaison des architectures dans les solutions de
reporting SAP Business Intelligence
Quatre solutions de reporting SAP Business Intelligence sont disponibles :
●
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio
●
SAP Crystal Reports Developer
●
Report Application Server non g&eacute;r&eacute; (RAS)
●
SAP Crystal Reports Server ou plateforme SAP BusinessObjects Business Intelligence
Une diff&eacute;rence d'architecture fondamentale entre chaque solution de reporting repose sur la fa&ccedil;on dont le moteur
de rapport est plac&eacute; et impl&eacute;ment&eacute;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
41
D&eacute;finition du moteur de rapport
Le moteur de rapport est une composante essentielle de chaque solution de reporting. Il traite toutes les
demandes utilisateur et g&eacute;n&egrave;re en sortie les informations concernant les rapports.
La capacit&eacute; maximale de traitement simultan&eacute; des demandes utilisateur varie d'une solution &agrave; l'autre. Dans
certaines solutions, elle est conditionn&eacute;e par la conception de l'architecture ou par les licences.
Les autres pi&egrave;ces ma&icirc;tresses de chaque solution de reporting sont les suivantes :
●
le fichier de d&eacute;finition de rapport (.rpt) ;
●
la source de donn&eacute;es ;
●
le visualiseur de rapports ;
●
le SDK ;
●
Une structure de plateforme (qui figure dans SAP Crystal Reports Server ou la plateforme SAP
BusinessObjects Business Intelligence).
Interaction du moteur de rapport avec les autres pi&egrave;ces ma&icirc;tresses
Le moteur de rapport utilise le fichier de d&eacute;finition de rapport (.rpt) comme mod&egrave;le. Il extrait ensuite les donn&eacute;es
de la source de donn&eacute;es et utilise la d&eacute;finition de rapport pour fournir le rendu du rapport demand&eacute;, puis le
transmet au visualiseur de rapports. Les informations re&ccedil;ues du visualiseur ou cod&eacute;es &agrave; l'aide du SDK d'interface
d&eacute;clenchent des traitements suppl&eacute;mentaires de la part du moteur de rapport qui ex&eacute;cute d'autres op&eacute;rations sur
le rapport.
Diff&eacute;rences de configuration du moteur de rapport entre les solutions de
reporting SAP Business Intelligence
●
Le moteur de rapport est incorpor&eacute;.
Dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, le moteur de rapport est
incorpor&eacute; dans l'application.
La capacit&eacute; maximale de traitement simultan&eacute; de ce moteur de rapport incorpor&eacute; est limit&eacute;e &agrave; trois
demandes utilisateur. Cela n'est pas d&ucirc; &agrave; une limite de licence arbitraire, mais &agrave; une restriction li&eacute;e &agrave;
l'architecture du moteur de rapport incorpor&eacute;.
●
Le moteur de rapport est extrait dans un processus serveur de rapports distinct.
Dans la solution qui fait appel au Report Application Server (RAS) non g&eacute;r&eacute;, le moteur de rapport est extrait
dans un processus serveur distinct. Ce processus serveur peut s'ex&eacute;cuter sur le m&ecirc;me ordinateur ou &ecirc;tre
plac&eacute; sur un ordinateur distinct de mani&egrave;re &agrave; augmenter les performances en d&eacute;chargeant le traitement de
votre serveur d'applications. Le serveur RAS non g&eacute;r&eacute; n'est plus disponible en tant qu'option de mise &agrave;
niveau. Il est recommand&eacute; d'effectuer &agrave; la place une mise &agrave; niveau vers SAP Crystal Reports Server. Pour en
savoir plus, voir Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65].
●
Le processus serveur de rapports distinct est encapsul&eacute; dans une architecture de plateforme compl&egrave;te.
Dans la solution SAP Crystal Reports Server ou de plateforme SAP BusinessObjects Business Intelligence,
une architecture de plateforme compl&egrave;te, qui encapsule le processus serveur de rapports distinct (RAS), a
&eacute;t&eacute; ajout&eacute;e. Le Report Application Server (RAS) g&eacute;r&eacute; devient alors un simple serveur, parmi les nombreux
42
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
autres serveurs qui constituent l'architecture de plateforme. Ce type d'architecture offre une large palette de
fonctionnalit&eacute;s suppl&eacute;mentaires, telles que la planification, l'&eacute;quilibrage des charges, le basculement et une
&eacute;volutivit&eacute; &agrave; la fois verticale et horizontale.
1.3.2
Contr&ocirc;le CrystalReportViewer
Pour afficher un rapport Crystal, vous devez ajouter un contr&ocirc;le CrystalReportViewer &agrave; votre application. Le
contr&ocirc;le CrystalReportViewer permet de lier et d'afficher des rapports dans le .NET Framework. Le contr&ocirc;le
CrystalReportViewer par d&eacute;faut inclut des &eacute;l&eacute;ments d'interface utilisateur pour vous aider &agrave; afficher, enregistrer
et parcourir un rapport.
Les deux contr&ocirc;le CrystalReportViewer les plus fr&eacute;quemment utilis&eacute;s sont le contr&ocirc;le CrystalReportViewer pour
les applications Windows, auquel on acc&egrave;de via la classe
CrystalDecisions.Windows.Forms.CrystalReportViewer, et le contr&ocirc;le CrystalReportViewer pour les
sites Web, auquel on acc&egrave;de via la classe CrystalDecisions.Web.CrystalReportViewer. Pour en savoir
plus, voir la R&eacute;f&eacute;rence de l'API .NET SAP Crystal Reports.
Remarque
Un contr&ocirc;le CrystalReportViewer n'est n&eacute;cessaire que si vous avez l'intention d'afficher des rapports Crystal.
Personnalisation du contr&ocirc;le CrystalReportViewer
En fonction de votre application, vous pouvez modifier certains &eacute;l&eacute;ments du contr&ocirc;le par d&eacute;faut.
SAP Crystal Reports vous permet de personnaliser l'aspect et la convivialit&eacute; du visualiseur dans votre application
de diff&eacute;rentes mani&egrave;res, notamment :
●
La barre d'outils CrystalReportViewer peut &ecirc;tre supprim&eacute;e du visualiseur.
●
Les boutons de la barre d'outils CrystalReportViewer peuvent &ecirc;tre ajout&eacute;s ou supprim&eacute;s par programmation.
●
Le contr&ocirc;le CrystalReportViewer prend en charge la personnalisation via la CSS ou Th&egrave;mes.
Informations associ&eacute;es
Personnalisation du contr&ocirc;le CrystalReportViewer [page 225]
Visualisation d'un rapport [page 165]
1.3.2.1
Comment utiliser les contr&ocirc;les visualiseur de
rapports ?
Les contr&ocirc;les visualiseur de rapports sont des contr&ocirc;les .NET qui peuvent &ecirc;tre ajout&eacute;s &agrave; un formulaire dans une
application Web ou Windows pour afficher des rapports dans ce formulaire.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
43
Lorsque vous envisagez de g&eacute;n&eacute;rer une application &agrave; l'aide du SDK de SAP Crystal Reports, l'un des points les
plus importants &agrave; d&eacute;terminer concerne l'utilisation des contr&ocirc;les visualiseur de rapports. Conna&icirc;tre les principes
fondamentaux du SDK qui influencent ces contr&ocirc;les vous aidera &agrave; choisir la structure la mieux adapt&eacute;e &agrave; votre
projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
D&eacute;finition des contr&ocirc;les .NET
Les contr&ocirc;les Microsoft .NET forment une classe particuli&egrave;re de contr&ocirc;les qui s'affichent dans la bo&icirc;te &agrave; outils
Visual Studio. Ils sont ajout&eacute;s &agrave; un Web Form ou un Windows Form en tant qu'objets GUI et h&eacute;ritent des
caract&eacute;ristiques d'une classe de contr&ocirc;les de base commune. Les contr&ocirc;les .NET classiques sont notamment
Button, DropDownList, CheckBox, TextBox ou DataGrid.
Les contr&ocirc;les Microsoft .NET respectent la convention selon laquelle la couche pr&eacute;sentation doit &ecirc;tre s&eacute;par&eacute;e de
la couche logique m&eacute;tier. Les informations d'affichage sont encapsul&eacute;es dans le contr&ocirc;le lui-m&ecirc;me dans le
Web Form ou le Windows Form. Dans la classe code-behind, le contr&ocirc;le .NET est instanci&eacute; en tant qu'instance de
niveau classe. Cette variable d'instance permet d'acc&eacute;der aux propri&eacute;t&eacute;s, m&eacute;thodes et &eacute;v&eacute;nements du contr&ocirc;le.
Les contr&ocirc;les Microsoft .NET sont identiques d'un point de vue fonctionnel pour les Windows Forms comme pour
les Web Forms. Le .NET Framework permet de visualiser chaque page Web sous la forme d'un formulaire
contenant des contr&ocirc;les, comme dans une application Windows.
Pourquoi SAP Crystal Reports utilise-t-il des contr&ocirc;les .NET pour la
visualisation des rapports ?
L'un des avantages des outils de cr&eacute;ation de rapports tient au fait qu'ils encapsulent toutes les op&eacute;rations
complexes li&eacute;es &agrave; la structure, &agrave; la conception et au rendu des rapports dans un outil GUI tr&egrave;s simple. De la m&ecirc;me
mani&egrave;re, les contr&ocirc;les .NET encapsulent des op&eacute;rations complexes d'affichage et de remplissage de donn&eacute;es
dans un objet GUI simple dans un Web Form ou un Windows Form.
L'utilisation de contr&ocirc;les .NET permet de regrouper les op&eacute;rations complexes d'affichage et de cr&eacute;ation de
rapports. Toutes les informations complexes li&eacute;es aux rapports, qui &eacute;taient auparavant encapsul&eacute;es uniquement
dans l'application SAP Crystal Reports autonome, sont d&eacute;sormais encapsul&eacute;es dans un contr&ocirc;le .NET comme
visualiseur de rapports.
Combien y a t'il de contr&ocirc;les visualiseur de rapports ?
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio contient deux versions du contr&ocirc;le
CrystalReportViewer : une pour les applications Web et l'autre pour les applications Windows. Le contr&ocirc;le
CrystalReportViewer, situ&eacute; dans l'espace de noms CrystalDecisions.Web, est utilis&eacute; par les projets Web ASP.NET.
Le contr&ocirc;le CrystalReportViewer, situ&eacute; dans l'espace de noms CrystalDecisions.Windows.Forms, est utilis&eacute; par
les projets Windows.
Le contr&ocirc;le CrystalReportPartsViewer permet d'afficher seulement quelques parties des rapports dans une page
Web.
44
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Affichage d'un rapport &agrave; l'aide du contr&ocirc;le CrystalReportViewer
Le contr&ocirc;le CrystalReportViewer n'affiche qu'un rapport &agrave; la fois. Le rapport affich&eacute; par le contr&ocirc;le d&eacute;pend du
rapport que vous avez li&eacute; &agrave; votre code. Pour indiquer au contr&ocirc;le le rapport qu'il doit afficher, vous devez lier sa
propri&eacute;t&eacute; ReportSource &agrave; un rapport particulier. Au moment de l'ex&eacute;cution, le contr&ocirc;le charge le rapport li&eacute; &agrave; sa
propri&eacute;t&eacute; ReportSource et l'affiche.
Dans sa forme la plus simple, l'affectation se pr&eacute;sente de la mani&egrave;re suivante :
crystalReportViewer1.ReportSource = &quot;C:\WorldSalesReport.rpt&quot;
crystalReportViewer1.ReportSource = &quot;C:\\WorldSalesReport.rpt&quot;;
Dans cet exemple, le rapport est li&eacute; au contr&ocirc;le directement &agrave; partir de son chemin d'acc&egrave;s au r&eacute;pertoire de
fichiers.
Il s'agit de la mani&egrave;re la plus &eacute;l&eacute;mentaire de lier un rapport au contr&ocirc;le CrystalReportViewer.
Est-ce le cas du contr&ocirc;le CrystalReportViewer ?
Non. Le contr&ocirc;le CrystalReportViewer se lie &agrave; un objet de rapport et non &agrave; un objet de donn&eacute;es.
En fait, le r&ocirc;le du contr&ocirc;le CrystalReportViewer est diff&eacute;rent de celui des autres contr&ocirc;les .NET. Les autres
contr&ocirc;les .NET se lient aux donn&eacute;es et mettent en forme les donn&eacute;es brutes sur la page. Dans la mesure o&ugrave; le
composant SAP Crystal Reports Designer incorpor&eacute; effectue cette op&eacute;ration automatiquement chaque fois qu'il
cr&eacute;e un rapport (qui, par d&eacute;finition, encapsule l'extraction et l'affichage des donn&eacute;es), le contr&ocirc;le
CrystalReportViewer n'intervient que dans l'affichage d'un objet de rapport.
Le tableau suivant effectue une comparaison entre la liaison &agrave; un contr&ocirc;le de donn&eacute;es .NET par rapport &agrave; la liaison
&agrave; un contr&ocirc;le CrystalReportViewer.
Type de contr&ocirc;le
Se lie &agrave;
Connectivit&eacute; &agrave; la couche suivante
Contr&ocirc;le de donn&eacute;es .NET (tel que
le contr&ocirc;le DataGrid)
un objet de donn&eacute;es (DataSet, Data&shy; Aucun
Reader, DataView, IDictionary, ICol&shy;
lection, DataTable).
Contr&ocirc;le visualiseur de rap&shy;
un objet de rapport (qui encapsule
ports .NET (tel que le contr&ocirc;le Crys&shy; un fichier de rapport Crystal).
talReportViewer)
La connectivit&eacute; entre donn&eacute;es est
int&eacute;gr&eacute;e au fichier de rapport Crys&shy;
tal, ce qui permet une connexion &agrave;
diverses sources de donn&eacute;es, telles
que ODBC et OleDb, ainsi qu'aux
objets DataReader et DataSet.
Pour vous aider &agrave; vous souvenir qu'un contr&ocirc;le CrystalReportViewer se lie &agrave; un objet de rapport et non &agrave; un objet
de donn&eacute;es, la propri&eacute;t&eacute; source du contr&ocirc;le visualiseur de rapports s'appelle ReportSource (et non DataSource).
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
45
Liaison de rapports automatique
Le contr&ocirc;le CrystalReportViewer se distingue &eacute;galement de la plupart des autres contr&ocirc;les .NET en ce sens qu'il
est inutile d'appeler manuellement une m&eacute;thode de liaison pour effectuer une liaison. Ce contr&ocirc;le lie en effet
automatiquement le visualiseur de rapports &agrave; l'objet de rapport.
Informations associ&eacute;es
Visualisation d'un rapport [page 165]
1.3.2.1.1
Pour ajouter un contr&ocirc;le CrystalReportViewer &agrave; une
application Windows
Proc&eacute;dure
1.
Ouvrez un Windows Form dans l'onglet Conception.
2.
Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
Remarque
Dans les versions pr&eacute;c&eacute;dentes de Visual Studio, le contr&ocirc;le CrystalReportViewer apparaissait dans le
nœud Crystal Reports.
3.
Faites glisser le contr&ocirc;le CrystalReportViewer sur le formulaire.
4.
Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Si vous ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application, les r&eacute;f&eacute;rences aux assemblies
SAP Crystal Reports seront automatiquement ajout&eacute;es &agrave; votre rapport.
1.3.2.1.2
site Web
Pour ajouter un contr&ocirc;le CrystalReportViewer &agrave; un
Proc&eacute;dure
1.
46
Ouvrez la page Default.aspx.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
Cliquez sur le bouton Design au bas du formulaire.
3.
Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
Remarque
Dans les versions pr&eacute;c&eacute;dentes de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio,
le contr&ocirc;le CrystalReportViewer apparaissait dans le nœud Crystal Reports.
4.
Faites glisser le contr&ocirc;le CrystalReportViewer sur le Web Form.
5.
Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Si vous ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application, les r&eacute;f&eacute;rences aux assemblies
SAP Crystal Reports seront automatiquement ajout&eacute;es &agrave; votre rapport.
1.3.2.1.3
Liaison du contr&ocirc;le CrystalReportViewer &agrave; un
fichier sur disque
Contexte
La mani&egrave;re la plus simple de lier un contr&ocirc;le CrystalReportViewer &agrave; un rapport Crystal est de d&eacute;finir la propri&eacute;t&eacute;
ReportSource sur un emplacement du disque. Ce rapport non incorpor&eacute; est affich&eacute; lors de l'ex&eacute;cution de
l'application.
Cette op&eacute;ration lie le rapport directement au contr&ocirc;le. Toutes les interactions par programmation avec le rapport
doivent &ecirc;tre effectu&eacute;es dans le mod&egrave;le d'objet limit&eacute; CrystalReportViewer.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; l'application Windows ou au site Web.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
D&eacute;finissez la propri&eacute;t&eacute; ReportSource sur l'emplacement du rapport sur votre syst&egrave;me de fichiers local.
○
Lors de l'utilisation d'une application Windows Form ou d'un site Web :
myCrystalReportViewer.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\MyReport.rpt&quot;;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
47
○
Lors de l'utilisation d'une application WPF :
myCrystalReportViewer.ViewerCore.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ViewerCore.ReportSource = &quot;C:\\MyReport.rpt&quot;;
1.3.2.2
Panneau T&acirc;ches guid&eacute;es
Dans Visual Studio 2005 ou versions ult&eacute;rieures, lorsque vous ajoutez un contr&ocirc;le .NET &agrave; un Web Form ou un
Windows Form, le panneau des t&acirc;ches guid&eacute;es s'affiche. Il s'agit d'un petit panneau fix&eacute; dans l'angle sup&eacute;rieur
droit du contr&ocirc;le .NET. Il contient des cases &agrave; cocher et des listes d&eacute;roulantes qui permettent aux d&eacute;veloppeurs
de s&eacute;lectionner des options de connectivit&eacute; et d'autres types d'option pour le contr&ocirc;le. Cette fonctionnalit&eacute; r&eacute;duit
consid&eacute;rablement le temps consacr&eacute; par le d&eacute;veloppeur &agrave; l'&eacute;criture du code.
Dans un site Web, les s&eacute;lections effectu&eacute;es dans le panneau des t&acirc;ches guid&eacute;es g&eacute;n&egrave;rent automatiquement du
code XML dans la page ASPX.
Dans un projet Windows, les s&eacute;lections effectu&eacute;es dans le panneau des t&acirc;ches guid&eacute;es g&eacute;n&egrave;rent
automatiquement du code dans un fichier de classe masqu&eacute;. Ce fichier de classe masqu&eacute; est une classe
&quot;partielle&quot; qui sert d'addenda &agrave; la classe Windows Form existante. Les classes partielles sont une nouvelle
fonctionnalit&eacute; de .NET Framework version 2.0.
Le panneau T&acirc;ches guid&eacute;es permet de lier rapidement et facilement le contr&ocirc;le CrystalReportViewer au contr&ocirc;le
CrystalReportSource. Lorsque vous ajoutez le contr&ocirc;le CrystalReportViewer &agrave; la page, le panneau des t&acirc;ches
guid&eacute;es s'affiche automatiquement en indiquant une s&eacute;rie d'&eacute;tapes permettant de cr&eacute;er et de configurer le
contr&ocirc;le CrystalReportSource.
Le contr&ocirc;le CrystalReportViewer fait tr&egrave;s fr&eacute;quemment appel au panneau des t&acirc;ches guid&eacute;es. Les s&eacute;lections
accessibles dans ce panneau diff&egrave;rent selon que vous travaillez sur un projet Web ou sur un projet Windows.
Limites des t&acirc;ches guid&eacute;es avec le mod&egrave;le de programmation all&eacute;g&eacute;e
Les t&acirc;ches guid&eacute;es facilitent l'utilisation d'un mod&egrave;le de programmation all&eacute;g&eacute;e qui g&eacute;n&egrave;re le code
automatiquement plut&ocirc;t que d'avoir &agrave; l'&eacute;crire manuellement.
L'auto-g&eacute;n&eacute;ration du code permet, au premier abord, de gagner du temps mais il est ensuite difficile de passer
d'un mode de codage all&eacute;g&eacute; &agrave; un mode classique lorsque vous voulez rendre un projet plus puissant ou flexible.
1.3.2.2.1
Panneau des t&acirc;ches guid&eacute;es CrystalReportViewer
pour projets Windows
Le panneau des t&acirc;ches guid&eacute;es CrystalReportViewer pour projets Windows permet de cr&eacute;er, de s&eacute;lectionner
ou de modifier un rapport Crystal. Il offre &eacute;galement la possibilit&eacute; de personnaliser le contr&ocirc;le
CrystalReportViewer.
48
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Le panneau des t&acirc;ches guid&eacute;es pour projets Windows comporte les fonctionnalit&eacute;s suivantes :
Cr&eacute;er un rapport Crystal...
Cette commande de menu permet de cr&eacute;er un rapport &agrave; l'aide du composant SAP Crystal Reports Designer
incorpor&eacute;.
Une fois l'op&eacute;ration termin&eacute;e, le code du rapport est g&eacute;n&eacute;r&eacute; automatiquement de mani&egrave;re &agrave; lier ce dernier au
contr&ocirc;le CrystalReportViewer pour un affichage imm&eacute;diat.
Modifier le rapport Crystal actuel
Cette commande de menu permet de modifier plus en d&eacute;tail le rapport qui a &eacute;t&eacute; s&eacute;lectionn&eacute; ou cr&eacute;&eacute; pour la
source de rapport.
Choisir un rapport Crystal
Cette commande de menu vous permet de s&eacute;lectionner un rapport Crystal ou un objet ReportDocument en tant
que source de rapport du contr&ocirc;le CrystalReportViewer.
Une fois l'op&eacute;ration termin&eacute;e, le code du rapport est g&eacute;n&eacute;r&eacute; automatiquement de mani&egrave;re &agrave; lier ce dernier au
contr&ocirc;le CrystalReportViewer pour un affichage imm&eacute;diat.
Effacer la source du rapport
Cette commande de menu efface la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
Choisissez une vue du volet des outils :
Cette commande de menu permet de s&eacute;lectionner le volet des outils &agrave; afficher par d&eacute;faut lors du chargement du
rapport. Vous pouvez s&eacute;lectionner l'arborescence des groupes ou le panneau des param&egrave;tres ou encore choisir
de laisser vide le volet des outils.
Afficher la barre d'outils
Cette case &agrave; cocher permet d'afficher ou de masquer la barre d'outils du contr&ocirc;le CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
49
Afficher la barre d'&eacute;tat
Cette case &agrave; cocher permet d'afficher ou de masquer la barre d'&eacute;tat dans le contr&ocirc;le CrystalReportViewer.
Annuler l'ancrage dans le conteneur parent
Cette commande de menu permet de d&eacute;finir la propri&eacute;t&eacute; Dock sur &quot;None&quot; ou sur &quot;Fill&quot;. Par d&eacute;faut, lorsqu'un
contr&ocirc;le CrystalReportViewer est plac&eacute; dans un Windows Form, la propri&eacute;t&eacute; Dock est d&eacute;finie sur &quot;Fill&quot;. Si cette
commande de menu est s&eacute;lectionn&eacute;e et si la propri&eacute;t&eacute; Dock est d&eacute;finie sur &quot;None&quot;, le contr&ocirc;le
CrystalReportViewer peut &ecirc;tre d&eacute;plac&eacute; et redimensionn&eacute; dans le Windows Form ou dans d'autres conteneurs
(contr&ocirc;le Panel dans un Windows Form par exemple).
1.3.2.2.2
Panneau des t&acirc;ches guid&eacute;es CrystalReportViewer
pour sites Web
Le panneau des t&acirc;ches guid&eacute;es CrystalReportViewer pour sites Web permet de cr&eacute;er, de s&eacute;lectionner ou de
modifier un rapport Crystal. Il offre &eacute;galement la possibilit&eacute; de personnaliser le contr&ocirc;le CrystalReportViewer et
d'activer la consignation des erreurs li&eacute;es aux connexions &agrave; la base de donn&eacute;es et aux valeurs de param&egrave;tre.
Le panneau des t&acirc;ches guid&eacute;es pour sites Web comporte les fonctionnalit&eacute;s suivantes :
S&eacute;lection de la source du rapport
Cette liste d&eacute;roulante permet de s&eacute;lectionner n'importe quelle source de rapport existante ou d'en cr&eacute;er une
nouvelle.
Une fois l'op&eacute;ration termin&eacute;e, le code du rapport est g&eacute;n&eacute;r&eacute; automatiquement de mani&egrave;re &agrave; lier ce dernier au
contr&ocirc;le CrystalReportViewer pour un affichage imm&eacute;diat.
Configurer la source de rapport...
Cette commande de menu permet de configurer plus en d&eacute;tail la source de rapport qui a &eacute;t&eacute; s&eacute;lectionn&eacute;e ou
cr&eacute;&eacute;e.
Modifier le rapport...
Cette commande de menu permet de modifier plus en d&eacute;tail le rapport qui a &eacute;t&eacute; s&eacute;lectionn&eacute; ou cr&eacute;&eacute; pour la
source de rapport.
50
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Choisissez une vue du volet des outils :
Cette commande de menu permet de s&eacute;lectionner le volet des outils &agrave; afficher par d&eacute;faut lors du chargement du
rapport. Vous pouvez s&eacute;lectionner l'arborescence des groupes ou le panneau des param&egrave;tres ou encore choisir
de laisser vide le volet des outils.
Activer la barre d'outils
Cette case &agrave; cocher permet d'afficher ou de masquer la barre d'outils du contr&ocirc;le CrystalReportViewer.
Activer la vue de rapport
Cette case &agrave; cocher permet d'afficher ou de masquer la vue de rapport dans le contr&ocirc;le CrystalReportViewer.
Remarque
Vous pouvez d&eacute;sactiver la vue de rapport si vous souhaitez utiliser l'arborescence des groupes seule dans un
Web Form.
Activer l'invite de connexion &agrave; la base de donn&eacute;es
Cette case &agrave; cocher permet d'activer ou de d&eacute;sactiver la consignation des erreurs li&eacute;es aux connexions &agrave; la base
de donn&eacute;es. Lorsqu'un rapport ne fournit pas toutes les informations n&eacute;cessaires &agrave; sa connexion &agrave; une base de
donn&eacute;es SQL Server, le message d'erreur &quot;Echec de la connexion&quot; est renvoy&eacute;. Toutefois, si la case &agrave; cocher est
activ&eacute;e, une fen&ecirc;tre vous invitant &agrave; saisir les informations de connexion requises s'affiche.
Activer l'invite de saisie de param&egrave;tre
Cette case &agrave; cocher permet d'activer ou de d&eacute;sactiver la consignation des erreurs li&eacute;es aux valeurs de param&egrave;tre.
Lorsqu'un rapport ne fournit pas toutes les informations n&eacute;cessaires pour d&eacute;signer un param&egrave;tre utilis&eacute; dans des
crit&egrave;res de s&eacute;lection, le message d'erreur &quot;Valeurs de param&egrave;tres manquantes&quot; est renvoy&eacute;. Toutefois, si la case
&agrave; cocher est activ&eacute;e, une fen&ecirc;tre vous invitant &agrave; saisir les informations requises sur le param&egrave;tre s'affiche.
R&eacute;utiliser la valeur des param&egrave;tres lors de l'actualisation du rapport
Cette case &agrave; cocher permet d'activer ou de d&eacute;sactiver la persistance des param&egrave;tres lors de l'actualisation des
rapports. Lorsque cette case &agrave; cocher est activ&eacute;e, les valeurs de param&egrave;tre transmises &agrave; un rapport lors de son
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
51
premier chargement son rendues persistantes. En revanche lorsqu'elle est d&eacute;sactiv&eacute;e, vous devez &eacute;crire du code
pour que les valeurs de param&egrave;tre soient transmises au rapport lors de chaque actualisation ult&eacute;rieure.
Informations associ&eacute;es
Panneau des t&acirc;ches guid&eacute;es CrystalReportViewer pour projets Windows [page 48]
1.3.2.3
Contr&ocirc;le CrystalReportPartsViewer
Dans le .NET Framework, le contr&ocirc;le CrystalReportPartsViewer permet de lier et d'afficher un rapport
Crystal sous la forme d'une s&eacute;rie de parties li&eacute;es. Ceci r&eacute;duit consid&eacute;rablement la zone requise pour afficher les
informations du rapport et est id&eacute;al pour afficher de petites quantit&eacute;s d'informations sur une page Web du portail.
Remarque
Les parties de rapport sont utilis&eacute;es uniquement dans les sites Web ; elles ne sont pas disponibles pour les
projets Windows.
Le contr&ocirc;le CrystalReportPartsViewer a &eacute;t&eacute; am&eacute;lior&eacute; pour prendre en charge la structure des composants
WebPart, une infrastructure de portail introduite avec la version 2.0 d'ASP.NET.
La structure des composants WebPart permet aux d&eacute;veloppeurs d'encapsuler des contr&ocirc;les de la page au sein de
composants WebPart configurables.
Informations associ&eacute;es
Tutoriel : Affichage de parties de rapport &agrave; l'aide du contr&ocirc;le CrystalReportPartsViewer [page 499]
Dans ce tutoriel, vous allez apprendre &agrave; diviser le rapport en plusieurs parties et &agrave; afficher chaque partie en
cliquant sur une s&eacute;rie de liens hypertexte successifs.
1.3.2.4
Contr&ocirc;le CrystalReportSource
Le contr&ocirc;le CrystalReportSource est un &eacute;l&eacute;ment du mod&egrave;le de d&eacute;veloppement d'applications avec balises fourni
avec ASP.NET version 2.0.
Remarque
Le contr&ocirc;le CrystalReportSource n'est disponible que pour les sites Web.
Dans la structure de contr&ocirc;le DataSource, les contr&ocirc;les .NET visuels se connectent aux contr&ocirc;les DataSource non
visuels (contr&ocirc;les qui ne g&egrave;rent pas les informations d'affichage). Cette nouvelle structure DataSource encapsule
52
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
les informations de connectivit&eacute; des donn&eacute;es &eacute;crites sous forme de lignes de code dans les contr&ocirc;les .NET ins&eacute;r&eacute;s
dans le Web Form.
Dans la fen&ecirc;tre Design, Visual Studio affiche le nom des contr&ocirc;les connect&eacute;s les uns aux autres.
Les fournisseurs de donn&eacute;es .NET poss&egrave;dent leur propre impl&eacute;mentation du contr&ocirc;le DataSource. Par exemple,
le contr&ocirc;le SqlDataSource acc&egrave;de &agrave; Microsoft SQL Server, tandis que le contr&ocirc;le OracleDataSource acc&egrave;de &agrave;
Oracle.
En ce qui concerne SAP Crystal Reports, le contr&ocirc;le est impl&eacute;ment&eacute; en tant que contr&ocirc;le CrystalReportSource.
Cette conception s'inspire de la conception d'ASP.NET version 1.0 dans laquelle le contr&ocirc;le CrystalReportViewer
contient une propri&eacute;t&eacute; ReportSource au lieu d'une propri&eacute;t&eacute; DataSource plus classique.
La diff&eacute;rence entre le contr&ocirc;le CrystalReportSource et le contr&ocirc;le DataSource r&eacute;side dans le fait que le premier
contient un rapport qui encapsule les donn&eacute;es, tandis que le second (tel que SqlDataSource) contient les donn&eacute;es
elles-m&ecirc;mes.
1.3.3
Quelle m&eacute;thode de persistance utiliser avec
SAP Crystal Reports ?
Lorsque vous envisagez de g&eacute;n&eacute;rer une application Web &agrave; l'aide du SDK de SAP Crystal Reports, l'un des points
les plus importants &agrave; prendre en consid&eacute;ration concerne la m&eacute;thode de persistance que vous allez utiliser.
Qu'est ce que la persistance ?
Les pages Web ne conservent ni le statut ni les informations d'identification d'un utilisateur lorsqu'il se connecte &agrave;
un site Web. Chaque page Web est demand&eacute;e &agrave; partir d'un serveur, envoy&eacute;e &agrave; l'utilisateur et le processus s'arr&ecirc;te
l&agrave;. Cela fonctionne tant qu'il est question de lire des donn&eacute;es texte, mais devient probl&eacute;matique lorsqu'il s'agit de
concevoir une application Web qui doit conserver les informations sur un utilisateur au fur et &agrave; mesure que les
pages sont recharg&eacute;es et redirig&eacute;es.
La persistance fait r&eacute;f&eacute;rence &agrave; l'utilisation d'un m&eacute;canisme qui conserve le statut de chaque utilisateur (tel que la
page de rapport actuelle visualis&eacute;e par chaque utilisateur) ind&eacute;pendamment du fait que les pages sont recharg&eacute;es
et redirig&eacute;es.
Conventions relatives &agrave; la persistance
Cette section d&eacute;crit les conventions utilis&eacute;es pour rendre persistantes des modifications apport&eacute;es &agrave; un rapport
Crystal dans une page Web tandis que ce rapport est actualis&eacute; au cours du rechargement de la page Web. Ces
changements peuvent aller du plus simple, comme acc&eacute;der &agrave; la page suivante apr&egrave;s que l'utilisateur a cliqu&eacute; sur
le bouton Page suivante du visualiseur de rapports, au plus complexe, comme afficher des donn&eacute;es
compl&egrave;tement diff&eacute;rentes apr&egrave;s modification des param&egrave;tres d'un rapport.
La persistance doit s'appliquer &agrave; ce qui suit :
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
53
●
Le contr&ocirc;le CrystalReportViewer.
●
le rapport li&eacute; au contr&ocirc;le CrystalReportViewer.
Comment assurer la persistance du statut dans les applications ASP et
ASP.NET
Dans les applications ASP et ASP.NET classiques, la persistance du statut est assur&eacute;e soit par le navigateur Web,
soit par le serveur Web comme indiqu&eacute; dans le tableau suivant.
Environnement
Client ou serveur ?
Nom
M&eacute;thode
ASP*
Navigateur client
Champs de formulaire
Transmet des paires nom/
valeur au fil des pages
Web par le biais de
champs de soumission de
formulaire.
ASP*
Navigateur client
Arguments URL
Transmet des paires nom/
valeur au fil des pages
Web par le biais d'argu&shy;
ments URL.
ASP*
Navigateur client
Cookie
Affecte des paires nom/
valeur &agrave; un cookie sur le
navigateur client, puis ex&shy;
trait le cookie dans une
nouvelle page.
ASP*
Serveur Web
Objet Session
Affecte des objets instan&shy;
ci&eacute;s &agrave; l'objet Session sur le
serveur, puis extrait le
contenu de cet objet Ses&shy;
sion dans une nouvelle
page.
ASP*
Serveur Web
Objet Application
Affecte des objets instan&shy;
ci&eacute;s &agrave; l'objet Application
sur le serveur, puis extrait
le contenu de cet objet Ap&shy;
plication dans une nou&shy;
velle page.
ASP.NET
Navigateur client
Objet ViewState
Affecte des valeurs de
cha&icirc;ne &agrave; l'objet ViewState
du Web Form ASP.NET.
ASP.NET
Serveur Web
Objet Cache
Identique &agrave; l'objet Applica&shy;
tion, mais avec des fonc&shy;
tionnalit&eacute;s avanc&eacute;es.
* Toutes les m&eacute;thodes de persistance ASP continuent &agrave; fonctionner dans ASP.NET.
54
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Quelles sont les m&eacute;thodes de persistance les mieux adapt&eacute;es &agrave;
SAP Crystal Reports ?
Les m&eacute;thodes de persistance les mieux adapt&eacute;es &agrave; SAP Crystal Reports sont ViewState, Session et Cache.
Informations associ&eacute;es
ViewState et persistance du mod&egrave;le d'objet CrystalReportViewer [page 55]
1.3.3.1
ViewState et persistance du mod&egrave;le d'objet
CrystalReportViewer
D&eacute;finition de ViewState
ViewState est une m&eacute;thode bas&eacute;e sur le navigateur utilis&eacute;e dans ASP.NET pour rendre persistant le statut de
visualisation, c'est-&agrave;-dire le Web Form. Sa fonction principale consiste &agrave; assurer la persistance des contr&ocirc;les Web.
Les contr&ocirc;les Web (&eacute;galement appel&eacute;s contr&ocirc;les serveur Web) sont calqu&eacute;s sur les contr&ocirc;les Windows introduits
dans Visual Basic. Les contr&ocirc;les Windows sont des objets contenus dans le formulaire qui encapsulent une partie
de fonctionnalit&eacute; d'affichage telle qu'un champ de texte, un bouton ou une table de donn&eacute;es.
Les contr&ocirc;les Web sont semblables aux contr&ocirc;les Windows. Tout comme les contr&ocirc;les Windows, ils agissent sur
deux niveaux : dans la page Web et dans la classe code-behind qui prend en charge cette page Web. Tout comme
les contr&ocirc;les classiques des Windows Forms, les contr&ocirc;les Web encapsulent des parties discr&egrave;tes de
fonctionnalit&eacute;s d'affichage dans des objets GUI : Button, TextField, DropDownList, DataGrid, etc. Dans la classe
code-behind, ces m&ecirc;mes contr&ocirc;les sont semblables aux classes qui exposent les propri&eacute;t&eacute;s et les m&eacute;thodes.
Une page Web se distingue d'un Windows Form par le fait qu'il s'agit d'un environnement sans statut. Il est donc
n&eacute;cessaire de recourir &agrave; un m&eacute;canisme de persistance afin de pr&eacute;server le statut de la page Web au fil de ses
rechargements successifs.
ViewState conserve le statut des contr&ocirc;les d'une page Web de la m&ecirc;me mani&egrave;re que Session pour les objets
instanci&eacute;s sur le serveur.
Remarque
ViewState conserve automatiquement le statut de tous les contr&ocirc;les Web. Pour cela, ViewState doit stocker
chaque contr&ocirc;le bas&eacute; sur la propri&eacute;t&eacute; EnableViewState du contr&ocirc;le (auquel la valeur True a &eacute;t&eacute; attribu&eacute;e par
d&eacute;faut).
Etant donn&eacute; que ViewState stocke le statut des donn&eacute;es &agrave; partir des contr&ocirc;les Web de la page, l'objet ViewState
doit &ecirc;tre inclus int&eacute;gralement dans la page lorsque cette derni&egrave;re est transf&eacute;r&eacute;e du navigateur vers le serveur
Web et vice-versa. Cela s'obtient en cryptant l'int&eacute;gralit&eacute; de l'objet ViewState sous forme de cha&icirc;ne, puis en
pla&ccedil;ant cette cha&icirc;ne dans la valeur d'une balise de formulaire masqu&eacute;e dans la page. Par exemple, le code HTML
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
55
de l'objet ViewState pour une page Web ASP.NET contenant uniquement un contr&ocirc;le Button se pr&eacute;sente sous la
forme suivante :
&lt;input type=&quot;hidden&quot; name=&quot;__VIEWSTATE&quot;
value=&quot;dDwtNTMwNzcxMzI0Ozs+I7GfLyg3p44eTLFCiVEiRKUBzFw=&quot; /&gt;
ViewState ne stocke que les informations qui peuvent &ecirc;tre converties au format cha&icirc;ne.
Persistance de l'affichage de rapports du contr&ocirc;le CrystalReportViewer
Le r&ocirc;le du contr&ocirc;le CrystalReportViewer consiste &agrave; afficher les rapports Crystal. Il convertit les rapports au format
HTML dans une page qui comporte une barre d'outils et une arborescence permettant de manipuler l'affichage
des rapports. La barre d'outils contient des boutons qui permettent d'effectuer des zooms, d'acc&eacute;der &agrave; la page
suivante, d'imprimer, d'exporter, etc. L'arborescence peut &ecirc;tre d&eacute;velopp&eacute;e pour afficher des groupes de donn&eacute;es
imbriqu&eacute;s.
En rendant les informations du contr&ocirc;le persistantes, ViewState assure par cons&eacute;quent la persistance du statut
de toutes les informations d'affichage des rapports (&eacute;v&eacute;nements de la barre d'outils et de l'arborescence
compris) pour le contr&ocirc;le CrystalReportViewer au fur et &agrave; mesure que les pages sont recharg&eacute;es.
Supposons par exemple qu'un utilisateur soit en train de consulter la page 3 d'un rapport et qu'il clique sur le
bouton Page suivante de la barre d'outils du contr&ocirc;le CrystalReportViewer, ViewState rendrait persistant le statut
des deux &eacute;l&eacute;ments d'information suivants :
●
le num&eacute;ro de page actuel ;
●
le statut du bouton Page suivante (sur lequel l'utilisateur a cliqu&eacute;).
Au cours du rechargement de la page, ViewState restaurerait le contr&ocirc;le CrystalReportViewer &agrave; la page 3, puis
l'&eacute;v&eacute;nement de clic sur Page suivante, ce qui entra&icirc;nerait l'affichage de la page 4 du rapport par le contr&ocirc;le.
Persistance du mod&egrave;le d'objet du contr&ocirc;le CrystalReportViewer
Outre l'affichage des rapports, le contr&ocirc;le CrystalReportViewer joue un deuxi&egrave;me r&ocirc;le : celui de mod&egrave;le d'objet
limit&eacute; (contenu dans la classe du contr&ocirc;le CrystalReportViewer). Ce mod&egrave;le d'objet limit&eacute; peut &ecirc;tre utilis&eacute; pour
interagir par programmation avec les rapports.
ViewState rend persistant le statut de ces deux r&ocirc;les :
●
affichage des rapports
●
mod&egrave;le d'objet CrystalReportViewer
Sachez toutefois que l'utilisation du mod&egrave;le d'objet CrystalReportViewer est g&eacute;n&eacute;ralement d&eacute;conseill&eacute;e au profit
du mod&egrave;le d'objet ReportDocument, plus complet. Cet autre mod&egrave;le d'objet n'est pas contenu dans le contr&ocirc;le,
mais il fait partie des biblioth&egrave;ques de classes du SDK.
56
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Partage des m&eacute;canismes de persistance
Si vous utilisez le contr&ocirc;le CrystalReportViewer dans ses deux r&ocirc;les (affichage des rapports et mod&egrave;le d'objet),
ViewState les rend tous deux persistants et vous n'avez pas &agrave; recourir &agrave; un autre m&eacute;canisme de persistance.
Remarque
Un exemple de ce cas consisterait &agrave; lier le contr&ocirc;le CrystalReportViewer au chemin d'acc&egrave;s d'un r&eacute;pertoire de
fichiers. Voir Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de fichiers par code [page 172].
Si vous d&eacute;cidez toutefois d'utiliser le contr&ocirc;le CrystalReportViewer uniquement pour afficher les rapports, puis si
vous le liez &agrave; un mod&egrave;le d'objet externe (tel que ReportDocument), vous devrez faire appel &agrave; un autre m&eacute;canisme
de persistance afin de rendre le mod&egrave;le d'objet externe persistant. En g&eacute;n&eacute;ral, cet autre m&eacute;canisme de
persistance est Session (ou plus occasionnellement Cache).
Informations associ&eacute;es
Quelle m&eacute;thode de persistance utiliser avec SAP Crystal Reports ? [page 53]
Session et persistance du mod&egrave;le d'objet ReportDocument [page 57]
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
1.3.3.2
Session et persistance du mod&egrave;le d'objet
ReportDocument
D&eacute;finition de Session
Session est une m&eacute;thode de persistance du statut bas&eacute;e sur un serveur Web et utilis&eacute;e &agrave; la fois dans ASP et
ASP.NET. Session permet de rendre persistant n'importe quel objet durant toute la session d'un utilisateur en
stockant cet objet dans la m&eacute;moire du serveur Web.
Cette m&eacute;thode est g&eacute;n&eacute;ralement employ&eacute;e pour effectuer l'une des op&eacute;rations suivantes :
●
Stocker des informations dont le statut doit &ecirc;tre rendu persistant durant toute la dur&eacute;e d'une session
utilisateur, telles que les informations de connexion ou d'autres donn&eacute;es requises pour permettre &agrave;
l'utilisateur de naviguer dans l'application Web.
●
Stocker un objet dont le statut doit &ecirc;tre rendu persistant uniquement au cours du rechargement d'une page
ou d'un ensemble de pages regroup&eacute;es pour des raisons fonctionnelles.
L'avantage de la m&eacute;thode Session tient au fait qu'elle conserve sur le serveur Web les informations de statut de
l'utilisateur pour un acc&egrave;s &agrave; tout moment et depuis n'importe quelle page. Etant donn&eacute; que ces informations ne
sont pas stock&eacute;es par le navigateur, n'importe quel navigateur peut &ecirc;tre utilis&eacute;, m&ecirc;me des dispositifs de
navigation tels que des assistants personnels ou des t&eacute;l&eacute;phones portables.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
57
Limites de cette m&eacute;thode de persistance
●
La quantit&eacute; de m&eacute;moire serveur requise par la m&eacute;thode Session augmente au fur et &agrave; mesure que les
utilisateurs se connectent.
●
Chaque utilisateur qui acc&egrave;de &agrave; l'application Web g&eacute;n&egrave;re un objet Session distinct. La &quot;dur&eacute;e de vie&quot; de
chaque objet Session correspond &agrave; la dur&eacute;e de la session de l'utilisateur plus une p&eacute;riode d'inactivit&eacute;.
●
Si de nombreux objets sont rendus persistants dans chaque Session et si de nombreux utilisateurs emploient
simultan&eacute;ment l'application Web (g&eacute;n&eacute;rant ainsi beaucoup d'objets Session), la quantit&eacute; de m&eacute;moire serveur
consacr&eacute;e &agrave; la m&eacute;thode de persistance Session peut devenir significative et limiter l'&eacute;volutivit&eacute;.
Pour en savoir plus sur les autres m&eacute;thodes de persistance, voir les sections suivantes :
●
ViewState et persistance du mod&egrave;le d'objet CrystalReportViewer [page 55]
●
Cache et persistance du mod&egrave;le d'objet ReportDocument [page 59]
Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session
Si le rapport a &eacute;t&eacute; encapsul&eacute; dans le mod&egrave;le d'objet ReportDocument, ce mod&egrave;le d'objet doit &ecirc;tre rendu
persistant &agrave; l'aide d'une m&eacute;thode bas&eacute;e sur le serveur, telle que Session ou Cache.
Pour rendre persistant un rapport encapsul&eacute; dans le mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session,
instanciez ReportDocument, puis affectez-le &agrave; Session.
De par sa simplicit&eacute;, Session est la m&eacute;thode recommand&eacute;e lorsque vous apprenez &agrave; g&eacute;n&eacute;rer une application Web
ASP.NET &agrave; l'aide de SAP Crystal Reports. Elle est &eacute;galement conseill&eacute;e pour stocker des instances de
ReportDocument qui pr&eacute;sentent un faible potentiel de partage.
Limites de la persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de
Session
Chaque fois qu'une instance de ReportDocument pr&eacute;sente un faible potentiel de partage, utilisez la m&eacute;thode de
persistance Cache &agrave; la place de Session.
Diff&eacute;rence entre Session et ViewState
La fonction principale de Session consiste &agrave; rendre persistant le statut des objets dans la classe code-behind. Le
r&ocirc;le principal de ViewState consiste &agrave; assurer la persistance du statut des contr&ocirc;les d'une page Web. Lorsqu'un
contr&ocirc;le d'une page Web est li&eacute; &agrave; un objet contenu dans la classe code-behind et que tous deux doivent &ecirc;tre rendu
persistants d'un rechargement de page &agrave; un autre, Session et ViewState &quot;se partagent les r&ocirc;les&quot;.
Dans ce cas, ViewState assure la persistance d'un contr&ocirc;le CrystalReportViewer, et Session celle d'un objet
ReportDocument li&eacute; &agrave; ce contr&ocirc;le.
58
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
1.3.3.3
Cache et persistance du mod&egrave;le d'objet
ReportDocument
Cache est une m&eacute;thode de persistance du statut bas&eacute;e sur un serveur et utilis&eacute;e dans ASP.NET. D'un point de vue
fonctionnel, Cache est identique &agrave; l'objet Application utilis&eacute; dans ASP comme dans ASP.NET :
●
L'objet Application permet de rendre persistant n'importe quel objet sur toute la port&eacute;e de l'application.
●
L'objet Application n'est pas con&ccedil;u pour conserver les informations propres aux utilisateurs.
Cache partage ces fonctionnalit&eacute;s avec Application, mais offre une intelligence plus avanc&eacute;e au niveau de la
gestion des donn&eacute;es provisoires :
●
Un objet ajout&eacute; au cache peut-&ecirc;tre configur&eacute; &agrave; l'aide de d&eacute;pendances bas&eacute;es sur des fichiers, des cl&eacute;s ou des
d&eacute;lais. Si le fichier ou la cl&eacute; associ&eacute;(e) est modifi&eacute;, ou si un certain d&eacute;lai arrive &agrave; expiration, l'objet est
automatiquement supprim&eacute; du cache, et une version mise &agrave; jour est plac&eacute;e dans le cache &agrave; la prochaine
requ&ecirc;te portant sur l'objet.
●
Un objet plac&eacute; dans le cache qui ne poss&egrave;de aucune d&eacute;pendance et qui est inutilis&eacute; arrive automatiquement &agrave;
expiration.
●
Lorsqu'un objet est supprim&eacute; du cache, cela d&eacute;clenche un &eacute;v&eacute;nement. Vous pouvez &eacute;crire du code pour qu'il
s'ex&eacute;cute avec cet &eacute;v&eacute;nement et charge une version mise &agrave; jour de l'objet dans le Cache.
Si une autre version d'un objet est ajout&eacute;e &agrave; l'aide de la cha&icirc;ne cl&eacute; d'origine, elle &eacute;crase la version pr&eacute;c&eacute;dente.
Pour &eacute;viter cette suppression, concat&eacute;nez l'autre d&eacute;finition au niveau de la cha&icirc;ne cl&eacute; afin de rendre chaque
version de l'objet unique.
Comme l'objet Application, l'objet Cache stocke des informations accessibles &agrave; tous les utilisateurs, mais son
avantage sur Application tient au fait qu'il se met jour automatiquement en fonction des modifications apport&eacute;es
&agrave; ses d&eacute;pendances.
Comportement de l'objet Cache dans .Net 2.0 Framework
Le cache dans .Net 2.0 Framework est plus efficace et s&ucirc;r, car il est g&eacute;r&eacute; par utilisateur et par session.
En d'autres termes, lorsqu'un utilisateur affiche un rapport, une copie du rapport est enregistr&eacute;e dans le cache et
affich&eacute;e pour cet utilisateur. Si l'utilisateur rouvre le rapport alors que la section en cours est active, l'application
affiche le rapport mis en cache. Cela &eacute;vite de devoir ex&eacute;cuter le rapport &agrave; chaque fois qu'un m&ecirc;me utilisateur
l'affiche. Si un autre utilisateur se connecte et ouvre le m&ecirc;me rapport, l'application ex&eacute;cute le rapport une
seconde fois, enregistre une seconde copie du rapport dans le cache et l'affiche pour cet utilisateur. Tous les
utilisateurs ont leurs propres copies en cache du rapport pour leur session. Cela &eacute;vite que plusieurs utilisateurs
partagent le m&ecirc;me rapport.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
59
Limites de cette m&eacute;thode de persistance
Les d&eacute;veloppeurs encore peu familiers de la m&eacute;thode Cache peuvent &ecirc;tre tent&eacute;s de l'utiliser tout le temps pour
assurer la persistance, au d&eacute;triment de la m&eacute;thode Session. Or la m&eacute;thode Cache n'est pas interchangeable avec
la m&eacute;thode Session. Tenter d'&eacute;muler le caract&egrave;re unique de Session en concat&eacute;nant des donn&eacute;es propres &agrave;
l'utilisateur au niveau de la cl&eacute; du Cache charge le Cache avec des objets utilisateur qui, contrairement &agrave; ce qui ce
passe avec Session, n'arrivent pas &agrave; expiration une fois &eacute;chu le d&eacute;lai d'attente utilisateur. Par cons&eacute;quent, la
m&eacute;moire du serveur Web est plus fortement sollicit&eacute;e par l'objet Cache que par l'objet Session.
Pour rendre persistantes des donn&eacute;es propres &agrave; l'utilisateur, utilisez l'objet Session.
Pour en savoir plus sur les autres m&eacute;thodes de persistance, voir :
●
ViewState et persistance du mod&egrave;le d'objet CrystalReportViewer [page 55]
●
Session et persistance du mod&egrave;le d'objet ReportDocument [page 57]
Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Cache
Si le rapport a &eacute;t&eacute; encapsul&eacute; dans le mod&egrave;le d'objet ReportDocument, ce mod&egrave;le d'objet doit &ecirc;tre rendu
persistant &agrave; l'aide d'une m&eacute;thode bas&eacute;e sur le serveur, telle que Session ou Cache.
Un rapport encapsul&eacute; dans le mod&egrave;le d'objet ReportDocument peut &ecirc;tre rendu persistant &agrave; l'aide de l'objet Cache
de l'une des mani&egrave;res suivantes :
●
Instanciez le rapport, puis affectez-le &agrave; l'objet Cache &agrave; l'aide de la m&ecirc;me syntaxe que celle utilis&eacute;e pour
affecter un rapport &agrave; l'objet Session.
Cette m&eacute;thode fonctionne uniquement pour un rapport pr&eacute;sentant un fort potentiel de partage, pour lequel
l'instance de ReportDocument ne se produit qu'une seule fois, en utilisant un ensemble de param&egrave;tres et de
r&eacute;f&eacute;rences de connexion unique. Avec une instance de ReportDocument qui se produit plusieurs fois en
raison de modifications apport&eacute;es &agrave; ses param&egrave;tres et &agrave; ses informations de connexion, le fait de r&eacute;affecter le
rapport &agrave; l'objet Cache en utilisant la m&ecirc;me cha&icirc;ne cl&eacute; &eacute;crase la version pr&eacute;c&eacute;dente de l'instance de
ReportDocument.
●
Instanciez une version de la classe de rapport qui impl&eacute;mente l'interface ICachedReport.
Le SDK de SAP Crystal Reports comporte une structure int&eacute;gr&eacute;e de mise en m&eacute;moire cache des rapports.
Chaque rapport qui impl&eacute;mente l'interface ICachedReport est automatiquement ajout&eacute; au cache &agrave; l'aide
d'une cl&eacute; unique bas&eacute;e sur les param&egrave;tres et r&eacute;f&eacute;rences de connexion de l'utilisateur. Cette m&eacute;thode
fonctionne avec n'importe quel rapport qui pr&eacute;sente un fort potentiel de partage, mais peut donner quelques
variations en raison de modifications mineures apport&eacute;es aux param&egrave;tres et aux r&eacute;f&eacute;rences de connexion. En
ce qui concerne les rapports qui pr&eacute;sentent un faible potentiel de partage (qui sont propres &agrave; l'utilisateur),
affectez-les &agrave; l'objet Session.
Limites de la persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Cache
Cache est la m&eacute;thode la mieux adapt&eacute;e pour rendre persistantes des instances de ReportDocument qui
pr&eacute;sentent un fort potentiel de partage pour les utilisateurs. Si le rapport est sp&eacute;cifique &agrave; l'utilisateur, Cache
consommera inutilement de la m&eacute;moire serveur en cr&eacute;ant des instances bas&eacute;es sur l'utilisateur au niveau de
60
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
l'application qui resteront stock&eacute;es dans la m&eacute;moire du serveur une fois &eacute;chu le d&eacute;lai d'attente utilisateur. Les
rapports sp&eacute;cifiques &agrave; l'utilisateur doivent &ecirc;tre affect&eacute;s &agrave; l'objet Session.
Remarque
Dans la plupart des cas, utilisez Session pour rendre persistantes les instances de ReportDocument. Utilisez
Cache (ou plus sp&eacute;cifiquement, l'interface ICachedReport) uniquement lorsqu'un rapport pr&eacute;sente un fort
potentiel de partage et qu'il est tr&egrave;s volumineux, ou tellement complexe que l'extraction de ses donn&eacute;es prend
plusieurs minutes.
Diff&eacute;rence entre Cache et ViewState
La fonction principale de Cache consiste &agrave; rendre persistant le statut des objets dans la classe code-behind. Le
r&ocirc;le principal de ViewState consiste &agrave; assurer la persistance du statut des contr&ocirc;les d'une page Web. Lorsqu'un
contr&ocirc;le d'une page Web est li&eacute; &agrave; un objet contenu dans la classe code-behind et que tous deux doivent &ecirc;tre
rendus persistants au fur et &agrave; mesure que la page est recharg&eacute;e, Cache et ViewState &quot;se partagent les r&ocirc;les&quot;.
Dans ce cas, ViewState assure la persistance d'un contr&ocirc;le CrystalReportViewer, et Cache celle d'un objet
ReportDocument li&eacute; &agrave; ce contr&ocirc;le.
Informations associ&eacute;es
Quelle m&eacute;thode de persistance utiliser avec SAP Crystal Reports ? [page 53]
Limites de la persistance lors de la liaison de rapports avec le gestionnaire d'&eacute;v&eacute;nements Page_Load [page 62]
1.3.3.3.1
Pour rendre persistant un rapport incorpor&eacute; qui
impl&eacute;mente ICachedReport
Proc&eacute;dure
1.
Ajoutez le rapport au projet.
Une classe de rapport incorpor&eacute; est alors cr&eacute;&eacute;e. Est &eacute;galement cr&eacute;&eacute;e une classe de rapport mis en cache qui
charge et renvoie une instance mise en cache de la classe de rapport incorpor&eacute;.
2.
Instanciez la classe de rapport mis en cache.
3.
Affectez l'instance de la classe de rapport mis en cache au contr&ocirc;le CrystalReportViewer.
Informations associ&eacute;es
Liaison &agrave; une classe de rapport incorpor&eacute; et mis en cache [page 205]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
61
1.3.3.3.2
Pour rendre persistant un rapport non incorpor&eacute;
par le biais d'une classe utilitaire qui impl&eacute;mente
ICachedReport
Proc&eacute;dure
1.
Cr&eacute;ez votre propre classe utilitaire de gestion du cache et configurez-la de sorte qu'elle impl&eacute;mente
ICachedReport.
2.
Dans cette classe utilitaire, chargez le rapport non incorpor&eacute; &agrave; partir d'une cha&icirc;ne chemin d'acc&egrave;s &agrave; l'aide de
la m&eacute;thode ReportDocument.Load().
3.
Codez la m&eacute;thode d'impl&eacute;mentation CreateReport() de mani&egrave;re &agrave; ce qu'elle renvoie l'instance
ReportDocument du rapport non incorpor&eacute;.
4.
Instanciez la classe utilitaire de gestion du cache du rapport.
5.
Affectez l'instance de cette classe au contr&ocirc;le CrystalReportViewer.
Informations associ&eacute;es
Liaison &agrave; un rapport non incorpor&eacute; charg&eacute; dans une classe utilitaire de gestion du cache [page 207]
1.3.3.4 Limites de la persistance lors de la liaison de
rapports avec le gestionnaire d'&eacute;v&eacute;nements Page_Load
Dans les applications Web ASP.NET, il est courant de placer tout le code concernant le lancement d'une page
dans le gestionnaire d'&eacute;v&eacute;nements Page_Load (ce code &eacute;tant appel&eacute; par l'&eacute;v&eacute;nement Page.Load).
En particulier, le code concernant la liaison des donn&eacute;es de contr&ocirc;le est g&eacute;n&eacute;ralement stock&eacute; dans le gestionnaire
d'&eacute;v&eacute;nements Page_Load. Toutefois, le fait de placer le code de liaison dans ce gestionnaire d'&eacute;v&eacute;nements g&eacute;n&egrave;re
un probl&egrave;me avec ViewState. Ce probl&egrave;me, et la solution g&eacute;n&eacute;ralement adopt&eacute;e, sont d&eacute;crits ci-apr&egrave;s :
●
ViewState est utilis&eacute; pour assurer la persistance de deux &eacute;l&eacute;ments au fur et &agrave; mesure que les pages sont
recharg&eacute;es : les donn&eacute;es li&eacute;es au contr&ocirc;le et les &eacute;v&eacute;nements de clic de souris effectu&eacute;s sur ce contr&ocirc;le.
●
ViewState &eacute;tant une cha&icirc;ne, les donn&eacute;es et les &eacute;v&eacute;nements de clic de souris doivent &ecirc;tre s&eacute;rialis&eacute;s.
●
Lors du rechargement des pages, les donn&eacute;es tout comme les &eacute;v&eacute;nements de clic sont restaur&eacute;s &agrave; partir de
ViewState.
●
L'&eacute;v&eacute;nement Page.Load s'ex&eacute;cute une fois la restauration de ViewState effectu&eacute;e. Si le gestionnaire
d'&eacute;v&eacute;nements Page_Load contient du code concernant la liaison du contr&ocirc;le, ce code &eacute;crase le contenu de
ViewState lors du rechargement des pages, entra&icirc;nant la perte des &eacute;v&eacute;nements de clic et des donn&eacute;es
d'origine.
●
Ce probl&egrave;me se manifeste en g&eacute;n&eacute;ral sous la forme de contr&ocirc;les ignorant les clics de souris (s&eacute;lection
DropDownList par exemple) lorsqu'une page est recharg&eacute;e.
●
Pour &eacute;viter que les donn&eacute;es et les &eacute;v&eacute;nements de clic ne soient &eacute;cras&eacute;s, tout code de liaison dans le
gestionnaire d'&eacute;v&eacute;nements Page_Load est plac&eacute; dans un bloc conditionnel Not IsPostBack qui emp&ecirc;che que
le code ne soit appel&eacute; lors des publications.
62
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Cette solution se fonde toutefois sur le principe capital selon lequel les donn&eacute;es comme les &eacute;v&eacute;nements de clic de
souris peuvent &ecirc;tre s&eacute;rialis&eacute;s dans ViewState. Or, le contr&ocirc;le CrystalReportViewer se lie &agrave; des objets qui ne
peuvent pas &ecirc;tre s&eacute;rialis&eacute;s (tout particuli&egrave;rement les classes ReportDocument, ReportClientDocument ou
InfoObject).
Remarque
Il existe toutefois une exception : lorsque le contr&ocirc;le CrystalReportViewer est li&eacute; &agrave; un rapport par le biais de son
chemin d'acc&egrave;s au r&eacute;pertoire de fichiers, la cha&icirc;ne du chemin d'acc&egrave;s peut &ecirc;tre rendue persistante dans
ViewState. Dans ce sc&eacute;nario, uniquement le contr&ocirc;le CrystalReportViewer pourrait &ecirc;tre plac&eacute; dans un bloc
conditionnel Not IsPostBack. Ce sc&eacute;nario de liaison de rapports est toutefois moins puissant et moins utilis&eacute;
que les sc&eacute;narios de liaison aux classes de rapports mentionn&eacute;s ci-dessus.
Dans la mesure o&ugrave; seuls les &eacute;v&eacute;nements de clic de souris du contr&ocirc;le CrystalReportViewer peuvent &ecirc;tre s&eacute;rialis&eacute;s
dans ViewState, la liaison &agrave; une classe de rapport qui ne peut &ecirc;tre s&eacute;rialis&eacute;e engendre un probl&egrave;me insoluble lors
du rechargement des pages :
●
Si le code de liaison du rapport est plac&eacute; dans un bloc conditionnel Not IsPostBack, les &eacute;v&eacute;nements de clic de
souris provenant de ViewState sont conserv&eacute;s, mais la liaison du rapport n'a pas lieu, et une exception est
alors renvoy&eacute;e.
●
Si le code de liaison du rapport est plac&eacute; hors du bloc conditionnel, le rapport est li&eacute; correctement, mais le
contenu de ViewState est &eacute;cras&eacute; lors du processus, et les &eacute;v&eacute;nements de clic de souris sont alors perdus.
Remarque
Cette situation se produit le plus souvent lorsque des clics sont effectu&eacute;s dans un rapport &agrave; plusieurs
pages au niveau du contr&ocirc;le CrystalReportViewer. Le rapport ne cesse alors de revenir myst&eacute;rieusement
en page 1.
Solution recommand&eacute;e : placer le code de liaison du contr&ocirc;le
CrystalReportViewer dans l'&eacute;v&eacute;nement Init
La solution concernant le contr&ocirc;le CrystalReportViewer consiste &agrave; placer le code de liaison de votre rapport dans
l'&eacute;v&eacute;nement Init qui s'ex&eacute;cute avant que ViewState ne soit restaur&eacute;.
Cette solution engendre toutefois une complication. Dans la mesure o&ugrave; l'&eacute;v&eacute;nement Init est cod&eacute; moins souvent
que l'&eacute;v&eacute;nement Load, il est plus difficile d'acc&egrave;s. Dans les projets Web ou Windows pour Visual Studio .NET 2003,
le code qui g&egrave;re l'&eacute;v&eacute;nement Init se trouve dans la zone Code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form, zone
g&eacute;n&eacute;ralement masqu&eacute;e et r&eacute;serv&eacute;e au code g&eacute;n&eacute;r&eacute;.
Pour contourner le probl&egrave;me, proc&eacute;dez comme suit :
●
Extrayez tout le code de configuration et de liaison du contr&ocirc;le CrystalReportViewer dans une m&eacute;thode
d'assistance priv&eacute;e d&eacute;nomm&eacute;e ConfigureCrystalReports().
●
Dans la zone Code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form, placez une seule ligne de code dans le gestionnaire
d'&eacute;v&eacute;nements Page_Init() ou dans la m&eacute;thode de d&eacute;clenchement d'&eacute;v&eacute;nement OnInit() : un appel &agrave; la
m&eacute;thode d'assistance ConfigureCrystalReports().
Les instructions concernant la cr&eacute;ation de la m&eacute;thode d'assistance ConfigureCrystalReports() et son
remplissage sont indiqu&eacute;es dans la section Configuration d'un projet [page 15].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
63
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
1.3.4
Evolutivit&eacute; de l'application
Lorsque vous planifiez la cr&eacute;ation d'une application &agrave; l'aide du SDK de SAP Crystal Reports, l'un des points les
plus importants &agrave; d&eacute;terminer concerne la mani&egrave;re d'optimiser l'&eacute;volutivit&eacute; de cette application. Vous pouvez faire
&eacute;voluer votre application de deux fa&ccedil;ons :
●
Optimiser les performances de votre application.
●
Optimiser les performances de votre rapport.
La mise en application de ces conventions est d&eacute;crite dans les sections ci-apr&egrave;s.
Evolutivit&eacute; du code d'application
Avec le SDK de SAP Crystal Reports .Net, l'&eacute;volutivit&eacute; peut &ecirc;tre accrue en appliquant les meilleures pratiques
d'am&eacute;lioration des performances suivantes :
●
Limiter l'utilisation des DataSets.
●
Tirer parti de la mise en cache des rapports.
●
Lib&eacute;rer le rapport de la m&eacute;moire apr&egrave;s utilisation.
●
Partager le traitement entre les serveurs.
Evolutivit&eacute; de l'application en r&eacute;duisant la complexit&eacute; du rapport
Lorsque vous concevez vos rapports et en particulier lorsque vous concevez des rapports pour le Web, vous
devez tenir compte de leur &eacute;volutivit&eacute;. Les meilleures pratiques suivantes permettent d'optimiser l'&eacute;volutivit&eacute; d'un
rapport.
●
R&eacute;duire si possible la taille et la complexit&eacute; des rapports.
●
Transf&eacute;rer la s&eacute;lection d'enregistrements vers le serveur de base de donn&eacute;es.
●
Utiliser des sous-rapports &agrave; la demande.
64
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.3.4.1
Options de mise &agrave; niveau
1.3.4.1.1
Solutions de reporting de SAP BusinessObjects
Business Intelligence
La ligne de produits SAP BusinessObjects Business Intelligence contient plusieurs solutions de reporting. La
gamme des produits et les diff&eacute;rentes licences de d&eacute;ploiement qui les accompagnent sont con&ccedil;ues pour
r&eacute;pondre &agrave; tous les besoins inh&eacute;rents &agrave; une solution de cr&eacute;ation de rapports en terme d'&eacute;volutivit&eacute; .
Cette page offre un aper&ccedil;u de chacune de ces solutions de reporting. Vous trouverez des informations
compl&eacute;mentaires sur le site Web de SAP BusinessObjects.
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio permet aux d&eacute;veloppeurs de cr&eacute;er et
d'int&eacute;grer rapidement et efficacement des rapports soigneusement pr&eacute;sent&eacute;s dans des applications, tout en
restant dans l'environnement de d&eacute;veloppement familier de Visual Studio.
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio contient la plupart des fonctionnalit&eacute;s
pr&eacute;sentes dans SAP Crystal Reports. Celles-ci permettent notamment de cr&eacute;er des rapports, de les connecter &agrave;
un contr&ocirc;le CrystalReportViewer et d'interagir avec eux par programme &agrave; l'aide du SDK de SAP Crystal Reports.
SAP Crystal Server ou plateforme SAP BusinessObjects Business Intelligence
Le serveur RAS inclus dans SAP Crystal Reports Server et dans la plateforme SAP BusinessObjects Business
Intelligence am&eacute;liore consid&eacute;rablement les performances et l'&eacute;volutivit&eacute; en termes de cr&eacute;ation, de manipulation
et de gestion des rapports.
SAP Crystal Reports Server est un logiciel peu co&ucirc;teux qui offre tout ce dont vous avez besoin pour cr&eacute;er, g&eacute;rer et
d&eacute;ployer en toute s&eacute;curit&eacute; des rapports sur le Web. Il prend en charge toutes les &eacute;tapes du processus de
reporting, de l'acc&egrave;s aux donn&eacute;es &agrave; la conception, la gestion et la distribution des rapports, en passant par
l'int&eacute;gration des rapports via des portails et des applications, facilitant ainsi le partage sur le Web de rapports
Crystal nouveaux ou existants.
La plateforme SAP BusinessObjects Business Intelligence est une plateforme multiserveur de Business
Intelligence (BI) con&ccedil;ue pour prendre en charge le reporting &agrave; grande &eacute;chelle et les exigences en mati&egrave;re de BI.
Son environnement multiserveur offre le syst&egrave;me de tol&eacute;rance des pannes, l'&eacute;quilibrage de la charge, l'&eacute;volutivit&eacute;
et la fiabilit&eacute; n&eacute;cessaires pour mener &agrave; bien des projets plus strat&eacute;giques et de plus grande envergure. La
plateforme SAP BusinessObjects Business Intelligence est &eacute;galement recommand&eacute;e pour ses fonctionnalit&eacute;s de
reporting avanc&eacute;es telles que l'auditing, l'Explorateur SAP Crystal Reports, le composant Encyclopedia pour
logiciels BusinessObjects Enterprise Premium et Process Tracker.
Pour cr&eacute;er, g&eacute;rer et d&eacute;ployer en toute s&eacute;curit&eacute; des rapports dans un environnement de petite ou moyenne
envergure, utilisez SAP Crystal Reports Server. Pour des applications strat&eacute;giques, des outils de Business
Intelligence suppl&eacute;mentaires et un maximum d'&eacute;volutivit&eacute;, utilisez la plateforme SAP BusinessObjects Business
Intelligence.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
65
1.3.4.1.2
Comparaison des solutions de reporting de SAP
BusinessObjects Business Intelligence
Cette table contient des informations qui vous aideront &agrave; choisir la solution de reporting SAP BusinessObjects
Business Intelligence adapt&eacute;e &agrave; vos besoins en termes d'&eacute;volutivit&eacute;.
Fonction
SAP Crystal Reports, ver&shy; SAP Crystal Reports
sion d&eacute;veloppeur pour
Microsoft Visual Studio
SAP Crystal Reports Ser&shy;
ver ou plateforme SAP
BusinessObjects Busi&shy;
ness Intelligence
Prise en charge ASP.NET
X
X
X
Visualisation interactive
des rapports
X
X
X
Connexion unique
X
X
X
Prise en charge des appli&shy;
cations Windows
X
X
X
Report Designer am&eacute;lior&eacute;
X
X
Prise en charge de p&eacute;ri&shy;
ph&eacute;riques mobiles
X
X
Pilotes de base de don&shy;
n&eacute;es natifs
X
X
Sources de donn&eacute;es OLAP
X
X
V&eacute;rification des d&eacute;pen&shy;
dances des rapports
X
X
Mod&egrave;les
X
X
Param&egrave;tres de mise en
cascade dynamiques
X
X
D&eacute;ploiement multi-plate&shy;
forme
X
Syst&egrave;me de gestion de la
distribution des informa&shy;
tions
X
S&eacute;curit&eacute; int&eacute;gr&eacute;e
X
Equilibrage de la charge
X
R&eacute;f&eacute;rentiel d'objets rap&shy;
port
X
Planification des rapports
X
Cr&eacute;ation et modification
des rapports par program&shy;
mation
66
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
X
X
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Fonction
SAP Crystal Reports, ver&shy; SAP Crystal Reports
sion d&eacute;veloppeur pour
Microsoft Visual Studio
SAP Crystal Reports Ser&shy;
ver ou plateforme SAP
BusinessObjects Busi&shy;
ness Intelligence
Mod&egrave;le d'objet CrystalRe&shy;
portViewer
X
X
X
Mod&egrave;le d'objet ReportDo&shy;
cument
X
X
X
X
X
Mod&egrave;le d'objet Report&shy;
ClientDocument
Serveur RAS
X
Mod&egrave;le d'objet InfoObject
X
Evolutivit&eacute;
Faible
Prise en charge de plu&shy;
sieurs versions de .Net
Framework
Faible
Moyenne &agrave; &eacute;lev&eacute;e
X
X
Informations associ&eacute;es
Comparaison des architectures dans les solutions de reporting SAP Business Intelligence [page 41]
1.3.4.1.3
Report Application Server (RAS)
Le serveur RAS peut &ecirc;tre utilis&eacute; pour cr&eacute;er et modifier des rapports Crystal, ainsi que pour traiter des requ&ecirc;tes
li&eacute;es aux pages.
Report Application Server (RAS) est l'une des technologies de SAP BusinessObjects. Il s'agit &agrave; la fois d'un SDK
client et d'un serveur. Le serveur RAS peut &ecirc;tre utilis&eacute; pour cr&eacute;er et modifier des rapports Crystal, ainsi que pour
traiter des requ&ecirc;tes li&eacute;es aux pages. Lorsqu'un processus serveur extrait un rapport demand&eacute;, le RAS le transmet
au visualiseur de rapports.
Le serveur RAS n'est disponible qu'en tant que composant de SAP Crystal Reports Server ou de la plateforme
SAP BusinessObjects Business Intelligence.
Serveur RAS g&eacute;r&eacute;
On appelle serveur RAS g&eacute;r&eacute; un serveur RAS dont le fonctionnement est contr&ocirc;l&eacute; par d'autres composants de la
structure Enterprise. SAP Crystal Reports Server et SAP BusinessObjects Enterprise offrent un environnement de
serveurs qui facilite la gestion et la distribution de rapports sur le Web &agrave; l'&eacute;chelle de l'entreprise. Le serveur RAS
g&eacute;r&eacute; est l'un des nombreux serveurs de cet environnement. Il peut traiter des rapports situ&eacute;s sur le m&ecirc;me
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
67
ordinateur que le serveur Web et le SDK du RAS (rapports non g&eacute;r&eacute;s) ou sur un serveur de r&eacute;f&eacute;rentiel de rapports
distinct (rapports g&eacute;r&eacute;s).
Le serveur RAS g&eacute;r&eacute; peut utiliser les mod&egrave;les d'objet ReportClientDocument et InfoObject.
Utilisation de l'API RAS sans serveur RAS
Dans SAP Crystal Reports, vous pouvez acc&eacute;der &agrave; la fonctionnalit&eacute; avanc&eacute;e de cr&eacute;ation et de modification de
rapport de l'objet de mod&egrave;le ReportClientDocument &agrave; partir du SDK CR .NET. Le module de d&eacute;ploiement de ce
sc&eacute;nario exige uniquement les assemblys .NET, ce qui signifie que vous utilisez l'API RAS contenue dans les
processus.
Cependant, si vous utilisez l'API RAS contenue dans les processus, vous perdez les avantages de performance et
de stabilit&eacute; offerts par un syst&egrave;me hors processus, orient&eacute; serveur. Pour b&eacute;n&eacute;ficier de ces avantages, utilisez l'API
RAS conjointement avec un serveur RAS dans un environnement SAP Crystal Reports Server ou de plateforme
SAP BusinessObjects Business Intelligence.
Pour en savoir plus et consulter un exemple de code, voir la propri&eacute;t&eacute; ReportClientDocument de la classe
CrystalDecisions.CrystalReports.Engine.ReportDocument dans le document de r&eacute;f&eacute;rence de l'API.
Informations associ&eacute;es
Comparaison des architectures dans les solutions de reporting SAP Business Intelligence [page 41]
Mod&egrave;le d'objet ReportClientDocument (RAS) [page 39]
1.3.4.2
1.3.4.2.1
simples
Optimisation du code
Eviter d'utiliser des DataSets pour des requ&ecirc;tes
La cr&eacute;ation de rapports &agrave; partir de DataSets offre des avantages, mais ces derniers ne doivent pas
n&eacute;cessairement &ecirc;tre utilis&eacute;s en tant que m&eacute;canisme d'acc&egrave;s aux donn&eacute;es lorsque l'&eacute;volutivit&eacute; d'une application
est en jeu. Si votre application cr&eacute;e un DataSet uniquement pour un rapport, et plus particuli&egrave;rement si la requ&ecirc;te
utilis&eacute;e est une requ&ecirc;te simple telle que SELECT field 1, field 2 FROM table, l'emploi d'un DataSet
pr&eacute;sente peu d'int&eacute;r&ecirc;t.
Dans des cas semblables, faire en sorte que SAP Crystal Reports se connecte directement &agrave; la base de donn&eacute;es
et effectue la requ&ecirc;te (comme cela se produit par d&eacute;faut pour tout rapport cr&eacute;&eacute; &agrave; l'aide du
SAP Crystal Reports Designer) s'av&egrave;re plus rapide et consomme moins de m&eacute;moire.
Les DataSets sont utiles lorsque :
●
Les donn&eacute;es de plusieurs sources de donn&eacute;es doivent &ecirc;tre combin&eacute;es.
●
Les donn&eacute;es du DataSet doivent &ecirc;tre modifi&eacute;es apr&egrave;s l'ex&eacute;cution de la requ&ecirc;te.
68
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Tutoriel : Connexion aux DataSets ADO.NET [page 549]
1.3.4.2.2
En cas d'utilisation des DataSets, les mettre en
m&eacute;moire cache
Les DataSets sont encore plus efficaces en termes d'&eacute;volutivit&eacute; lorsqu'ils sont mis en cache,
Au moment de l'ex&eacute;cution, lorsqu'un rapport est charg&eacute;, le moteur de rapport SAP Crystal Reports tente de
regrouper les connexions &agrave; la base de donn&eacute;es. Par exemple, si trois utilisateurs consultent la m&ecirc;me page ASPX
avec le m&ecirc;me rapport, ces trois requ&ecirc;tes sont regroup&eacute;es dans une seule connexion &agrave; la base de donn&eacute;es.
Toutefois, la requ&ecirc;te elle-m&ecirc;me n'est pas regroup&eacute;e. M&ecirc;me si elle est identique dans les trois cas, la requ&ecirc;te doit
&ecirc;tre ex&eacute;cut&eacute;e chaque fois qu'un rapport est demand&eacute; par le moteur de rapport. Dans le cas d'une requ&ecirc;te lente ou
d'un ensemble de donn&eacute;es volumineux, ce mode de requ&ecirc;te par utilisateur peut constituer un goulot
d'&eacute;tranglement pour l'application.
L'ex&eacute;cution r&eacute;p&eacute;t&eacute;e de cette m&ecirc;me requ&ecirc;te par utilisateur pour remplir un DataSet de mani&egrave;re redondante
s'av&egrave;rerait encore pire au niveau de la charge de m&eacute;moire.
Pour r&eacute;duire le nombre de requ&ecirc;tes envoy&eacute;es &agrave; la base de donn&eacute;es, placez le DataSet dans l'objet Cache ASP.NET
apr&egrave;s la premi&egrave;re requ&ecirc;te de sorte que toutes les t&acirc;ches de rapport partagent ce m&ecirc;me DataSet dans le Cache.
Informations associ&eacute;es
Connexion aux DataSets ADO.NET [page 159]
Cr&eacute;ation de rapports &agrave; partir de DataSets ADO.NET [page 667]
Explique comment connecter votre rapport &agrave; un DataSet ADO.NET.
1.3.4.2.3
Utiliser la m&eacute;thode Close() pour lib&eacute;rer le rapport
Utilisez l'une des m&eacute;thodes Close() disponibles pour lib&eacute;rer la m&eacute;moire utilis&eacute;e par le rapport.
Une autre fa&ccedil;on d'optimiser l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio consiste &agrave; utiliser l'une des m&eacute;thodes Close() disponibles pour lib&eacute;rer la m&eacute;moire utilis&eacute;e par le
rapport.
Deux m&eacute;thodes Close() sont disponibles :
●
ReportDocument.Close() qui est utilis&eacute;e avec SAP Crystal Reports ;
●
ReportClientDocument.Close() qui est utilis&eacute;e avec le SDK du RAS.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
69
M&eacute;thode ReportDocument.Close()
Vous pouvez utiliser la m&eacute;thode ReportDocument.Close() pour lib&eacute;rer la m&eacute;moire consomm&eacute;e par le rapport
Crystal sur le serveur Web.
Le mode d'acc&egrave;s &agrave; la m&eacute;thode ReportDocument.Close() varie selon que le rapport est incorpor&eacute; ou non
incorpor&eacute; :
●
Si le rapport est incorpor&eacute;, une classe wrapper de rapport est g&eacute;n&eacute;r&eacute;e pour repr&eacute;senter le rapport dans du
code. Cette classe wrapper de rapport h&eacute;rite de ReportDocument et permet d'acc&eacute;der &agrave; la m&eacute;thode Close()
par h&eacute;ritage.
●
Si le rapport est non incorpor&eacute;, il est charg&eacute; depuis le r&eacute;pertoire de fichiers dans une instance de
ReportDocument, ce qui permet d'acc&eacute;der &agrave; la m&eacute;thode Close() directement &agrave; partir de la classe
ReportDocument.
Le rapport Crystal et l'instance ReportDocument consomment tous deux de la m&eacute;moire. Une fois que l'instance
ReportDocument est lib&eacute;r&eacute;e de la m&eacute;moire, le rapport continue d'utiliser la m&eacute;moire.
Ainsi, l'instance ReportDocument est mise hors de port&eacute;e lorsque le chargement de la page Web est termin&eacute;.
Lorsque le garbage collection .NET supprime l'instance ReportDocument, la m&eacute;moire utilis&eacute;e par celle-ci est
lib&eacute;r&eacute;e sur le serveur Web.
Le rapport demeure quant &agrave; lui en m&eacute;moire sur le serveur Web. Il ne peut pas &ecirc;tre supprim&eacute;, car il n'existe plus
d'instance ReportDocument pour y acc&eacute;der. Lorsque ces circonstances se r&eacute;p&egrave;tent &agrave; grande &eacute;chelle, la m&eacute;moire
du serveur Web se remplit de rapports auxquels on ne peut plus acc&eacute;der.
Pour r&eacute;soudre ce probl&egrave;me, appelez la m&eacute;thode ReportDocument.Close(). Le rapport est ainsi ferm&eacute; sur le
serveur Web et la m&eacute;moire est lib&eacute;r&eacute;e pour d'autres rapports.
A quel moment appeler la m&eacute;thode ReportDocument.Close()
La m&eacute;thode ReportDocument.Close() ne doit pas &ecirc;tre appel&eacute;e sur la page avant que le rapport n'ait &eacute;t&eacute; affich&eacute;,
car m&ecirc;me si le rapport a &eacute;t&eacute; ferm&eacute;, ReportDocument le rouvrira s'il est de nouveau r&eacute;f&eacute;renc&eacute;. La m&eacute;thode Close()
ne doit &ecirc;tre appel&eacute;e qu'une fois le processus d'affichage termin&eacute;.
L'&eacute;v&eacute;nement Page_Unload repr&eacute;sente le moment ad&eacute;quat pour appeler la m&eacute;thode Close().
M&eacute;thode ReportClientDocument.Close()
Lorsque vous utilisez un serveur RAS g&eacute;r&eacute; ou non g&eacute;r&eacute;, les rapports sont stock&eacute;s sur le Report Application Server,
mais ils sont repr&eacute;sent&eacute;s sur le serveur Web par une instance de ReportClientDocument. Si l'instance
ReportClientDocument est mise hors de port&eacute;e sans avoir appel&eacute; la m&eacute;thode ReportClientDocument.Close(), le
Report Application Server conserve le rapport ouvert en m&eacute;moire, m&ecirc;me lorsque l'on ne peut plus y acc&eacute;der.
Lorsque ces circonstances se r&eacute;p&egrave;tent &agrave; grande &eacute;chelle, la m&eacute;moire du Report Application Server se remplit de
rapports auxquels on ne peut plus acc&eacute;der sur le serveur Web.
Pour r&eacute;soudre ce probl&egrave;me, appelez la m&eacute;thode ReportClientDocument.Close(). Le rapport est ferm&eacute; sur le
Report Application Server et la m&eacute;moire est lib&eacute;r&eacute;e pour d'autres rapports.
70
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
A quel moment appeler la m&eacute;thode ReportClientDocument.Close()
La m&eacute;thode Close() ne doit pas &ecirc;tre appel&eacute;e sur la page avant que le rapport n'ait &eacute;t&eacute; affich&eacute;, car le rapport doit
rester ouvert sur le serveur jusqu'&agrave; la fin du processus d'affichage.
Pour une instance ReportClientDocument, la m&eacute;thode Close() ferme imm&eacute;diatement le rapport, qui ne peut alors
plus &ecirc;tre rouvert. Par cons&eacute;quent, si la m&eacute;thode Close() est appel&eacute;e avant l'affichage du rapport, celui-ci sera
inaccessible et une exception sera renvoy&eacute;e.
L'&eacute;v&eacute;nement Page_Unload repr&eacute;sente le moment ad&eacute;quat pour appeler la m&eacute;thode Close().
Informations associ&eacute;es
Comparaison des rapports incorpor&eacute;s et non incorpor&eacute;s [page 165]
1.3.4.2.4 Configurer une batterie de serveurs Web ou un
jardin Web
Une batterie de serveurs Web permet d'&eacute;tendre un site Web sur plusieurs serveurs. Un jardin Web permet
d'&eacute;tendre un site Web sur plusieurs ordinateurs sur un seul serveur. Etendre la charge du processus de rapport &agrave;
travers plusieurs CPU ou plusieurs serveurs peut am&eacute;liorer la performance de votre application Web de reporting.
Informations associ&eacute;es
Utilisation de SAP Crystal Reports dans une batterie de serveurs Web ou un jardin Web [page 75]
1.3.4.3
1.3.4.3.1
Optimisation des rapports
Utiliser des rapports moins volumineux
Une autre fa&ccedil;on d'optimiser l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, consiste &agrave; r&eacute;duire la taille des rapports.
Faites en sorte, si possible, que vos rapports contiennent moins de 15 pages. Dans les applications Web, les
utilisateurs souhaitent souvent ne consulter que quelques informations importantes et non des pages et des
pages de donn&eacute;es.
Il se peut que les rapports utilis&eacute;s dans les applications de bureau ne soient plus adapt&eacute;s aux applications Web.
Pour r&eacute;duire la taille des rapports, utilisez des formules de s&eacute;lection d'enregistrements afin de limiter le nombre
d'enregistrements renvoy&eacute;s dans les rapports. Vous avez pour cela le choix entre trois possibilit&eacute;s :
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
71
●
Vous pouvez coder en dur une formule de s&eacute;lection d'enregistrements dans le rapport &agrave; l'aide du
SAP Crystal Reports Designer incorpor&eacute;.
●
Vous pouvez filtrer par programmation de mani&egrave;re encore plus pr&eacute;cise les enregistrements qui ont &eacute;t&eacute;
extraits du rapport.
○
Avec le mod&egrave;le d'objet CrystalReportViewer, utilisez la propri&eacute;t&eacute; SelectionFormula ou
ViewTimeSelectionFormula de CrystalReportViewer.
○
Avec le mod&egrave;le d'objet ReportDocument, utilisez la propri&eacute;t&eacute; RecordSelectionFormula de
ReportDocument.
Informations associ&eacute;es
Tutoriel : Filtrage des donn&eacute;es &agrave; l'aide des formules de s&eacute;lection [page 290]
Dans ce tutoriel, vous allez apprendre &agrave; utiliser des formules de s&eacute;lection afin de filtrer les enregistrements &agrave;
afficher dans un rapport Crystal.
1.3.4.3.2
Utiliser des graphiques moins volumineux
Une autre fa&ccedil;on d'optimiser l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, consiste &agrave; r&eacute;duire la taille des graphiques utilis&eacute;s dans les rapports.
Il ne s'agit pas de supprimer les graphiques des rapports lorsque l'&eacute;volutivit&eacute; d'une application est en question,
mais vous devez les utiliser avec mod&eacute;ration en raison de leur forte consommation de ressources syst&egrave;me.
Lorsqu'un rapport contenant un graphique (diagramme ou image) est affich&eacute; dans un contr&ocirc;le
CrystalReportViewer, le moteur de rapport doit cr&eacute;er un fichier JPG temporaire (dans le dossier dynamic_images)
et le navigateur doit effectuer une demande distincte aupr&egrave;s du serveur Web pour pouvoir l'extraire.
Le contr&ocirc;le CrystalReportViewer recherche &eacute;galement de fa&ccedil;on r&eacute;guli&egrave;re des anciennes images dans le dossier
dynamic_images afin de les supprimer. Cet acc&egrave;s au disque peut r&eacute;duire les performances du rapport. Une
utilisation limit&eacute;e des diagrammes et des images r&eacute;duit l'acc&egrave;s au disque &agrave; son minimum.
Informations associ&eacute;es
Configuration du fichier Web.Config [page 20]
R&eacute;pertoire des visualiseurs [page 14]
72
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.3.4.3.3
demande
Red&eacute;finir les sous-rapports pour r&eacute;duire la
Le fait de modifier la m&eacute;thode d'utilisation des sous-rapports dans votre application peut avoir un impact
important sur les performances de votre application.
Une autre fa&ccedil;on d'optimiser l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, consiste &agrave; refactoriser les appels aux sous-rapports afin de r&eacute;duire la demande.
A propos de l'utilisation des sous-rapports
Si les sous-rapports peuvent &ecirc;tre fr&eacute;quemment utilis&eacute;s pour cr&eacute;er des rapports complexes, ils repr&eacute;sentent une
charge consid&eacute;rable. Cela ne veut pas dire pour autant que vous ne devez pas en utiliser. Toutefois, leur utilisation
doit &ecirc;tre limit&eacute;e.
Notez &eacute;galement que lorsque des sous-rapports sont plac&eacute;s dans des sections qui se r&eacute;p&egrave;tent (en-t&ecirc;tes de
groupes ou section D&eacute;tails par exemple), chaque instance de sous-rapport requiert sa propre t&acirc;che de rapport.
Cela signifie qu'un rapport contenant 100 enregistrements avec un sous-rapport dans la section D&eacute;tails implique
en r&eacute;alit&eacute; l'ex&eacute;cution de 101 t&acirc;ches de rapport.
Refactorisation des sous-rapports en tant que contr&ocirc;le DataGrid .NET li&eacute; &agrave; des
rapports
Les sous-rapports sont g&eacute;n&eacute;ralement utilis&eacute;s dans un mod&egrave;le r&eacute;sum&eacute;/d&eacute;tails :
●
Le rapport principal affiche les lignes de r&eacute;sum&eacute;.
●
Chaque ligne est li&eacute;e &agrave; un sous-rapport qui contient un rapport de d&eacute;tails.
S'il n'est pas n&eacute;cessaire d'imprimer les donn&eacute;es de r&eacute;sum&eacute;, pr&eacute;sentez-les dans une liste de lignes plut&ocirc;t que dans
un rapport. En d'autres termes, au lieu d'utiliser en tant que r&eacute;sum&eacute; un rapport li&eacute; &agrave; plusieurs sous-rapports pour
les d&eacute;tails, utilisez un contr&ocirc;le DataGrid .NET qui se lie &agrave; plusieurs rapports standard pour les d&eacute;tails. L'utilisation
du contr&ocirc;le DataGrid .NET en tant que r&eacute;sum&eacute; constitue une solution plus simple et plus &eacute;volutive.
Pour cela, liez un jeu de r&eacute;sultats de donn&eacute;es &agrave; un contr&ocirc;le DataGrid, avec un lien permettant d'acc&eacute;der au
rapport sur chaque ID de ligne. Un seul rapport est ainsi utilis&eacute; pour chaque ligne (avec un param&egrave;tre qui accepte
un ID unique qui lui a &eacute;t&eacute; transmis par l'URL de l'ID de ligne du contr&ocirc;le DataGrid).
Dans ce sc&eacute;nario, aucun traitement de rapport n'est effectu&eacute; lorsque le contr&ocirc;le DataGrid s'affiche. Il intervient
uniquement lorsque l'un des liens contenus dans le contr&ocirc;le DataGrid est s&eacute;lectionn&eacute;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
73
1.3.4.3.4 Ne pas utiliser de champs bloquant le traitement &agrave;
la demande
Une autre fa&ccedil;on d'optimiser l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, consiste &agrave; ne pas utiliser de champs qui bloquent le traitement &agrave; la demande.
SAP Crystal Reports traite les rapports &agrave; la demande. Par exemple, si la premi&egrave;re page d'un rapport doit &ecirc;tre
affich&eacute;e, Crystal Reports ne traite que cette premi&egrave;re page, et non le rapport dans son int&eacute;gralit&eacute;. Toutefois, le fait
d'ins&eacute;rer dans la premi&egrave;re page d'un rapport des champs ou des formules qui impliquent que le rapport soit trait&eacute;
en entier emp&ecirc;che le traitement &agrave; la demande.
Si par exemple le champ sp&eacute;cial &quot;Page N/M&quot; est plac&eacute; dans la premi&egrave;re page d'un rapport, ce dernier doit &ecirc;tre
trait&eacute; dans son int&eacute;gralit&eacute; pour d&eacute;terminer son nombre total de pages et ainsi assurer le rendu du champ. La
premi&egrave;re page doit donc attendre que la totalit&eacute; du rapport ait &eacute;t&eacute; trait&eacute;e avant de pouvoir s'afficher. Il se produit
la m&ecirc;me chose lorsque vous utilisez un champ pourcentage de r&eacute;sum&eacute; pour vos calculs.
Il est donc d&eacute;conseill&eacute; d'utiliser ces types de champ.
1.3.4.3.5
S&eacute;lection de l'option Aucune imprimante sous
Configuration de l'impression
La s&eacute;lection de l'option Aucune imprimante sous Configuration de l'impression est une autre fa&ccedil;on d'optimiser
l'&eacute;volutivit&eacute; dans un projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
Option Aucune imprimante
G&eacute;n&eacute;ralement, lorsque vous cr&eacute;ez un rapport Crystal, une imprimante par d&eacute;faut a &eacute;t&eacute; s&eacute;lectionn&eacute;e sur
l'ordinateur de d&eacute;veloppement. Cette imprimante par d&eacute;faut d&eacute;termine la pr&eacute;sentation des images, des polices et
des champs de base de donn&eacute;es du rapport.
La s&eacute;lection d'une imprimante par d&eacute;faut a pour avantage d'assurer l'uniformit&eacute; de l'affichage des rapports : ceuxci s'affichent selon la pr&eacute;sentation d&eacute;finie au niveau de l'imprimante par d&eacute;faut. L'inconv&eacute;nient est que cela peut
poser un probl&egrave;me en termes d'&eacute;volutivit&eacute;.
Par exemple, certains pilotes d'impression pr&eacute;sentent des fuites de m&eacute;moire ou des fuites de descripteurs de
fichiers. Si un rapport est configur&eacute; pour un pilote d'impression pr&eacute;sentant l'un de ces probl&egrave;mes, les
performances du rapport seront &eacute;galement affect&eacute;es.
Par cons&eacute;quent, pour assurer l'&eacute;volutivit&eacute;, il est recommand&eacute; de modifier le rapport de mani&egrave;re &agrave; ce qu'il n'utilise
aucun pilote d'impression.
Remarque
Le fait de ne configurer aucun pilote d'impression pour votre rapport peut notamment avoir pour cons&eacute;quence
une diff&eacute;rence de pr&eacute;sentation du rapport par rapport au r&eacute;sultat obtenu depuis l'imprimante souhait&eacute;e. Apr&egrave;s
avoir d&eacute;fini l'option Aucune imprimante pour le rapport, il est recommand&eacute; de le tester sur l'imprimante
souhait&eacute;e. Si n&eacute;cessaire, modifiez la pr&eacute;sentation du rapport.
74
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Suppression du pilote de l'imprimante par d&eacute;faut de votre rapport [page 123]
1.3.5
Utilisation de SAP Crystal Reports dans une batterie de
serveurs Web ou un jardin Web
Cette section pr&eacute;sente bri&egrave;vement comment utiliser un site Web SAP Crystal Reports, version d&eacute;veloppeur pour
Microsoft Visual Studio, dans une batterie de serveurs Web ou dans un jardin Web.
Une batterie de serveurs Web permet d'&eacute;tendre un site Web sur plusieurs serveurs. Un jardin Web permet
d'&eacute;tendre un site Web sur plusieurs processeurs au sein d'un serveur unique. La r&eacute;partition de la charge de travail
li&eacute;e au traitement de rapport sur plusieurs processeurs ou plusieurs serveurs peut am&eacute;liorer les performances de
votre application de reporting bas&eacute;e sur le Web.
1.3.5.1
Architecture d'une batterie de serveurs Web ou d'un
jardin Web
Architecture de la batterie de serveurs Web
Une batterie de serveurs Web se compose de plusieurs serveurs expos&eacute;s aux navigateurs clients sous la forme
d'un serveur virtuel unique, avec une carte Media Access virtuelle et une adresse TCP/IP.
Derri&egrave;re cette couche virtuelle, chaque serveur de la batterie de serveurs Web re&ccedil;oit tous les paquets du r&eacute;seau,
mais ne traite qu'un sous-ensemble de ces paquets. La capacit&eacute; &agrave; partager de mani&egrave;re &eacute;gale la charge de travail
est ce qui conf&egrave;re aux batteries de serveurs Web une puissance de traitement extr&ecirc;mement performante.
Cette distribution des paquets est g&eacute;r&eacute;e par l'&eacute;quilibrage de la charge r&eacute;seau. L'&eacute;quilibrage de la charge r&eacute;seau
effectue les op&eacute;rations suivantes :
●
R&eacute;partit &eacute;quitablement les demandes du client entre les serveurs.
●
D&eacute;termine quel serveur traitera une demande donn&eacute;e.
●
V&eacute;rifie que l'utilisation des ressources du serveur et les temps d'attente du client sont optimis&eacute;s.
●
Offre des alternatives performantes &agrave; l'affinit&eacute; du client.
Remarque
Dans un sc&eacute;nario d'affinit&eacute; du client, les clients qui se connectent sont limit&eacute;s de sorte qu'ils reviennent
chaque fois vers le m&ecirc;me serveur.
L'affinit&eacute; du client est g&eacute;n&eacute;ralement d&eacute;sactiv&eacute;e car elle peut cr&eacute;er un goulot d'&eacute;tranglement en raison des
demandes destin&eacute;es &agrave; un serveur particulier.
Chaque serveur d'une batterie de serveurs Web dispose d'un pilote de p&eacute;riph&eacute;rique r&eacute;seau d'&eacute;quilibrage de la
charge r&eacute;seau qui communique avec les autres serveurs, et chaque serveur est g&eacute;n&eacute;ralement dot&eacute; de deux cartes
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
75
r&eacute;seau. La seconde carte permet les communications internes pour que l'&eacute;quilibrage de la charge r&eacute;seau puisse
s'effectuer sur un autre r&eacute;seau interne.
Le pilote de p&eacute;riph&eacute;rique r&eacute;seau d'&eacute;quilibrage de la charge r&eacute;seau est fourni avec la famille Windows Server des
syst&egrave;mes d'exploitation.
Architecture du jardin Web
Un jardin Web est identique &agrave; une batterie de serveurs Web, except&eacute; qu'au lieu d'utiliser plusieurs serveurs reli&eacute;s
entre eux, il utilise un seul ordinateur dot&eacute; de plusieurs processeurs.
Le serveur SMP (multitraitement sym&eacute;trique) unique utilise ASP.NET pour ex&eacute;cuter un processus de traitement
ASP.NET s&eacute;par&eacute; sur chaque processeur. Ce serveur g&egrave;re plusieurs demandes de clients sur ses diff&eacute;rents
processeurs.
1.3.5.2
Processus de traitement ASP.NET
ASP.NET s'ex&eacute;cute dans le cadre d'un processus appel&eacute; processus de traitement ASP.NET. Toutes les
fonctionnalit&eacute;s ASP.NET s'ex&eacute;cutent dans le cadre de ce processus.
Un serveur Web standard contient un seul processus de traitement ASP.NET. Ce n'est pas le cas des batteries de
serveurs Web et des jardins Web :
●
Une batterie de serveurs Web contient plusieurs processus de traitement ASP.NET.
Chaque serveur du groupe de serveurs g&egrave;re un processus de traitement ASP.NET s&eacute;par&eacute;.
●
Un jardin Web contient plusieurs processus de traitement ASP.NET.
Chaque processeur du serveur SMP g&egrave;re un processus de traitement ASP.NET s&eacute;par&eacute;.
Choix d'un processus de traitement ASP.NET
Lorsqu'un client Web se connecte &agrave; une batterie de serveurs Web ou un jardin Web, l'un des diff&eacute;rents processus
de traitement ASP.NET est s&eacute;lectionn&eacute; pour ex&eacute;cuter la demande.
●
Dans une batterie de serveurs Web, l'&eacute;quilibrage de la charge r&eacute;seau d&eacute;termine le processus de traitement
ASP.NET s&eacute;lectionn&eacute;.
●
Dans un jardin Web, le processus de traitement ASP.NET s&eacute;lectionn&eacute; est d&eacute;termin&eacute; par ASP.NET.
Gestion de l'&eacute;tat avec plusieurs processus de traitement ASP.NET
Lorsque l'on passe d'un sc&eacute;nario avec un seul processus de traitement ASP.NET (un serveur Web standard) &agrave; un
sc&eacute;nario avec plusieurs processus de traitement ASP.NET (une batterie de serveurs Web ou un jardin Web), des
complications apparaissent au niveau de la gestion de l'&eacute;tat.
76
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Les pages Web sont sans &eacute;tat ; un serveur Web doit donc assurer la persistance de l'&eacute;tat par d'autres moyens. Les
moyens les plus courants de g&eacute;rer un &eacute;tat sur le serveur Web sont l'&eacute;tat de session et le cache ASP.NET.
Session et Cache sont tous deux contenus dans l'espace m&eacute;moire d'un seul processus de traitement ASP.NET.
Mais dans une batterie de serveurs Web ou un jardin Web, plusieurs processus de traitement ASP.NET
fonctionnent simultan&eacute;ment. Ni Session ni Cache ne peuvent g&eacute;rer l'&eacute;tat de plusieurs processus au sein d'un seul
processus de traitement ASP.NET.
Par cons&eacute;quent, une couche suppl&eacute;mentaire est requise pour la gestion de l'&eacute;tat : un serveur d'&eacute;tat de session
hors processus qui stocke et extrait les informations sur l'&eacute;tat de chaque processus de traitement ASP.NET dans
la batterie de serveurs Web ou l
Informations associ&eacute;es
Etat de session hors processus [page 77]
Quelle m&eacute;thode de persistance utiliser avec SAP Crystal Reports ? [page 53]
1.3.5.3
Etat de session hors processus
Dans les batteries de serveurs Web et les jardins Web, l'&eacute;tat de session doit &ecirc;tre partag&eacute; &agrave; travers plusieurs
serveurs &agrave; l'aide d'une forme d'&eacute;tat de session hors processus.
Deux solutions sont couramment utilis&eacute;es :
●
D&eacute;ployer le serveur d'&eacute;tat de session hors processus fourni avec ASP.NET.
●
Configurer manuellement chaque serveur Web pour stocker les donn&eacute;es d'&eacute;tat de session sur un serveur SQL
Server.
Obligation de s&eacute;rialisation
Dans les deux solutions, tous les objets &agrave; stocker doivent &ecirc;tre s&eacute;rialisables. Si un objet ne peut pas &ecirc;tre s&eacute;rialis&eacute;, il
ne peut pas &ecirc;tre rendu persistant sur un serveur d'&eacute;tat hors processus.
Remarque
Tous les mod&egrave;les d'objet du SDK de SAP Crystal Reports ne peuvent pas &ecirc;tre s&eacute;rialis&eacute;s. Toutefois, SAP fournit
une solution de mise &agrave; niveau pour g&eacute;rer l'&eacute;tat des rapports &agrave; l'aide d'un serveur hors processus.
Informations associ&eacute;es
Mod&egrave;les d'objet s&eacute;rialisables dans SAP Crystal Reports [page 78]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
77
1.3.5.4
Mod&egrave;les d'objet s&eacute;rialisables dans
SAP Crystal Reports
Quatre mod&egrave;les d'objet sont disponibles pour SAP Crystal Reports : deux sont fournis avec SAP Crystal Reports
et deux sont disponibles par mise &agrave; niveau.
Cette section explique quels mod&egrave;les d'objet peuvent &ecirc;tre s&eacute;rialis&eacute;s pour &ecirc;tre utilis&eacute;s avec un serveur d'&eacute;tat de
session hors processus.
Remarque
Pour une pr&eacute;sentation de l'&eacute;tat de session hors processus, voir Etat de session hors processus [page 77].
S&eacute;rialisation et mod&egrave;le d'objet CrystalReportViewer
Le mod&egrave;le d'objet CrystalReportViewer est un mod&egrave;le d'objet limit&eacute; inclus avec l'API du contr&ocirc;le
CrystalReportViewer. En raison de la port&eacute;e limit&eacute;e de ce mod&egrave;le d'objet, il n'est g&eacute;n&eacute;ralement pas
recommand&eacute;. On conseille plut&ocirc;t d'utiliser le mod&egrave;le d'objet plus puissant ReportDocument.
Toutefois, le mod&egrave;le d'objet CrystalReportViewer peut &ecirc;tre utilis&eacute; dans une batterie de serveurs Web ou un
jardin Web. En effet, CrystalReportViewer est contenu dans un contr&ocirc;le Web et la persistance du contr&ocirc;le
Web est g&eacute;r&eacute;e c&ocirc;t&eacute; client, avec ViewState. La persistance ViewState place l'&eacute;tat des contr&ocirc;les serveur Web
ASP.NET dans une cha&icirc;ne crypt&eacute;e, puis inclut cette cha&icirc;ne crypt&eacute;e sous la forme d'un champ de formulaire
masqu&eacute; dans la page ASPX durant le rechargement de la page. Les informations sur l'&eacute;tat peuvent &ecirc;tre fournies &agrave;
n'importe quel processus de traitement ASP.NET.
Remarque
Cette forme de persistance du client fonctionne uniquement au moment du rechargement de la page.
ViewState ne peut pas assurer la persistance des informations &agrave; travers les pages.
S&eacute;rialisation et mod&egrave;le d'objet ReportDocument
Le mod&egrave;le d'objet ReportDocument est plus puissant que CrystalReportViewer et son utilisation est par
cons&eacute;quent g&eacute;n&eacute;ralement recommand&eacute;e dans SAP Crystal Reports.
Toutefois, dans SAP Crystal Reports versions 9 et ant&eacute;rieures, la classe ReportDocument n'a pas pu &ecirc;tre
s&eacute;rialis&eacute;e et par cons&eacute;quent, n'a pas pu &ecirc;tre utilis&eacute;e avec un serveur d'&eacute;tat de session hors processus dans une
batterie de serveurs Web ou un jardin Web.
Ce probl&egrave;me a &eacute;t&eacute; r&eacute;solu dans SAP Crystal Reports 10 et versions ult&eacute;rieures en rapprochant le mod&egrave;le d'objet
ReportDocument d'un objet s&eacute;rialisable, ReportClientDocument.
Le mod&egrave;le d'objet ReportClientDocument est accessible de plusieurs mani&egrave;res.
78
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Pour utiliser le mod&egrave;le d'objet ReportDocument dans une batterie de serveurs Web ou un jardin Web, il faut que
le serveur d'&eacute;tat de session hors processus ASP.NET stocke l'&eacute;tat de l'instance ReportDocument s&eacute;rialis&eacute;e et
que le serveur RAS non g&eacute;r&eacute; stocke le fichier de rapport Crystal .rpt.
Remarque
Vous ne pouvez s&eacute;rialiser le mod&egrave;le d'objet ReportDocument que si vous avez install&eacute; le serveur RAS et
configur&eacute; les propri&eacute;t&eacute;s ReportDocument.ReportAppServer et ReportDocument.EnterpriseSession
de telle sorte qu'elles d&eacute;signent ce serveur.
S&eacute;rialisation et mod&egrave;le d'objet ReportClientDocument
Le mod&egrave;le d'objet ReportClientDocument peut &ecirc;tre s&eacute;rialis&eacute;. Le mod&egrave;le d'objet ReportClientDocument est
accessible de plusieurs mani&egrave;res.
Mod&egrave;le d'objet InfoObject
Le mod&egrave;le d'objet InfoObject fait partie de la solution de mise &agrave; niveau de Crystal, de
SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.
SAP Crystal Reports Server et la plateforme SAP BusinessObjects Business Intelligence sont des solutions
d'entreprise multiserveur qui servent g&eacute;n&eacute;ralement d'alternative &agrave; une batterie de serveurs Web ou un jardin Web
existant.
Informations associ&eacute;es
Utilisation de SAP Crystal Reports dans une batterie de serveurs Web ou un jardin Web [page 75]
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
ViewState et persistance du mod&egrave;le d'objet CrystalReportViewer [page 55]
1.3.5.5
Configuration de SAP Crystal Reports pour une
batterie de serveurs Web ou un jardin Web
Serveurs suppl&eacute;mentaires
En plus des serveurs de la batterie de serveurs Web ou du jardin Web, deux serveurs suppl&eacute;mentaires sont
n&eacute;cessaires :
●
Le serveur d'&eacute;tat de session hors processus ASP.NET, pour stocker l'&eacute;tat de l'instance ReportDocument
s&eacute;rialis&eacute;e.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
79
●
Un serveur RAS non g&eacute;r&eacute; pour stocker le fichier de rapport Crystal .rpt.
Remarque
Pour en savoir plus, voir Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65].
Utilisation particuli&egrave;re de ReportDocument
La batterie de serveurs Web ou le jardin Web utilise le serveur d'&eacute;tat de session hors processus ASP.NET pour
stocker l'objet ReportDocument s&eacute;rialis&eacute;. Dans ce sc&eacute;nario, l'objet ReportDocument n'est pas utilis&eacute; de la m&ecirc;me
fa&ccedil;on que dans une installation classique de SAP Crystal Reports.
En effet, la m&eacute;thode ReportDocument.Load() ou la propri&eacute;t&eacute; ReportDocument.FileName lie l'instance
ReportDocument &agrave; un rapport hors processus stock&eacute; sur le serveur RAS non g&eacute;r&eacute;. Pour avoir des exemples de
l'utilisation de ces solutions, voir les informations de configuration ci-dessous.
Remarque
Le stockage du fichier de rapport .rpt sur le serveur RAS non g&eacute;r&eacute; hors processus signifie que chaque
processus de traitement ASP.NET dans la batterie de serveurs Web ou le jardin Web peut acc&eacute;der au m&ecirc;me
fichier de rapport .rpt &agrave; partir d'un emplacement central.
Configuration de ReportDocument pour le serveur RAS non g&eacute;r&eacute;
La relation entre l'instance ReportDocument et le serveur RAS non g&eacute;r&eacute; peut &ecirc;tre configur&eacute;e de l'une des
mani&egrave;res suivantes :
●
Chargez le rapport Crystal incorpor&eacute; local de l'instance ReportDocument sur le serveur RAS non g&eacute;r&eacute; au
moment de l'ex&eacute;cution. Ceci permet de stocker temporairement le fichier de rapport .rpt sur le serveur RAS
non g&eacute;r&eacute; hors processus.
●
Associez un rapport externe stock&eacute; en permanence sur le serveur RAS non g&eacute;r&eacute; hors processus &agrave; l'instance
ReportDocument, en affectant le chemin d'acc&egrave;s au r&eacute;pertoire du fichier de rapport sur le serveur RAS non
g&eacute;r&eacute; &agrave; la propri&eacute;t&eacute; FileName de l'instance ReportDocument.
Instance ReportDocument sur le serveur d'&eacute;tat de session, fichier .rpt sur le
serveur RAS non g&eacute;r&eacute;
L'instance ReportDocument, qui peut &ecirc;tre s&eacute;rialis&eacute;e lorsqu'elle est utilis&eacute;e en coop&eacute;ration avec la solution de mise
&agrave; niveau Crystal du RAS non g&eacute;r&eacute;, est stock&eacute;e sur le serveur d'&eacute;tat de session hors processus ASP.NET.
Etant donn&eacute; que l'instance ReportDocument reste active sur le serveur d'&eacute;tat de session, le fichier de rapport
Crystal .rpt associ&eacute; &agrave; l'instance ReportDocument reste ouvert sur le serveur RAS non g&eacute;r&eacute;.
80
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Dans la batterie de serveurs Web ou le jardin Web, lorsqu'un autre processus de traitement ASP.NET extrait
l'instance ReportDocument &agrave; partir du serveur d'&eacute;tat de session hors processus, l'instance ReportDocument
acc&egrave;de au fichier .rpt associ&eacute; &agrave; partir du serveur RAS non g&eacute;r&eacute;.
Ecriture d'image sur le partage r&eacute;seau
Il vous faut configurer un d&eacute;tail suppl&eacute;mentaire lorsque vous utilisez une batterie de serveurs Web.
Les images qui sont &eacute;crites durant le processus de cr&eacute;ation de rapports (telles que les diagrammes dynamiques)
doivent &ecirc;tre plac&eacute;es sur un partage r&eacute;seau commun pour que n'importe quel processus de traitement ASP.NET
puisse y acc&eacute;der. Chaque ordinateur doit &ecirc;tre configur&eacute; pour &eacute;crire les images sur le m&ecirc;me partage r&eacute;seau et
pour accorder des autorisations d'acc&egrave;s au compte de traitement ASP.NET sur chaque ordinateur qui &eacute;crit sur ce
partage.
Pour configurer un ordinateur afin qu'il puisse acc&eacute;der &agrave; ce r&eacute;pertoire, ajoutez les informations ci-dessous &agrave; votre
registre.
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Report Application Server
\Viewer]
&quot;CrystalImageDir&quot;=&quot;\\fileserver\images&quot;
Instructions de configuration d&eacute;taill&eacute;es
Pour des informations d&eacute;taill&eacute;es sur les probl&egrave;mes de configuration pos&eacute;s par l'ex&eacute;cution de SAP Crystal Reports
dans une batterie de serveurs Web ou un jardin Web, consultez le site Web du support technique.
1.3.6
Utilisation de Crystal Reports en tant que service Web
Cette section explique comment utiliser des rapports Crystal qui ont &eacute;t&eacute; publi&eacute;s en tant que services Web de
rapports.
Les services Web permettent de partager les donn&eacute;es et les fonctionnalit&eacute;s de diff&eacute;rentes applications. Un logiciel
de comptabilit&eacute; peut ainsi &ecirc;tre connect&eacute; &agrave; un logiciel de gestion de commandes client par exemple. Les services
Web peuvent &eacute;galement &ecirc;tre utilis&eacute;s entre diff&eacute;rentes soci&eacute;t&eacute;s afin de partager leurs donn&eacute;es et leurs
applications.
Les services Web sont ind&eacute;pendants de toute technologie de composants ou convention d'appel d'objets pour les
raisons suivantes :
●
Ils utilisent le protocole HTTP en tant que protocole Web.
●
Ils font appel au langage XML.
●
Ils prennent en charge SSL (Secure Socket Layer).
Tout programme peut acc&eacute;der aux services Web, quels que soient son langage de programmation, le mod&egrave;le de
composant ou le syst&egrave;me d'exploitation utilis&eacute;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
81
SAP Crystal Reports permet de publier et d'utiliser facilement des rapports en tant que services Web de rapports.
Les applications Web et Windows peuvent &ecirc;tre connect&eacute;es &agrave; un service Web de rapports et afficher le rapport
Crystal expos&eacute; par ce service.
1.3.6.1
Publication et utilisation d'un rapport en tant que
service Web
Dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, vous pouvez publier des rapports
Crystal en tant que services Web.
Publication d'un rapport en tant que service Web de rapports
Dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, lorsque vous s&eacute;lectionnez l'option
permettant de publier un rapport Crystal dans un service Web de rapports, ce dernier est compil&eacute; en DLL et un
fichier XML portant l'extension &quot;.asmx&quot; (fichier des services Web .NET) est alors g&eacute;n&eacute;r&eacute;. Ce fichier .ASMX d&eacute;crit
les fonctions publiques, les param&egrave;tres d'entr&eacute;e, les types de donn&eacute;es et les types de donn&eacute;es renvoy&eacute;es qui sont
expos&eacute;s par le service Web de rapports. Les fichiers DLL et ASMX sont publi&eacute;s sur le serveur Web en tant que
services Web de rapports. Le service Web de rapports peut d&eacute;sormais &ecirc;tre appel&eacute; par l'interm&eacute;diaire de son URL
par une application cliente &agrave; partir d'un navigateur Web. Les donn&eacute;es sont transmises depuis et vers le service
Web via le protocole HTTP sous forme de langage XML.
Utilisation du rapport en tant que fichier de service Web de rapports dans une
application cliente
Pour acc&eacute;der &agrave; partir d'une application cliente au service Web de rapports publi&eacute;, vous devez transmettre la
cha&icirc;ne URL de ce dernier &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer &agrave; partir d'un site Web ou
d'un projet Windows.
Informations associ&eacute;es
Utilisation des services Crystal [page 84]
Utilisation de Crystal Reports en tant que service Web [page 81]
82
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.3.6.1.1
Pour publier un service Web de rapports
Pr&eacute;requis
Avant de commencer, vous devez disposer d'un rapport Crystal existant. Le rapport est publi&eacute; en tant que service
Web, qui peut ensuite &ecirc;tre utilis&eacute; par la propri&eacute;t&eacute; CrystalReportViewer.ReportSource.
Proc&eacute;dure
1.
D&eacute;marrez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau, puis cliquez sur Site Web.
3.
Dans la liste Mod&egrave;les Visual Studio install&eacute;s, cliquez sur Service Web ASP.NET.
4.
Dans le champ Emplacement, saisissez le nom et le chemin d'acc&egrave;s du r&eacute;pertoire de fichiers de votre service
Web.
C:\WebServices\MyCrystalReportsWebServices
5.
Cliquez sur OK.
6.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom de projet affich&eacute; en gras,
puis s&eacute;lectionnez Ajouter un &eacute;l&eacute;ment existant.
7.
Dans la bo&icirc;te de dialogue Ajouter un &eacute;l&eacute;ment existant, s&eacute;lectionnez Tous les fichiers (*.*) sous Types de
fichiers.
8.
Ajoutez un rapport existant Crystal &agrave; votre projet.
9.
Cliquez avec le bouton droit de la souris sur le rapport, puis s&eacute;lectionnez Publier en tant que service Web.
Un nouveau service est cr&eacute;&eacute;.
10. Cliquez avec le bouton droit de la souris sur Service Web, puis s&eacute;lectionnez D&eacute;finir comme page de d&eacute;but.
Lorsque vous ex&eacute;cutez votre application, le nouveau service Web s'affiche dans le navigateur Web. Vous
pouvez utiliser l'URL du service Web en tant que source du rapport pour un contr&ocirc;le CrystalReportViewer.
Remarque
Dans Visual Studio 2005 et versions ult&eacute;rieures, le serveur Web utilis&eacute; par d&eacute;faut pour afficher l'aper&ccedil;u des
sites et des services Web n'est pas IIS, mais le serveur Web Visual Web Developer. Lorsque vous utilisez ce
serveur Web, l'URL contient uniquement un num&eacute;ro de port temporaire et al&eacute;atoire, valide uniquement au
moment de la compilation. Pour acc&eacute;der &agrave; l'URL du service Web &agrave; partir d'une application cliente, vous
devez tout d'abord configurer le r&eacute;pertoire de fichiers du projet de service Web en tant que r&eacute;pertoire
virtuel dans IIS. Ce r&eacute;pertoire virtuel fournit alors une URL coh&eacute;rente qu'il est possible d'appeler &agrave; partir de
l'application cliente.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
83
1.3.6.1.2
Pour utiliser le service Web de rapports &agrave; partir
d'un projet client
Pr&eacute;requis
Avant de commencer, vous devez disposer d'un acc&egrave;s &agrave; un rapport ayant d&eacute;j&agrave; &eacute;t&eacute; publi&eacute; en tant que service Web.
Proc&eacute;dure
1.
Ajoutez le contr&ocirc;le CrystalReportViewer &agrave; votre site Web ou votre application Windows.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Affectez l'URL d'un service Web de rapports &agrave; la propri&eacute;t&eacute; ReportSource de la classe
CrystalReportViewer.
myCrystalReportViewer.ReportSource =
&quot;http://localhost/MyCrystalReportsWebService/Hierarchical_GroupingService.asmx&quot;
crystalReportViewer.ReportSource =
&quot;http://localhost/MyCrystalReportsWebService/Hierarchical_GroupingService.asmx&quot;;
R&eacute;sultats
Lorsque vous ex&eacute;cutez votre application, le contr&ocirc;le CrystalReportViewer affiche le rapport publi&eacute; par le service
Web.
1.3.6.2
Utilisation des services Crystal
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, permet de se connecter par
programmation aux rapports via le service Web des services Crystal. Les services Crystal facilitent la connexion
aux rapports expos&eacute;s par diff&eacute;rents serveurs du r&eacute;seau.
Les sources des rapports sous-jacentes et les classes que ces derniers g&eacute;n&egrave;rent (lorsqu'ils sont d&eacute;plac&eacute;s par
glissement dans un Web Form ou un Windows Form) varient au fil des versions successives de SAP Crystal
Reports.
84
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Utilisation des services Crystal avec SAP Crystal Reports 2005 ou une version
plus r&eacute;cente
Dans Visual Studio 2005, les services Crystal sont accessibles par programmation. Ils permettent de g&eacute;n&eacute;rer une
liste de rapports disponibles sur un ordinateur local ou distant, ainsi que d'acc&eacute;der &agrave; ces rapports via un service
Web.
Le code de connexion doit &ecirc;tre saisi manuellement dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio.
Les services Crystal utilisent le protocole des services Web de rapports pour acc&eacute;der &agrave; un r&eacute;pertoire virtuel du
serveur, appel&eacute; r&eacute;pertoire virtuel des visualiseurs.
Utilisation des services Crystal avec SAP Crystal Reports pour
Visual Studio .NET 2003
Dans SAP Crystal Reports pour Visual Studio 2003, les services Crystal &eacute;taient accessibles &agrave; partir de
l'Explorateur de serveurs.
Le sous-nœud Services Crystal de chaque serveur se d&eacute;veloppe pour afficher d'autres sous-nœuds. Le nom de
ces sous-nœuds varie en fonction des versions de SAP Crystal Reports, mais ils ont un comportement commun :
chaque sous-nœud Services Crystal se d&eacute;veloppe pour afficher une liste de rapports &agrave; partir du r&eacute;pertoire de
fichiers de l'ordinateur local ou &agrave; partir des serveurs du r&eacute;seau.
Un sous-nœud Services Crystal peut parfois utiliser le protocole des services Web de rapports. Dans ce cas, il
l'utilise pour acc&eacute;der &agrave; un r&eacute;pertoire virtuel du serveur, appel&eacute; r&eacute;pertoire virtuel des visualiseurs.
Dans d'autres cas, une connexion directe est &eacute;tablie avec un serveur RAS non g&eacute;r&eacute;, SAP Crystal Reports Server
ou la plateforme SAP BusinessObjects Business Intelligence. Dans ce cas, le protocole des services Web de
rapports n'est pas utilis&eacute;.
Il se peut que vous deviez ajuster vos param&egrave;tres de pare-feu afin d'acc&eacute;der au CMS de la plateforme SAP
BusinessObjects Business Intelligence. Le port par d&eacute;faut pour le CMS est 6400. Contactez votre administrateur
syst&egrave;me pour plus d'informations sur l'adresse r&eacute;seau et les param&egrave;tres de port de votre syst&egrave;me de plateforme
SAP BusinessObjects Business Intelligence. Pour plus d'informations sur la personnalisation des ports, voir le
Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
Remarque
Les nœuds disponibles d&eacute;pendent de la configuration et du contrat de licence dont vous disposez.
Un rapport expos&eacute; via le nœud Services Crystal peut &ecirc;tre d&eacute;plac&eacute; par une simple op&eacute;ration glisser-d&eacute;placer vers
la barre d'&eacute;tat des composants d'un Web Form ou d'un Windows Form dans Visual Studio NET 2003.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
85
1.3.6.3
Crystal
Configuration des fichiers serveur dans les services
Parmi les groupes de services Crystal fournis avec SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, figurent les fichiers serveur. Les fichiers serveur constituent un ensemble de services Web de
rapports qui sont expos&eacute;s par le biais d'un r&eacute;pertoire virtuel &agrave; partir du chemin d'acc&egrave;s &agrave; un r&eacute;pertoire de fichiers
situ&eacute; sur le disque dur.
Diff&eacute;rentes conditions d'impl&eacute;mentation sont requises pour chaque version de Visual Studio.
1.3.6.3.1
Configuration des fichiers serveur dans Visual
Studio .NET 2003
Les fichiers serveur correspondent &agrave; un ensemble de services Web de rapports qui sont expos&eacute;s &agrave; partir du
r&eacute;pertoire virtuel des visualiseurs dans IIS. Les fichiers serveur &eacute;taient &agrave; l'origine fournis sous la forme d'un nœud
Services Crystal dans SAP Crystal Reports pour Visual Studio .NET 2002, mais ce nœud a depuis &eacute;t&eacute; supprim&eacute;.
Chaque nouvelle version de SAP Crystal Reports continue &agrave; prendre en charge les fichiers serveur dans le SDK,
mais leur utilisation n&eacute;cessite une configuration particuli&egrave;re pour chaque version.
Les fichiers serveur sont g&eacute;n&eacute;r&eacute;s &agrave; partir des fichiers de rapport sous-jacents figurant dans le dossier des
exemples de rapports (ou tout autre dossier d&eacute;sign&eacute;) du chemin d'acc&egrave;s au r&eacute;pertoire de fichiers du serveur Web.
Vous pouvez acc&eacute;der aux fichiers serveur de deux mani&egrave;res :
●
Via un nœud visible sous Services Crystal.
Ce mode d'acc&egrave;s est uniquement disponible dans SAP Crystal Reports pour Visual Studio 2003.
●
En programmant la classe ServerFileReport dans le SDK.
Vous pouvez acc&eacute;der aux fichiers serveur par le biais du SDK avec toutes les versions de
SAP Crystal Reports .NET.
Les fichiers serveur sont expos&eacute;s par le biais d'un r&eacute;pertoire virtuel dans IIS. La connexion aux fichiers de rapport
sous-jacents n&eacute;cessite la configuration des droits d'acc&egrave;s au dossier.
Les droits d'acc&egrave;s sont configur&eacute;s par le biais d'une entr&eacute;e de fichier web.config.
Configuration des fichiers serveur dans Visual Studio .NET 2003
Dans Visual Studio .NET 2003, le dossier de configuration des fichiers serveur est devenu obsol&egrave;te et remplac&eacute;
par l'ajout d'une entr&eacute;e de configuration au fichier web.config.
Vous pouvez ajouter cette entr&eacute;e de configuration au fichier web.config de chaque projet, l'un apr&egrave;s l'autre. Il est
toutefois recommand&eacute; de l'ajouter au fichier web.config situ&eacute; dans le r&eacute;pertoire virtuel des visualiseurs de
SAP Crystal Reports afin de rendre cette information accessible &agrave; tous les projets Visual Studio .NET. Avant
d'effectuer cette op&eacute;ration, lisez la section suivante pour en savoir plus sur le r&eacute;pertoire virtuel des visualiseurs.
86
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Fichiers serveur et r&eacute;pertoire virtuel des visualiseurs
Les fichiers serveur sont pris en charge en dehors d'IIS (Internet Information Services) &agrave; partir d'un service Web
centralis&eacute; situ&eacute; dans un r&eacute;pertoire virtuel des visualiseurs sp&eacute;cial. Chaque nouvelle version de
SAP Crystal Reports cr&eacute;e un r&eacute;pertoire virtuel des visualiseurs suppl&eacute;mentaire dans IIS, ce qui permet de
conserver plusieurs versions de SAP Crystal Reports.
Un probl&egrave;me de maintenance se pose si vous avez cod&eacute; les fichiers serveur dans un projet d'une version
ant&eacute;rieure de SAP Crystal Reports et si vous proc&eacute;dez &agrave; une mise &agrave; niveau vers une version ult&eacute;rieure. Pour
permettre le fonctionnement des instances de ServerFileReport, dans votre code, le nom du r&eacute;pertoire virtuel des
visualiseurs dans la propri&eacute;t&eacute; WebServiceURL de chaque instance de ServerFileReport doit &ecirc;tre remplac&eacute; par le
r&eacute;pertoire virtuel des visualiseurs actuel.
Informations associ&eacute;es
Configuration des fichiers serveur dans Visual Studio 2005 et les versions plus r&eacute;centes [page 89]
Utilisation de Crystal Reports en tant que service Web [page 81]
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.3.1.1
Pour modifier le r&eacute;pertoire virtuel des
visualiseurs dans la propri&eacute;t&eacute; WebServiceURL des instances de
ServerFileReport
Proc&eacute;dure
1.
Recherchez dans votre projet toutes les occurrences dans lesquelles la propri&eacute;t&eacute; WebServiceURL d'une
instance de ServerFilesReport a &eacute;t&eacute; affect&eacute;e.
2.
Comparez le nom du r&eacute;pertoire virtuel des visualiseurs actuellement affect&eacute; dans votre code &agrave; celui utilis&eacute;
dans les versions pr&eacute;c&eacute;dentes
3.
Changez le nom du r&eacute;pertoire virtuel des visualiseurs utilis&eacute; dans la version de SAP Crystal Reports la plus
r&eacute;cente.
4.
Recompilez l'application et v&eacute;rifiez que les rapports se chargent correctement.
&Eacute;tapes suivantes
Modifiez le fichier web.config du r&eacute;pertoire virtuel des visualiseurs de mani&egrave;re &agrave; configurer correctement les
fichiers serveur dans toutes les versions post&eacute;rieures &agrave; Visual Studio .NET 2002.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
87
1.3.6.3.1.2
Pour ajouter l'entr&eacute;e de configuration des fichiers
serveur au fichier web.config du r&eacute;pertoire virtuel des
visualiseurs (toutes les versions post&eacute;rieures &agrave; Visual
Studio .NET 2002)
Proc&eacute;dure
1.
Localisez le r&eacute;pertoire virtuel des visualiseurs de la version SAP Crystal Reports la plus r&eacute;cente.
2.
Pour vous assurer que le r&eacute;pertoire virtuel des visualiseurs fonctionne, ouvrez un navigateur, puis saisissez
l'URL du service Web de rapports publi&eacute; dans le r&eacute;pertoire virtuel des visualiseurs.
Option
Description
Visual Studio 2003
http://localhost/CrystalReportWebFormViewer2/
ServerFileReportService.asmx?wsdl
SAP Crystal Reports 2008 http://localhost/crystalreportviewers12/
ServerFileReportService.asmx?wsdl
3.
Ouvrez le fichier web.config situ&eacute; dans le r&eacute;pertoire virtuel des visualiseurs dans un &eacute;diteur de texte.
Remarque
Si vous le souhaitez, vous pouvez &eacute;galement apporter ces modifications uniquement dans le fichier
web.config de l'application Web cliente qui acc&egrave;dera &agrave; ces rapports des fichiers serveur.
4.
Au tout d&eacute;but du fichier web.config, &agrave; l'int&eacute;rieur de la balise configuration, ajoutez une entr&eacute;e configSections
qui d&eacute;clare un nouveau type sectionGroup (crystalDecisions) et sa section (serverFileReportManager).
&lt;configSections&gt;
&lt;sectionGroup name=&quot;crystalDecisions&quot;&gt;
&lt;section name=&quot;serverFileReportManager&quot;
type=&quot;System.Configuration.NameValueSectionHandler, System,
Version=1.0.3300.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089, Custom=null&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
5.
Apr&egrave;s la balise de fermeture de configSections, ajoutez le nouveau type sectionGroup et la section que vous
avez d&eacute;clar&eacute;s &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
Dans l'exemple ci-dessous, remplacez la valeur du r&eacute;pertoire racine par celle du r&eacute;pertoire dans lequel vous
avez stock&eacute; vos rapports. Pour cet exemple, le chemin du fichier est le suivant : C:\program files
\Microsoft Visual Studio .NET 2003\Crystal Reports\Samples\Reports\Feature Examples.
&lt;crystalDecisions&gt;
&lt;serverFileReportManager&gt;
&lt;add key=&quot;rootDirectory&quot;
value=&quot;C:\program files\Microsoft Visual Studio .NET 2003\Crystal Reports\Samples
\En\Reports\Feature Examples&quot; /&gt;
&lt;/serverFileReportManager&gt;
&lt;/crystalDecisions&gt;
88
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Vous devez saisir le chemin d'acc&egrave;s du r&eacute;pertoire de fichiers au dossier de rapports dans le champ de
valeur.
6.
Enregistrez les modifications apport&eacute;es au fichier web.config.
1.3.6.3.2
Configuration des fichiers serveur dans Visual
Studio 2005 et les versions plus r&eacute;centes
Les fichiers serveur correspondent &agrave; un ensemble de services Web de rapports qui exposent des rapports sur un
serveur IIS. Les fichiers serveur &eacute;taient &agrave; l'origine fournis sous la forme d'un nœud Services Crystal dans
SAP Crystal Reports pour Visual Studio .NET 2002, mais ce nœud a depuis &eacute;t&eacute; supprim&eacute;. Chaque nouvelle
version de SAP Crystal Reports continue &agrave; prendre en charge les fichiers serveur dans le SDK, mais leur utilisation
n&eacute;cessite une configuration particuli&egrave;re pour chaque version.
Les fichiers serveur sont g&eacute;n&eacute;r&eacute;s &agrave; partir des fichiers de rapport sous-jacents figurant dans le dossier des
exemples de rapports (ou tout autre dossier d&eacute;sign&eacute;) du r&eacute;pertoire de fichiers du serveur Web.
Configuration des fichiers serveur
La configuration des fichiers serveur pour Visual Studio 2005 ou une version plus r&eacute;cente s'effectue en deux
&eacute;tapes. La premi&egrave;re &eacute;tape consiste &agrave; cr&eacute;er le service Web de rapports qui va exposer les rapports. La deuxi&egrave;me
&eacute;tape consiste &agrave; modifier le fichier web.config correspondant au nouveau service Web. Dans Visual Studio 2005,
l'utilisation du dossier de configuration pour les fichiers serveur qui se faisait dans Visual Studio .NET 2002 a &eacute;t&eacute;
d&eacute;conseill&eacute;e au profit de l'ajout d'une entr&eacute;e de configuration dans le fichier web.config.
Vous pouvez ajouter l'entr&eacute;e de configuration au fichier web.config de chaque projet, l'un apr&egrave;s l'autre. Il est
toutefois recommand&eacute; d'ajouter cette entr&eacute;e de configuration au fichier web.config situ&eacute; dans le r&eacute;pertoire virtuel
qui contient les services Web de rapports.
Informations associ&eacute;es
Connexion aux services Web de rapports &agrave; partir d'un site Web s&eacute;curis&eacute; [page 93]
Utilisation de Crystal Reports en tant que service Web [page 81]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
89
1.3.6.3.2.1
Pour cr&eacute;er les services Web de rapports requis
pour les fichiers serveur
Proc&eacute;dure
1.
D&eacute;marrez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau, puis cliquez sur Site Web.
3.
Dans la bo&icirc;te de dialogue Nouveau site Web, s&eacute;lectionnez Visual C# dans la liste Langage.
4.
Dans la liste Mod&egrave;les, cliquez sur Service Web ASP.NET.
5.
Dans le champ Emplacement, remplacez le nom de projet par d&eacute;faut par le nom de votre projet.
Pour cet exemple, le projet sera enregistr&eacute; dans C:\InetPub\wwwroot\ sous le nom
CrystalReportsWebServices.
C:\InetPub\wwwroot\CrystalReportsWebServices\
6.
Cliquez sur OK.
7.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer le d&eacute;bogage.
Une bo&icirc;te de dialogue indiquant que le fichier web.config doit &ecirc;tre modifi&eacute; s'affiche alors. Cliquez sur le
bouton OK pour activer le d&eacute;bogage.
8.
Une fois le d&eacute;bogage termin&eacute;, revenez &agrave; l'application.
9.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur Service.asmx, puis cliquez sur
Supprimer.
10. Dans l'Explorateur de solutions, d&eacute;veloppez le dossier App_Code, cliquez avec le bouton droit de la souris sur
Service.cs, puis cliquez sur Supprimer.
11. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
puis cliquez sur Ajouter un nouvel &eacute;l&eacute;ment.
12. Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, proc&eacute;dez de la mani&egrave;re suivante :
a) Dans le champ Mod&egrave;les, s&eacute;lectionnez Service Web.
b) Dans le champ Nom, saisissez ServerFileReportService.asmx.
c) D&eacute;sactivez la case &agrave; cocher Placer le code dans un fichier distinct.
d) Cliquez sur Ajouter.
13. Remplacez le contenu du fichier ServerFileReportService.asmx par la ligne suivante :
&lt;%@ WebService language=&quot;C#&quot;
class=&quot;CrystalDecisions.Web.Services.ServerFileReportService&quot; %&gt;
14. Dans le menu Fichier, cliquez sur Enregistrer tout.
15. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
puis cliquez sur Ajouter un nouvel &eacute;l&eacute;ment.
16. Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment :
a) Dans le champ Mod&egrave;les, s&eacute;lectionnez Service Web.
b) Dans le champ Nom, saisissez ServerFileReportManager.asmx.
c) D&eacute;sactivez la case &agrave; cocher Placer le code dans un fichier distinct.
90
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
d) Cliquez sur Ajouter.
17. Remplacez le contenu du fichier ServerFileReportManager.asmx par la ligne suivante :
&lt;%@ WebService language=&quot;C#&quot;
class=&quot;CrystalDecisions.Web.Services.ServerFileReportManager&quot; %&gt;
18. Dans le menu Fichier, cliquez sur Enregistrer tout.
1.3.6.3.2.2
Pour modifier le r&eacute;pertoire virtuel des
visualiseurs dans la propri&eacute;t&eacute; WebServiceURL des instances de
ServerFileReport
Proc&eacute;dure
1.
Recherchez dans votre projet toutes les occurrences dans lesquelles la propri&eacute;t&eacute; WebServiceURL d'une
instance de ServerFilesReport a &eacute;t&eacute; affect&eacute;e.
2.
Comparez le nom du r&eacute;pertoire virtuel des visualiseurs actuellement affect&eacute; dans votre code &agrave; celui utilis&eacute;
dans les versions pr&eacute;c&eacute;dentes
3.
Changez le nom du r&eacute;pertoire virtuel des visualiseurs utilis&eacute; dans la version de SAP Crystal Reports la plus
r&eacute;cente.
Si votre version de SAP Crystal Reports la plus r&eacute;cente est SAP Crystal Reports pour Visual Studio 2005,
saisissez le chemin d'acc&egrave;s au service Web de rapports que vous avez pr&eacute;c&eacute;demment cr&eacute;&eacute; dans ce tutoriel.
4.
Recompilez l'application et v&eacute;rifiez que les rapports se chargent correctement.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.3.2.3
Pour ajouter l'entr&eacute;e de configuration des fichiers
serveur au fichier web.config
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, ouvrez le fichier Web.Config.
2.
Remplacez le contenu int&eacute;gral du fichier Web.Config par le code XML ci-apr&egrave;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
91
Dans l'exemple ci-dessous, remplacez la valeur du r&eacute;pertoire racine par celle du r&eacute;pertoire dans lequel vous
avez stock&eacute; vos rapports. Pour cet exemple, le chemin de fichier d&eacute;fini est C:\program files\Microsoft
Visual Studio 8\Crystal Reports\Samples\fr\Reports\Feature Examples.
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;configuration
xmlns=&quot;http://schemas.microsoft.com/.NetConfiguration/v2.0&quot;&gt;
&lt;configSections&gt;
&lt;sectionGroup name=&quot;crystalDecisions&quot;&gt;
&lt;section name=&quot;serverFileReportManager&quot;
type=&quot;System.Configuration.NameValueSectionHandler, System,
Version=1.0.3300.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089, Custom=null&quot;/&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;crystalDecisions&gt;
&lt;serverFileReportManager&gt;
&lt;add key=&quot;rootDirectory&quot; value=&quot;C:\program files\Microsoft Visual
Studio 8\Crystal Reports\Samples\fr\Reports\Feature Examples&quot;/&gt;
&lt;/serverFileReportManager&gt;
&lt;/crystalDecisions&gt;
&lt;appSettings/&gt;
&lt;connectionStrings/&gt;
&lt;system.web&gt;
&lt;compilation debug=&quot;true&quot;&gt;
&lt;assemblies&gt;
&lt;add assembly=&quot;CrystalDecisions.Web, Version=12.1.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;/assemblies&gt;
&lt;/compilation&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;
Remarque
Vous devez saisir le chemin d'acc&egrave;s du r&eacute;pertoire de fichiers au dossier des rapports &agrave; l'endroit o&ugrave; vous
voyez l'&eacute;nonc&eacute; PUT_FILE_DIRECTORY_PATH_TO_REPORTS_FOLDER_HERE.
3.
Enregistrez les modifications apport&eacute;es au fichier web.config.
4.
Pour vous assurer que le r&eacute;pertoire virtuel des visualiseurs fonctionne, ouvrez un navigateur, puis saisissez
l'URL du service Web de rapports publi&eacute;.
http://localhost/CrystalReportsWebServices/ServerFileReportService.asmx?wsdl
1.3.6.3.2.4
Anciens fichiers serveur et r&eacute;pertoire virtuel des
visualiseurs
Dans les pr&eacute;c&eacute;dentes versions de SAP Crystal Reports, les fichiers serveur &eacute;taient pris en charge en dehors d'IIS,
&agrave; partir d'un service Web centralis&eacute; situ&eacute; dans le r&eacute;pertoire virtuel des visualiseurs. Chaque nouvelle version de
SAP Crystal Reports cr&eacute;e un r&eacute;pertoire virtuel des visualiseurs suppl&eacute;mentaire dans IIS, ce qui permet de
conserver plusieurs versions de SAP Crystal Reports.
92
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Un probl&egrave;me de maintenance se pose si vous avez cod&eacute; les fichiers serveur dans un projet d'une version
ant&eacute;rieure de SAP Crystal Reports et si vous proc&eacute;dez &agrave; une mise &agrave; niveau vers une version ult&eacute;rieure. Pour
permettre le fonctionnement des instances de ServerFileReport, dans votre code, le nom du r&eacute;pertoire virtuel des
visualiseurs dans la propri&eacute;t&eacute; WebServiceURL de chaque instance de ServerFileReport doit &ecirc;tre remplac&eacute; par
l'emplacement actuel du service Web de rapports.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.4 Connexion aux services Web de rapports &agrave; partir d'un
site Web s&eacute;curis&eacute;
Dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, vous pouvez publier des rapports
Crystal en tant que services Web.
Dans la mesure o&ugrave; les services Web sont accessibles via le Web, vous souhaiterez peut-&ecirc;tre les prot&eacute;ger de tout
acc&egrave;s anonyme.
Cette section explique comment supprimer l'acc&egrave;s anonyme d'un r&eacute;pertoire virtuel contenant un service Web de
rapports, puis comment &eacute;crire du code permettant de placer ce service dans une classe RemoteReportProxy qui
peut &ecirc;tre configur&eacute;e de mani&egrave;re &agrave; traiter l'authentification NT sur le serveur IIS (Internet Information Services).
Deux types de service Web de rapports n&eacute;cessitent un code d'authentification : les services Web de rapports
standard et les fichiers serveur.
Informations associ&eacute;es
Publication et utilisation d'un rapport en tant que service Web [page 82]
Configuration des fichiers serveur dans les services Crystal [page 86]
1.3.6.4.1
Services Web de rapports et authentification NT
1.3.6.4.1.1
Ajout de l'authentification NT &agrave; un service Web
de rapports
Avant d'apporter quelque modification que ce soit en vue de l'authentification NT, vous devez cr&eacute;er un projet qui
publie et utilise un service Web de rapports comme indiqu&eacute; dans la section Publication et utilisation d'un rapport
en tant que service Web [page 82].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
93
Dans cette section, vous allez apprendre &agrave; supprimer l'acc&egrave;s anonyme du r&eacute;pertoire qui contient le service Web
de rapports que vous avez cr&eacute;&eacute; pr&eacute;c&eacute;demment.
Informations associ&eacute;es
Connexion aux services Web de rapports &agrave; partir d'un site Web s&eacute;curis&eacute; [page 93]
1.3.6.4.1.1.1
Pour supprimer l'acc&egrave;s anonyme du r&eacute;pertoire
contenant le service Web de rapports
Proc&eacute;dure
1.
Dans le Panneau de configuration, cliquez deux fois sur Outils d'administration, puis sur Gestionnaire des
services Internet.
2.
Dans la fen&ecirc;tre Services Internet (IIS), d&eacute;veloppez les nœuds sup&eacute;rieurs, puis le nœud Site Web par d&eacute;faut.
3.
Recherchez le r&eacute;pertoire virtuel contenant le Report Web Service que vous avez cr&eacute;&eacute; pr&eacute;c&eacute;demment.
4.
Cliquez sur ce r&eacute;pertoire virtuel avec le bouton droit de la souris, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
5.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s, dans l'onglet S&eacute;curit&eacute; de r&eacute;pertoire, cliquez sur Modifier.
6.
D&eacute;sactivez la case &agrave; cocher Acc&egrave;s anonyme, puis cliquez sur OK.
7.
Cliquez sur OK pour fermer la bo&icirc;te de dialogue Propri&eacute;t&eacute;s.
8.
Fermez la fen&ecirc;tre Services Internet (IIS).
R&eacute;sultats
A ce stade, si vous souhaitez qu'un utilisateur r&eacute;seau en particulier puisse acc&eacute;der au r&eacute;pertoire par
authentification, vous devez attribuer &agrave; cet utilisateur une autorisation individuelle sur le dossier &agrave; partir de
l'Explorateur Windows.
1.3.6.4.1.1.2
Pour attribuer &agrave; un utilisateur r&eacute;seau en
particulier des autorisations sur le dossier
Proc&eacute;dure
1.
Dans l'Explorateur Windows, recherchez le dossier contenant le service Web.
2.
Cliquez avec le bouton droit de la souris sur le dossier, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
94
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s, dans l'onglet S&eacute;curit&eacute;, cliquez sur Ajouter.
4.
Dans la bo&icirc;te de dialogue S&eacute;lectionner les utilisateurs, les ordinateurs ou les groupes, dans le panneau
&lt;&lt;Entrez des noms s&eacute;par&eacute;s par des points-virgules ou choisissez &agrave; partir de la liste&gt;&gt;, saisissez le nom de
l'utilisateur r&eacute;seau.
5.
Cliquez sur V&eacute;rifier les noms.
6.
V&eacute;rifiez que le nom de l'utilisateur a &eacute;t&eacute; correctement ajout&eacute;, puis cliquez sur OK.
7.
Dans le panneau Autorisations, activez la case &agrave; cocher Autoriser pour l'autorisation Lecture.
1.3.6.4.1.2
Modification de l'application cliente pour ajouter
un acc&egrave;s s&eacute;curis&eacute;
Dans cette section, vous allez modifier l'application cliente afin qu'elle puisse acc&eacute;der au service Web de rapports
de fa&ccedil;on s&eacute;curis&eacute;e par le biais de l'authentification NT. Vous devez pour cela ajouter des assemblys, des espaces
de noms et du code.
1.3.6.4.1.2.1
V&eacute;rification de l'impossibilit&eacute; pour votre
application cliente d'acc&eacute;der au service Web s&eacute;curis&eacute;
Proc&eacute;dure
1.
Rouvrez l'application cliente que vous avez cr&eacute;&eacute;e pour utiliser le service Web de rapports (dans la section
Publication et utilisation d'un rapport en tant que service Web [page 82]).
2.
Ex&eacute;cutez l'application afin de vous assurer que vous n'&ecirc;tes plus autoris&eacute; &agrave; acc&eacute;der de mani&egrave;re anonyme au
service Web de rapports contenu dans ce r&eacute;pertoire.
Le message d'erreur suivant s'affiche : &quot;La demande a &eacute;chou&eacute; avec l'&eacute;tat HTTP 401 : acc&egrave;s refus&eacute;&quot;.
1.3.6.4.1.2.2
Pour ajouter de nouveaux assemblys ainsi que
les r&eacute;f&eacute;rences &agrave; ces assemblys
Proc&eacute;dure
1.
Cliquez avec le bouton droit de la souris sur le dossier References, puis s&eacute;lectionnez Ajouter une r&eacute;f&eacute;rence.
2.
Dans la bo&icirc;te de dialogue Add Reference, dans l'onglet .NET, cliquez sur les assemblys suivants tout en
maintenant la touche CTRL enfonc&eacute;e :
3.
○
CrystalDecisions.ReportSource
○
System.Web.Services
Cliquez sur Select sur le c&ocirc;t&eacute; droit de la bo&icirc;te de dialogue.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
95
4.
V&eacute;rifiez que les deux assemblys ont bien &eacute;t&eacute; ajout&eacute;s au panneau Selected Components, puis cliquez sur
OK.
5.
Ouvrez le Web Form ou le Windows Form que vous avez cr&eacute;&eacute; dans Configuration d'un projet [page 15].
6.
Dans le menu View, cliquez sur Code.
7.
Au-dessus de la signature de classe, ajoutez trois d&eacute;clarations &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au
d&eacute;but de la classe pour les espaces de noms suivants.
Imports CrystalDecisions.ReportSource
Imports System.Net
Imports System.Web.Services
using CrystalDecisions.ReportSource;
using System.Net;
using System.Web.Services;
&Eacute;tapes suivantes
Vous allez ensuite apprendre &agrave; ajouter du code pour configurer une classe RemoteReportProxy de sorte qu'elle
transmette les r&eacute;f&eacute;rences de connexion de l'utilisateur au r&eacute;pertoire s&eacute;curis&eacute; du service Web de rapports.
1.3.6.4.1.2.3
Codage de la m&eacute;thode
GetReportWebServiceWithAuthentication()
Contexte
La m&eacute;thode GetReportWebServiceWithAuthentication() permet de configurer le proxy du rapport distant
et de g&eacute;rer l'authentification NT.
Dans cette section, vous allez apprendre &agrave; coder la m&eacute;thode GetReportWebServiceWithAuthentication()
pour d&eacute;finir les valeurs des propri&eacute;t&eacute;s URL et Credentials. Vous devez ajouter la m&eacute;thode
GetReportWebServiceWithAuthentication() &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer pour la d&eacute;claration et l'instanciation de la classe RemoteReportProxy.
Cette m&eacute;thode ajoute en option des param&egrave;tres de proxy pare-feu &agrave; l'instance RemoteReportProxy.
Proc&eacute;dure
1.
Au bas de la classe, cr&eacute;ez la m&eacute;thode d'assistance priv&eacute;e GetReportWebServiceWithAuthentication()
qui renvoie une classe RemoteReportProxy.
Private Function GetReportWebServiceWithAuthentication() As
96
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
RemoteReportProxy
End Function
private RemoteReportProxy GetReportWebServiceWithAuthentication()
{
}
2.
Dans la m&eacute;thode ConfigureCrystalReports(), s&eacute;lectionnez la cha&icirc;ne URL de service Web actuellement
affect&eacute;e &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer. Coupez cette cha&icirc;ne dans le
Presse-papiers.
Remarque
Plus loin dans cette proc&eacute;dure, vous affecterez une nouvelle valeur &agrave; la propri&eacute;t&eacute; ReportSource du
contr&ocirc;le CrystalReportViewer.
3.
D&eacute;clarez une variable cha&icirc;ne reportWebServiceURL et collez la cha&icirc;ne URL.
Dim reportWebServiceURL As String =
&quot;http://mywebserviceserver.com/MyWebServiceDirectory/Hierarchical
%20GroupingService.asmx&quot;
string reportWebServiceURL =
&quot;http://mywebserviceserver.com/MyWebServiceDirectory/Hierarchical
%20GroupingService.asmx&quot;;
4.
D&eacute;clarez et instanciez la classe RemoteReportProxy.
Dim myRemoteReportProxy As RemoteReportProxy = New RemoteReportProxy()
RemoteReportProxy remoteReportProxy = new RemoteReportProxy();
5.
Affectez la variable reportWebServiceURL &agrave; la propri&eacute;t&eacute; URL de l'instance RemoteReportProxy.
myRemoteReportProxy.Url = reportWebServiceURL
remoteReportProxy.Url = reportWebServiceURL;
6.
Appelez la m&eacute;thode ConfigureAuthentication() (que vous allez cr&eacute;er dans les proc&eacute;dures suivantes) et
transmettez-lui la valeur Boolean True et la variable reportWebServiceURL. Affectez cette m&eacute;thode &agrave; la
propri&eacute;t&eacute; Credentials de l'instance RemoteReportProxy.
myRemoteReportProxy.Credentials = ConfigureAuthentication(True,
reportWebServiceURL)
remoteReportProxy.Credentials = ConfigureAuthentication(true,
reportWebServiceURL);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
97
7.
Appelez la m&eacute;thode AddFirewallProxySettings() (que vous allez cr&eacute;er dans les proc&eacute;dures suivantes)
et transmettez-lui la valeur bool&eacute;enne False, la cha&icirc;ne URI d'un serveur proxy pare-feu et l'instance
RemoteReportProxy.
Remarque
Remplacez la cha&icirc;ne URI par votre serveur proxy pare-feu.
myRemoteReportProxy = AddFirewallProxySettings(False, &quot;&lt;&lt;
http://firewallproxyserver:8080&gt;&gt;&quot;,
myRemoteReportProxy)
remoteReportProxy = AddFirewallProxySettings(false, &quot;&lt;&lt;
http://firewallproxyserver:8080&gt;&gt;&quot;,
remoteReportProxy);
8.
Renvoyez l'instance RemoteReportProxy &agrave; partir de la m&eacute;thode.
Return myRemoteReportProxy
return remoteReportProxy;
1.3.6.4.1.2.4
Codage de la m&eacute;thode
ConfigureAuthentication()
Contexte
Dans cette section, vous allez apprendre &agrave; coder la m&eacute;thode ConfigureAuthentication() et ainsi d&eacute;couvrir
deux approches pour configurer l'authentification.
Dans la premi&egrave;re approche, vous allez utiliser un nom d'utilisateur, un mot de passe et un nom de domaine
sp&eacute;cifiques conform&eacute;ment aux autorisations utilisateur (droits d'acc&egrave;s) que vous avez ajout&eacute;es dans Ajout de
l'authentification NT &agrave; un service Web de rapports [page 93]. La seconde approche est bas&eacute;e sur l'autorisation
NTLM.
Lorsqu'une valeur True Boolean est transmise &agrave; cette m&eacute;thode, les r&eacute;f&eacute;rences de connexion propres &agrave;
l'utilisateur sont communiqu&eacute;es pour permettre l'acc&egrave;s aux services Web. La transmission d'une valeur Boolean
False entra&icirc;ne l'appel du code des r&eacute;f&eacute;rences de connexion NTLM pour acc&eacute;der aux services Web.
La m&eacute;thode ConfigureAuthentication() est appel&eacute;e &agrave; partir de la m&eacute;thode
GetReportWebServiceWithAuthentication().
98
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Proc&eacute;dure
1.
Au bas de la classe, cr&eacute;ez la m&eacute;thode d'assistance priv&eacute;e ConfigureAuthentication() qui renvoie
l'interface ICredentials. Cette m&eacute;thode fait appel &agrave; deux param&egrave;tres, une valeur bool&eacute;enne nomm&eacute;e
isUserSpecific et la cha&icirc;ne reportWebServiceURL.
Private Function ConfigureAuthentication(ByVal isUserSpecific As
Boolean, ByVal reportWebServiceURL As String) As ICredentials
End Function
private ICredentials ConfigureAuthentication(bool isUserSpecific,
string reportWebServiceURL)
{
}
2.
Dans la m&eacute;thode, cr&eacute;ez un bloc conditionnel qui teste le param&egrave;tre de m&eacute;thode Boolean isUserSpecific.
If isUserSpecific Then
Else
End If
if(isUserSpecific)
{
}
else
{
}
3.
Recueillez les informations suivantes : nom de domaine r&eacute;seau, nom et mot de passe de l'utilisateur auquel
vous avez accord&eacute; les droits d'acc&egrave;s au r&eacute;pertoire qui contient le service Web de rapports.
4.
Dans le bloc If, d&eacute;clarez et affectez les valeurs appropri&eacute;es aux variables cha&icirc;ne de nom d'utilisateur, de mot
de passe et de domaine.
Dim userName As String = &quot;fchen&quot;
&lt;NonSerialized()&gt; Dim password As String = &quot;1234&quot;
Dim domain As String = &quot;Enterprise&quot;
string userName = &quot;fchen&quot;;
[NonSerialized()] string password = &quot;1234&quot;;
string domain = &quot;Enterprise&quot;;
5.
D&eacute;clarez et instanciez la classe NetworkCredential et transmettez-lui les variables cha&icirc;ne de nom
d'utilisateur, de mot de passe et de domaine.
Dim myNetworkCredential As NetworkCredential = New
NetworkCredential(userName, password, domain)
NetworkCredential networkCredential = new
NetworkCredential(userName, password, domain);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
99
6.
Renvoyez l'instance NetworkCredential &agrave; partir du blocIf.
Dans le bloc Else, cr&eacute;ez trois autres valeurs : un URI pour le service Web de rapports, une cha&icirc;ne indiquant
que le type d'authentification est NTLM et une instance NetworkCredential. Chacune de ces valeurs est
transmise au cache des r&eacute;f&eacute;rences de connexion.
Return myNetworkCredential
return networkCredential;
7.
Dans le bloc Else, d&eacute;clarez et instanciez la classe CredentialCache.
Dim myCredentialCache As CredentialCache = New CredentialCache()
CredentialCache credentialCache = new CredentialCache();
8.
D&eacute;clarez et instanciez la classe Uri et transmettez-lui le param&egrave;tre reportWebServiceURL &agrave; partir de la
m&eacute;thode ConfigureAuthentication().
Dim myUri As Uri = New Uri(reportWebServiceURL)
Uri uri = new Uri(reportWebServiceURL);
9.
Affectez la valeur &quot;NTLM&quot; &agrave; une variable cha&icirc;ne nomm&eacute;e &quot;ntlmAuthorization&quot;.
Dim ntlmAuthorization As String = &quot;NTLM&quot;
string ntlmAuthorization = &quot;NTLM&quot;;
10. D&eacute;clarez et instanciez la classe NetworkCredential.
Dim myNetworkCredential As NetworkCredential = New
NetworkCredential()
NetworkCredential networkCredential = new NetworkCredential();
11. Transmettez l'instance Uri, la cha&icirc;ne ntlmAuthorization et l'instance NetworkCredential &agrave; la m&eacute;thode Add()
de l'instance CredentialCache.
myCredentialCache.Add(myUri, ntlmAuthorization,
myNetworkCredential)
credentialCache.Add(uri, ntlmAuthorization, networkCredential);
100
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
12. Renvoyez l'instance ICredentials &agrave; partir de la propri&eacute;t&eacute; DefaultCredentials de la classe
CredentialCache du bloc Else.
Return CredentialCache.DefaultCredentials
return CredentialCache.DefaultCredentials;
1.3.6.4.1.2.5
Codage de la m&eacute;thode
AddFirewallProxySettings()
Contexte
Dans cette section, vous allez apprendre &agrave; coder la m&eacute;thode AddFirewallProxySettings() avec l'instance
RemoteReportProxy en tant que param&egrave;tre. Vous apprendrez &eacute;galement &agrave; ajouter des param&egrave;tres proxy Web &agrave;
l'instance RemoteReportProxy.
La m&eacute;thode AddFirewallProxySettings() est appel&eacute;e &agrave; partir de la m&eacute;thode
GetReportWebServiceWithAuthentication().
Cette m&eacute;thode ne s'ex&eacute;cute que lorsque vous avez besoin d'acc&eacute;der au service Web de rapports par le biais d'un
serveur proxy pare-feu.
Proc&eacute;dure
1.
Au bas de la classe, cr&eacute;ez la m&eacute;thode d'assistance priv&eacute;e AddFirewallProxySettings() qui renvoie la
classe RemoteReportProxy et transmettez-lui une variable bool&eacute;enne, une variable cha&icirc;ne et l'instance
RemoteReportProxy.
Private Function AddFirewallProxySettings(ByVal isFirewallProxy As
Boolean, ByVal webProxyURI As String, ByVal remoteReportProxy As
RemoteReportProxy) As RemoteReportProxy
End Function
private RemoteReportProxy AddFirewallProxySettings(bool
isFirewallProxy, string webProxyURI, RemoteReportProxy
remoteReportProxy)
{
}
2.
Dans la m&eacute;thode, cr&eacute;ez un bloc conditionnel qui teste la variable Boolean isFirewallProxy.
If isFirewallProxy Then
End If
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
101
if(isFirewallProxy)
{
}
3.
Dans le bloc conditionnel, d&eacute;clarez et instanciez la classe WebProxy et transmettez-lui la cha&icirc;ne
webProxyURI et la valeur BooleanTrue.
Dim myWebProxy As WebProxy = New WebProxy(webProxyURI, True)
WebProxy webProxy = new WebProxy(webProxyURI, true);
4.
Affectez l'instance WebProxy &agrave; la propri&eacute;t&eacute; Proxy de l'instance RemoteReportProxy qui a &eacute;t&eacute; transmise &agrave; la
m&eacute;thode en tant que param&egrave;tre.
myRemoteReportProxy.Proxy = myWebProxy
remoteReportProxy.Proxy = webProxy;
5.
En dehors du bloc conditionnel, renvoyez l'instance RemoteReportProxy.
Return myRemoteReportProxy
return remoteReportProxy;
R&eacute;sultats
Lorsqu'une valeur bool&eacute;enne False est transmise au param&egrave;tre isFireWallProxy, les param&egrave;tres du proxy
pare-feu ne sont pas ajout&eacute;s. Il est conseill&eacute; de tester cette version du projet avec la configuration
d'authentification NT la plus simple et sans pare-feu entre le client test et le service Web.
Lorsque vous testez ce projet avec un pare-feu, placez l'application cliente en dehors du pare-feu, puis modifiez le
param&egrave;tre bool&eacute;en isFireWallProxy en lui attribuant la valeur True. Vous devez affecter au param&egrave;tre cha&icirc;ne
webProxyURI une valeur URI de proxy Web correcte et continuer &agrave; tester ce code via un pare-feu.
Informations associ&eacute;es
Connexion aux services Web de rapports &agrave; partir d'un site Web s&eacute;curis&eacute; [page 93]
102
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.3.6.4.1.3
Test du code d'authentification NT et des
r&eacute;f&eacute;rences de connexion NTLM
1.3.6.4.1.3.1
V&eacute;rification de l'authentification NT
Pr&eacute;requis
Pour pouvoir tester le code, vous devez auparavant modifier le code de liaison de rapport dans la m&eacute;thode
ConfigureCrystalReports().
●
Dans la m&eacute;thode ConfigureCrystalReports(), affectez &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer un appel &agrave; la m&eacute;thode GetReportWebServiceWithAuthentication().
myCrystalReportViewer.ReportSource =
GetReportWebServiceWithAuthentication()
crystalReportViewer.ReportSource =
GetReportWebServiceWithAuthentication();
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; tester le code d'authentification NT que vous avez ajout&eacute; au projet client de service
Web.
Contexte
Pour tester le code d'authentification NT du projet client de service Web
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
L'application cliente se connecte au service Web et, si les nom d'utilisateur, mot de passe et nom de domaine
sont corrects, le rapport s'affiche.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Vous venez de vous connecter au r&eacute;pertoire s&eacute;curis&eacute; &agrave; l'aide des r&eacute;f&eacute;rences de connexion r&eacute;seau propres &agrave;
l'utilisateur. Vous allez maintenant apprendre &agrave; tester la connexion via les r&eacute;f&eacute;rences de connexion NTLM.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
103
Remarque
Pour configurer les param&egrave;tres du proxy pare-feu, vous pouvez modifier la valeur Boolean transmise &agrave; la
m&eacute;thode AddFirewallProxySettings() en tant que param&egrave;tre.
Informations associ&eacute;es
Fichiers serveur et authentification NT [page 104]
1.3.6.4.1.3.2
Pour tester les r&eacute;f&eacute;rences de connexion NTLM
du projet client de service Web
Proc&eacute;dure
1.
Recherchez l'appel &agrave; la m&eacute;thode ConfigureAuthentication() dans la m&eacute;thode
GetReportWebServiceWithAuthentication().
2.
Dans l'appel &agrave; la m&eacute;thode ConfigureAuthentication(), remplacez la valeur bool&eacute;enne True du premier
param&egrave;tre par False.
3.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
5.
L'application cliente se connecte au service Web &agrave; l'aide de l'authentification NTLM.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Vous &ecirc;tes maintenant capable de vous connecter depuis votre client de services Web &agrave; un service Web de
rapports situ&eacute; dans un r&eacute;pertoire s&eacute;curis&eacute;. Pour cela, vous avez configur&eacute; des valeurs dans l'instance
RemoteReportProxy, puis transmis cette instance &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
1.3.6.4.2
Fichiers serveur et authentification NT
Vous pouvez utiliser les fichiers serveur pour vous connecter facilement aux rapports stock&eacute;s sur un ordinateur
distant.
Toutefois, si le r&eacute;pertoire virtuel qui fournit les rapports stock&eacute;s dans les fichiers serveur est prot&eacute;g&eacute; par un
m&eacute;canisme d'authentification NT, vous devez ajouter du code &agrave; l'application cliente pour d&eacute;signer ces rapports et
fournir les r&eacute;f&eacute;rences de connexion r&eacute;seau n&eacute;cessaires.
104
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Configuration des fichiers serveur dans les services Crystal [page 86]
1.3.6.4.2.1
Cr&eacute;ation d'un projet pour d&eacute;signer un r&eacute;pertoire
de fichiers serveur non s&eacute;curis&eacute;
Pr&eacute;requis
Pour cr&eacute;er un projet qui d&eacute;signe un r&eacute;pertoire non s&eacute;curis&eacute;, les fichiers serveur doivent &ecirc;tre configur&eacute;s pour la
version de Visual Studio dont vous disposez.
Suivez les instructions de la section appropri&eacute;e et notez le chemin d'acc&egrave;s au r&eacute;pertoire de vos rapports (vous en
aurez besoin pour les proc&eacute;dures suivantes) :
●
Configuration des fichiers serveur dans Visual Studio .NET 2003 [page 86]
●
Configuration des fichiers serveur dans Visual Studio 2005 et les versions plus r&eacute;centes [page 89]
Acc&eacute;dez au r&eacute;pertoire de rapports de votre projet et identifiez le nom d'un rapport que vous voulez visualiser via
les fichiers serveur.
Dans les &eacute;tapes suivantes, le rapport utilis&eacute; en exemple s'appelle Hierarchical Grouping.rpt.
Remarque
Les instructions ci-dessous ne s'appliquent qu'&agrave; un projet cr&eacute;&eacute; dans la section Configuration d'un projet [page
15].
Contexte
Dans cette section, vous allez apprendre &agrave; d&eacute;finir les r&eacute;f&eacute;rences de connexion r&eacute;seau dont vous avez besoin.
Vous allez commencer par cr&eacute;er une application cliente qui acc&egrave;de aux rapports stock&eacute;s dans les fichiers serveur
et qui autorise un acc&egrave;s non s&eacute;curis&eacute; au r&eacute;pertoire de services Web. Apr&egrave;s avoir v&eacute;rifi&eacute; que votre application
cliente fonctionne, vous pourrez s&eacute;curiser l'acc&egrave;s au r&eacute;pertoire virtuel, puis ajouter du code &agrave; l'application cliente
pour fournir les r&eacute;f&eacute;rences de connexion n&eacute;cessaires &agrave; l'authentification NT.
Pour cr&eacute;er une application cliente afin d'acc&eacute;der aux rapports des fichiers serveur :
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
105
3.
Localisez la m&eacute;thode ConfigureCrystalReports() que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15].
4.
Dans la m&eacute;thode, d&eacute;clarez et instanciez la classe ServerFileReport.
Dim myServerFileReport As ServerFileReport = New ServerFileReport()
ServerFileReport serverFileReport = new ServerFileReport();
5.
Affectez &agrave; la propri&eacute;t&eacute; ReportPath de l'instance ServerFileReport le nom du rapport que vous voulez
afficher &agrave; partir du r&eacute;pertoire de rapports.
Remarque
Il s'agit du r&eacute;pertoire que vous avez configur&eacute; pour les rapports de fichiers serveur dans le fichier
Web.config.
Lorsque vous avez configur&eacute; le r&eacute;pertoire virtuel des visualiseurs, vous avez test&eacute; le param&egrave;tre wsdl en
entrant l'URL du service Web ServerFileReportServer.asmx &agrave; partir du chemin d'acc&egrave;s du r&eacute;pertoire virtuel.
Dans l'&eacute;tape suivante, vous allez saisir cette URL en tant que valeur dans le code.
L'exemple de code ci-dessous utilise le rapport Hierarchical Grouping, qui figure dans le sous-r&eacute;pertoire
Feature Examples du dossier des exemples de rapports. Veillez &agrave; saisir le nom du sous-r&eacute;pertoire, suivi d'une
barre oblique inverse.
myServerFileReport.ReportPath = &quot;Feature Examples\Hierarchical
Grouping.rpt&quot;
serverFileReport.ReportPath = &quot;Feature Examples\\Hierarchical
Grouping.rpt&quot;;
6.
Localisez la version correcte de l'URL du service Web ServerFileReportService.asmx en fonction de
votre version de SAP Crystal Reports.
Si vous disposez de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, cet emplacement
correspond au r&eacute;pertoire virtuel du visualiseur de la version install&eacute;e de SAP Crystal Reports.
Si vous avez install&eacute; SAP Crystal Reports, mais pas SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio, il s'agit de l'URL du service Web de rapports que vous avez cr&eacute;&eacute; dans Configuration des fichiers
serveur dans Visual Studio 2005 et les versions plus r&eacute;centes [page 89].
7.
Affectez cette URL de service Web &agrave; la propri&eacute;t&eacute; WebService de l'instance ServerFileReport.
myServerFileReport.WebServiceUrl =
&quot;http://localhost/CrystalReportsWebServices/ServerFileReportService.asmx&quot;
serverFileReport.WebServiceUrl =
&quot;http://localhost/CrystalReportsWebServices/ServerFileReport.asmx&quot;;
L'instance ServerFileReport est maintenant configur&eacute;e et pr&ecirc;te &agrave; &ecirc;tre transmise au contr&ocirc;le
CrystalReportViewer.
106
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
8.
Affectez l'instance de ServerFileReport &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = myServerFileReport
crystalReportViewer.ReportSource = serverFileReport;
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.4.2.2
Reconfiguration des fichiers serveur pour
d&eacute;signer un r&eacute;pertoire s&eacute;curis&eacute;
Dans cette section, vous allez apprendre &agrave; reconfigurer le r&eacute;pertoire et l'application cliente pour d&eacute;signer un
r&eacute;pertoire s&eacute;curis&eacute;.
Vous allez commencer par d&eacute;sactiver l'acc&egrave;s anonyme au r&eacute;pertoire virtuel des visualiseurs dans IIS (Internet
Information Services).
1.3.6.4.2.2.1
Pour d&eacute;sactiver l'acc&egrave;s anonyme au r&eacute;pertoire
virtuel des visualiseurs dans IIS
Proc&eacute;dure
1.
Dans le Panneau de configuration, cliquez deux fois sur Outils d'administration, puis sur Gestionnaire des
services Internet.
2.
Dans la fen&ecirc;tre Services Internet (IIS), d&eacute;veloppez les nœuds sup&eacute;rieurs, puis le nœud Site Web par d&eacute;faut.
3.
Localisez le r&eacute;pertoire virtuel voulu, cliquez dessus avec le bouton droit de la souris, puis s&eacute;lectionnez
Propri&eacute;t&eacute;s.
4.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s, dans l'onglet S&eacute;curit&eacute; de r&eacute;pertoire, cliquez sur Modifier.
5.
D&eacute;sactivez la case &agrave; cocher Acc&egrave;s anonyme, puis cliquez sur OK.
6.
Cliquez sur OK pour fermer la bo&icirc;te de dialogue Propri&eacute;t&eacute;s.
7.
Fermez la fen&ecirc;tre Services Internet (IIS).
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
107
R&eacute;sultats
Vous allez ensuite ajouter une balise &lt;identity&gt; dans le fichier Web.config.
Remarque
Il s'agit du fichier Web.config que vous avez modifi&eacute; pr&eacute;c&eacute;demment lors de la proc&eacute;dure de configuration des
fichiers serveur.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.4.2.2.2
Web.config
Pour ajouter la balise &lt;identity&gt; au fichier
Proc&eacute;dure
1.
Rouvrez le fichier Web.config dans le r&eacute;pertoire virtuel des visualiseurs.
Remarque
Il existe deux fichiers Web.config, l'un dans le r&eacute;pertoire virtuel des visualiseurs, l'autre dans votre
application Web locale. Vous devez ajouter la balise d'identit&eacute; au fichier Web.config situ&eacute; dans le r&eacute;pertoire
virtuel du visualiseur. En effet, cette balise est requise lorsque l'acc&egrave;s anonyme &agrave; un r&eacute;pertoire virtuel a &eacute;t&eacute;
d&eacute;sactiv&eacute;.
2.
Dans la balise &lt;system.web&gt;, au d&eacute;but, saisissez la balise &lt;identity&gt; comme indiqu&eacute; ci-apr&egrave;s.
&lt;identity impersonate='true' /&gt;
3.
Enregistrez le fichier Web.config.
4.
Si vous avez &eacute;galement d&eacute;sactiv&eacute; l'acc&egrave;s anonyme au r&eacute;pertoire virtuel de votre projet Web client, ajoutez
&eacute;galement la balise &lt;identity&gt; au fichier Web.config de votre projet Web client.
&Eacute;tapes suivantes
Vous allez ensuite modifier le projet Web ou Windows client pour acc&eacute;der au service Web de rapports s&eacute;curis&eacute; via
l'authentification NT.
108
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
1.3.6.4.2.2.3
Pour modifier le projet client de sorte qu'il
d&eacute;signe le r&eacute;pertoire virtuel s&eacute;curis&eacute; des visualiseurs
Proc&eacute;dure
1.
Ouvrez le projet Web ou Windows client dans Visual Studio.
2.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rences, puis s&eacute;lectionnez Ajouter une r&eacute;f&eacute;rence.
3.
Dans la bo&icirc;te de dialogue Ajouter une r&eacute;f&eacute;rence, dans l'onglet .NET, cliquez sur les deux assemblys suivants
tout en maintenant la touche CTRL enfonc&eacute;e pour les s&eacute;lectionner :
○
CrystalDecisions.ReportSource
○
System.Web.Services
4.
Cliquez sur S&eacute;lectionner sur le c&ocirc;t&eacute; droit de la bo&icirc;te de dialogue.
5.
V&eacute;rifiez que les deux assemblys ont bien &eacute;t&eacute; ajout&eacute;s dans le panneau Composants s&eacute;lectionn&eacute;s, puis cliquez
sur OK.
6.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
s&eacute;lectionnez Ajouter, puis cliquez sur Ajouter une classe.
7.
Dans le champ Nom, saisissez le nom de classe &quot;NTServerFileRemoteReportSource&quot;, puis cliquez sur
Ajouter.
8.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au
d&eacute;but de la classe pour les trois espaces de noms suivants.
Imports CrystalDecisions.Shared
Imports CrystalDecisions.ReportSource
Imports System.Net
using CrystalDecisions.Shared;
using CrystalDecisions.ReportSource;
using System.Net;
9.
Modifiez la signature de classe NTServerFileRemoteReportSource pour &eacute;tendre la classe
RemoteReportSource.
Public Class NTServerFileRemoteReportSource : Inherits RemoteReportSource
End Class
public class NTServerFileRemoteReportSource : RemoteReportSource
{
}
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
109
La classe de base RemoteReportSource ne contenant aucun constructeur sans argument, vous devez cr&eacute;er
un constructeur avec arguments pour remplacer celui de la classe de base RemoteReportSource.
10. Si vous codez votre projet en C#, supprimez le constructeur par d&eacute;faut cr&eacute;&eacute; dans cette classe.
11. Cr&eacute;ez un constructeur qui contient un param&egrave;tre de m&eacute;thode de ServerFileReport, puis appelez le
constructeur de la classe de base en transmettant le param&egrave;tre de rapport ainsi que la valeur bool&eacute;enne
False.
Public Sub New(ByVal report As ServerFileReport)
MyBase.New(report, False)
End Sub
public NTServerFileRemoteReportSource(ServerFileReport report) : base(report,
false)
{
}
12. Dans le constructeur, affectez la propri&eacute;t&eacute; statique DefaultCredentials de la classe CredentialCache &agrave; la
propri&eacute;t&eacute; Credentials de la propri&eacute;t&eacute; m_proxy de la classe de base.
MyBase.m_proxy.Credentials = CredentialCache.DefaultCredentials
base.m_proxy.Credentials = CredentialCache.DefaultCredentials;
13. Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Vous pouvez maintenant modifier la classe code-behind du Web Form ou du Windows Form.
1.3.6.4.2.2.4
Pour modifier la classe code-behind de sorte
qu'elle d&eacute;signe la source de rapport distant
Proc&eacute;dure
1.
Revenez au Web Form ou Windows Form d'origine.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la m&eacute;thode ConfigureCrystalReports(), ajoutez une nouvelle ligne entre le param&egrave;tre de la
propri&eacute;t&eacute; serverFileReport.WebServiceUrl et celui de la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer. Dans cette ligne, d&eacute;clarez et instanciez la nouvelle classe &eacute;tendue que vous avez
cr&eacute;&eacute;e, puis transmettez l'instance ServerFileReport en tant que param&egrave;tre de m&eacute;thode.
Dim myNTServerFileRemoteReportSource As NTServerFileRemoteReportSource = New
NTServerFileRemoteReportSource(myServerFileReport)
110
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
NTServerFileRemoteReportSource ntServerFileRRS = new
NTServerFileRemoteReportSource(serverFileReport);
4.
Modifiez la derni&egrave;re ligne de code de cette m&eacute;thode de la mani&egrave;re suivante : remplacez l'instance
ServerFileReport affect&eacute;e &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer par la nouvelle
instance NTServerFileRemoteReportSource.
myCrystalReportViewer.ReportSource = myNTServerFileRemoteReportSource
crystalReportViewer.ReportSource = ntServerFileRRS;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; tester l'application cliente qui a &eacute;t&eacute; modifi&eacute;e pour transmettre les r&eacute;f&eacute;rences de
connexion n&eacute;cessaires &agrave; partir d'une source de rapport distant. Cette application d&eacute;signe le service de rapports
des fichiers serveur par l'interm&eacute;diaire du r&eacute;pertoire virtuel des visualiseurs, qui n&eacute;cessite d&eacute;sormais une
authentification NT.
1.3.6.4.2.2.5
Pour tester la source de rapport distant &agrave; l'aide
des r&eacute;f&eacute;rences de connexion qui d&eacute;signent le r&eacute;pertoire virtuel
s&eacute;curis&eacute; des visualiseurs
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
L'application cliente se connecte au r&eacute;pertoire virtuel s&eacute;curis&eacute; des visualiseurs, et, si la nouvelle instance
NTServerFileRemoteReportSource a &eacute;t&eacute; configur&eacute;e avec les r&eacute;f&eacute;rences de connexion correctes, le
rapport s'affiche.
3.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.3.7
Consid&eacute;rations de s&eacute;curit&eacute;
Les sc&eacute;narios suivants doivent &ecirc;tre pris en compte lors de la conception d'une application s&eacute;curis&eacute;e
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
111
Stockage des donn&eacute;es dans la m&eacute;moire cache frontale
Les rapports visualis&eacute;s dans un navigateur Web peuvent contenir des donn&eacute;es sensibles qu'un navigateur Web
est susceptible de mettre en cache. Consultez la documentation Microsoft pour savoir comment d&eacute;sactiver la
mise en cache pour diff&eacute;rents navigateurs.
Protection du fichier de rapport
Les fichiers SAP Crystal Reports .rpt doivent contenir des donn&eacute;es professionnelles sensibles. Il est recommand&eacute;
de prot&eacute;ger l'acc&egrave;s &agrave; vos rapports en les g&eacute;rant avec le serveur de la plateforme SAP BusinessObjects Business
Intelligence, en utilisant la s&eacute;curit&eacute; de fichier ou le cryptage au niveau du syst&egrave;me d'exploitation.
Validation d'entr&eacute;e utilisateur avec champs de param&egrave;tre
Les champs de param&egrave;tre invitent l'utilisateur &agrave; fournir les informations utilis&eacute;es pour le traitement d'un rapport.
La bo&icirc;te de dialogue d'invite valide les donn&eacute;es mais des &eacute;tapes suppl&eacute;mentaires permettent de s'assurer que les
valeurs attendues sont fournies :
1.
Utilisez le texte de l'invite pour d&eacute;crire le type de donn&eacute;es attendues.
2.
Indiquez une valeur minimale et une valeur maximale pour limiter la plage de nombres &agrave; saisir pour les
donn&eacute;es num&eacute;riques.
3.
Utilisez un masque d'&eacute;dition pour demander les donn&eacute;es dans un format sp&eacute;cifique.
4.
Construisez votre propre bo&icirc;te de dialogue d'invite. Le SDK de SAP Crystal Reports .NET fournit de
nombreuses API pouvant &ecirc;tre utilis&eacute;es pour construire votre propre bo&icirc;te de dialogue d'invite. En cr&eacute;ant votre
propre bo&icirc;te de dialogue d'invite, vous contr&ocirc;lez totalement la mani&egrave;re dont l'utilisateur fournit les champs de
param&egrave;tre.
Utilisation du contr&ocirc;le d'impression ActiveX pour imprimer les rapports depuis
le visualiseur Web Form .NET
Le visualiseur Web Form .NET SAP Crystal Reports vous permet d'imprimer le rapport sous format PDF ou en
utilisant un contr&ocirc;le d'impression ActiveX. Le format PDF est l'option par d&eacute;faut recommand&eacute;e pour l'impression
d'un rapport. Le contr&ocirc;le d'impression ActiveX est fourni comme solution alternative permettant une impression
en un seul clic. Cette option n'est pas recommand&eacute;e car elle requiert des droits d'administrateur pour &ecirc;tre
install&eacute;e. Le contr&ocirc;le d'impression ActiveX est en outre utilis&eacute; dans un navigateur Web, le bit d'arr&ecirc;t n'est donc
pas d&eacute;fini, ce qui est consid&eacute;r&eacute; comme &eacute;tant moins s&ucirc;r.
112
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Construction d'une application pour visualiser les rapports dans la plateforme
SAP BusinessObjects Business Intelligence
Vous pouvez utiliser SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio pour cr&eacute;er des
applications destin&eacute;es &agrave; visualiser les rapports stock&eacute;s dans un syst&egrave;me de plateforme SAP BusinessObjects
Business Intelligence. Il est n&eacute;cessaire de prendre en compte les impacts en termes de s&eacute;curit&eacute; lors de la cr&eacute;ation
d'applications destin&eacute;es &agrave; visualiser les rapports stock&eacute;s dans un syst&egrave;me de plateforme SAP BusinessObjects
Business Intelligence. Pour en savoir plus, voir le Guide d'administration de la plateforme SAP BusinessObjects
Business Intelligence.
Informations associ&eacute;es
Filtrage de donn&eacute;es avec des param&egrave;tres ou des formules [page 136]
1.4
Utilisation du SDK
Cette section fournit des instructions d&eacute;taill&eacute;es sur l'utilisation de fonctionnalit&eacute;s sp&eacute;cifiques du SDK
SAP Crystal Reports .Net.
1.4.1
Impression d'un rapport
Le SDK SAP Crystal Reports .NET permet de cr&eacute;er des applications Windows ou des sites Web pouvant
s'imprimer sur l'imprimante d'un utilisateur final ou sur une imprimante configur&eacute;e sur votre serveur Web.
La mani&egrave;re la plus simple d'ajouter des fonctionnalit&eacute;s d'impression &agrave; votre application SAP Crystal Reports .NET
est d'utiliser le bouton d'impression du contr&ocirc;le CrystalReportViewer. Lorsque les utilisateurs cliquent sur le
bouton d'impression de la barre d'outils, la bo&icirc;te de dialogue d'impression standard du syst&egrave;me s'affiche. Les
param&egrave;tres d'impression personnalis&eacute;e peuvent &ecirc;tre sp&eacute;cifi&eacute;s par le biais de cette bo&icirc;te de dialogue.
Le SDK SAP Crystal Reports .NET permet de configurer des options d'impression et d'appeler une imprimante
depuis le code, plut&ocirc;t que depuis l'interface utilisateur de SAP Crystal Reports. Utilisez la classe PrintOptions
et la m&eacute;thode PrintToPrinter du mod&egrave;le d'objet ReportDocument.
Classes utilis&eacute;es pour l'impression de rapports
●
CrystalDecisions.CrystalReports.Engine.ReportDocument
Repr&eacute;sente un rapport et contient les propri&eacute;t&eacute;s et les m&eacute;thodes permettant de d&eacute;finir, mettre en forme,
charger, exporter et imprimer ce rapport.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
113
●
CrystalDecisions.CrystalReports.Engine.PrintOptions
Indique les propri&eacute;t&eacute;s et les m&eacute;thodes permettant de d&eacute;finir les options d'impression d'un rapport.
●
CrystalDecisions.Windows.Forms.CrystalReportViewer
Repr&eacute;sente le contr&ocirc;le CrystalReportViewer dans un Windows Form. Le contr&ocirc;le CrystalReportViewer permet
d'imprimer des rapports via l'interface utilisateur.
●
CrystalDecisions.Web.CrystalReportViewer
Fournit des propri&eacute;t&eacute;s, des m&eacute;thodes et des &eacute;v&eacute;nements permettant de modifier ou d'extraire les
informations sur la mani&egrave;re dont fonctionne et s'affiche le contr&ocirc;le CrystalReportViewer. Le contr&ocirc;le
CrystalReportViewer permet d'imprimer des rapports via l'interface utilisateur.
Informations associ&eacute;es
Exportation d'un rapport [page 123]
1.4.1.1
Impression d'un rapport depuis le contr&ocirc;le
CrystalReportViewer
La mani&egrave;re la plus simple d'ajouter des fonctionnalit&eacute;s d'impression &agrave; votre application SAP Crystal Reports .NET
est d'utiliser le bouton d'impression du contr&ocirc;le CrystalReportViewer. Le bouton d'impression est activ&eacute; par
d&eacute;faut sur la barre d'outils CrystalReportViewer.
Il existe deux contr&ocirc;les CrystalReportViewer dans le SDK SAP Crystal Reports .NET. Pour un site Web, vous
utiliserez la classe CrystalDecisions.Web.CrystalReportViewer. Pour une application Windows, vous
utiliserez la classe CrystalDecisions.Windows.Forms.CrystalReportViewer.
Impression &agrave; l'aide de la classe
CrystalDecisions.Windows.Forms.CrystalReportViewer
Lorsque vous cliquez sur le bouton d'impression de la barre d'outils CrystalReportViewer dans une application
Windows, la bo&icirc;te de dialogue d'impression Windows standard s'affiche. Vous pouvez invoquer par
programmation la bo&icirc;te de dialogue d'impression via la m&eacute;thode CrystalReportViewer.PrintReport.
Le bouton d'impression peut &ecirc;tre d&eacute;sactiv&eacute; dans une application Windows en d&eacute;finissant la propri&eacute;t&eacute;
CrystalReportViewer.ShowPrintButton sur False.
Impression &agrave; l'aide de la classe CrystalDecisions.Web.CrystalReportViewer
Le contr&ocirc;le CrystalReportViewer pour les sites Web prend en charge deux m&eacute;thodes d'impression : PDF et
ActiveX.
114
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
L'impression PDF est le param&egrave;tre par d&eacute;faut pour un site Web. Lorsque vous cliquez sur le bouton d'impression
de la barre d'outils CrystalReportViewer dans un site Web, la bo&icirc;te de dialogue Options d'impression s'affiche.
Saisissez une option d'impression personnalis&eacute;e et cliquez sur OK. SAP Crystal Reports ouvre une nouvelle
fen&ecirc;tre avec un PDF de votre rapport. Imprimez le PDF sur votre imprimante locale.
Si l'impression ActiveX est activ&eacute;e, la bo&icirc;te de dialogue d'impression Windows standard s'affiche lorsque vous
cliquez sur le bouton d'impression. L'impression ActiveX requiert une configuration suppl&eacute;mentaire et
&eacute;ventuellement l'installation du plug-in ActiveX PrintControl.cab sur l'ordinateur client.
Le bouton d'impression peut &ecirc;tre d&eacute;sactiv&eacute; sur un site Web en d&eacute;finissant la propri&eacute;t&eacute;
CrystalReportViewer.HasPrintButton sur False.
Informations associ&eacute;es
Impression d'un rapport par programmation [page 118]
1.4.1.1.1
Suppression du bouton d'impression depuis le
contr&ocirc;le CrystalReportViewer
Contexte
Vous pourrez continuer &agrave; utiliser le SDK pour imprimer un rapport, m&ecirc;me si le bouton d'impression n'est pas
visible.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
D&eacute;finissez la propri&eacute;t&eacute; qui contr&ocirc;le la visibilit&eacute; du bouton d'impression sur False.
○
Pour une application Windows, d&eacute;finissez la propri&eacute;t&eacute; CrystalReportViewer.ShowPrintButton sur
False.
○
Pour un site Web, d&eacute;finissez la propri&eacute;t&eacute; CrystalReportViewer.HasPrintButton sur False.
R&eacute;sultats
Lorsque vous ex&eacute;cuterez votre application, le bouton d'impression ne devrait plus appara&icirc;tre sur le contr&ocirc;le
CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
115
Exemple
D&eacute;sactivation du bouton Imprimer dans une application Windows
Private Sub ConfigureCrystalReports()
CrystalReportViewer1.ShowPrintButton = False
End Sub
private void ConfigureCrystalReports()
{
InitializeComponent();
crystalReportViewer1.ShowPrintButton = false;
}
Informations associ&eacute;es
Impression d'un rapport [page 113]
1.4.1.1.2
Impression d'un rapport avec la m&eacute;thode
CrystalReportViewer.PrintReport
Pr&eacute;requis
Assurez-vous qu'une imprimante a &eacute;t&eacute; configur&eacute;e sur l'ordinateur client avant d'essayer d'imprimer.
Contexte
Vous pouvez invoquer par programmation la bo&icirc;te de dialogue d'impression via la m&eacute;thode
CrystalReportViewer.PrintReport dans une application Windows. Utilisez cette m&eacute;thode pour imprimer
lorsque la barre d'outils CrystalReportViewer est masqu&eacute;e ou dans une application qui utilise des boutons de
barre d'outils personnalis&eacute;s.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre Windows Form.
2.
Configurez une source de rapport valide et liez-la au contr&ocirc;le CrystalReportViewer.
3.
Appelez la m&eacute;thode PrintReport pour invoquer la bo&icirc;te de dialogue d'impression par d&eacute;faut.
116
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple
Private Sub PrintReport()
CrystalReportViewer.PrintReport()
End Sub
private void PrintReport()
{
crystalReportViewer.PrintReport();
}
1.4.1.1.3
Web
Activation de l'impression ActiveX dans un site
Contexte
Si l'impression ActiveX est activ&eacute;e, la bo&icirc;te de dialogue d'impression standard du syst&egrave;me s'affiche lorsque
l'utilisateur clique sur le bouton d'impression. L'impression ActiveX requiert une configuration suppl&eacute;mentaire et
&eacute;ventuellement l'installation du plug-in ActiveX PrintControl.cab sur l'ordinateur client.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
D&eacute;finissez la propri&eacute;t&eacute; de mode d'impression du contr&ocirc;le CrystalReportViewer sur ActiveX.
CrystalReportViewer1.PrintMode = PrintMode.ActiveX
CrystalReportViewer1.PrintMode = PrintMode.ActiveX;
3.
Dans votre fichier Web.Config, ajoutez une r&eacute;f&eacute;rence au contr&ocirc;le ActiveX PrintControl.cab.
&lt;configSections&gt;
&lt;section group name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;printControl&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;printControl&gt;
&lt;add key=&quot;url&quot; value=&quot;http://localhost/PrintControl.cab&quot; /&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
117
&lt;/printControl&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
Remplacez &quot;localhost&quot; par l'adresse de votre serveur Web.
L'&eacute;l&eacute;ment printControl vous permet d'imprimer le rapport directement sur votre imprimante locale. Par
d&eacute;faut, ce contr&ocirc;le n'est pas install&eacute; sur votre ordinateur local et doit &ecirc;tre t&eacute;l&eacute;charg&eacute; s&eacute;par&eacute;ment. Ce
param&egrave;tre rend le fichier .cab visible par votre site Web SAP Crystal Reports .NET.
R&eacute;sultats
Le contr&ocirc;le CrystalReportViewer doit &agrave; pr&eacute;sent utiliser la bo&icirc;te de dialogue d'impression Windows au lieu de
l'impression PDF. La premi&egrave;re fois qu'un utilisateur essaie d'imprimer depuis le site Web SAP Crystal Reports, il se
peut qu'il soit invit&eacute; &agrave; installer le plug-in ActiveX PrintControl.cab.
Informations associ&eacute;es
Configuration du fichier Web.Config [page 20]
1.4.1.2
Impression d'un rapport par programmation
Vous pouvez configurer des options d'impression et appeler une imprimante par programmation. Pour ce faire,
utilisez la classe PrintOptions et la m&eacute;thode PrintToPrinter du mod&egrave;le d'objet ReportDocument.
Si le bouton Imprimer de la barre d'outils du contr&ocirc;le CrystalReportViewer r&eacute;pond &agrave; vos besoins d'impression, il
est inutile d'&eacute;crire un code pour configurer des options d'impression suppl&eacute;mentaires.
Toutefois, pour des sc&eacute;narios particuliers, vous pouvez avoir recours &agrave; une solution bas&eacute;e sur du code pour
l'impression des rapports :
●
Vous pouvez contr&ocirc;ler le moment, l'emplacement et la configuration de votre impression. D&eacute;sactivez le
bouton Imprimerde la barre d'outils du contr&ocirc;le CrystalReportViewer et g&eacute;rez toutes les impressions via le
code.
●
Vous pouvez imprimer un rapport en arri&egrave;re-plan, sans l'afficher. Les param&egrave;tres d'impression sont
accessibles via la classe ReportDocument, qui peut &ecirc;tre instanci&eacute;e et configur&eacute;e sans jamais afficher le
rapport avec un contr&ocirc;le CrystalReportViewer.
●
Vous pouvez centraliser toutes les impressions sur le serveur Web pour un client Web. Utilisez la m&eacute;thode
PrintToPrinter() pour envoyer des t&acirc;ches d'impression &agrave; une imprimante connect&eacute;e au serveur Web
plut&ocirc;t qu'&agrave; une imprimante locale connect&eacute;e au client Web.
Remarque
L'impression par programmation &agrave; l'aide du mod&egrave;le d'objet ReportDocument est moins compl&egrave;te que la
structure de planification des rapports fournie avec SAP Crystal Reports Server ou la plateforme SAP
BusinessObjects Business Intelligence.
118
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Impression par programmation depuis une application Web
Si vous utilisez la m&eacute;thode ReportDocument.PrintToPrinter dans une application Web, le rapport est
imprim&eacute; depuis le serveur Web et non depuis l'ordinateur client. Toute l'impression c&ocirc;t&eacute; client utilise le contr&ocirc;le
CrystalReportViewer.
Informations associ&eacute;es
Impression d'un rapport depuis le contr&ocirc;le CrystalReportViewer [page 114]
1.4.1.2.1
D&eacute;finition des options d'impression personnalis&eacute;e
avec le mod&egrave;le d'objet ReportDocument
La classe PrintOptions permet de sp&eacute;cifier des param&egrave;tres suppl&eacute;mentaires avant l'impression d'un rapport
par programmation. La classe PrintOptions permet d'effectuer les op&eacute;rations suivantes :
●
Changer la source de papier actuelle.
●
D&eacute;terminer la hauteur ou la largeur de la sortie imprim&eacute;e.
●
R&eacute;gler les marges de page.
●
Forcer l'impression duplex ou simplex.
●
Changer l'imprimante par d&eacute;faut.
Pour modifier les options d'impression d'un rapport, vous devez extraire un objet PrintOptions via la propri&eacute;t&eacute;
PrintOptions de la classe ReportDocument.
Copie des options d'impression
Les options d'impression peuvent &ecirc;tre copi&eacute;es depuis ou vers les param&egrave;tres par d&eacute;faut de votre syst&egrave;me local &agrave;
l'aide des m&eacute;thodes PrintOptions.CopyFrom ou PrintOptions.CopyTo.
Pour en savoir plus sur la classe PrintOptions, voir la R&eacute;f&eacute;rence de l'API .NET SAP Crystal Reports.
Exemple
Forcer l'impression duplex
Cet exemple d&eacute;finit le mode d'impression par d&eacute;faut sur Duplex.
Private Sub enableDuplex(ByVal rd As ReportDocument)
rd.PrintOptions.PrinterDuplex = PrinterDuplex.Vertical
End Sub
private void enableDuplex(ReportDocument rd)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
119
{
}
rd.PrintOptions.PrinterDuplex = PrinterDuplex.Vertical;
1.4.1.2.2
d&eacute;faut
Impression d'un rapport sur l'imprimante par
Contexte
La m&eacute;thode ReportDocument.PrintToPrinter envoie un rapport &agrave; l'imprimante par d&eacute;faut sp&eacute;cifi&eacute;e dans le
fichier du rapport. Pour envoyer le rapport sur l'imprimante par d&eacute;faut sp&eacute;cifi&eacute;e sur l'ordinateur client, vous devez
d&eacute;finir la propri&eacute;t&eacute; PrintOptions.PrinterName avant d'imprimer le rapport.
Proc&eacute;dure
1.
Cr&eacute;ez une instance de la classe PrintDocument.
L'imprimante par d&eacute;faut de l'ordinateur client est sp&eacute;cifi&eacute;e dans la propri&eacute;t&eacute;
PrinterSettings.PrinterName de toute nouvelle classe PrintDocument.
Dim localPrinter As System.Drawing.Printing.PrintDocument = New PrintDocument()
System.Drawing.Printing.PrintDocument localPrinter = new PrintDocument();
2.
D&eacute;finissez la propri&eacute;t&eacute; PrinterName de l'objet ReportDocument sur la valeur sp&eacute;cifi&eacute;e dans
PrinterSettings.PrinterName.
rd.PrintOptions.PrinterName = localPrinter.PrinterSettings.PrinterName
rd.PrintOptions.PrinterName = localPrinter.PrinterSettings.PrinterName;
3.
Appelez la m&eacute;thode ReportDocument.PrintToPrinter pour imprimer le rapport.
rd.PrintToPrinter(1, False, 0, 0)
rd.PrintToPrinter(1, false, 0, 0);
Cette m&eacute;thode PrintToPrinter utilise quatre param&egrave;tres : le nombre de copies &agrave; imprimer, si les pages
doivent &ecirc;tre assembl&eacute;es ou non, la page de d&eacute;but et la page de fin.
120
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Conseil
Pour imprimer toutes les pages, d&eacute;finissez les param&egrave;tres de page de d&eacute;but et de page de fin sur z&eacute;ro.
Exemple
Private Sub printReport(ByVal rd As ReportDocument)
Dim localPrinter As System.Drawing.Printing.PrintDocument = New
PrintDocument()
rd.PrintOptions.PrinterName = localPrinter.PrinterSettings.PrinterName
rd.PrintToPrinter(1, False, 0, 0)
End Sub
private void printReport(ReportDocument rd) {
System.Drawing.Printing.PrintDocument localPrinter = new PrintDocument();
rd.PrintOptions.PrinterName = localPrinter.PrinterSettings.PrinterName;
rd.PrintToPrinter(1, false, 0, 0);
}
1.4.1.2.3
Impression d'un rapport sur un fichier
Contexte
Vous pouvez imprimer un rapport sur un fichier de votre syst&egrave;me local en modifiant les propri&eacute;t&eacute;s
PrinterSettings par d&eacute;faut et en appelant la m&eacute;thode ReportDocument.PrintToPrinter. Pour enregistrer
un rapport sur un disque en vue de l'afficher ult&eacute;rieurement ou pour enregistrer un rapport dans un format
diff&eacute;rent, exportez-le au lieu de l'imprimer sur un fichier.
Proc&eacute;dure
1.
Cr&eacute;ez une instance des classes PrinterSettings et PageSettings.
Dim printerSettings As New PrinterSettings()
Dim pageSettings As New PageSettings()
PrinterSettings printerSettings = new PrinterSettings();
PageSettings pageSettings = new PageSettings();
2.
Copiez les param&egrave;tres de l'objet ReportDocument vers les objets PrinterSettings et PageSettings.
rd.PrintOptions.CopyTo(printerSettings, pageSettings)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
121
rd.PrintOptions.CopyTo(printerSettings, pageSettings);
3.
D&eacute;finissez la propri&eacute;t&eacute; PrintToFile de l'objet PrinterSettings sur la valeur True.
printerSettings.PrintToFile = True
printerSettings.PrintToFile = true;
4.
D&eacute;finissez l'emplacement du fichier de sortie.
printerSettings.PrintFileName = &quot;c:\outputFile.prn&quot;
printerSettings.PrintFileName = &quot;c:\\outputFile.prn&quot;;
Remarque
Lors d'une impression sur un fichier, le format du fichier de sortie est d&eacute;termin&eacute; par l'imprimante. Il se peut
que votre imprimante cr&eacute;e des fichiers XPS, PS ou d'un autre format. Consultez le manuel du fabricant
pour plus d'informations.
5.
Appelez la m&eacute;thode ReportDocument.PrintToPrinter pour imprimer le rapport.
Cette m&eacute;thode PrintToPrinter utilise trois param&egrave;tres : les options d'impression, les param&egrave;tres de page
et une valeur bool&eacute;enne qui indique si le rapport doit &ecirc;tre remis en forme pour correspondre aux param&egrave;tres
de page.
rd.PrintToPrinter(printerSettings, pageSettings, False)
rd.PrintToPrinter(printerSettings, pageSettings, false);
Exemple
Private Sub printToFile(ByVal rd As ReportDocument)
Dim printerSettings As New PrinterSettings()
Dim pageSettings As New PageSettings()
rd.PrintOptions.CopyTo(printerSettings, pageSettings)
printerSettings.PrintToFile = True
printerSettings.PrintFileName = &quot;c:\outputFile.prn&quot;
rd.PrintToPrinter(printerSettings, pageSettings, False)
End Sub
private void printToFile(ReportDocument rd)
{
PrinterSettings printerSettings = new PrinterSettings();
PageSettings pageSettings = new PageSettings();
rd.PrintOptions.CopyTo(printerSettings, pageSettings);
printerSettings.PrintToFile = true;
printerSettings.PrintFileName = &quot;c:\\outputFile.prn&quot;;
122
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
}
rd.PrintToPrinter(printerSettings, pageSettings, false);
Informations associ&eacute;es
Exportation d'un rapport [page 123]
1.4.1.3
Suppression du pilote de l'imprimante par d&eacute;faut de
votre rapport
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez deux fois sur le rapport.
2.
Cliquez avec le bouton droit de la souris sur une zone quelconque du rapport et s&eacute;lectionnez
Concepteur
Configuration de l'imprimante .
3.
Dans la bo&icirc;te de dialogue Configuration de l'impression, activez la case &agrave; cocher Aucune imprimante, puis
cliquez sur OK.
4.
Cliquez sur
Fichier
Tout enregistrer .
Informations associ&eacute;es
S&eacute;lection de l'option Aucune imprimante sous Configuration de l'impression [page 74]
1.4.2
Exportation d'un rapport
SAP Crystal Reports permet d'exporter des rapports vers diff&eacute;rents formats. Les formats disponibles d&eacute;pendent
de la version de SAP Crystal Reports que vous avez install&eacute;e et de la m&eacute;thode utilis&eacute;e pour exporter le rapport.
Un rapport peut &ecirc;tre export&eacute; vers un disque, une fen&ecirc;tre de navigateur ou vers le flux d'entr&eacute;e/de sortie sous
forme de s&eacute;quence d'octets.
Classes utilis&eacute;es pour l'exportation de rapports
●
CrystalDecisions.CrystalReports.Engine.ReportDocument
Repr&eacute;sente un rapport et contient les propri&eacute;t&eacute;s et les m&eacute;thodes permettant de d&eacute;finir, mettre en forme,
charger, exporter et imprimer ce rapport.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
123
●
CrystalDecisions.Shared
Contient plusieurs classes utilis&eacute;es pour sp&eacute;cifier les options d'exportation de diff&eacute;rents formats de sortie.
●
CrystalDecisions.Shared.ExportOptions
Indique les propri&eacute;t&eacute;s permettant d'extraire et de d&eacute;finir des options pour l'exportation de votre rapport.
Informations associ&eacute;es
Impression d'un rapport [page 113]
Bo&icirc;te de dialogue Exportation [page 908]
1.4.2.1
Formats d'exportation disponibles
Les formats d'exportation pris en charge par SAP Crystal Reports peuvent &ecirc;tre class&eacute;s en deux groupes : les
formats bas&eacute;s sur les pages et les formats bas&eacute;s sur les enregistrements. Les formats d'exportation sont
davantage ax&eacute;s sur la charte graphique et produisent donc g&eacute;n&eacute;ralement un r&eacute;sultat proche de la mise en page et
de la mise en forme de l'original. Les formats d'exportation d'enregistrements sont ax&eacute;s sur la repr&eacute;sentation
exacte des donn&eacute;es plut&ocirc;t que sur la mise en page et la mise en forme.
Mise en forme
Description
SAP Crystal Reports (RPT)
L'exportation vers le format SAP Crystal Reports s'apparente
&agrave; l'utilisation de la fonctionnalit&eacute; Enregistrer sous avec
l'option Enregistrer les donn&eacute;es avec le rapport s&eacute;lectionn&eacute;e.
Ce format exporte (enregistre) le rapport avec les donn&eacute;es
en cours sans modifier le rapport d'origine. Si une source de
rapport est un fichier SAP Crystal Reports Read-Only
(RPTR), vous ne pourrez pas l'exporter vers
SAP Crystal Reports (RPT).
SAP Crystal Reports Read-Only (RPTR)
Ce format exporte (enregistre) le rapport avec les donn&eacute;es
en cours sans modifier le rapport d'origine. Les rapports
RPTR sont des rapports Crystal qui peuvent &ecirc;tre visualis&eacute;s
avec des applications de visualiseur de rapport, mais qui ne
peuvent pas &ecirc;tre modifi&eacute;s avec le SDK ni ouverts par des
applications de concepteur de rapports. La d&eacute;finition d'un
rapport RPTR ne peut pas &ecirc;tre modifi&eacute;e, ce qui signifie qu'il
n'est pas possible d'utiliser ce SDK pour d&eacute;finir
l'emplacement de la source de donn&eacute;es d'un RPTR via le
contr&ocirc;leur de base de donn&eacute;es. Il est toutefois possible
d'actualiser les donn&eacute;es d'un rapport RPTR lors de
l'ex&eacute;cution en actualisant le rapport dans un visualiseur.
HTML 4.0
Exporte le rapport au format HTML 4.0. Ce format conserve
la mise en page et la mise en forme du rapport en utilisant le
DHTML.
Microsoft Excel (97-2003)
Ce format convertit le contenu de votre rapport en cellules
Excel page par page. Le contenu de plusieurs pages est
export&eacute; vers la m&ecirc;me feuille de calcul Excel. Si une feuille de
calcul est pleine et qu'il reste des donn&eacute;es &agrave; exporter, le
124
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Mise en forme
Description
programme d'exportation cr&eacute;e plusieurs feuilles de calcul
pour int&eacute;grer ces donn&eacute;es. Si un objet de rapport couvre
plusieurs cellules, le programme d'exportation fusionne les
cellules pour le repr&eacute;senter. Microsoft Excel est limit&eacute; &agrave;
256 colonnes par feuille de calcul ; par cons&eacute;quent, tout objet
de rapport (ou partie de cet objet) ajout&eacute; &agrave; des cellules audel&agrave; des 256 colonnes ne peut &ecirc;tre export&eacute;. Ce format
d'exportation conserve la plupart de la mise en forme, mais
n'exporte pas les objets ligne et objets cadre du rapport.
Microsoft Excel (97-2003) Donn&eacute;es uniquement
Comme son nom l'indique, Microsoft Excel - Donn&eacute;es
uniquement est un format d'exportation d'enregistrements
ax&eacute; sur la repr&eacute;sentation exacte des donn&eacute;es. Toutefois, ce
format exporte &eacute;galement la plupart de la mise en forme.
Contrairement au format Microsoft Excel, Microsoft Excel Donn&eacute;es uniquement ne fusionne pas les cellules ; chaque
objet est ajout&eacute; &agrave; une cellule unique. Ce format exporte aussi
certains types de r&eacute;sum&eacute;s de rapports Crystal sous forme de
fonctions Excel. Les r&eacute;sum&eacute;s pris en charge sont SUM,
AVERAGE, COUNT, MIN et MAX.
Microsoft Excel 2007 (XLSX) Donn&eacute;es uniquement
Le format XLSX est dot&eacute; des m&ecirc;mes propri&eacute;t&eacute;s que le format
Microsoft Excel (97-2003) Donn&eacute;es uniquement ; toutefois,
le format XLSX prend en charge jusqu'&agrave; 16 385 colonnes et
1 048 576 lignes dans un seul classeur.
Microsoft Word (97-2003)
Ce format g&eacute;n&egrave;re un fichier RTF (Rich Text Format) qui
contient du texte et des objets de dessin pour repr&eacute;senter les
objets de rapport. Ce format d'exportation conserve la
plupart de la mise en forme. Toutefois, les objets texte ne
peuvent pas &ecirc;tre plac&eacute;s &agrave; l'ext&eacute;rieur du bord gauche de la
page. Les objets texte du rapport plac&eacute;s &agrave; l'ext&eacute;rieur du bord
gauche de la zone imprimable sont donc d&eacute;plac&eacute;s vers la
droite. (Cela est particuli&egrave;rement visible dans les rapports
comportant des pages larges.)
Microsoft Word (97-2003) - Modifiable
Le format Microsoft Word - Modifiable diff&egrave;re du format
Microsoft Word : il s'agit d'un format d'exportation, mais la
mise en page et la mise en forme ne sont pas int&eacute;gralement
conserv&eacute;es dans le format de sortie. Ce format convertit le
contenu de tous les objets du rapport en lignes de texte.
Contrairement au format Microsoft Word, ce format n'utilise
pas de cadres de texte. La mise en forme du texte est
conserv&eacute;e, mais les attributs tels que couleur d'arri&egrave;re-plan,
mod&egrave;le de remplissage, etc. peuvent ne pas &ecirc;tre conserv&eacute;s.
Toutes les images du rapport sont align&eacute;es sur le contenu
textuel. Par cons&eacute;quent, les images sont automatiquement
d&eacute;plac&eacute;es afin d'int&eacute;grer le texte lorsque le document est
&eacute;dit&eacute; dans Microsoft Word. Ce format n'exporte pas les
objets ligne et objets cadre du rapport. De m&ecirc;me, les champs
sp&eacute;ciaux Num&eacute;ro de page et Page N sur M ne fonctionnent
pas lorsqu'ils sont export&eacute;s dans ce format.
ODBC
ODBC est un format d'&eacute;change de donn&eacute;es bas&eacute; sur les
enregistrements. Ce format permet d'exporter les donn&eacute;es
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
125
Mise en forme
Description
de rapport vers n'importe quelle base de donn&eacute;es compatible
ODBC.
PDF
Les documents export&eacute;s sont destin&eacute;s &agrave; l'impression et &agrave; la
redistribution. Le format PDF exporte &agrave; la fois la mise en page
et la mise en forme de mani&egrave;re &agrave; correspondre &agrave; l'apparence
du rapport dans l'onglet Aper&ccedil;u. Le format PDF int&egrave;gre les
polices True Type qui apparaissent dans le document. (Les
polices autres que True Type ne sont pas prises en charge.)
Ce format d'exportation ne prend pas en charge la
technologie Font-Linking de Microsoft, utilis&eacute;e pour des
ensembles de caract&egrave;res &eacute;tendus comme le HKCS chinois.
Par cons&eacute;quent, les polices utilis&eacute;es dans le rapport doivent
contenir tous les glyphes requis. Les types d'URI suivants
sont pris en charge pour les hyperliens : http, https et mailto.
Style d'enregistrement - Colonnes avec espaces
Exporte les donn&eacute;es du rapport sous forme de texte. Ce
format ins&egrave;re des espaces entre les colonnes.
Style d'enregistrement - Colonnes sans espaces
Exporte les donn&eacute;es du rapport sous forme de texte. Ce
format n'ins&egrave;re pas d'espaces entre les colonnes.
D&eacute;finition de rapport
Le format de d&eacute;finition de rapport exporte le rapport dans un
fichier texte qui contient une br&egrave;ve description de la vue de
conception du rapport. Ce format est uniquement g&eacute;r&eacute; dans
le cadre d'une compatibilit&eacute; avec SAP Crystal Reports 5.0.
Rich Text Format (RTF)
G&eacute;n&egrave;re un fichier RTF contenant des objets de type texte et
dessin.
Valeurs s&eacute;par&eacute;es par des virgules (CSV)
Le format Valeurs d&eacute;limit&eacute;es est un format d'&eacute;change de
donn&eacute;es bas&eacute; sur les enregistrements. Il exporte le contenu
des objets du rapport sous forme d'ensemble de valeurs
s&eacute;par&eacute;es par des s&eacute;parateurs que vous indiquez. (Lorsqu'une
virgule (,) est utilis&eacute;e pour s&eacute;parer des champs, on parle de
Valeurs s&eacute;par&eacute;es par des virgules (CSV). Ce format
d'exportation est largement utilis&eacute; par les utilisateurs de
Microsoft Excel.)
Texte s&eacute;par&eacute; par des tabulations (TTX)
Conserve la mise en page du rapport &agrave; quelques diff&eacute;rences
pr&egrave;s : les objets texte sur plusieurs lignes sont export&eacute;s sur
une seule ligne, toutes les valeurs de type cha&icirc;ne comportent
des guillemets (&quot;&quot;) et les valeurs elles-m&ecirc;mes sont s&eacute;par&eacute;es
par des tabulations. Les fichiers TTX peuvent s'ouvrir dans
Microsoft Excel.
Texte
G&eacute;n&egrave;re du texte brut (sans conserver la mise en forme).
XML
Utilis&eacute; essentiellement pour l'&eacute;change de donn&eacute;es. Ce format
g&eacute;n&egrave;re du code XML &agrave; l'aide du sch&eacute;ma XML de
SAP Crystal Reports.
S&eacute;lection d'un format d'exportation
Les formats disponibles d&eacute;pendent de la version de SAP Crystal Reports que vous avez install&eacute;e et de la m&eacute;thode
utilis&eacute;e pour exporter le rapport. Le contr&ocirc;le CrystalReportViewer propose par d&eacute;faut la plupart des formats
126
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
d'exportation. Certains formats sont uniquement disponibles avec le SDK de SAP Crystal Reports .NET ou
l'application autonome SAP Crystal Reports Designer.
Mise en forme
Contr&ocirc;le
CrystalReportViewer
SDK de
SAP Crystal Reports .NE
T
SAP Crystal Reports Desi
gner
SAP Crystal Reports (RPT)
x
x
x
SAP Crystal Reports ReadOnly (RPTR)
x
x
x
x
x
HTML 4.0
Microsoft Excel (97-2003)
x
x
x
Microsoft Excel (97-2003)
Donn&eacute;es uniquement
x
x
x
Microsoft Excel 2007 (XLSX)
Donn&eacute;es uniquement
x
x
x
Microsoft Word (97-2003)
x
x
x
Microsoft Word (97-2003) Modifiable
x
x
x
ODBC
PDF
x
x
x
x
Style d'enregistrement Colonnes avec espaces
x
Style d'enregistrement Colonnes sans espaces
x
D&eacute;finition de rapport
x
Rich Text Format (RTF)
x
x
Valeurs s&eacute;par&eacute;es par des
virgules (CSV)
x
x
Texte s&eacute;par&eacute; par des
tabulations (TTX)
x
x
Texte
x
x
x
x
XML
x
x
1.4.2.2
Exportation d'un rapport depuis le contr&ocirc;le
CrystalReportViewer
La mani&egrave;re la plus simple d'ajouter des fonctionnalit&eacute;s d'exportation &agrave; votre application SAP Crystal Reports .NET
est d'utiliser le bouton d'exportation du contr&ocirc;le CrystalReportViewer. Le bouton Exporter est activ&eacute; par d&eacute;faut
sur la barre d'outils CrystalReportViewer.
L'utilisateur peut cliquer sur le bouton Exporter pour faire appara&icirc;tre la bo&icirc;te de dialogue d'exportation par d&eacute;faut.
Les options d'exportation disponibles pour votre utilisateur sont d&eacute;termin&eacute;es par les pilotes inclus dans votre
d&eacute;ploiement.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
127
D&eacute;sactivation de la fonction d'exportation de rapport depuis le visualiseur
L'exportation est activ&eacute;e par d&eacute;faut dans toutes les applications SAP Crystal Reports. Vous pouvez limiter
l'exportation de deux fa&ccedil;ons :
●
Supprimer le bouton Exporter du visualiseur.
Vous pourrez continuer &agrave; utiliser le SDK pour exporter un rapport, m&ecirc;me si le bouton d'exportation n'est pas
visible.
●
La d&eacute;sactivation de certains pilotes d'exportation dans SAP Crystal Reports fusionne les modules.
Lorsque vous d&eacute;ployez une application SAP Crystal Reports vers un ordinateur cible, vous devez inclure
l'ex&eacute;cution de SAP Crystal Reports sous la forme d'un MSI ou d'un module de fusion. Si vous choisissez
d'utiliser des modules de fusion pour votre d&eacute;ploiement, vous pouvez sp&eacute;cifier les pilotes d'exportation &agrave;
inclure ou exclure.
Informations associ&eacute;es
Bo&icirc;te de dialogue Exportation [page 908]
1.4.2.2.1
Suppression du bouton d'exportation depuis le
contr&ocirc;le CrystalReportViewer
Contexte
Vous pourrez continuer &agrave; utiliser le SDK pour exporter un rapport, m&ecirc;me si le bouton d'exportation n'est pas
visible.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
D&eacute;finissez la propri&eacute;t&eacute; qui contr&ocirc;le la visibilit&eacute; du bouton d'exportation sur False.
○
Pour une application Windows, d&eacute;finissez la propri&eacute;t&eacute; CrystalReportViewer.ShowExportButton sur
False.
○
Pour un site Web, d&eacute;finissez la propri&eacute;t&eacute; CrystalReportViewer.HasExportButton sur False.
R&eacute;sultats
Lorsque vous ex&eacute;cuterez votre application, le bouton d'exportation ne devrait plus appara&icirc;tre sur le contr&ocirc;le
CrystalReportViewer.
128
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple
D&eacute;sactivation du bouton Exporter dans une application Web
Private Sub ConfigureCrystalReports()
CrystalReportViewer1.HasExportButton = False
End Sub
private void ConfigureCrystalReports()
{
InitializeComponent();
crystalReportViewer1.HasExportButton = false;
}
1.4.2.3
Exportation d'un rapport par programmation
Le SDK SAP Crystal Reports .NET permet d'exporter par programmation un rapport vers un plus grand nombre
de formats et de destinations que le contr&ocirc;le CrystalReportViewer.
Si le bouton Exporter de la barre d'outils du contr&ocirc;le CrystalReportViewer r&eacute;pond &agrave; vos besoins d'exportation, il
est inutile d'&eacute;crire un code pour configurer des options d'exportation suppl&eacute;mentaires.
Toutefois, pour des sc&eacute;narios particuliers, vous pouvez avoir recours &agrave; une solution bas&eacute;e sur du code pour
l'impression des rapports :
●
Vous pouvez contr&ocirc;ler le moment, l'emplacement et la configuration de votre exportation. D&eacute;sactivez le
bouton Exporter de la barre d'outils du contr&ocirc;le CrystalReportViewer et g&eacute;rez toutes les exportations via le
code.
●
Vous pouvez exporter un rapport en arri&egrave;re-plan, sans l'afficher.
●
Vous pouvez exporter un rapport vers une r&eacute;ponse HTTP ou vers un flux. Le contr&ocirc;le CrystalReportViewer
prend uniquement en charge l'exportation d'un rapport vers un disque.
Il existe quatre m&eacute;thodes pour exporter un rapport. Vous pouvez acc&eacute;der &agrave; toutes ces m&eacute;thodes via la classe
ReportDocument.
●
ReportDocument.Export
●
ReportDocument.ExportToHTTPResponse
●
ReportDocument.ExportToDisk
●
ReportDocument.ExportToStream
La m&eacute;thode la plus courante, ReportDocument.Export, permet d'exporter vos rapports vers n'importe quel
format et destination pris en charge par le SDK SAP Crystal Reports .NET. Pour utiliser la m&eacute;thode
ReportDocument.Export, vous devez d'abord d&eacute;finir plusieurs param&egrave;tres via la classe ExportOptions.
Chacune des trois autres m&eacute;thodes offre un moyen pratique d'exporter un rapport d'une mani&egrave;re sp&eacute;cifique.
L'utilisation des autres m&eacute;thodes g&eacute;n&egrave;re en g&eacute;n&eacute;ral moins de code, mais offre moins de contr&ocirc;le sur le fichier qui
en r&eacute;sulte.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
129
1.4.2.3.1
D&eacute;finition des options d'exportation personnalis&eacute;es
Pour utiliser la m&eacute;thode ReportDocument.Export, vous devez d'abord d&eacute;finir plusieurs param&egrave;tres via la classe
ExportOptions. Ces param&egrave;tres contr&ocirc;lent l'emplacement de l'exportation, le format d'exportation et plusieurs
options de style sp&eacute;cifiques au format de sortie.
Quatre options doivent &ecirc;tre d&eacute;finies pour exporter un rapport &agrave; l'aide de la m&eacute;thode ReportDocument.Export.
Option d'exportation
Description
ExportDestinationType
D&eacute;termine comment exporter le rapport.
ExportDestinationOptions
D&eacute;termine l'emplacement et le nom du fichier qui en r&eacute;sulte.
ExportFormatOptions
D&eacute;termine les options de mise en forme sp&eacute;cifiques au
format de sortie.
ExportFormatType
D&eacute;termine le type de fichier de destination.
D&eacute;finition de la propri&eacute;t&eacute; ExportDestinationType
La propri&eacute;t&eacute; ExportOptions.ExportDestinationType d&eacute;termine comment exporter le rapport. Les valeurs
disponibles sont stock&eacute;es dans l'&eacute;num&eacute;ration ExportDestinationType.
ExportDestinationType.DiskFile est la valeur la plus courante. D'autres valeurs sont prises en charge,
telles que ExchangeFolder, MicrosoftMail et NoDestination.
D&eacute;finition de la propri&eacute;t&eacute; ExportDestinationOptions
La propri&eacute;t&eacute; ExportOptions.ExportDestinationOptions d&eacute;finit les options sp&eacute;cifiques &agrave; l'emplacement
cible du fichier de sortie. La valeur de la propri&eacute;t&eacute; ExportDestinationOptions d&eacute;pend de la valeur de la
propri&eacute;t&eacute; ExportOptions.ExportDestinationType.
ExportDestinationType
ExportDestinationOptions
D&eacute;finit les valeurs suivantes :
DiskFile
Un objet
●
D&eacute;finit le nom et l'emplacement du
fichier de sortie.
●
Le profil et le mot de passe
utilisateur du serveur Exchange.
●
Le chemin d'acc&egrave;s au dossier
Exchange.
●
Le nom et le mot de passe
utilisateur du compte de courrier
&eacute;lectronique.
●
L'objet et le corps du message
&eacute;lectronique.
DiskFileDestinationOptions
ExchangeFolder
Un objet
ExchangeFolderDestinationOp
tions
MicrosoftMail
Un objet
MicrosoftMailDestinationOpt
ions
130
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ExportDestinationType
ExportDestinationOptions
D&eacute;finit les valeurs suivantes :
●
Les destinataires du message
&eacute;lectronique.
D&eacute;finition de la propri&eacute;t&eacute; ExportFormatType
Cette propri&eacute;t&eacute; d&eacute;termine le format du fichier de sortie. Les valeurs disponibles sont stock&eacute;es dans l'&eacute;num&eacute;ration
ExportFormatType. Les options disponibles d&eacute;pendent de la version de SAP Crystal Reports utilis&eacute;e.
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio prend en charge les options d'exportation
suivantes :
●
SAP Crystal Reports (RPT)
●
SAP Crystal Reports Read-Only (RPTR)
●
PDF
●
Rich Text Format (RTF)
●
Microsoft Word (97-2003)
●
Microsoft Excel (97-2003)
●
Microsoft Excel (97-2003) Donn&eacute;es uniquement
●
Microsoft Excel (2007) Donn&eacute;es uniquement
●
HTML 4.0
●
Valeurs s&eacute;par&eacute;es par des virgules (CSV)
●
Microsoft Word modifiable (RTF)
●
Texte s&eacute;par&eacute; par des tabulations (TTX)
●
Texte
D&eacute;finition de la propri&eacute;t&eacute; ExportFormatOptions
La propri&eacute;t&eacute; ExportOptions.ExportFormatOptions d&eacute;finit les options sp&eacute;cifiques au format du fichier de
sortie. La valeur de la propri&eacute;t&eacute; ExportFormatOption d&eacute;pend de la valeur de la propri&eacute;t&eacute;
ExportOptions.ExportFormatType.
ExportFormatOptions
Format d'exportation
D&eacute;finit les valeurs suivantes :
Un objet ExcelFormatOptions
●
Microsoft Excel (97-2003)
●
●
Microsoft Excel (97-2003) Donn&eacute;es
●
uniquement
Un objet HTMLFormatOptions
●
HTML 4.0
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
La premi&egrave;re et la derni&egrave;re page du
rapport &agrave; exporter.
La largeur de colonne par d&eacute;faut.
●
S'il est n&eacute;cessaire d'inclure des ent&ecirc;tes de colonne.
●
La premi&egrave;re et la derni&egrave;re page du
rapport &agrave; exporter.
●
Le nom de la page HTML par
d&eacute;faut.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
131
ExportFormatOptions
Un objet
PdfRtfWordFormatOptions
Format d'exportation
●
PDF
●
Rich Text Format (RTF)
●
Microsoft Word (97-2003)
●
Microsoft Word modifiable (RTF)
D&eacute;finit les valeurs suivantes :
●
Le nom du dossier contenant les
fichiers de prise en charge requis
pour la sortie au format HTML,
comme les images utilis&eacute;es dans le
rapport.
●
La premi&egrave;re et la derni&egrave;re page du
rapport &agrave; exporter.
Exemple
D&eacute;finition des options d'exportation pour Microsoft Excel - Donn&eacute;es uniquement
Cet exemple d&eacute;finit les options d'exportation requises pour exporter un rapport au format “Microsoft Excel Donn&eacute;es uniquement”.
La m&eacute;thode instancie une nouvelle classe DiskFileDestinationOptions et affecte &agrave; la propri&eacute;t&eacute;
DiskFileDestinationOptions.DiskFileName un chemin d'acc&egrave;s au fichier. Pour exporter le fichier vers le
disque, la propri&eacute;t&eacute; ExportOptions.ExportDestinationType doit &ecirc;tre d&eacute;finie sur
ExportDestinationType.DiskFile et ExportOptions.DestinationOptions doit &ecirc;tre d&eacute;finie sur un
objet DiskFileDestinationOptions valide.
Si aucune mise en forme sp&eacute;cifique n'est requise, la propri&eacute;t&eacute; ExportOptions.ExportFormatOptions peut
&ecirc;tre d&eacute;finie sur null.
Private Function ConfigureExportToExcelRecord(ByVal filepath As String) As
ExportOptions
Dim exOptions As New ExportOptions()
Dim dfDestinationOptions As New DiskFileDestinationOptions()
dfDestinationOptions.DiskFileName = filepath
exOptions.ExportDestinationType = ExportDestinationType.DiskFile
exOptions.DestinationOptions = dfDestinationOptions
exOptions.ExportFormatType = ExportFormatType.ExcelRecord
exOptions.ExportFormatOptions = Nothing
Return exOptions
End Function
private ExportOptions ConfigureExportToExcelRecord(String filepath)
{
ExportOptions exOptions = new ExportOptions();
DiskFileDestinationOptions dfDestinationOptions = new
DiskFileDestinationOptions();
dfDestinationOptions.DiskFileName = filepath;
}
132
exOptions.ExportDestinationType = ExportDestinationType.DiskFile;
exOptions.DestinationOptions = dfDestinationOptions;
exOptions.ExportFormatType = ExportFormatType.ExcelRecord;
exOptions.ExportFormatOptions = null;
return exOptions;
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple
D&eacute;finition des options d'exportation pour le format de sortie HTML 4.0
Cet exemple d&eacute;finit les options d'exportation requises pour exporter un rapport au format “HTML 4.0”.
Il n'est pas n&eacute;cessaire d'instancier de classe DiskFileDestinationOptions pour les exportations au format
HTML. Ces options sont d&eacute;finies par le biais de la classe HTMLFormatOptions.
Cette m&eacute;thode instancie une nouvelle classe HTMLFormatOptions et affecte le nom de fichier par d&eacute;faut &agrave; la
propri&eacute;t&eacute; HTMLFormatOptions.HTMLFileName et le chemin d'exportation par d&eacute;faut &agrave; la propri&eacute;t&eacute;
HTMLFormatOptions.HTMLBaseFolderName. Le dossier de base contient chacune des pages HTML
export&eacute;es par le rapport ainsi que toutes les images requises.
D&eacute;finissez la propri&eacute;t&eacute; ExportOptions.ExportFormatOptions sur un objet HTMLFormatOptions valide.
Private Function ConfigureExportToHtml40(ByVal exportpath As String) As
ExportOptions
Dim exOptions As New ExportOptions()
Dim html40FormatOptions As New HTMLFormatOptions()
html40FormatOptions.HTMLBaseFolderName = exportpath
html40FormatOptions.HTMLFileName = &quot;default.html&quot;
html40FormatOptions.HTMLEnableSeparatedPages = True
html40FormatOptions.HTMLHasPageNavigator = True
exOptions.ExportFormatType = ExportFormatType.HTML40
exOptions.ExportFormatOptions = html40FormatOptions
Return exOptions
End Function
private ExportOptions ConfigureExportToHtml40(String exportpath)
{
ExportOptions exOptions = new ExportOptions();
HTMLFormatOptions html40FormatOptions = new HTMLFormatOptions();
html40FormatOptions.HTMLBaseFolderName = exportpath;
html40FormatOptions.HTMLFileName = &quot;default.html&quot;;
html40FormatOptions.HTMLEnableSeparatedPages = true;
html40FormatOptions.HTMLHasPageNavigator = true;
exOptions.ExportFormatType = ExportFormatType.HTML40;
exOptions.ExportFormatOptions = html40FormatOptions;
}
return exOptions;
Informations associ&eacute;es
Formats d'exportation disponibles [page 124]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
133
1.4.2.3.2
Exportation vers un disque avec des options
d'exportation personnalis&eacute;e
Contexte
Cet exemple montre comment exporter un rapport Crystal vers le format Microsoft Word. Le SDK de
SAP Crystal Reports 2008 permet d'exporter des rapports vers un format sp&eacute;cifique, tel qu'Excel, PDF ou RTF.
Vous pouvez exporter des rapports vers diff&eacute;rents formats en utilisant le mod&egrave;le d'objet ReportDocument.
Cet exemple d&eacute;finit la propri&eacute;t&eacute; ReportDocument.ExportOptions et utilise la m&eacute;thode
ReportDocument.Export pour exporter le rapport.
Proc&eacute;dure
1.
Cr&eacute;ez une m&eacute;thode qui utilise un objet ReportDocument et un chemin de fichier en tant que param&egrave;tres.
2.
Cr&eacute;ez une instance de la classe DiskFileDestinationOptions et d&eacute;finissez la valeur de la propri&eacute;t&eacute;
DiskFileDestinationOptions.DiskFileName sur le chemin du fichier de sortie.
Dim dfDestinationOptions As New DiskFileDestinationOptions()
dfDestinationOptions.DiskFileName = filepath
DiskFileDestinationOptions dfDestinationOptions = new
DiskFileDestinationOptions();
dfDestinationOptions.DiskFileName = filepath;
3.
Cr&eacute;ez une instance de la classe ExportOptions et d&eacute;finissez les propri&eacute;t&eacute;s requises.
a) D&eacute;finissez la propri&eacute;t&eacute; ExportDestinationType sur ExportDestinationType.DiskFile.
b) D&eacute;finissez la propri&eacute;t&eacute; ExportDestinationOptions sur l'objet DiskFileDestinationOptions.
c) D&eacute;finissez la propri&eacute;t&eacute; ExportFormatType sur ExportFormatType.WordForWindows.
d) Si aucune mise en forme sp&eacute;cifique n'est requise, la propri&eacute;t&eacute; ExportOptions.ExportFormatOptions
peut &ecirc;tre d&eacute;finie sur null.
Dim wordExportOptions As New ExportOptions()
wordExportOptions.ExportDestinationType = ExportDestinationType.DiskFile
wordExportOptions.ExportDestinationOptions = dfDestinationOptions
wordExportOptions.ExportFormatType = ExportFormatType.WordForWindows
wordExportOptions.ExportFormatOptions = Nothing
ExportOptions wordExportOptions = new ExportOptions();
wordExportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
wordExportOptions.ExportDestinationOptions = dfDestinationOptions;
wordExportOptions.ExportFormatType = ExportFormatType.WordForWindows;
wordExportOptions.ExportFormatOptions = null;
4.
134
Appelez la m&eacute;thode Export et transmettez l'objet ExportOptions en tant que param&egrave;tre.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple
Private Sub ExportToWord_RD(ByVal rd As ReportDocument, ByVal filepath As String)
Dim dfDestinationOptions As New DiskFileDestinationOptions()
dfDestinationOptions.DiskFileName = filepath
Dim wordExportOptions As New ExportOptions()
wordExportOptions.ExportDestinationType = ExportDestinationType.DiskFile
wordExportOptions.ExportDestinationOptions = dfDestinationOptions
wordExportOptions.ExportFormatType = ExportFormatType.WordForWindows
wordExportOptions.ExportFormatOptions = Nothing
rd.Export(wordExportOptions)
End Sub
private void ExportToWord_RD(ReportDocument rd, String filepath)
{
DiskFileDestinationOptions dfDestinationOptions = new
DiskFileDestinationOptions();
dfDestinationOptions.DiskFileName = filepath;
ExportOptions wordExportOptions = new ExportOptions();
wordExportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
wordExportOptions.ExportDestinationOptions = dfDestinationOptions;
wordExportOptions.ExportFormatType = ExportFormatType.WordForWindows;
wordExportOptions.ExportFormatOptions = null;
}
rd.Export(wordExportOptions);
1.4.2.3.3
Exportation vers un disque au format PDF &agrave; l'aide
de la m&eacute;thode ReportDocument.ExportToDisk
Contexte
Cet exemple montre comment exporter un rapport Crystal vers le format PDF. Le SDK de
SAP Crystal Reports 2008 permet d'exporter des rapports vers un format sp&eacute;cifique, tel qu'Excel, PDF ou RTF.
Vous pouvez exporter des rapports vers diff&eacute;rents formats en utilisant le mod&egrave;le d'objet ReportDocument.
Proc&eacute;dure
1.
Cr&eacute;ez une m&eacute;thode qui utilise un objet ReportDocument comme param&egrave;tre.
2.
Sp&eacute;cifiez un r&eacute;pertoire de sortie et v&eacute;rifiez qu'il existe. Si le r&eacute;pertoire de sortie n'existe pas, cr&eacute;ez-le.
3.
Appelez la m&eacute;thode ExportToDisk et sp&eacute;cifiez le format de sortie ainsi que le nom du fichier de sortie.
Exemple
Private Shared Sub ExportToPDF_RD(ByVal rd As ReportDocument)
Dim exportPath As String = &quot;C:\\Exported\\&quot;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
135
If Not System.IO.Directory.Exists(exportPath) Then
System.IO.Directory.CreateDirectory(exportPath)
End If
rd.ExportToDisk(ExportFormatType.PortableDocFormat, exportPath +
&quot;PortableDoc.pdf&quot;)
End Sub
private static void ExportToPDF_RD(ReportDocument rd) {
String exportPath = &quot;C:\\Exported\\&quot;;
if (!System.IO.Directory.Exists(exportPath))
{
System.IO.Directory.CreateDirectory(exportPath);
}
rd.ExportToDisk(ExportFormatType.PortableDocFormat, exportPath +
&quot;PortableDoc.pdf&quot;);
}
Informations associ&eacute;es
Mod&egrave;le d'objet ReportDocument [page 37]
1.4.3 Filtrage de donn&eacute;es avec des param&egrave;tres ou des
formules
SAP Crystal Reports vous permet de personnaliser les donn&eacute;es de votre rapport par le biais de param&egrave;tres de
rapport ou en changeant la formule de s&eacute;lection.
Un param&egrave;tre est une variable de rapport d&eacute;finie par l'utilisateur et instanci&eacute;e &agrave; l'actualisation du rapport.
Lorsqu'un param&egrave;tre est utilis&eacute; dans une formule de s&eacute;lection, il vous permet de modifier les donn&eacute;es incluses
dans votre rapport au moment de l'ex&eacute;cution. Les param&egrave;tres peuvent &eacute;galement &ecirc;tre utilis&eacute;s pour personnaliser
l'apparence d'un rapport.
Les formules de s&eacute;lection sp&eacute;cifient et filtrent les enregistrements et les groupes qui apparaissent dans un
rapport. En modifiant la formule de s&eacute;lection, vous modifiez la requ&ecirc;te utilis&eacute;e lors de l'extraction des donn&eacute;es de
la source de donn&eacute;es.
Classes utilis&eacute;es pour la d&eacute;finition de param&egrave;tres ou formules
●
CrystalDecisions.CrystalReports.Engine.DataDefinition
Contient toutes les informations relatives &agrave; la manipulation des donn&eacute;es bas&eacute;es sur la source de donn&eacute;es
d'un rapport.
●
CrystalDecisions.CrystalReports.Engine.ParameterFieldDefinition
Repr&eacute;sente un champ de param&egrave;tre dans le rapport. Cet objet indique les propri&eacute;t&eacute;s et les m&eacute;thodes
permettant d'extraire les informations et de d&eacute;finir les options d'un champ de param&egrave;tre dans le rapport.
●
136
CrystalDecisions.Web.Parameter
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Fournit des propri&eacute;t&eacute;s permettant de modifier ou d'extraire des informations concernant un param&egrave;tre dans
un site Web.
1.4.3.1
Param&egrave;tres
Un param&egrave;tre est une variable de rapport d&eacute;finie par l'utilisateur et instanci&eacute;e &agrave; l'actualisation du rapport. Il existe
de nombreux types de param&egrave;tres et la d&eacute;finition par programmation des diff&eacute;rents types peut entra&icirc;ner des
r&eacute;sultats et des exp&eacute;riences diff&eacute;rents pour les utilisateurs de votre application.
Possibilit&eacute;s d'optimisation de l'utilisation des param&egrave;tres
Afin d'&eacute;viter des erreurs de moment d'ex&eacute;cution lors de la d&eacute;finition de param&egrave;tres par programmation, notez les
&eacute;l&eacute;ments suivants :
●
Les valeurs de param&egrave;tres doivent &ecirc;tre du m&ecirc;me type que le param&egrave;tre.
●
Si le param&egrave;tre poss&egrave;de un masque d'&eacute;dition, les valeurs du param&egrave;tre doivent respecter ce masque.
●
Lors de la lecture des valeurs de param&egrave;tres, assurez-vous de conna&icirc;tre le type de valeurs que vous lisez,
c'est-&agrave;-dire, si ces valeurs sont discr&egrave;tes ou si elles font partie d'une plage.
●
D&eacute;finissez le type de limite sur une valeur de plage avant de l'ajouter au param&egrave;tre.
●
Assurez-vous que la limite sup&eacute;rieure d'une valeur de plage est plus grande que la limite inf&eacute;rieure.
Informations associ&eacute;es
D&eacute;finition des param&egrave;tres [page 699]
Param&egrave;tres de donn&eacute;es et param&egrave;tres non relatifs &agrave; des donn&eacute;es [page 702]
Conception des champs de param&egrave;tre [page 701]
1.4.3.1.1
Propri&eacute;t&eacute;s des valeurs de param&egrave;tres
Les param&egrave;tres prennent en charge de nombreuses fonctions en plus de celles mentionn&eacute;es ici. Pour obtenir une
liste compl&egrave;te de ces fonctions, voir la classe ParameterField.
Param&egrave;tres &agrave; valeurs multiples ou uniques
Si un param&egrave;tre prend en charge plusieurs valeurs, un utilisateur peut s&eacute;lectionner plusieurs valeurs pour un
param&egrave;tre &agrave; l'actualisation du rapport. Si un param&egrave;tre prend en charge des valeurs uniques, un utilisateur ne
peut s&eacute;lectionner qu'une seule valeur pour un param&egrave;tre &agrave; l'actualisation du rapport. Si un param&egrave;tre prend en
charge plusieurs valeurs, il passe d'une variable unique &agrave; un tableau contenant de nombreuses valeurs.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
137
Valeurs de param&egrave;tres discr&egrave;tes ou faisant partie d'une plage
Les valeurs de param&egrave;tres discr&egrave;tes repr&eacute;sentent une valeur unique, telle que 1, &quot;Jill&quot;, 3.141 ou True. Les valeurs
de plages repr&eacute;sentent une &eacute;tendue sp&eacute;cifique de valeurs d'un point &agrave; un autre, telles que [1..45], (4..6],
[&quot;Lundi&quot;,&quot;Jeudi&quot;]. La valeur de limite inf&eacute;rieure de la plage doit &ecirc;tre plus petite que la limite sup&eacute;rieure.
De plus, les param&egrave;tres peuvent &agrave; la fois &ecirc;tre discrets et faire partie d'une plage si le param&egrave;tre prend en charge
plusieurs valeurs.
Valeurs par d&eacute;faut
Vous pouvez sp&eacute;cifier des valeurs par d&eacute;faut pour un param&egrave;tre et forcer l'utilisateur &agrave; s&eacute;lectionner une seule
valeur ou un grand nombre de valeurs. Vous pouvez &eacute;galement fournir des valeurs de param&egrave;tres par d&eacute;faut mais
autoriser l'utilisateur &agrave; saisir des valeurs personnalis&eacute;es. Les valeurs par d&eacute;faut sont stock&eacute;es dans la propri&eacute;t&eacute;
DefaultValues de l'objet ParameterField. Une fois que l'utilisateur a s&eacute;lectionn&eacute; un ensemble de valeurs pour
les param&egrave;tres du rapport, ces valeurs sont stock&eacute;es dans la propri&eacute;t&eacute; CurrentValues.
Remarque
Les valeurs par d&eacute;faut ne peuvent &ecirc;tre que discr&egrave;tes.
Valeurs de param&egrave;tres facultatives
Si la valeur d'un param&egrave;tre est d&eacute;finie sur &quot;facultative&quot;, les utilisateurs ne sont pas oblig&eacute;s de saisir une valeur
lorsqu'une invite s'affiche.
Valeurs de param&egrave;tres statiques ou dynamiques
Les valeurs de param&egrave;tres statiques sont stock&eacute;es dans le rapport. Les valeurs de param&egrave;tres dynamiques sont
extraites d'une source de donn&eacute;es ext&eacute;rieure au rapport.
Valeurs de param&egrave;tres de mise en cascade dynamique
Une invite dynamique peut inclure une liste de valeurs mise en cascade qui guide l'utilisateur dans une s&eacute;quence
d'invites dynamiques pour d&eacute;terminer une valeur de param&egrave;tre finale. Par exemple, les utilisateurs peuvent &ecirc;tre
invit&eacute;s &agrave; choisir un pays avant qu'un choix de r&eacute;gions apparaisse.
138
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Valeurs de param&egrave;tres interactives
Les valeurs de param&egrave;tres peuvent &ecirc;tre manipul&eacute;es au moment de l'ex&eacute;cution &agrave; l'aide de la propri&eacute;t&eacute;
CrystalReportViewer.ViewTimeSelectionFormula. La formule de s&eacute;lection du moment de visualisation
est prise en compte apr&egrave;s application des r&eacute;sultats des formules de s&eacute;lection enregistr&eacute;s avec le rapport.
Types de valeurs de param&egrave;tres
Un champ de param&egrave;tre doit contenir un ParameterType sp&eacute;cifique.
Une valeur de param&egrave;tre doit &ecirc;tre de l'un des types de param&egrave;tres suivants :
●
ReportParameter
●
StoredProcedureParameter
●
QueryParameter
1.4.3.1.2
Panneau des param&egrave;tres
Mettez en forme et filtrez les donn&eacute;es de rapport de mani&egrave;re interactive en utilisant le panneau des param&egrave;tres.
Le nouveau panneau des param&egrave;tres de SAP Crystal Reports 2008 permet aux utilisateurs de d&eacute;finir des
param&egrave;tres statiques et dynamiques et d'actualiser le rapport. Les utilisateurs peuvent &eacute;galement mettre en
forme et filtrer les donn&eacute;es du rapport de mani&egrave;re interactive. Le panneau des param&egrave;tres est accessible depuis
le volet des outils. Vous pouvez acc&eacute;der au panneau des param&egrave;tres en cliquant sur le bouton Param&egrave;tres de la
barre d'outils ou par programmation en utilisant le code suivant :
myCrystalReportViewer.ToolPanelView = ToolPanelViewType.ParameterPanel
crystalReportViewer.ToolPanelView = ToolPanelViewType.ParameterPanel;
Vous pouvez masquer le bouton Param&egrave;tres par programmation en utilisant le code suivant :
myCrystalReportViewer.ShowParameterPanelButton = False
crystalReportViewer.ShowParameterPanelButton = false;
Le panneau affiche tous les param&egrave;tres qui ont &eacute;t&eacute; d&eacute;finis sur Modifiable ou Lecture seule. Si un param&egrave;tre est
d&eacute;fini sur Modifiable, vous pouvez ajouter, supprimer ou modifier les valeurs du param&egrave;tre en cliquant sur le
bouton Afficher la bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s. Si les valeurs du param&egrave;tre sont modifi&eacute;es mais pas
appliqu&eacute;es, un ast&eacute;risque appara&icirc;t en regard du champ de param&egrave;tre pour indiquer que les valeurs n'ont pas &eacute;t&eacute;
appliqu&eacute;es au rapport.
Remarque
Si le param&egrave;tre accepte les valeurs personnalis&eacute;es, vous pouvez directement modifier la valeur du param&egrave;tre
dans le champ de texte du panneau des param&egrave;tres.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
139
Une ic&ocirc;ne de base de donn&eacute;es appara&icirc;t &agrave; c&ocirc;t&eacute; des param&egrave;tres de donn&eacute;es. Lorsque vous modifiez la valeur d'un
param&egrave;tre de donn&eacute;es, le rapport actualise la base de donn&eacute;es et y acc&egrave;de pour effectuer les modifications
correspondantes. Lorsque vous modifiez la valeur d'un param&egrave;tre non relatif &agrave; des donn&eacute;es, le rapport est mis en
forme ou filtr&eacute; en fonction des donn&eacute;es enregistr&eacute;es dans le rapport. Le rapport n'acc&egrave;de pas &agrave; la base de
donn&eacute;es.
Informations associ&eacute;es
Filtrage des donn&eacute;es &agrave; l'aide des formules de s&eacute;lection [page 148]
1.4.3.1.3
D&eacute;finition de param&egrave;tres dans la page ASPX
Lorsque vous cr&eacute;ez un rapport Crystal, la s&eacute;lection des donn&eacute;es de ce rapport est g&eacute;r&eacute;e par le crit&egrave;re &quot;where&quot;. La
valeur de ce crit&egrave;re peut &ecirc;tre cod&eacute;e en dur, mais lorsqu'elle doit &ecirc;tre dynamique, un param&egrave;tre est cr&eacute;&eacute; et la
clause &quot;where&quot; lui est affect&eacute;e. Les param&egrave;tres ne sont pas g&eacute;r&eacute;s de la m&ecirc;me mani&egrave;re selon que vous utilisez un
mod&egrave;le de programmation all&eacute;g&eacute;e ou classique.
Lorsque vous d&eacute;veloppez un projet &agrave; l'aide d'un mod&egrave;le de programmation classique, SAP Crystal Reports,
version d&eacute;veloppeur pour Microsoft Visual Studio acc&egrave;de aux param&egrave;tres et interagit avec eux par le biais d'un
groupe de classes associ&eacute;es aux param&egrave;tres dans le SDK de SAP Crystal Reports.
Lorsque vous utilisez un mod&egrave;le de programmation all&eacute;g&eacute;e (le mod&egrave;le de d&eacute;veloppement d'applications avec
balises), le contr&ocirc;le CrystalReportSourceacc&egrave;de aux param&egrave;tres et interagit avec eux par le biais de la
structure Parameters. La structure Parameters est une nouveaut&eacute; de ASP.NET version 2.0, qui permet d'affecter
des param&egrave;tres &agrave; n'importe quel contr&ocirc;le DataSource (dans le cas pr&eacute;sent, un contr&ocirc;le
CrystalReportSource). Ces param&egrave;tres peuvent &ecirc;tre affect&eacute;s au rapport principal comme aux sous-rapports,
si n&eacute;cessaire.
Il est possible d'affecter un param&egrave;tre &agrave; partir de tous les types de param&egrave;tre suivants :
●
ControlParameter
●
QueryStringParameter
●
SessionParameter
●
FormParameter
●
CookieParameter
Cette affectation permet alors de cr&eacute;er une solution de programmation all&eacute;g&eacute;e dans laquelle les param&egrave;tres d'un
rapport peuvent &ecirc;tre d&eacute;finis &agrave; partir de s&eacute;lections effectu&eacute;es dans les contr&ocirc;les DropDownList (ou d'autres types
de contr&ocirc;le), de valeurs contenues dans une cha&icirc;ne de requ&ecirc;te URL, de valeurs extraites d'un objet Session, de
valeurs provenant de champs de formulaires ou d'un cookie.
140
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Configuration des propri&eacute;t&eacute;s Parameters directement dans le fichier XML
Dans un fichier XML, la balise &lt;Parameters&gt; est imbriqu&eacute;e dans la balise &lt;CrystalReportSource&gt;. Dans la
balise imbriqu&eacute;e &lt;Parameters&gt;, il est possible de configurer des liens &agrave; un param&egrave;tre par d&eacute;faut ou &agrave; un
param&egrave;tre &agrave; partir d'un contr&ocirc;le.
Exemple
Configuration d'un param&egrave;tre dans XML
Cet exemple d&eacute;finit la valeur par d&eacute;faut du param&egrave;tre City sur Tokyo.
&lt;CR:CrystalReportSource ID=&quot;CrystalReportSource1&quot;
runat=&quot;server&quot;&gt;
&lt;Report FileName=&quot;SalesReport.rpt&quot;&gt;
&lt;Parameters&gt;
&lt;CR:Parameter ConvertEmptyStringToNull=&quot;False&quot;
DefaultValue=&quot;Tokyo&quot; Name=&quot;City&quot; ReportName=&quot;&quot; /&gt;
&lt;/Parameters&gt;
&lt;/Report&gt;
&lt;/CR:CrystalReportSource&gt;
Exemple
Liaison d'un param&egrave;tre &agrave; un contr&ocirc;le
Vous pouvez lier la valeur d'un param&egrave;tre &agrave; un autre contr&ocirc;le au sein du Web Form. Cet exemple d&eacute;finit la
valeur d'un param&egrave;tre nomm&eacute; City sur la valeur d'un contr&ocirc;le de zone de texte nomm&eacute; Location.
&lt;CR:CrystalReportSource ID=&quot;CrystalReportSource1&quot;
runat=&quot;server&quot;&gt;
&lt;Report FileName=&quot;SalesReport.rpt&quot;&gt;
&lt;Parameters&gt;
&lt;CR:ControlParameter ControlID=&quot;Location&quot;
ConvertEmptyStringToNull=&quot;False&quot;
Name=&quot;city&quot; PropertyName=&quot;Text&quot; ReportName=&quot;&quot; /&gt;
&lt;/Parameters&gt;
&lt;/Report&gt;
&lt;/CR:CrystalReportSource&gt;
Informations associ&eacute;es
D&eacute;finition des param&egrave;tres [page 699]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
141
1.4.3.1.3.1
Acc&egrave;s &agrave; la bo&icirc;te de dialogue Editeur de
collections de param&egrave;tres
Contexte
Les param&egrave;tres sont configur&eacute;s dans la bo&icirc;te de dialogue Editeur de collections de param&egrave;tres.
Proc&eacute;dure
1.
S&eacute;lectionnez le contr&ocirc;le CrystalReportSource.
2.
Dans Propri&eacute;t&eacute;s, d&eacute;veloppez Report.
3.
Dans la propri&eacute;t&eacute; Report, cliquez sur le bouton de s&eacute;lection (...) tout &agrave; fait &agrave; droite de Parameters (Collection).
4.
Dans la bo&icirc;te de dialogue Editeur de collections de param&egrave;tres, saisissez un ou plusieurs param&egrave;tres pour le
rapport principal ainsi que pour tous les sous-rapports.
1.4.3.1.4
D&eacute;finition de param&egrave;tres discrets dans un rapport
Cet exemple d&eacute;finit les param&egrave;tres sur des valeurs sp&eacute;cifiques utilis&eacute;es par l'exemple de rapport.
Pr&eacute;requis
Vous devez disposer d'un rapport avec un champ de param&egrave;tre d&eacute;j&agrave; sp&eacute;cifi&eacute;.
Contexte
En utilisant le mod&egrave;le d'objet ReportDocument, vous pouvez d&eacute;finir les valeurs des param&egrave;tres existants dans un
rapport. Les param&egrave;tres sont accessibles par nom ou valeur d'index num&eacute;rique. Pour ajouter un nouveau
param&egrave;tre &agrave; un rapport, vous devez utiliser le mod&egrave;le d'objet ReportClientDocument.
Proc&eacute;dure
1.
Cr&eacute;e une constante de cha&icirc;ne PARAMETER_FIELD_NAME et d&eacute;finit sa valeur sur le nom d'un param&egrave;tre
existant.
2.
142
Cr&eacute;ez une instance de la classe ArrayList.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Pour chaque valeur que vous souhaitez affecter au param&egrave;tre, ajoutez une valeur &agrave; l'instance ArrayList.
4.
Appelez la m&eacute;thode ReportDocument.SetParameterValue et transmettez le nom de param&egrave;tre et la liste
de valeurs.
La m&eacute;thode ReportDocument.SetParameterValue d&eacute;finit la valeur actuelle d'un champ de param&egrave;tre.
Cette valeur peut &ecirc;tre une valeur primaire, ParameterValue, un tableau d'un type ou l'autre ou une
collection ParameterValues.
Exemple
D&eacute;finition de param&egrave;tres discrets dans un rapport
Private Sub SettingParameters_RD(ByVal TestReport As ReportDocument)
Dim PARAMETER_FIELD_NAME As String = &quot;Country&quot;
Dim countries As New ArrayList()
countries.Add(&quot;Canada&quot;)
countries.Add(&quot;USA&quot;)
TestReport.SetParameterValue(PARAMETER_FIELD_NAME, countries.ToArray())
crystalReportViewer.ReportSource = TestReport
End Sub
private void SettingParameters_RD(ReportDocument TestReport)
{
string PARAMETER_FIELD_NAME = &quot;Country&quot;;
ArrayList countries = new ArrayList();
countries.Add(&quot;Canada&quot;);
countries.Add(&quot;USA&quot;);
TestReport.SetParameterValue(PARAMETER_FIELD_NAME, countries.ToArray());
crystalReportViewer.ReportSource = TestReport;
}
&Eacute;tapes suivantes
Un site Web SAP Crystal Reports peut requ&eacute;rir un code suppl&eacute;mentaire pour g&eacute;rer l'&eacute;tat de la session entre les
affichages de page.
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 389]
Dans ce tutoriel, vous allez apprendre &agrave; cr&eacute;er un rapport dont les donn&eacute;es peuvent &ecirc;tre filtr&eacute;es en fonction d'un
param&egrave;tre discret.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
143
1.4.3.1.5
rapport
D&eacute;finition de param&egrave;tres discrets dans un sous-
Cet exemple attribue &agrave; un param&egrave;tre de sous-rapport une valeur sp&eacute;cifique.
Pr&eacute;requis
Vous devez disposer d'un rapport avec un champ de param&egrave;tre d&eacute;j&agrave; sp&eacute;cifi&eacute;.
Contexte
Pour d&eacute;finir une valeur discr&egrave;te dans un rapport, vous devez appeler la m&eacute;thode
ReportDocument.SetParameterValue avec le nom du param&egrave;tre et la valeur du param&egrave;tre. Cette m&eacute;thode
n'est pas prise en charge pour les sous-rapports. Dans ce cas, vous devez acc&eacute;der au param&egrave;tre du sous-rapport
via la collection ParameterFields du rapport principal et le d&eacute;finir sur un nouvel objet
ParameterDiscreteValue.
Proc&eacute;dure
1.
Cr&eacute;ez une instance de la classe ParameterDiscreteValue.
Conseil
Utilisez la classe ParameterRangeValue pour les param&egrave;tres limit&eacute;s.
2.
D&eacute;finissez la propri&eacute;t&eacute; ParameterDiscreteValue.Value sur la nouvelle valeur du param&egrave;tre.
Dim dv As New ParameterDiscreteValue()
dv.Value = parameterValue
ParameterDiscreteValue dv = new ParameterDiscreteValue();
dv.Value = parameterValue;
3.
Cr&eacute;ez une instance de la collection ParameterFields et affectez-lui la valeur de la propri&eacute;t&eacute;
ReportDocument.ParameterFields du rapport principal.
Dim parameterFields As ParameterFields = testReport.ParameterFields
ParameterFields parameterFields = testReport.ParameterFields;
144
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
4.
Acc&eacute;dez au param&egrave;tre du sous-rapport via un index nomm&eacute; de l'instance ParameterFields.
Dim parameterField As ParameterField = parameterFields(parameterFieldName,
subreportName)
ParameterField parameterField = parameterFields[parameterFieldName,
subreportName];
La collection ParameterFields requiert deux index, l'un pour le nom du param&egrave;tre et l'autre pour le nom du
sous-rapport.
5.
Effacez la valeur existante dans le champ de param&egrave;tre et ajoutez l'objet ParameterDiscreteValue que vous
avez cr&eacute;&eacute; pr&eacute;alablement.
parameterField.CurrentValues.Clear()
parameterField.CurrentValues.Add(dv)
parameterField.CurrentValues.Clear();
parameterField.CurrentValues.Add(dv);
6.
Liez le rapport &agrave; un contr&ocirc;le CrystalReportViewer.
Remarque
ParameterFields doit &ecirc;tre d&eacute;fini avant la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer ; sinon,
le contr&ocirc;le vous invite &agrave; saisir les informations de param&egrave;tres.
Exemple
D&eacute;finition de param&egrave;tres discrets dans un sous-rapport
Private Sub SubreportSettingParameters_RD(ByVal testReport As ReportDocument,
ByVal subreportName As String, ByVal parameterFieldName As String, ByVal
parameterValue As String)
Dim dv As New ParameterDiscreteValue()
dv.Value = parameterValue
Dim parameterFields As ParameterFields = testReport.ParameterFields
Dim parameterField As ParameterField = parameterFields(parameterFieldName,
subreportName)
parameterField.CurrentValues.Clear()
parameterField.CurrentValues.Add(dv)
crystalReportViewer1.ReportSource = TestReport
End Sub
private void SubreportSettingParameters_RD(ReportDocument testReport,
String subreportName, String parameterFieldName, String
parameterValue)
{
ParameterDiscreteValue dv = new ParameterDiscreteValue();
dv.Value = parameterValue;
ParameterFields parameterFields = testReport.ParameterFields;
ParameterField parameterField = parameterFields[parameterFieldName,
subreportName];
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
145
}
parameterField.CurrentValues.Clear();
parameterField.CurrentValues.Add(dv);
crystalReportViewer1.ReportSource = TestReport;
&Eacute;tapes suivantes
Un site Web SAP Crystal Reports peut requ&eacute;rir un code suppl&eacute;mentaire pour g&eacute;rer l'&eacute;tat de la session entre les
affichages de page.
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres de plage d'un sous-rapport [page 277]
Dans ce tutoriel, vous allez traiter un probl&egrave;me suppl&eacute;mentaire : que faire si un rapport contient un sousrapport n&eacute;cessitant des param&egrave;tres diff&eacute;rents ?
1.4.3.1.6
D&eacute;finition de param&egrave;tres limit&eacute;s dans un rapport
Pr&eacute;requis
Vous devez disposer d'un rapport avec un champ de param&egrave;tre d&eacute;j&agrave; sp&eacute;cifi&eacute;.
Contexte
En utilisant le mod&egrave;le d'objet ReportDocument, vous pouvez d&eacute;finir les valeurs des param&egrave;tres existants dans un
rapport. Les param&egrave;tres sont accessibles par nom ou valeur d'index num&eacute;rique. Pour ajouter un nouveau
param&egrave;tre &agrave; un rapport, vous devez utiliser le mod&egrave;le d'objet ReportClientDocument.
Pour d&eacute;finir un param&egrave;tre limit&eacute;, vous devez cr&eacute;er une instance de la classe ParameterRangeValue et la
transmettre &agrave; la m&eacute;thode ReportDocument.SetParameterValue.
146
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Proc&eacute;dure
1.
Cr&eacute;e une constante de cha&icirc;ne PARAMETER_FIELD_NAME et d&eacute;finit sa valeur sur le nom d'un param&egrave;tre
existant.
2.
Cr&eacute;ez une instance de la classe ParameterRangeValue.
Dim dateRange As New ParameterRangeValue()
ParameterRangeValue dateRange = new ParameterRangeValue();
3.
D&eacute;finissez les valeurs de d&eacute;but et de fin pour l'objet ParameterRangeValue.
dateRange.StartValue = startDate
dateRange.EndValue = endDate
dateRange.StartValue = startDate;
dateRange.EndValue = endDate;
4.
D&eacute;finissez les limites sup&eacute;rieure et inf&eacute;rieure de la plage.
Option
Description
RangeBoundType.BoundExclusive
Les valeurs sup&eacute;rieures et inf&eacute;rieures ne sont pas incluses dans la plage.
RangeBoundType.BoundInclusive
Les valeurs sup&eacute;rieures et inf&eacute;rieures sont incluses dans la plage.
RangeBoundType.NoBound
Aucune plage n'est s&eacute;lectionn&eacute;e.
dateRange.LowerBoundType = RangeBoundType.BoundInclusive
dateRange.UpperBoundType = RangeBoundType.BoundInclusive
dateRange.LowerBoundType = RangeBoundType.BoundInclusive;
dateRange.UpperBoundType = RangeBoundType.BoundInclusive;
5.
Appelez la m&eacute;thode ReportDocument.SetParameterValue et transmettez le nom du param&egrave;tre et l'objet
ParameterRangeValue.
La m&eacute;thode ReportDocument.SetParameterValue d&eacute;finit la valeur actuelle d'un champ de param&egrave;tre.
Cette valeur peut &ecirc;tre une valeur primaire, ParameterValue, un tableau d'un type ou l'autre ou une
collection ParameterValues.
Exemple
Private Sub SettingParameters_RD(ByVal testReport As ReportDocument, ByVal
startDate As String, ByVal endDate As String)
Dim PARAMETER_FIELD_NAME As String = &quot;SalesDates&quot;
Dim dateRange As New ParameterRangeValue()
dateRange.StartValue = startDate
dateRange.EndValue = endDate
dateRange.LowerBoundType = RangeBoundType.BoundInclusive
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
147
dateRange.UpperBoundType = RangeBoundType.BoundInclusive
testReport.SetParameterValue(PARAMETER_FIELD_NAME, dateRange)
crystalReportViewer1.ReportSource = testReport
End Sub
private void SettingParameters_RD(ReportDocument testReport, String startDate,
String endDate)
{
string PARAMETER_FIELD_NAME = &quot;SalesDates&quot;;
ParameterRangeValue dateRange = new ParameterRangeValue();
dateRange.StartValue = startDate;
dateRange.EndValue = endDate;
dateRange.LowerBoundType = RangeBoundType.BoundInclusive;
dateRange.UpperBoundType = RangeBoundType.BoundInclusive;
}
testReport.SetParameterValue(PARAMETER_FIELD_NAME, dateRange);
crystalReportViewer1.ReportSource = testReport;
&Eacute;tapes suivantes
Un site Web SAP Crystal Reports peut requ&eacute;rir un code suppl&eacute;mentaire pour g&eacute;rer l'&eacute;tat de la session entre les
affichages de page.
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
1.4.3.2
Filtrage des donn&eacute;es &agrave; l'aide des formules de
s&eacute;lection
Les formules de s&eacute;lection sp&eacute;cifient et filtrent les enregistrements et les groupes qui apparaissent dans un
rapport. Les trois formules de s&eacute;lection suivantes permettent de filtrer les donn&eacute;es :
●
Formule de s&eacute;lection d'enregistrement
●
Formule de s&eacute;lection des donn&eacute;es enregistr&eacute;es
●
Formule de s&eacute;lection de groupe
Le tableau suivant montre les types de champs autoris&eacute;s dans diff&eacute;rents filtres de rapports :
148
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Formule de s&eacute;lection
d'enregistrement
Formule de s&eacute;lection des
donn&eacute;es enregistr&eacute;es
Formule de s&eacute;lection de
groupe
Param&egrave;tres
X
X
X
R&eacute;sum&eacute;s
-
-
X
Formules d'heure d'im&shy;
pression/totaux cumul&eacute;s
-
-
-
Le tableau suivant montre les diff&eacute;rents comportements associ&eacute;s aux diff&eacute;rents filtres de rapports :
Formule de s&eacute;lection
d'enregistrement
Formule de s&eacute;lection des
donn&eacute;es enregistr&eacute;es
Formule de s&eacute;lection de
groupe
Peut-on se r&eacute;f&eacute;rer au r&eacute;&shy;
sum&eacute; ?
Non.
Oui.
Oui.
Quand la formule est-elle
&eacute;valu&eacute;e ?
Pendant la lecture des en&shy;
registrements.
Si un r&eacute;sum&eacute; est utilis&eacute;, &agrave;
l'heure d'impression ; si&shy;
non, pendant la lecture
des enregistrements.
A l'heure d'impression.
Quand le rapport est-il ac&shy;
tualis&eacute; ?
Si le r&eacute;sultat de l'&eacute;valua&shy;
tion est faux, lorsque les
enregistrements sont
abandonn&eacute;s.
Si les enregistrements
sont lus, lors de l'&eacute;valua&shy;
tion. Si le r&eacute;sultat de l'&eacute;va&shy;
luation est faux, lorsque
les enregistrements sont
abandonn&eacute;s.
N/A
Le calcul du r&eacute;sum&eacute; est-il
affect&eacute; ?
Oui, les enregistrements
Si le filtre est &eacute;valu&eacute; pen&shy;
Non, les enregistrements
filtr&eacute;s ne sont pas compta&shy; dant la lecture des enre&shy;
sont comptabilis&eacute;s m&ecirc;me
bilis&eacute;s.
gistrements, alors non ; si&shy; lorsqu'ils sont filtr&eacute;s.
non, oui.
Vous pouvez appliquer la formule de s&eacute;lection des donn&eacute;es enregistr&eacute;es au r&eacute;sultat de la formule de s&eacute;lection
d'enregistrement. Le diagramme suivant d&eacute;crit le flux d'utilisation des formules de s&eacute;lection d'enregistrement et
de s&eacute;lection des donn&eacute;es enregistr&eacute;es :
Formule de s&eacute;lection d'enregistrement
La formule de s&eacute;lection d'enregistrement sp&eacute;cifie les enregistrements qui formeront les donn&eacute;es enregistr&eacute;es du
rapport. Cette formule de s&eacute;lection autorise deux niveaux de filtrage :
●
filtrage par la base de donn&eacute;es ;
●
filtrage par le moteur de traitement du rapport.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
149
Formule de s&eacute;lection des donn&eacute;es enregistr&eacute;es
SavedDataFilter permet aux utilisateurs de visualiser un sous-ensemble des donn&eacute;es enregistr&eacute;es dans un
rapport. En cas de modification de SavedDataFilter, les donn&eacute;es enregistr&eacute;es dans le rapport ne sont pas ignor&eacute;es
et la base de donn&eacute;es n'est pas sollicit&eacute;e.
Formule de s&eacute;lection de groupe
La formule de s&eacute;lection de groupe sp&eacute;cifie les enregistrements qui seront pris en compte lors du rendu des pages
du rapport. Cette formule utilise g&eacute;n&eacute;ralement les valeurs produites &agrave; des &eacute;tapes ant&eacute;rieures de traitement du
rapport, comme les r&eacute;sum&eacute;s.
Remarque
La formule de s&eacute;lection de groupe filtre les enregistrements et pas les groupes.
1.4.3.2.1
s&eacute;lection
Filtrage de donn&eacute;es &agrave; l'aide de formules de
Contexte
Cet exemple applique un filtre &agrave; l'un des param&egrave;tres de la base de donn&eacute;es qui sont utilis&eacute;s par l'exemple de
rapport. Le filtre permet aux utilisateurs de personnaliser les valeurs qui apparaissent dans un rapport.
Proc&eacute;dure
1.
Cr&eacute;ez une m&eacute;thode qui utilise un objet ReportDocument et une cha&icirc;ne contenant une formule de s&eacute;lection.
Le SDK SAP Crystal Reports .NET utilise la m&ecirc;me syntaxe pour une formule de s&eacute;lection que le concepteur
incorpor&eacute; de SAP Crystal Reports.
2.
Affectez la formule de s&eacute;lection &agrave; la propri&eacute;t&eacute; DataDefinition.RecordSelectionFormula de l'objet
ReportDocument en cours.
La classe DataDefinition contient toutes les informations relatives &agrave; la manipulation des donn&eacute;es bas&eacute;es sur
la source de donn&eacute;es d'un rapport. La classe DataDefinition de chaque rapport est accessible via la propri&eacute;t&eacute;
ReportDocument.DataDefinition.
3.
150
Liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer &agrave; l'instance ReportDocument.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;sultats
Le rapport sera actualis&eacute; avec les nouveaux r&eacute;sultats en fonction de la formule de s&eacute;lection sp&eacute;cifi&eacute;e.
Exemple
Cet exemple accepte un objet ReportDocument et un param&egrave;tre d'entier. Le param&egrave;tre d'entier est concat&eacute;n&eacute;
avec une cha&icirc;ne existante pour cr&eacute;er une formule de s&eacute;lection compl&egrave;te. La formule de s&eacute;lection est appliqu&eacute;e
au rapport avant la liaison du contr&ocirc;le CrystalReportViewer &agrave; l'objet ReportDocument.
Private Sub FilterData_RD(ByVal TestReport As ReportDocument, ByVal sales As
Integer)
Dim selectFormula As String = &quot;{Customer.Last Year's Sales} &gt; &quot; + sales
TestReport.DataDefinition.RecordSelectionFormula = selectionFormula
crystalReportViewer.ReportSource = TestReport
End Sub
private void FilterData_RD(ReportDocument TestReport, int sales)
{
string selectFormula = &quot;{Customer.Last Year's Sales} &gt; &quot; + sales;
TestReport.DataDefinition.RecordSelectionFormula = selectionFormula;
crystalReportViewer.ReportSource = TestReport;
}
&Eacute;tapes suivantes
Un site Web SAP Crystal Reports peut requ&eacute;rir un code suppl&eacute;mentaire pour g&eacute;rer l'&eacute;tat de la session entre les
affichages de page.
Informations associ&eacute;es
Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page 341]
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
Incorporation des param&egrave;tres dans des formules [page 705]
1.4.4
D&eacute;finition de la source de donn&eacute;es
SAP Crystal Reports permet de cr&eacute;er des rapports &agrave; partir de n'importe quelle source de donn&eacute;es, notamment les
sources persistantes telles que les bases de donn&eacute;es et les fichiers XML, et les sources ex&eacute;cutables telles que les
ensembles d'objets.
Le mod&egrave;le d'objet ReportDocument permet d'acc&eacute;der par programmation aux informations de connexion &agrave; ces
sources de donn&eacute;es et de les modifier pour le fichier de rapport au moment de l'ex&eacute;cution.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
151
Une source de donn&eacute;es peut &ecirc;tre d&eacute;finie de diff&eacute;rentes mani&egrave;res :
●
En utilisant la m&eacute;thode ReportDocument.DatasourceConnections[0].SetConnection.
Cette m&eacute;thode permet de se connecter &agrave; un rapport ou &agrave; un sous-rapport.
●
En mettant &agrave; jour la propri&eacute;t&eacute; ReportDocument.Table.LogOnInfo et en appelant la m&eacute;thode
ReportDocument.Table.ApplyLogOnInfo.
Cette m&eacute;thode permet de se connecter &agrave; un rapport ou &agrave; un sous-rapport. Cette m&eacute;thode permet &eacute;galement
de sp&eacute;cifier un emplacement de tableau enti&egrave;rement qualifi&eacute;.
●
En utilisant la m&eacute;thode CrystalReportViewer.LogOnInfo.
Cette m&eacute;thode permet de se connecter &agrave; un rapport, mais ne permet pas de d&eacute;finir l'emplacement de la base
de donn&eacute;es.
Classes utilis&eacute;es pour la d&eacute;finition de la source de donn&eacute;es
●
CrystalDecisions.Shared.ConnectionInfo
Indique les propri&eacute;t&eacute;s permettant d'extraire et de d&eacute;finir des options de connexion aux serveurs de bases de
donn&eacute;es ou aux sources de donn&eacute;es ODBC.
●
CrystalDecisions.CrystalReports.Engine.Table
Repr&eacute;sente une table de base de donn&eacute;es &agrave; laquelle acc&egrave;de le rapport. Cette classe indique les propri&eacute;t&eacute;s et
les m&eacute;thodes permettant d'extraire les informations sur la table et de d&eacute;finir les informations de connexion de
la table.
●
CrystalDecisions.CrystalReports.Engine.ReportDocument
Repr&eacute;sente un rapport et contient les propri&eacute;t&eacute;s et les m&eacute;thodes permettant de sp&eacute;cifier une source de
donn&eacute;es au moment de l'ex&eacute;cution.
Informations associ&eacute;es
Sources de donn&eacute;es prises en charge [page 666]
Acc&egrave;s aux donn&eacute;es et ajout des donn&eacute;es [page 666]
1.4.4.1
Connexion &agrave; une base de donn&eacute;es
La source de donn&eacute;es la plus courante pour un rapport Crystal est une base de donn&eacute;es. Vous pouvez acc&eacute;der &agrave;
une base de donn&eacute;es &agrave; partir de l'une des sources suivantes :
●
152
Directement &agrave; partir du fichier de rapport, &agrave; l'aide des informations de connectivit&eacute; de la base de donn&eacute;es
stock&eacute;es dans ce fichier.
Les informations de connectivit&eacute; &agrave; la base de donn&eacute;es sont configur&eacute;es &agrave; l'aide du concepteur
SAP Crystal Report incorpor&eacute; lorsque le rapport est cr&eacute;&eacute; ou modifi&eacute;. Ces informations sont automatiquement
transmises &agrave; la base de donn&eacute;es par le moteur de rapport chaque fois qu'un rapport est affich&eacute;.
Les r&eacute;f&eacute;rences de connexion peuvent &ecirc;tre enregistr&eacute;es avec le rapport ou transmises au moment de
l'ex&eacute;cution.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
A partir du code de l'API .NET de SAP Crystal Reports.
Les informations de connectivit&eacute; &agrave; la base de donn&eacute;es peuvent &ecirc;tre reconfigur&eacute;es avec un code qui interagit
avec le rapport par programmation au moment de l'ex&eacute;cution.
Le sc&eacute;nario le plus courant pour la cr&eacute;ation d'une connexion &agrave; une base de donn&eacute;es consiste &agrave; d&eacute;finir les
param&egrave;tres de connexion &agrave; la base de donn&eacute;es dans le concepteur SAP Crystal Reports, puis &agrave; fournir les
informations de connexion par programmation au moment de l'ex&eacute;cution.
Informations associ&eacute;es
Acc&egrave;s aux donn&eacute;es et ajout des donn&eacute;es [page 666]
1.4.4.1.1
Optimisation de la s&eacute;curit&eacute; lors d'une connexion &agrave;
une base de donn&eacute;es SQL Server
Quelle que soit la source des rapports, le probl&egrave;me de s&eacute;curit&eacute; reste le m&ecirc;me : comment prot&eacute;ger la base de
donn&eacute;es des attaques malveillantes ?
utiliser l'authentification Windows avec la s&eacute;curit&eacute; int&eacute;gr&eacute;e
Pour une s&eacute;curit&eacute; optimale, Microsoft recommande l'utilisation de l'authentification Windows avec la s&eacute;curit&eacute;
int&eacute;gr&eacute;e. Avec cette configuration, aucun ID utilisateur ni mot de passe n'est n&eacute;cessaire dans l'application.
utiliser l'authentification SQL Server avec un compte de base de donn&eacute;es &agrave;
acc&egrave;s limit&eacute;
Pour utiliser l'authentification SQL Server avec votre base de donn&eacute;es, vous devez prendre des mesures
suppl&eacute;mentaires pour parvenir &agrave; une s&eacute;curit&eacute; optimale.
N'utilisez jamais l'ID et le mot de passe de l'administrateur syst&egrave;me dans votre code. Ceci repr&eacute;sentant une
menace consid&eacute;rable pour la s&eacute;curit&eacute;. Proc&eacute;dez plut&ocirc;t de la mani&egrave;re suivante :
●
Cr&eacute;ez un compte de base de donn&eacute;es &agrave; acc&egrave;s limit&eacute;.
●
Configurez ce compte pour autoriser uniquement l'acc&egrave;s aux tables requises de la base de donn&eacute;es.
●
Pour chaque table accessible, autorisez uniquement l'ex&eacute;cution de l'instruction SELECT.
Microsoft recommande &eacute;galement de crypter votre ID utilisateur et votre mot de passe. Pour en savoir plus sur le
cryptage de l'ID utilisateur et du mot de passe, consultez les informations sur la s&eacute;curit&eacute; dans MSDN.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
153
1.4.4.1.2
Connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e avec un sous-rapport
Pr&eacute;requis
Pour ex&eacute;cuter cet exemple, vous devez disposer d'un rapport contenant un sous-rapport qui requiert une
authentification SQL s&eacute;curis&eacute;e. Le nom d'utilisateur et le mot de passe pour se connecter &agrave; la base de donn&eacute;es
SQL Server doivent &ecirc;tre fournis.
Contexte
Cet exemple permet d'activer la base de donn&eacute;es d'un sous-rapport par programmation.
Proc&eacute;dure
1.
Extrayez l'instance DataSourceConnections de la propri&eacute;t&eacute; DataSourceConnections des instances de
rapport et sous-rapport.
2.
Extrayez l'&eacute;l&eacute;ment IConnectionInfo au niveau de l'index 0 de l'instance DataSourceConnections.
3.
Appelez la m&eacute;thode SetConnection avec votre nom de serveur, de base de donn&eacute;es, d'utilisateur et votre
mot de passe.
4.
Appelez la m&eacute;thode SetLogon avec votre nom d'utilisateur et de votre mot de passe.
Exemple
Private Function SubreportLogon_RD(ByVal TestReport As ReportDocument) As
ReportDocument
Dim dataSourceConnections As DataSourceConnections =
TestReport.DataSourceConnections
Dim connectInfo As IConnectionInfo = dataSourceConnections(0)
connectInfo.SetConnection(&quot;ServerName&quot;, &quot;DatabaseName&quot;, &quot;UserName&quot;,
&quot;Password&quot;)
Dim TestSubreport As ReportDocument = TestReport.Subreports(&quot;Subreport1&quot;)
Dim subreportDataSourceConnections As DataSourceConnections =
TestSubreport.DataSourceConnections
Dim connectInfo As IConnectionInfo = subreportDataSourceConnections(0)
connectInfo.SetLogon(&quot;UserName&quot;, &quot;Password&quot;)
End Function
private ReportDocument SubreportLogon_RD(ReportDocument TestReport)
{
DataSourceConnections dataSourceConnections =
TestReport.DataSourceConnections;
IConnectionInfo connectInfo = dataSourceConnections[0];
connectInfo.SetConnection(&quot;ServerName&quot;, &quot;DatabaseName&quot;, &quot;UserName&quot;,
&quot;Password&quot;);
154
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ReportDocument TestSubreport = TestReport.Subreports[&quot;Subreport1&quot;];
DataSourceConnections subreportDataSourceConnections =
TestSubreport.DataSourceConnections;
IConnectionInfo connectInfo = subreportDataSourceConnections[0];
connectInfo.SetLogon(&quot;UserName&quot;, &quot;Password&quot;);
}
1.4.4.1.3
Connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e avec le mod&egrave;le d'objet ReportDocument
Cet exemple montre comme se connecter &agrave; une base de donn&eacute;es en utilisant une authentification SQL s&eacute;curis&eacute;e.
Pr&eacute;requis
Avant de commencer, vous devez disposer d'un rapport requ&eacute;rant une authentification SQL s&eacute;curis&eacute;e.
Contexte
Pour mettre &agrave; jour les informations de connexion pour un rapport en utilisant le mod&egrave;le d'objet ReportDocument,
vous devez mettre &agrave; jour la propri&eacute;t&eacute; ConnectionInfo pour chaque objet Table de la collection
ReportDocument.Database.Tables. Une fois chaque propri&eacute;t&eacute; mise &agrave; jour, appelez la m&eacute;thode
Table.ApplyLogOnInfo pour valider les modifications.
Proc&eacute;dure
1.
Cr&eacute;ez un objet ConnectionInfo.
2.
D&eacute;finissez les propri&eacute;t&eacute;s DatabaseName, UserID et Password de l'objet ConnectionInfo sur les valeurs
requises pour la connexion.
Remarque
Si vous d&eacute;finissez uniquement les propri&eacute;t&eacute;s DatabaseName, UserID et Password, vous &ecirc;tes connect&eacute; au
serveur par d&eacute;faut de la base de donn&eacute;es sp&eacute;cifi&eacute;e dans le rapport. Toutefois, si vous affectez une autre
propri&eacute;t&eacute; ServerName, vous pouvez rediriger le rapport vers un serveur diff&eacute;rent au moment de
l'ex&eacute;cution.
3.
Extrayez l'instance Tables de la propri&eacute;t&eacute; Database de la classe ReportDocument.
Remarque
Tables est une classe index&eacute;e contenant des instances de la classe Table.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
155
4.
Pour chaque objet Table de la collection :
a) Extrayez l'instance TableLogOnInfode la propri&eacute;t&eacute; LogOnInfo de la classe Table.
b) Mettez &agrave; jour la propri&eacute;t&eacute; ConnectionInfo de l'objet TableLogOnInfo.
c) Appelez la m&eacute;thode ApplyLogOnInfo pour valider la modification.
Exemple
Private Sub setDatabaseLogon(ByVal rd As ReportDocument, ByVal databaseName As
String, ByVal userName As String, ByVal password As String)
Dim myConnectionInfo As New ConnectionInfo()
myConnectionInfo.DatabaseName = databaseName
myConnectionInfo.UserID = userName
myConnectionInfo.Password = password
Dim myTables As Tables = rd.Database.Tables
For Each myTable As Table In myTables
Dim newLogonInfo As TableLogOnInfo = myTable.LogOnInfo
newLogonInfo.ConnectionInfo = myConnectionInfo
myTable.ApplyLogOnInfo(newLogonInfo)
Next
End Sub
private void setDatabaseLogon(ReportDocument rd, String databaseName, String
userName, String password)
{
ConnectionInfo connectionInfo = new ConnectionInfo();
connectionInfo.DatabaseName = databaseName;
connectionInfo.UserID = userName;
connectionInfo.Password = password;
}
Tables tables = rd.Database.Tables;
foreach (Table table in tables)
{
TableLogOnInfo newLogonInfo = table.LogOnInfo;
newLogonInfo.ConnectionInfo = connectionInfo;
table.ApplyLogOnInfo(newLogonInfo);
}
&Eacute;tapes suivantes
Une fois les informations de connexion &agrave; la base de donn&eacute;es d&eacute;finies pour l'instance ReportDocument, mettez &agrave;
jour la propri&eacute;t&eacute; ReportSource de l'objet CrystalReportViewer.
156
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.4.1.4
Connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e avec le contr&ocirc;le CrystalReportViewer
Contexte
Lorsque vous utilisez le mod&egrave;le d'objet CrystalReportViewer pour vous connecter &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e, vous devez utiliser les classes de l'espace de noms CrystalDecisions.Shared.
Les propri&eacute;t&eacute;s de la classe ConnectionInfo permettent la connexion au serveur de base de donn&eacute;es ou aux
sources de donn&eacute;es ODBC.
Proc&eacute;dure
1.
Cr&eacute;ez un objet ConnectionInfo.
2.
D&eacute;finissez les propri&eacute;t&eacute;s DatabaseName, UserID et Password de l'objet ConnectionInfo sur les valeurs
requises pour la connexion.
Remarque
Si vous d&eacute;finissez uniquement les propri&eacute;t&eacute;s DatabaseName, UserID et Password, vous &ecirc;tes connect&eacute; au
serveur par d&eacute;faut de la base de donn&eacute;es sp&eacute;cifi&eacute;e dans le rapport. Toutefois, si vous affectez une autre
propri&eacute;t&eacute; ServerName, vous pouvez rediriger le rapport vers un serveur diff&eacute;rent au moment de
l'ex&eacute;cution.
3.
Extrayez l'instance TableLogOnInfosde la propri&eacute;t&eacute; LogOnInfo de la classe CrystalReportViewer.
Remarque
TableLogOnInfos est une classe index&eacute;e contenant des instances de la classe TableLogOnInfo.
4.
Pour chaque objet TableLogOnInfo de la collection, d&eacute;finissez la ConnectionInfo propri&eacute;t&eacute;
d'TableLogOnInfoobjet sur l'ConnectionInfo objet.
Exemple
Private
String,
Dim
Dim
For
Sub setDatabaseLogon(ByVal databaseName As String, ByVal userName As
ByVal password As String)
myCconnectionInfo As New ConnectionInfo()
logOnInfos As TableLogOnInfos = crystalReportViewer.LogOnInfo
Each logOnInfo As TableLogOnInfo In logOnInfos
logOnInfo.ConnectionInfo = myCconnectionInfo
Next
myCconnectionInfo.DatabaseName = databaseName
myCconnectionInfo.UserID = userName
myCconnectionInfo.Password = password
End Sub
private void setDatabaseLogon(String databaseName, String userName, String
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
157
password){
ConnectionInfo connectionInfo = new ConnectionInfo();
TableLogOnInfos logOnInfos = crystalReportViewer.LogOnInfo;
foreach(TableLogOnInfo logOnInfo in logOnInfos) {
logOnInfo.ConnectionInfo = connectionInfo;
}
connectionInfo.DatabaseName = databaseName;
connectionInfo.UserID = userName;
connectionInfo.Password = password;
}
1.4.4.2
Connexion aux IDataReader
De nombreux projets .NET utilisent les DataReader, plut&ocirc;t que les DataSets, pour extraire des donn&eacute;es. Par
exemple, le moyen le plus courant de lier un contr&ocirc;le (tel que le contr&ocirc;le GridView) aux donn&eacute;es consiste &agrave; cr&eacute;er
une m&eacute;thode qui extrait les donn&eacute;es par le biais d'un DataReader, puis de renvoyer ces donn&eacute;es &agrave; partir de la
m&eacute;thode via une interface IDataReader.
Le concepteur de rapports SAP Crystal incorpor&eacute; peut acc&eacute;der &agrave; l'interface IDataReader si certaines conditions
sont remplies :
●
Les donn&eacute;es doivent &ecirc;tre renvoy&eacute;es &agrave; partir d'une m&eacute;thode, par le biais de l'interface IDataReader.
●
Le fournisseur de donn&eacute;es utilis&eacute; dans la m&eacute;thode doit &ecirc;tre le fournisseur de donn&eacute;es OleDb .NET.
Remarque
Les classes de ce fournisseur de donn&eacute;es se trouvent dans l'espace de noms System.Data.OleDb.
●
La m&eacute;thode doit &ecirc;tre partag&eacute;e [Visual Basic] ou statique [C#].
●
La classe contenant cette m&eacute;thode doit faire partie d'un projet de biblioth&egrave;que de classes et &ecirc;tre compil&eacute;e
dans un assembly.
Pour cr&eacute;er un rapport Crystal utilisant une instance d'IDataReader comme source de donn&eacute;es, vous devez cr&eacute;er
une biblioth&egrave;que de classes &agrave; l'aide d'une m&eacute;thode statique qui renvoie un objet IDataReader. Apr&egrave;s avoir
compil&eacute; cette biblioth&egrave;que de classes, l'assemblage qui en r&eacute;sulte fait office de source de donn&eacute;es pour votre
rapport.
Remarque
Vous ne serez pas en mesure de d&eacute;finir la source de donn&eacute;es de votre rapport sur IDataReader tant que vous
n'aurez pas cr&eacute;&eacute; et compil&eacute; la biblioth&egrave;que de classes.
Informations associ&eacute;es
Tutoriel : Connexion aux IDataReader [page 563]
Dans ce tutoriel sur la connectivit&eacute; des donn&eacute;es, vous allez apprendre &agrave; vous connecter &agrave; une instance
d'IDataReader.
158
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.4.3
Connexion aux DataSets ADO.NET
Un objet DataSet ADO.NET est une collection de classes de DataSets cr&eacute;&eacute;es en m&eacute;moire. Vous pouvez cr&eacute;er un
DataSet ADO.NET &agrave; partir de diverses sources de donn&eacute;es (y compris &agrave; partir de bases de donn&eacute;es Access,
Oracle et SQL Server) &agrave; l'aide du concepteur de DataSets ADO.NET de Visual Studio. Le concepteur de DataSets
ADO.NET affiche une vue graphique de la base de donn&eacute;es avec ses tables, ses champs et les types
correspondants. Vous pouvez faire glisser des tables de l'Explorateur de serveurs vers un fichier de sch&eacute;ma dans
l'onglet Sch&eacute;ma du concepteur.
Pour cr&eacute;er un rapport Crystal utilisant un ensemble de donn&eacute;es ADO.Net comme source de donn&eacute;es, vous devez
cr&eacute;er une biblioth&egrave;que de classes &agrave; l'aide d'une m&eacute;thode statique ou d'une propri&eacute;t&eacute; qui renvoie un objet
DataSet. Apr&egrave;s avoir compil&eacute; cette biblioth&egrave;que de classes, l'assemblage qui en r&eacute;sulte fait office de source de
donn&eacute;es pour votre rapport.
Remarque
Vous ne pourrez pas d&eacute;finir la source de donn&eacute;es de votre rapport sur le DataSet tant que vous n'aurez pas
cr&eacute;&eacute; et compil&eacute; la biblioth&egrave;que de classes.
Dans quels cas utiliser un DataSet
Les DataSets sont utiles lorsque :
●
Les donn&eacute;es du DataSet doivent &ecirc;tre modifi&eacute;es apr&egrave;s l'ex&eacute;cution de la requ&ecirc;te.
●
Les donn&eacute;es de plusieurs sources de donn&eacute;es doivent &ecirc;tre mises en relation.
Remarque
Les DataSets sont une repr&eacute;sentation XML des donn&eacute;es qui proviennent g&eacute;n&eacute;ralement d'une base de
donn&eacute;es. Un DataSet correspond non pas &agrave; une seule table mais &agrave; un groupe de tables dans une base de
donn&eacute;es. Cela peut pr&eacute;senter un probl&egrave;me d'&eacute;volutivit&eacute; au niveau des rapports. Si un rapport extrait
plusieurs tables dans un DataSet et qu'une jointure est requise entre ces tables, c'est au rapport
d'effectuer la jointure lorsqu'il interagit s&eacute;par&eacute;ment avec chaque table. Ce processus n'est pas efficace. Il
est toujours plus judicieux de placer les instructions de jointure dans la requ&ecirc;te que vous utilisez pour
remplir le DataSet. Cela g&eacute;n&egrave;re une &quot;pseudo-table&quot; unique de donn&eacute;es pr&eacute;-jointes dans votre DataSet, qui
&quot;lib&egrave;re&quot; ainsi le rapport et lui permet de se consacrer &agrave; l'affichage des donn&eacute;es.
Informations associ&eacute;es
Eviter d'utiliser des DataSets pour des requ&ecirc;tes simples [page 68]
En cas d'utilisation des DataSets, les mettre en m&eacute;moire cache [page 69]
Tutoriel : Connexion aux DataSets ADO.NET [page 549]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
159
1.4.4.4
Connexion aux ensembles d'objets
SAP Crystal Reports 2008 a la capacit&eacute; de cr&eacute;er des rapports &agrave; partir de donn&eacute;es d'objet. Les donn&eacute;es d'objet
peuvent &ecirc;tre simples, telles que des donn&eacute;es de cha&icirc;ne ou d'entier. ou peuvent &ecirc;tre complexes, telles qu'une
classe ou une collection. Les collections doivent &ecirc;tre un simple tableau ou un objet IEnumerable. SAP Crystal
Reports peut acc&eacute;der &agrave; ces collections d'objets comme &agrave; une source de donn&eacute;es normale, fournissant une source
de donn&eacute;es polyvalente pour vos rapports Crystal.
Une collection d'objets permet d'&eacute;crire une classe personnalis&eacute;e qui remplit un objet avec des donn&eacute;es par
programmation ou de fa&ccedil;on dynamique. Vous pouvez &eacute;galement r&eacute;diger vos propres objets d'acc&egrave;s aux donn&eacute;es
en augmentant le nombre de sources de donn&eacute;es fournies avec une installation par d&eacute;faut SAP Crystal Reports,
version d&eacute;veloppeur pour Microsoft Visual Studio.
Pour utiliser une collection d'objets comme source de donn&eacute;es, vous devez cr&eacute;er une classe qui fournit au moins
une propri&eacute;t&eacute; publique. Si la propri&eacute;t&eacute; renvoie des donn&eacute;es simples, telles que des valeurs de cha&icirc;ne ou d'entier,
SAP Crystal Reports traite ces donn&eacute;es en tant que champ d'une base de donn&eacute;es. Si la propri&eacute;t&eacute; renvoie des
donn&eacute;es complexes, telles qu'un objet ArrayList, chaque objet de la collection d'objets fournit une ligne de d&eacute;tails
dans le rapport.
Acc&egrave;s aux donn&eacute;es au sein des objets
Les versions ant&eacute;rieures de SAP Crystal Reports permettent d'acc&eacute;der &agrave; des propri&eacute;t&eacute;s qui renvoient uniquement
des types de donn&eacute;es simples. Par exemple, si un objet contient une propri&eacute;t&eacute; qui renvoie une cha&icirc;ne, cette
cha&icirc;ne est fournie en tant que champ normal au moment de la conception. Mais si l'objet contient une propri&eacute;t&eacute;
qui renvoie un objet, les donn&eacute;es au sein de l'objet renvoy&eacute; ne sont pas fournies, m&ecirc;me s'il contient des donn&eacute;es
simples.
SAP Crystal Reports 2008 et les versions ult&eacute;rieures permettent d'acc&eacute;der aux donn&eacute;es contenues dans des
types de donn&eacute;es complexes gr&acirc;ce &agrave; une expansion des types complexes. Au moment de la conception, l'objet
renvoy&eacute; appara&icirc;t en tant que source de donn&eacute;es hi&eacute;rarchique. Les donn&eacute;es complexes peuvent &ecirc;tre &eacute;tendues
pour r&eacute;v&eacute;ler tout type de donn&eacute;es simples qu'elles fournissent et qui peuvent ensuite &ecirc;tre ajout&eacute;es au rapport.
Pour activer l'expansion des types complexes, ajoutez l'attribut CrystalComplexTypeExpansionLevels &agrave; la
propri&eacute;t&eacute; qui renvoie l'objet que vous souhaitez &eacute;tendre. Vous devez d&eacute;finir l'attribut
CrystalComplexTypeExpansionLevels sur une valeur sup&eacute;rieure &agrave; 1 pour explorer en avant les donn&eacute;es de
classe. Si vous ne d&eacute;finissez pas l'attribut CrystalComplexTypeExpansionLevels, SAP Crystal Reports ne
pourra pas acc&eacute;der aux donn&eacute;es de champ au sein de la classe.
Exemple
Exposition de donn&eacute;es simples
Cet exemple comporte deux objets : Employee et Person. Lorsque l'objet Employee est ajout&eacute; au rapport
comme source de donn&eacute;es, la propri&eacute;t&eacute; Employee.EmployeeID est fournie en tant que champ valide ;
toutefois, la propri&eacute;t&eacute; Employee.Person n'est pas visible, car elle renvoie un type de donn&eacute;es complexes.
Class Employee
Private _employeeID As Integer
Private _person As New Person()
160
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Public Property EmployeeID() As Integer
Get
Return _employeeID
End Get
Set(ByVal value As Integer)
_employeeID = value
End Set
End Property
Public ReadOnly Property Person() As Person
Get
Return _person
End Get
End Property
End Class
Class Person
Private _name As String
Public Property Name() As String
Get
Return _name
End Get
Set(ByVal value As String)
_name = value
End Set
End Property
End Class
class Employee
{
int _employeeID;
Person _person = new Person();
public int EmployeeID
{
get { return _employeeID; }
set { _employeeID = value; }
}
}
public Person Person
{
get { return _person; }
}
class Person
{
private String _name;
}
public String Name
{
get { return _name; }
set { _name = value; }
}
Exemple
Autorisation d'expansion de types complexes
Dans l'exemple pr&eacute;c&eacute;dent, la propri&eacute;t&eacute; Employee.Person n'est pas visible, car elle renvoie un type de
donn&eacute;es complexes.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
161
Dans cet exemple, l'attribut CrystalComplexTypeExpansionLevels a &eacute;t&eacute; ajout&eacute; &agrave; la propri&eacute;t&eacute;
Employee.Person, ce qui permet au concepteur du rapport d'afficher un nouveau champ dans l'Explorateur
de champs : Person-Name.
Class Employee
Private _employeeID As Integer
Private _person As New Person()
Public Property EmployeeID() As Integer
Get
Return _employeeID
End Get
Set(ByVal value As Integer)
_employeeID = value
End Set
End Property
_
&lt;CrystalDecisions.CrystalReports.Engine.CrystalComplexTypeExpansionLevels(1)&gt;
Public ReadOnly Property Person() As Person
Get
Return _person
End Get
End Property
End Class
Class Person
Private _name As String
Public Property Name() As String
Get
Return _name
End Get
Set(ByVal value As String)
_name = value
End Set
End Property
End Class
class Employee
{
int _employeeID;
Person _person = new Person();
public int EmployeeID
{
get { return _employeeID; }
set { _employeeID = value; }
}
}
[CrystalDecisions.CrystalReports.Engine.CrystalComplexTypeExpansionLevels(1)]
public Person Person
{
get { return _person; }
}
class Person
{
private String _name;
public String Name
{
get { return _name; }
162
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
}
}
set { _name = value; }
Informations associ&eacute;es
Tutoriels : Connexion aux collections d'objets [page 574]
Dans ce tutoriel sur la connectivit&eacute; des donn&eacute;es, vous allez apprendre &agrave; utiliser une collection d'objets comme
source de donn&eacute;es d'un rapport Crystal.
1.4.4.5 Activation de la mise en cache des rapports dans un
site Web SAP Crystal Reports
Pr&eacute;requis
Ces &eacute;tapes font appel aux t&acirc;ches guid&eacute;es. Cette fonctionnalit&eacute; est disponible dans Visual Studio 2005 et versions
ult&eacute;rieures.
Contexte
Les projets Windows qui utilisent Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio font appel &agrave;
la m&ecirc;me structure de mise en cache que celle utilis&eacute;e dans Visual Studio .NET 2003. A savoir, lorsqu'un rapport
est ajout&eacute; &agrave; un projet, deux classes de rapport wrapper sont g&eacute;n&eacute;r&eacute;es : une classe de rapport standard et une
classe de rapport mis en cache.
Si aucune classe wrapper de rapport n'est g&eacute;n&eacute;r&eacute; pour un rapport, la mise en cache est contr&ocirc;l&eacute;e via la propri&eacute;t&eacute;
EnableCaching du contr&ocirc;le CrystalReportSource.
Proc&eacute;dure
1.
Cr&eacute;er un site Web Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
2.
Dans la page Default.aspx, s&eacute;lectionnez le mode Source.
3.
Localisez la balise XML du contr&ocirc;le CrystalReportSource.
4.
Modifiez la valeur de la propri&eacute;t&eacute; EnableCaching en la faisant passer de False &agrave; True.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
163
Remarque
Pour en savoir plus sur la mise en cache des rapports, sur la version mise en cache de la classe de rapport
wrapper et sur l'opportunit&eacute; de faire ou non appel &agrave; la mise en cache, voir Cache et persistance du mod&egrave;le
d'objet ReportDocument [page 59].
Exemple
&lt;CR:CrystalReportSource ID=&quot;myCrystalReportSource&quot; runat=&quot;server&quot;
EnableCaching=&quot;True&quot;&gt;
&lt;Report FileName=&quot;CrystalReport1.rpt&quot;&gt;
&lt;/Report&gt;
&lt;/CR:CrystalReportSource&gt;
1.4.4.6
Utilisation de LINQ
LINQ (Language Integrated Query) est un composant Microsoft Framework permettant d'effectuer des requ&ecirc;tes
sur tout type de source de donn&eacute;es.
SAP Crystal Reports peut cr&eacute;er des rapports sur une collection d'objets personnalis&eacute;s. Cela permet de mieux
contr&ocirc;ler l'affichage des informations dans un rapport. Toutefois, la constitution d'une collection d'objets peut se
r&eacute;v&eacute;ler compliqu&eacute;e si cette collection contient des donn&eacute;es d'agr&eacute;gat issues de plusieurs sources de donn&eacute;es.
L'utilisation de LINQ simplifie le processus de reporting sur une collection d'objets et permet d'ex&eacute;cuter des
requ&ecirc;tes de type SQL sur des objets personnalis&eacute;s. Par exemple, supposons que vous ayez une base de donn&eacute;es
SQL, un fichier XML et un fichier Microsoft Access contenant des donn&eacute;es commerciales. LINQ permet
d'effectuer une requ&ecirc;te &agrave; partir des trois sources de donn&eacute;es et d'afficher les donn&eacute;es dans un rapport unique.
LINQ permet d'effectuer les op&eacute;rations suivantes :
●
Constituer une collection d'objets &agrave; partir de plusieurs sources de donn&eacute;es.
●
Lier deux collections d'objets.
●
Regrouper des &eacute;l&eacute;ments au sein d'une collection.
Vous devez installer les logiciels suivants pour utiliser LINQ avec SAP Crystal Reports :
●
Visual Studio 2008 ou une version plus r&eacute;cente
●
Microsoft .NET Framework version 3.5
●
SAP Crystal Reports Basic pour Visual Studio 2008 ou une version plus r&eacute;cente
Informations associ&eacute;es
D&eacute;finition de la source de donn&eacute;es [page 151]
164
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.5
Visualisation d'un rapport
Le contr&ocirc;le CrystalReportViewer permet de visualiser des rapports Crystal. Il existe deux contr&ocirc;les
CrystalReportViewer dans le SDK SAP Crystal Reports .NET. Pour un site Web, utilisez la classe
CrystalDecisions.Web.CrystalReportViewer. Pour une application Windows, utilisez la classe
CrystalDecisions.Windows.Forms.CrystalReportViewer.
Pour visualiser un rapport, vous devez d'abord ajouter un contr&ocirc;le CrystalReportViewer &agrave; votre application, puis
affecter la propri&eacute;t&eacute; ReportSource de ce contr&ocirc;le &agrave; un rapport. Le processus d'affectation d'un rapport &agrave; un
contr&ocirc;le CrystalReportViewer est appel&eacute; liaison de rapports.
Il existe diff&eacute;rentes mani&egrave;res de lier un contr&ocirc;le CrystalReportViewer &agrave; un rapport. Cette section d&eacute;taille chaque
sc&eacute;nario de liaison de rapports, ainsi que les consid&eacute;rations g&eacute;n&eacute;rales concernant la visualisation de rapport.
Classes utilis&eacute;es pour la visualisation de rapports
●
CrystalDecisions.Windows.Forms.CrystalReportViewer
Fournit des propri&eacute;t&eacute;s, des m&eacute;thodes et des &eacute;v&eacute;nements permettant de modifier ou d'extraire les
informations sur la mani&egrave;re dont fonctionne et s'affiche le contr&ocirc;le CrystalReportViewer.
●
CrystalDecisions.Web.CrystalReportViewer
Fournit des propri&eacute;t&eacute;s, des m&eacute;thodes et des &eacute;v&eacute;nements permettant de modifier ou d'extraire les
informations sur la mani&egrave;re dont fonctionne et s'affiche le contr&ocirc;le CrystalReportViewer.
●
CrystalDecisions.CrystalReports.Engine.ReportDocument
Repr&eacute;sente un rapport et contient les propri&eacute;t&eacute;s et les m&eacute;thodes permettant de d&eacute;finir, mettre en forme,
charger, exporter et imprimer ce rapport.
Informations associ&eacute;es
Comment utiliser les contr&ocirc;les visualiseur de rapports ? [page 43]
Contr&ocirc;le CrystalReportViewer [page 43]
Sc&eacute;narios de liaison de rapports [page 170]
1.4.5.1
Comparaison des rapports incorpor&eacute;s et non
incorpor&eacute;s
Diff&eacute;rence entre un rapport incorpor&eacute; et un rapport non incorpor&eacute;
Un rapport incorpor&eacute; est un rapport qui a &eacute;t&eacute; import&eacute; ou cr&eacute;&eacute; dans un projet Visual Studio. Lorsqu'un rapport est
incorpor&eacute; dans un projet, une classe wrapper est automatiquement g&eacute;n&eacute;r&eacute;e pour ce rapport. Cela permet
d'acc&eacute;der au rapport par son nom, plut&ocirc;t que par le biais d'une instance ReportDocument distincte.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
165
Un rapport non incorpor&eacute; est un rapport externe au projet Visual Studio. Il existe de nombreuses mani&egrave;res
d'acc&eacute;der au rapport et de le charger dans un mod&egrave;le d'objet (afin de pouvoir interagir avec lui par
programmation), mais ce rapport restera toujours externe au projet.
Fonctionnement d'un rapport incorpor&eacute;
Lorsqu'un rapport est import&eacute; ou cr&eacute;&eacute; dans un projet, une classe wrapper (du m&ecirc;me nom que le rapport) est
g&eacute;n&eacute;r&eacute;e. Cette classe wrapper inclut ou repr&eacute;sente le rapport dans le projet. Une fois cette op&eacute;ration termin&eacute;e,
tout le code du projet interagit avec la classe cr&eacute;&eacute;e pour repr&eacute;senter le rapport plut&ocirc;t qu'avec le rapport luim&ecirc;me.
Lorsque le projet est compil&eacute;, le rapport et sa classe wrapper sont incorpor&eacute;s dans l'assembly, comme pour
n'importe quelle autre ressource du projet.
Remarque
Avec .Net Framework, la taille des fichiers DLL est limit&eacute;e. Cela signifie que la compilation du projet peut
&eacute;chouer s'il contient des rapports incorpor&eacute;s volumineux. Pour les projets utilisant des rapports volumineux,
d&eacute;sactivez les donn&eacute;es enregistr&eacute;es dans le rapport ou modifiez votre projet de sorte &agrave; utiliser des rapports
non incorpor&eacute;s. La taille limite varie selon les versions de .Net Framework. Pour en savoir plus, reportez-vous &agrave;
la documentation de .Net Framework.
La classe wrapper d'un rapport s'&eacute;tend &agrave; partir de la classe de base commune ReportDocument. Elle h&eacute;rite de
toutes les propri&eacute;t&eacute;s et m&eacute;thodes de ReportDocument.
La classe ReportDocument est la classe racine du mod&egrave;le d'objet ReportDocument.
Fonctionnement d'un rapport non incorpor&eacute;
L'acc&egrave;s &agrave; un rapport non incorpor&eacute; se fait toujours depuis l'ext&eacute;rieur et le SDK peut y acc&eacute;der de diverses
mani&egrave;res :
●
Le rapport peut &ecirc;tre situ&eacute; sur le disque dur avec un chemin d'acc&egrave;s au r&eacute;pertoire de fichiers.
●
Le rapport peut &ecirc;tre expos&eacute; en tant que service Web de rapports.
●
Le rapport peut faire partie d'un groupe de rapports expos&eacute;s via les services Crystal.
Les rapports non incorpor&eacute;s ne sont jamais import&eacute;s dans un projet, et par cons&eacute;quent, aucune classe wrapper
n'est cr&eacute;&eacute;e (contrairement aux rapports incorpor&eacute;s). A la place, le rapport non incorpor&eacute; est charg&eacute; dans un des
mod&egrave;les d'objet au moment de l'ex&eacute;cution, de l'une des mani&egrave;res suivantes :
●
Le rapport est charg&eacute; par et dans le mod&egrave;le d'objet ReportDocument &agrave; l'aide de la m&eacute;thode
ReportDocument.Load().
●
Le mod&egrave;le d'objet CrystalReportViewer utilise la propri&eacute;t&eacute; CrystalReportViewer.ReportSource pour lier
directement le rapport au contr&ocirc;le.
166
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Comment choisir entre un rapport incorpor&eacute; ou non incorpor&eacute;
Si vous souhaitez simplifier le d&eacute;ploiement de votre projet, utilisez des rapports incorpor&eacute;s. Vous aurez moins de
fichiers &agrave; g&eacute;rer et aucun risque de placement incorrect des rapports suite &agrave; un chemin d'acc&egrave;s erron&eacute;. Cette
solution est &eacute;galement plus s&ucirc;re dans la mesure o&ugrave; les rapports ne sont pas expos&eacute;s pour les modifications.
S'ils garantissent simplicit&eacute; et s&eacute;curit&eacute;, les rapports incorpor&eacute;s impliquent une charge de travail plus importante.
Ils ne peuvent pas &ecirc;tre modifi&eacute;s sans recompiler le projet dans son int&eacute;gralit&eacute;. Si des rapports doivent &ecirc;tre
modifi&eacute;s r&eacute;guli&egrave;rement, ne les incorporez pas. Leur acc&egrave;s et leur modification seront ainsi facilit&eacute;s et vous n'aurez
pas &agrave; recompiler les assemblys &agrave; chaque fois. En outre, la taille des rapports incorpor&eacute;s est limit&eacute;e. Les rapports
tr&egrave;s volumineux ne peuvent pas &ecirc;tre compil&eacute;s en tant que ressources incorpor&eacute;es.
Les sc&eacute;narios de liaison de rapports vous indiqueront de nombreuses mani&egrave;res de lier des rapports incorpor&eacute;s et
non incorpor&eacute;s. Vous verrez &eacute;galement comment utiliser ReportDocument en tant que classe g&eacute;n&eacute;rique pour l'un
comme pour l'autre type de rapport. Cela permet de limiter au maximum les modifications de code, si vous
d&eacute;cidez de passer d'une solution &agrave; une autre.
Incorporation de rapports dans un projet Web
La prise en charge des rapports incorpor&eacute;s est activ&eacute;e par le biais d'un Build Provider qui compile les rapports
sous la forme d'un fichier DLL. Pour incorporer un rapport dans un fichier DLL lors de la compilation, vous devez
attribuer au param&egrave;tre embedRptInResourc de votre fichier web.config la valeur True. Pour acc&eacute;der &agrave; la classe
du wrapper via Intellisense, vous devez placer le rapport dans le dossier App_Code/Global de votre solution.
Remarque
Si le rapport est situ&eacute; dans le r&eacute;pertoire App_Code/Global et que le param&egrave;tre embedRptInResource est
d&eacute;fini sur False, le fichier du rapport ne sera pas copi&eacute; dans l'emplacement cible au moment de la publication
du site Web. Pour contourner ce probl&egrave;me, copiez votre site Web dans l'emplacement cible.
embedRptInResour
ce
Emplacement du
rapport
Intellisense
disponible
Publier pour
d&eacute;ployer
Copier pour
d&eacute;ployer
True
App_Code/Global
X
X
X
True
En dehors de
X
X
X
X
App_Code/Global,
mais dans le projet
False
App_Code/Global
False
En dehors de
X
X
App_Code/Global,
mais dans le projet
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
167
Informations associ&eacute;es
Configuration du fichier Web.Config [page 20]
1.4.5.2
D&eacute;finition de la source du rapport
Le contr&ocirc;le CrystalReportViewer n'affiche qu'un rapport &agrave; la fois. Pour indiquer au contr&ocirc;le le rapport qu'il doit
afficher, vous devez lier sa propri&eacute;t&eacute; ReportSource &agrave; un rapport particulier. Au moment de l'ex&eacute;cution, le contr&ocirc;le
charge le rapport li&eacute; &agrave; la propri&eacute;t&eacute; ReportSource et l'affiche.
Un contr&ocirc;le CrystalReportViewer peut &ecirc;tre li&eacute; &agrave; un fichier sur un disque, &agrave; un objet ReportDocument ou &agrave; un objet
ReportClientDocument. La liaison &agrave; un objet fournit des fonctionnalit&eacute;s suppl&eacute;mentaires par le biais des mod&egrave;les
d'objet ReportDocument et ReportClientDocument. Il s'agit de la mani&egrave;re la plus simple de d&eacute;finir la propri&eacute;t&eacute;
ReportSource.
Dans sa forme la plus simple, l'affectation se pr&eacute;sente de la mani&egrave;re suivante :
crystalReportViewer1.ReportSource = &quot;C:\WorldSalesReport.rpt&quot;
crystalReportViewer1.ReportSource = &quot;C:\\WorldSalesReport.rpt&quot;;
Dans cet exemple, le rapport est li&eacute; au contr&ocirc;le directement &agrave; partir de son chemin d'acc&egrave;s au r&eacute;pertoire de
fichiers.
Contr&ocirc;le CrystalReportSource
Le contr&ocirc;le CrystalReportSource est un &eacute;l&eacute;ment du mod&egrave;le de d&eacute;veloppement d'applications avec balises fourni
avec ASP.NET version 2.0.
Remarque
Le contr&ocirc;le CrystalReportSource n'est disponible que pour les sites Web.
Dans la structure de contr&ocirc;le DataSource, les contr&ocirc;les .NET visuels se connectent aux contr&ocirc;les DataSource non
visuels (contr&ocirc;les qui ne g&egrave;rent pas les informations d'affichage). Cette nouvelle structure DataSource encapsule
les informations de connectivit&eacute; des donn&eacute;es &eacute;crites sous forme de lignes de code dans les contr&ocirc;les .NET ins&eacute;r&eacute;s
dans le Web Form.
168
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.5.2.1
Liaison du contr&ocirc;le CrystalReportViewer &agrave; un
fichier sur disque
Contexte
La mani&egrave;re la plus simple de lier un contr&ocirc;le CrystalReportViewer &agrave; un rapport Crystal est de d&eacute;finir la propri&eacute;t&eacute;
ReportSource sur un emplacement du disque. Ce rapport non incorpor&eacute; est affich&eacute; lors de l'ex&eacute;cution de
l'application.
Cette op&eacute;ration lie le rapport directement au contr&ocirc;le. Toutes les interactions par programmation avec le rapport
doivent &ecirc;tre effectu&eacute;es dans le mod&egrave;le d'objet limit&eacute; CrystalReportViewer.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; l'application Windows ou au site Web.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
D&eacute;finissez la propri&eacute;t&eacute; ReportSource sur l'emplacement du rapport sur votre syst&egrave;me de fichiers local.
○
Lors de l'utilisation d'une application Windows Form ou d'un site Web :
myCrystalReportViewer.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\MyReport.rpt&quot;;
○
Lors de l'utilisation d'une application WPF :
myCrystalReportViewer.ViewerCore.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ViewerCore.ReportSource = &quot;C:\\MyReport.rpt&quot;;
1.4.5.2.2
Liaison du contr&ocirc;le CrystalReportViewer &agrave; un objet
ReportDocument
Contexte
Ce sc&eacute;nario de liaison de rapports permet d'utiliser ReportDocument, le mod&egrave;le d'objet le plus puissant, avec des
rapports non incorpor&eacute;s (externes &agrave; votre projet).
Au lieu de lier directement les chemins d'acc&egrave;s des r&eacute;pertoires au visualiseur, vous les transmettez &agrave; la m&eacute;thode
ReportDocument.Load(). Vous liez ensuite le contr&ocirc;le CrystalReportViewer &agrave; l'objet ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
169
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; l'application Windows ou au site Web.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Instanciez un nouvel objet ReportDocument et chargez un rapport depuis le disque &agrave; l'aide de la m&eacute;thode
ReportDocument.Load.
Dim rd As ReportDocument = New ReportDocument()
rd.Load(reportPath)
ReportDocument rd = new ReportDocument();
rd.Load(reportPath);
5.
D&eacute;finissez la propri&eacute;t&eacute; ReportSource sur l'objet ReportDocument.
○
Lors de l'utilisation d'une application Windows Form ou d'un site Web :
myCrystalReportViewer.ReportSource = rd
crystalReportViewer.ReportSource = rd;
○
Lors de l'utilisation d'une application WPF :
myCrystalReportViewer.ViewerCore.ReportSource = rd
crystalReportViewer.ViewerCore.ReportSource = rd;
1.4.5.3
Sc&eacute;narios de liaison de rapports
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, propose plusieurs m&eacute;thodes pour
associer un contr&ocirc;le CrystalReportViewer &agrave; un rapport. Afin de vous aider &agrave; choisir le sc&eacute;nario de liaison de
rapports le mieux adapt&eacute; &agrave; votre application, cette section r&eacute;capitule les avantages et les inconv&eacute;nients des
sc&eacute;narios recommand&eacute;s et explique pourquoi certains sont plus utilis&eacute;s que d'autres.
Remarque
La plupart des sites Web ou des projets Windows peuvent reposer sur les deux sc&eacute;narios de liaison les plus
simples : la liaison &agrave; un rapport incorpor&eacute; ou non incorpor&eacute;.
Apr&egrave;s avoir lu cette section, vous pouvez consulter la liste d&eacute;taill&eacute;e de tous les sc&eacute;narios afin d'examiner en d&eacute;tail
toutes les options disponibles dans le SDK.
170
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Sc&eacute;narios de liaison recommand&eacute;s pour SAP Crystal Reports
Les sc&eacute;narios qui lient les rapports &agrave; l'aide du mod&egrave;le d'objet ReportDocument sont g&eacute;n&eacute;ralement plus utilis&eacute;s
que ceux qui font appel au mod&egrave;le d'objet CrystalReportViewer. Cela tient au fait que le mod&egrave;le d'objet
ReportDocument fournit une interface API plus compl&egrave;te pour programmer l'interaction avec le rapport.
La plupart des utilisateurs pr&eacute;f&egrave;rent le sc&eacute;nario Liaison &agrave; une classe de rapport incorpor&eacute; [page 200]. S'il n'est pas
le plus &agrave; m&ecirc;me d'optimiser les performances, ce sc&eacute;nario est le plus simple d'utilisation : vous ajoutez un rapport
au projet pour cr&eacute;er une classe wrapper de rapport, vous instanciez cette classe wrapper, puis vous la
transmettez au contr&ocirc;le CrystalReportViewer. Etant donn&eacute; que la classe wrapper du rapport h&eacute;rite des
caract&eacute;ristiques de la classe de base ReportDocument, vous avez acc&egrave;s &agrave; toutes les fonctionnalit&eacute;s du mod&egrave;le
d'objet ReportDocument.
Une autre m&eacute;thode courante de liaison des rapports est d&eacute;crite dans Liaison &agrave; un rapport non incorpor&eacute; charg&eacute;
dans la classe ReportDocument [page 202]. Ce sc&eacute;nario offre &eacute;galement un acc&egrave;s &agrave; toutes les fonctionnalit&eacute;s du
mod&egrave;le d'objet ReportDocument avec en plus l'avantage des rapports non incorpor&eacute;s qui peuvent &ecirc;tre modifi&eacute;s
sans avoir &agrave; recompiler l'application dans son int&eacute;gralit&eacute;.
Sc&eacute;narios de liaison recommand&eacute;s pour le Report Application Server
Avec le serveur RAS et selon la mani&egrave;re dont vous configurez votre projet, vous pouvez utiliser des sc&eacute;narios
suppl&eacute;mentaires de liaison de rapports.
●
Si vous utilisez SAP Crystal Reports 10 avec le RAS 10, vous pouvez transf&eacute;rer des projets cr&eacute;&eacute;s &agrave; l'origine
dans SAP Crystal Reports (en utilisant des rapports incorpor&eacute;s) vers le serveur RAS et le mod&egrave;le d'objet
ReportClientDocument, en ajoutant uniquement deux lignes de code par rapport.
●
Pour optimiser le sc&eacute;nario ci-dessus, faites des copies de vos rapports incorpor&eacute;s sur le serveur RAS et
dirigez ce dernier de mani&egrave;re &agrave; ce qu'il utilise ces copies.
Sc&eacute;narios de liaison recommand&eacute;s pour SAP Crystal Reports Server ou la
plateforme SAP BusinessObjects Business Intelligence
Si vous avez proc&eacute;d&eacute; &agrave; une mise &agrave; niveau vers SAP Crystal Reports Server ou la plateforme SAP BusinessObjects
Business Intelligence, vous avez le choix entre quatre sc&eacute;narios de liaison de rapports recommand&eacute;s. Votre choix
d&eacute;pendra de vos attentes en mati&egrave;re de modification des rapports et d'&eacute;volutivit&eacute; :
●
Vous pouvez afficher un rapport qui ne n&eacute;cessite aucun modification par programmation avec une vitesse et
des performances optimales.
●
Vous pouvez modifier l'affichage de votre rapport par programmation en acc&eacute;dant au mod&egrave;le d'objet
ReportClientDocument.
●
Si vous utilisez SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio avec
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence, vous pouvez
transf&eacute;rer des projets initialement cr&eacute;&eacute;s dans SAP Crystal Reports (en utilisant des rapports incorpor&eacute;s) vers
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence, tout en conservant
le code de rapport existant, en publiant des copies des rapports incorpor&eacute;s dans SAP Crystal Reports Server
ou dans la plateforme SAP BusinessObjects Business Intelligence.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
171
●
Vous pouvez acc&eacute;der &agrave; votre rapport en tant qu'instance d'InfoObject dans la structure de plateforme, ce
qui vous permet de planifier ce rapport et d'en modifier les param&egrave;tres.
Informations associ&eacute;es
Contr&ocirc;les du visualiseur de rapports [page 35]
1.4.5.3.1
Liaison de rapports &agrave; l'aide du mod&egrave;le d'objet
CrystalReportViewer
Le mod&egrave;le d'objet CrystalReportViewer est le mod&egrave;le d'objet le plus simple. Etant donn&eacute; la port&eacute;e limit&eacute;e de ses
fonctionnalit&eacute;s, son utilisation est g&eacute;n&eacute;ralement d&eacute;conseill&eacute;e au profit du mod&egrave;le d'objet plus complet
ReportDocument.
Informations associ&eacute;es
Mod&egrave;le d'objet CrystalReportViewer [page 37]
Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de fichiers par code [page 172]
1.4.5.3.1.1
Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de
fichiers par code
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports se trouvent dans un r&eacute;pertoire de fichiers.
Description
Il s'agit du sc&eacute;nario de liaison de rapports le plus simple : vous liez un rapport situ&eacute; dans le r&eacute;pertoire de fichiers
au contr&ocirc;le CrystalReportViewer par le biais de son chemin d'acc&egrave;s.
172
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Avantages
●
Peu de maintenance : les rapports sont ajout&eacute;s, supprim&eacute;s ou modifi&eacute;s sans avoir &agrave; recompiler l'application.
●
Impl&eacute;mentation simplifi&eacute;e : il est inutile de d&eacute;clarer et d'instancier les classes. Ce sc&eacute;nario contourne
l'utilisation du mod&egrave;le d'objet ReportDocument en transf&eacute;rant directement un rapport au contr&ocirc;le
CrystalReportViewer.
Inconv&eacute;nients
●
Distribution limit&eacute;e : les rapports restent g&eacute;n&eacute;ralement stock&eacute;s sur le m&ecirc;me ordinateur que l'application, en
raison des complications g&eacute;n&eacute;r&eacute;es par l'octroi au compte utilisateur ASPNET de droits d'acc&egrave;s &agrave; un autre
ordinateur du r&eacute;seau.
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
Informations associ&eacute;es
Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de fichiers via la fen&ecirc;tre Propri&eacute;t&eacute;s [page 174]
1.4.5.3.1.1.1
Liaison du contr&ocirc;le CrystalReportViewer &agrave; un
fichier sur disque
Contexte
La mani&egrave;re la plus simple de lier un contr&ocirc;le CrystalReportViewer &agrave; un rapport Crystal est de d&eacute;finir la propri&eacute;t&eacute;
ReportSource sur un emplacement du disque. Ce rapport non incorpor&eacute; est affich&eacute; lors de l'ex&eacute;cution de
l'application.
Cette op&eacute;ration lie le rapport directement au contr&ocirc;le. Toutes les interactions par programmation avec le rapport
doivent &ecirc;tre effectu&eacute;es dans le mod&egrave;le d'objet limit&eacute; CrystalReportViewer.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; l'application Windows ou au site Web.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
D&eacute;finissez la propri&eacute;t&eacute; ReportSource sur l'emplacement du rapport sur votre syst&egrave;me de fichiers local.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
173
○
Lors de l'utilisation d'une application Windows Form ou d'un site Web :
myCrystalReportViewer.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\MyReport.rpt&quot;;
○
Lors de l'utilisation d'une application WPF :
myCrystalReportViewer.ViewerCore.ReportSource = &quot;C:\MyReport.rpt&quot;
crystalReportViewer.ViewerCore.ReportSource = &quot;C:\\MyReport.rpt&quot;;
1.4.5.3.1.2
Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de
fichiers via la fen&ecirc;tre Propri&eacute;t&eacute;s
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports se trouvent dans un r&eacute;pertoire de fichiers.
Description
Ce sc&eacute;nario constitue une alternative au sc&eacute;nario de liaison de rapports le plus simple : Liaison au chemin d'acc&egrave;s
d'un r&eacute;pertoire de fichiers par code [page 172]. Vous liez un rapport situ&eacute; dans un r&eacute;pertoire de fichiers au contr&ocirc;le
CrystalReportViewer par le biais de son chemin d'acc&egrave;s, mais d&eacute;finissez cette affectation dans la fen&ecirc;tre
Propri&eacute;t&eacute;s, directement &agrave; l'aide de la propri&eacute;t&eacute; DataBindings&gt;ReportSource ou de la propri&eacute;t&eacute;
ReportSource.
Dans un projet Web, le chemin d'acc&egrave;s au rapport est ins&eacute;r&eacute; directement dans le code HTML de la page ASPX
plut&ocirc;t que dans le code de la classe code-behind.
Avantages
●
174
Aper&ccedil;u au moment de la conception : vous pouvez afficher un aper&ccedil;u du rapport au moment de sa
conception, dans le Web Form ou le Windows Form.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
L'aper&ccedil;u au moment de la conception est une fonctionnalit&eacute; dont les projets Web b&eacute;n&eacute;ficiaient d&eacute;j&agrave;, mais
qui est nouvelle pour les projets Windows.
●
Peu de maintenance : les rapports sont ajout&eacute;s, supprim&eacute;s ou modifi&eacute;s sans avoir &agrave; recompiler l'application.
●
Impl&eacute;mentation simplifi&eacute;e : il est inutile de d&eacute;clarer et d'instancier les classes. Ce sc&eacute;nario contourne
l'utilisation du mod&egrave;le d'objet ReportDocument en transf&eacute;rant directement un rapport au contr&ocirc;le
CrystalReportViewer.
Inconv&eacute;nients
●
Pour les applications Web, &eacute;tant donn&eacute; que la liaison se fait au niveau de la page HTML, vous devez appeler la
m&eacute;thode DataBind() du contr&ocirc;le CrystalReportViewer dans la classe code-behind.
Remarque
Cette restriction a &eacute;t&eacute; supprim&eacute;e dans SAP Crystal Reports pour Visual Studio 2005.
●
Distribution limit&eacute;e : les rapports restent g&eacute;n&eacute;ralement stock&eacute;s sur le m&ecirc;me ordinateur que l'application, en
raison des complications g&eacute;n&eacute;r&eacute;es par l'octroi au compte utilisateur ASPNET de droits d'acc&egrave;s &agrave; un autre
ordinateur du r&eacute;seau.
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
Informations associ&eacute;es
Liaison &agrave; un contr&ocirc;le CrystalReportSource (sites Web dans Visual Studio) [page 176]
1.4.5.3.1.2.1
Pour lier un rapport par l'interm&eacute;diaire du
chemin d'acc&egrave;s &agrave; son r&eacute;pertoire de fichiers &agrave; l'aide de la
fen&ecirc;tre Propri&eacute;t&eacute;s
Proc&eacute;dure
1.
Cr&eacute;ez un projet Web ou Windows.
2.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le CrystalReportViewer dans un Web Form ou un
Windows Form.
3.
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
4.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, affectez &agrave; la propri&eacute;t&eacute; ReportSource le chemin d'acc&egrave;s &agrave; un r&eacute;pertoire de
fichiers.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
175
Remarque
Le chemin d'acc&egrave;s au r&eacute;pertoire de fichiers pointe sur les exemples de rapports de Visual Studio 2005.
En raison de la fonctionnalit&eacute; d'aper&ccedil;u au moment de la conception, le rapport s'affiche en mode Aper&ccedil;u.
C:\Program Files\Microsoft Visual Studio 8.0\Crystal Reports\Samples\fr\Reports
\Feature Examples\Hierarchical Grouping.rpt
5.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.1.3
Liaison &agrave; un contr&ocirc;le CrystalReportSource (sites
Web dans Visual Studio)
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports se trouvent dans un r&eacute;pertoire de fichiers.
Description
Ce sc&eacute;nario constitue une alternative au sc&eacute;nario de liaison de rapports le plus simple : Liaison au chemin d'acc&egrave;s
d'un r&eacute;pertoire de fichiers par code [page 172]. Dans ce sc&eacute;nario, vous liez un rapport &agrave; l'aide du nouveau mod&egrave;le
de d&eacute;veloppement d'applications avec balises et programmation all&eacute;g&eacute;e d'ASP.NET version 2.0.
Remarque
Ce sc&eacute;nario de liaison de rapports n'est disponible que pour les sites Web.
Dans ce sc&eacute;nario, vous utilisez des t&acirc;ches guid&eacute;es pour cr&eacute;er un contr&ocirc;le CrystalReportSource. Vous
s&eacute;lectionnez ensuite un rapport pour le contr&ocirc;le CrystalReportSource.
Au lieu d'&eacute;crire manuellement du code pour interagir avec le rapport et permettre son acc&egrave;s au mod&egrave;le d'objet
CrystalReportViewer, vous effectuez des s&eacute;lections dans le panneau des t&acirc;ches guid&eacute;es (mode Design) ou vous
saisissez directement des d&eacute;clarations XML (mode Source).
Avec les d&eacute;clarations XML, vous pouvez associer les balises &lt;Parameters&gt; et &lt;DataSources&gt;, imbriqu&eacute;es dans la
balise &lt;Report&gt;, &agrave; un ensemble de contr&ocirc;les non visuels accessibles &agrave; partir des structures Parameter et
DataSource.
176
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Les structures Parameter et DataSource sont de nouvelles fonctionnalit&eacute;s d'ASP.NET 2.0. Elles incluent des
contr&ocirc;les tels que ControlParameter ou QueryStringParameter et SqlDataSource ou JetDataSource.
Le mod&egrave;le de d&eacute;veloppement d'applications avec balises est un moyen simple et rapide d'interagir de mani&egrave;re
limit&eacute;e avec le rapport sans avoir &agrave; &eacute;crire du code.
Avantages
●
Aper&ccedil;u au moment de la conception : vous pouvez afficher un aper&ccedil;u du rapport au moment de sa
conception, dans le Web Form ou le Windows Form.
●
Interaction simplifi&eacute;e avec le rapport : le mod&egrave;le de d&eacute;veloppement d'applications avec balises, plus simple et
all&eacute;g&eacute; en programmation, peut &ecirc;tre utilis&eacute; pour interagir avec le rapport.
●
Avantages identiques &agrave; ceux r&eacute;pertori&eacute;s dans le sc&eacute;nario Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de fichiers
par code [page 172].
Inconv&eacute;nients
●
Distribution limit&eacute;e : les rapports restent g&eacute;n&eacute;ralement stock&eacute;s sur le m&ecirc;me ordinateur que l'application, en
raison des complications g&eacute;n&eacute;r&eacute;es par l'octroi au compte utilisateur ASPNET de droits d'acc&egrave;s &agrave; un autre
ordinateur du r&eacute;seau.
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
1.4.5.3.1.3.1
Liaison &agrave; un contr&ocirc;le CrystalReportSource &agrave;
l'aide du mod&egrave;le de programmation all&eacute;g&eacute;e
Proc&eacute;dure
1.
Faites glisser un contr&ocirc;le CrystalReportViewer sur le Web Form.
2.
Dans l'angle sup&eacute;rieur droit du contr&ocirc;le CrystalReportViewer, cliquez sur le petit bouton triangulaire.
Le panneau des t&acirc;ches guid&eacute;es T&acirc;ches CrystalReportViewer s'affiche. Dans la liste S&eacute;lectionner la source du
rapport, la valeur &lt;Aucune&gt; s'affiche.
3.
Cliquez sur la liste S&eacute;lectionner la source du rapport, puis s&eacute;lectionnez &lt;Source du nouveau rapport…&gt;.
La bo&icirc;te de dialogue Cr&eacute;er la source du rapport s'ouvre.
4.
Dans la zone Indiquer le nom du contr&ocirc;le CrystalReportSource, laissez l'entr&eacute;e par d&eacute;faut
CrystalReportSource1.
5.
Cliquez sur la liste Sp&eacute;cifier un rapport pour le contr&ocirc;le CrystalReportSource, puis s&eacute;lectionnez &lt;Parcourir...&gt;.
L'autre s&eacute;lection possible est &lt;Nouveau rapport&gt;. Cette option permet de cr&eacute;er un rapport Crystal.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
177
6.
S&eacute;lectionnez un rapport &agrave; afficher dans le contr&ocirc;le CrystalReportViewer et cliquez sur OK.
7.
Cliquez &agrave; nouveau sur OK pour fermer la bo&icirc;te de dialogue Cr&eacute;er la source du rapport.
Informations associ&eacute;es
Tutoriel : Configuration par programmation all&eacute;g&eacute;e d'un site Web avec SAP Crystal Reports &agrave; l'aide du panneau des
t&acirc;ches guid&eacute;es [page 508]
Dans ce tutoriel, vous allez apprendre &agrave; utiliser le nouveau mod&egrave;le de d&eacute;veloppement d'applications avec
balises dans Visual Studio. Vous allez suivre un mod&egrave;le de d&eacute;veloppement par programmation all&eacute;g&eacute;e pour
configurer un site Web avec SAP Crystal Reports, &agrave; l'aide des t&acirc;ches guid&eacute;es.
1.4.5.3.1.4
Liaison &agrave; l'URL d'un service Web de rapports
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports, situ&eacute;s &agrave; l'emplacement d'un service Web de rapports, sont h&eacute;berg&eacute;s sur un serveur Web (en g&eacute;n&eacute;ral
distant).
Description
Un rapport, stock&eacute; sur un autre serveur et trait&eacute; comme un service Web de rapports, est li&eacute; par le biais de son
URL au contr&ocirc;le CrystalReportViewer.
Avantages
●
Large distribution : les rapports peuvent exister n'importe o&ugrave; sur Internet.
●
Distribution facile : les services Web de rapports se trouvent sur le port 80, ce qui les rend accessibles m&ecirc;me
par le biais de pare-feu.
178
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Inconv&eacute;nients
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
Impl&eacute;mentation
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
●
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), affectez l'URL d'un service Web de rapports &agrave; la propri&eacute;t&eacute; ReportSource de la classe
CrystalReportViewer.
Cette op&eacute;ration lie le rapport directement au contr&ocirc;le. Toutes les interactions par programmation avec le
rapport doivent &ecirc;tre effectu&eacute;es dans le mod&egrave;le d'objet limit&eacute; CrystalReportViewer.
myCrystalReportViewer.ReportSource = _
&quot;http://localhost/TestProject/World_Sales_ReportService.asmx&quot;
crystalReportViewer.ReportSource =
&quot;http://localhost/TestProject/World_Sales_ReportService.asmx&quot;;
Remarque
Pour utiliser ce sc&eacute;nario de liaison, cr&eacute;ez un projet de services Web de rapports dans Visual Studio.
Informations associ&eacute;es
Utilisation de Crystal Reports en tant que service Web [page 81]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
179
1.4.5.3.1.5
Sc&eacute;narios de liaison CrystalReportViewer avec les
services Crystal
Utilisation des services Crystal dans Visual Studio
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio permet d'acc&eacute;der par programmation aux
fichiers serveur via Crystal Services.
Utilisation des services Crystal dans Visual Studio 2003
Dans Visual Studio 2003, vous pouvez acc&eacute;der aux rapports Crystal via le nœud Services Crystal dans
l'Explorateur de serveurs. Une fois SAP Crystal Reports et les services Crystal install&eacute;s, Services Crystal appara&icirc;t
sous la forme d'un sous-nœud sous chaque serveur de l'Explorateur de serveurs.
Le nœud Services Crystal peut &ecirc;tre d&eacute;velopp&eacute; pour afficher des listes de rapports situ&eacute;s &agrave; divers emplacements :
●
R&eacute;pertoire de fichiers local sur votre disque dur
●
Report Application Server (RAS)
●
Crystal Enterprise
Vous pouvez placer n'importe quel rapport r&eacute;pertori&eacute; dans ces listes dans un Web Form ou un Windows Form &agrave;
l'aide d'une op&eacute;ration glisser-d&eacute;placer.
Selon la version de SAP Crystal Reports que vous avez install&eacute;e et les licences suppl&eacute;mentaires que vous avez
&eacute;ventuellement acquises pour le RAS (Report Application Server) ou Crystal Enterprise, les services Crystal
exposent g&eacute;n&eacute;ralement deux nœuds qui peuvent &ecirc;tre d&eacute;velopp&eacute;s. Le tableau situ&eacute; dans la section suivante d&eacute;crit
les conditions requises pour acc&eacute;der &agrave; un nœud particulier.
Il se peut que vous deviez ajuster vos param&egrave;tres de pare-feu afin d'acc&eacute;der au CMS de la plateforme SAP
BusinessObjects Business Intelligence. Le port par d&eacute;faut pour le CMS est 6400. Contactez votre administrateur
syst&egrave;me pour plus d'informations sur l'adresse r&eacute;seau et les param&egrave;tres de port de votre syst&egrave;me de plateforme
SAP BusinessObjects Business Intelligence. Pour plus d'informations sur la personnalisation des ports, voir le
Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
Classes wrapper
Lorsque vous faites glisser un rapport depuis les services Crystal vers un Web Form ou un Windows Form, cela
cr&eacute;e une instance de la classe wrapper qui r&eacute;f&eacute;rence le rapport dans la r&eacute;gion du code de la classe code-behind
g&eacute;n&eacute;r&eacute; par le Concepteur Web Form ou Windows Form.
Remarque
Le type de classe wrapper varie selon les versions de SAP Crystal Reports. Voir le tableau ci-dessous.
180
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Les services Crystal r&eacute;pertori&eacute;s dans le tableau ci-dessous exposent des types de classes wrapper qui ne
contiennent pas de mod&egrave;le d'objet et d&eacute;pendent du mod&egrave;le d'objet limit&eacute; fourni par le contr&ocirc;le
CrystalReportViewer.
La table indique les services Crystal inclus dans SAP Crystal Reports pour Visual Studio 2003. Ces services
exposent des groupes de rapports, soit &agrave; partir du r&eacute;pertoire de fichiers local, soit &agrave; partir du WCS
(Web Component Server) de Crystal Enterprise. Les rapports sont contenus dans deux classes wrapper
diff&eacute;rentes : ServerFileReport pour les rapports situ&eacute;s dans le r&eacute;pertoire de fichiers local, et EnterpriseReport
pour les rapports situ&eacute;s sur le WCS de Crystal Enterprise.
Classe wrapper ex&shy; Nom du nœud sous
pos&eacute;e par le biais
les services Crystal
des services Crystal
Versions de
SAP Crystal Re&shy;
ports
Description
Conditions requises
pour acc&eacute;der au
nœud
ServerFileReport
SAP Crystal Reports
pour Visual Stu&shy;
dio .NET 2003
Expose les rapports
situ&eacute;s dans le r&eacute;per&shy;
toire de fichiers local
par le biais d'un ser&shy;
vice Web commun,
ServerFileReport&shy;
Service. Pour en sa&shy;
voir plus, voir Liaison
aux fichiers serveur
(VS .NET 2003)
[page 181].
Configurez les auto&shy;
risations pour les uti&shy;
lisateurs ASPNET.
(Voir Liaison aux fi&shy;
chiers serveur
(VS .NET 2003)
[page 181].)
Acc&egrave;de aux services
Web de rapports ex&shy;
pos&eacute;s par le serveur
WCS de Crystal En&shy;
&Ucirc;&sup2;?&agrave;%`Cł&atilde;
prise 8, 8.5, 9 ou 10
par le biais d'un ser&shy;
vice Web commun,
EnterpriseReport&shy;
Service. Pour en sa&shy;
voir plus, voir Liaison
&agrave; Crystal Enterprise
(VS .NET 2003)
[page 186].
Vous devez pouvoir
acc&eacute;der &agrave; Crys&shy;
tal Enterprise (qui
expose les rapports
Enterprise par le bi&shy;
ais de son WCS).
Fichiers serveur
(le nœud est rem&shy;
plac&eacute; lorsque
SAP Crystal Re&shy;
ports 9 ou 10 est in&shy;
stall&eacute;)
EnterpriseReport
Crystal Enterprise
SAP Crystal Reports
pour Visual Stu&shy;
dio .NET 2003
(le nœud est rem&shy;
plac&eacute; lorsque
SAP Crystal Re&shy;
ports 9 ou 10 est in&shy;
stall&eacute;)
1.4.5.3.1.5.1
Liaison aux fichiers serveur (VS .NET 2003)
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
181
Emplacement des rapports
Les rapports se trouvent dans un dossier situ&eacute; dans le r&eacute;pertoire de fichiers local. Ces rapports sont expos&eacute;s en
tant que services Web de rapports.
Pr&eacute;sentation des services Crystal
Ce sc&eacute;nario de liaison de rapports s'applique aux rapports accessibles depuis le nœud du serveur de services
Crystal dans l'Explorateur de serveurs.
Cette section pr&eacute;sente le sous-nœud Fichiers serveur des services Crystal dans Visual Studio .NET 2003.
[NOMSERVEUR]
●
Services Crystal
○
Fichiers serveur
Description
Le sous-nœud Fichiers serveur acc&egrave;de aux rapports qui ont &eacute;t&eacute; expos&eacute;s comme services Web de rapports &agrave; partir
du r&eacute;pertoire de fichiers local, puis les affiche. Ces rapports sont expos&eacute;s &agrave; l'aide du protocole des services Web
de rapports. Dans Visual Studio .NET 2003, cliquez sur le nœud Fichiers serveur situ&eacute; sous Services Crystal pour
acc&eacute;der aux fichiers serveur.
Avantages
●
Acc&egrave;s centralis&eacute; aux rapports : offre un point d'acc&egrave;s unique &agrave; tous les rapports situ&eacute;s dans votre r&eacute;pertoire
d'exemples de rapports, ce qui cr&eacute;e un r&eacute;f&eacute;rentiel de rapports efficace sur votre disque dur local.
Inconv&eacute;nients
●
Remplac&eacute; dans SAP Crystal Reports 9 et 10 par un nœud Services Crystal de serveur RAS non g&eacute;r&eacute;. Pour en
savoir plus, voir la section Description ci-dessus.
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
182
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Configuration des fichiers serveur
Les fichiers serveur sont fournis en tant que nœud de Services Crystal dans SAP Crystal Reports pour Visual
Studio 2003. Lorsque SAP Crystal Reports 9 ou 10 (les versions compl&egrave;tes) est install&eacute; par-dessus la version
incluse avec Visual Studio 2003, le nœud des fichiers serveur n'est plus visible.
Chaque &eacute;dition de SAP Crystal Reports Developer continue &agrave; prendre en charge les fichiers serveur dans le SDK.
Toutefois, une programmation manuelle est n&eacute;cessaire pour utiliser les fichiers serveur dans cette version.
Informations associ&eacute;es
Configuration des fichiers serveur dans les services Crystal [page 86]
Liaison &agrave; Crystal Enterprise (VS .NET 2003) [page 186]
Utilisation des services Crystal [page 84]
1.4.5.3.1.5.1.1
Pour installer les services Crystal
Pr&eacute;requis
SAP Crystal Reports pour Visual Studio 2003 doit &ecirc;tre install&eacute;.
Contexte
Les services Crystal ne sont pas install&eacute;s par d&eacute;faut lors de l'installation de Visual Studio .NET 2003. Dans cette
proc&eacute;dure, vous allez installer les Services Crystal &agrave; partir du CD d'installation de Visual Studio .NET 2003.
Proc&eacute;dure
1.
Sur le CD d'installation de Microsoft Visual Studio .NET, localisez Crystal Reports.
2.
S&eacute;lectionnez les services Web Crystal.
3.
Cliquez sur le bouton Mettre &agrave; jour.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
183
1.4.5.3.1.5.1.2
Pour utiliser le nœud Services
Crystal &gt; Fichiers serveur
Pr&eacute;requis
●
SAP Crystal Reports pour Visual Studio 2003 est install&eacute; et fonctionnel.
●
Ou SAP Crystal Reports 9 ou versions ult&eacute;rieures est install&eacute; et fonctionnel.
Remarque
Dans SAP Crystal Reports 9 et 10, les fichiers serveur sont remplac&eacute;s (ils ne s'affichent plus en tant que
nœud sous Services Crystal). Il est toutefois toujours possible de les coder manuellement.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans le menu Affichage, cliquez sur Autres fen&ecirc;tres, puis sur Explorateur de serveurs.
2.
D&eacute;veloppez le nœud Services Crystal, puis Fichiers serveur.
3.
S&eacute;lectionnez un rapport dans l'arborescence Fichiers serveur, puis faites-le glisser dans votre formulaire.
Remarque
Lorsqu'un rapport Fichiers serveur est plac&eacute; dans votre formulaire, une instance de la classe
ServerFileReport est ajout&eacute;e &agrave; la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le concepteur de votre formulaire.
Lorsqu'une classe qui h&eacute;rite de System.ComponentModel.Component (telle que ServerFileReport)
est instanci&eacute;e et configur&eacute;e dans la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le concepteur, une ic&ocirc;ne correspondant &agrave;
cette classe instanci&eacute;e s'affiche au bas du formulaire en mode Design.
En mode Design, un objet serverFileReport1 s'affiche au bas du formulaire.
4.
Passez en mode code et ouvrez la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form ou Windows Form.
Une classe ServerFileReport a &eacute;t&eacute; instanci&eacute;e et configur&eacute;e dans cette r&eacute;gion.
5.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet), affectez l'instance de ServerFileReport &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = serverFileReport1
crystalReportViewer.ReportSource = serverFileReport1;
184
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&Eacute;tapes suivantes
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.1.5.1.3
Pour coder manuellement les fichiers serveur
Pr&eacute;requis
●
SAP Crystal Reports pour Visual Studio 2003 est install&eacute; et fonctionnel.
●
Ou SAP Crystal Reports 9 ou versions ult&eacute;rieures est install&eacute; et fonctionnel.
Remarque
Dans SAP Crystal Reports 9 et 10, les fichiers serveur sont remplac&eacute;s (ils ne s'affichent plus en tant que
nœud sous Services Crystal). Il est toutefois toujours possible de les coder manuellement.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet), d&eacute;clarez une instance deServerFileReport.
Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _
New CrystalDecisions.Shared.ServerFileReport()
CrystalDecisions.Shared.ServerFileReport serverFileReport = new
CrystalDecisions.Shared.ServerFileReport();
2.
Attribuez &agrave; la propri&eacute;t&eacute; ObjectType de ServerFileReport la valeur REPORT.
myServerFileReport.ObjectType = CrystalDecisions.
[Shared].EnumServerFileType.REPORT
serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;
3.
Attribuez &agrave; la propri&eacute;t&eacute; ReportPath de ServerFileReport le rapport et son sous-r&eacute;pertoire.
myServerFileReport.ReportPath = &quot;\General Business\World Sales Report.rpt&quot;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
185
serverFileReport.ReportPath = &quot;\\General Business\\World Sales Report.rpt&quot;;
4.
D&eacute;finissez la propri&eacute;t&eacute; WebServiceURL de ServerFileReport sur le r&eacute;pertoire virtuel du visualiseur de
votre version install&eacute;e de SAP Crystal Reports.
Remarque
Dans cet exemple de code, le r&eacute;pertoire virtuel des visualiseurs est configur&eacute; pour SAP Crystal Reports 10.
myServerFileReport.WebServiceUrl = &quot;http://localhost/crystalreportviewers10/
ServerFileReportService.asmx&quot;
serverFileReport.WebServiceUrl = &quot;http://localhost/crystalreportviewers10/
ServerFileReportService.asmx&quot;;
5.
Attribuez &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer l'instance ServerFileReport.
myCrystalReportViewer.ReportSource = myServerFileReport
crystalReportViewer.ReportSource = serverFileReport1;
1.4.5.3.1.5.2
Liaison &agrave; Crystal Enterprise (VS .NET 2003)
Il fait r&eacute;f&eacute;rence &agrave; une ancienne technologie et s'adresse aux utilisateurs &eacute;quip&eacute;s d'une version de
Crystal Enterprise. Crystal Enterprise a &eacute;t&eacute; remplac&eacute; par SAP Crystal Reports Server et la plateforme SAP
BusinessObjects Business Intelligence.
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer (voir Liaison de rapports &agrave; l'aide
du mod&egrave;le d'objet CrystalReportViewer [page 172]).
Emplacement des rapports
Les rapports sont situ&eacute;s sur le WCS (Web Component Server) de Crystal Enterprise 8, 8.5, 9 ou 10. Les rapports
issus du serveur WCS sont expos&eacute;s comme services Web de rapports par le biais du service Web
EnterpriseReportService.asmx. Ce service Web se trouve dans le r&eacute;pertoire virtuel des visualiseurs du WCS.
Pr&eacute;sentation des services Crystal
Ce sc&eacute;nario de liaison de rapports s'applique aux rapports accessibles depuis le nœud du serveur de services
Crystal dans l'Explorateur de serveurs.
186
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Cette section pr&eacute;sente le sous-nœud Crystal Enterprise des services Crystal dans Visual Studio .NET 2003.
[NOMSERVEUR]
●
Services Crystal
○
Crystal Enterprise
Description
Le sous-nœud Crystal Enterprise acc&egrave;de aux rapports qui ont &eacute;t&eacute; expos&eacute;s comme services Web de rapports &agrave;
partir d'un serveur WCS, puis les affiche.
Pour que le sous-nœud Crystal Enterprise acc&egrave;de &agrave; une liste de rapports depuis le serveur WCS
Crystal Enterprise et les affiche correctement, les conditions suivantes doivent &ecirc;tre remplies :
●
Le serveur que vous visualisez actuellement dans l'Explorateur de serveurs ex&eacute;cute
Crystal Enterprise 8 ou 8.5.
Remarque
Vous devez mettre &agrave; niveau SAP Crystal Reports pour Visual Studio 2003 vers
SAP Crystal Reports Developer (version 9 ou ult&eacute;rieure) pour pouvoir vous connecter &agrave;
Crystal Enterprise 9 ou version ult&eacute;rieure.
●
Le serveur WCS de Crystal Enterprise est install&eacute; sur le serveur Crystal Enterprise.
Remarque
Le serveur WCS est install&eacute; par d&eacute;faut dans Crystal Enterprise 9 et 10. Dans Crystal Enterprise 8 et 8.5, le
serveur WCS doit &ecirc;tre install&eacute; s&eacute;par&eacute;ment.
●
Pour configurer des services Web de rapports sur le serveur Crystal Enterprise 10, vous devez installer
Visual Studio .NET 2003 sur le serveur Crystal Enterprise, puis ex&eacute;cuter une installation personnalis&eacute;e pour
ajouter sp&eacute;cifiquement les services Crystal.
Si l'administrateur de Crystal Enterprise ne souhaite pas installer une version compl&egrave;te de
Visual Studio .NET 2003 sur le serveur Crystal Enterprise, il peut proc&eacute;der comme suit :
○
Installer le module de fusion managed.msm.
○
Rechercher le r&eacute;pertoire virtuel des visualiseurs install&eacute; sur l'ordinateur de d&eacute;veloppement et copier le
fichier EnterpriseReportService.asmx de ce r&eacute;pertoire vers le r&eacute;pertoire virtuel des visualiseurs de
l'ordinateur serveur.
Une fois les rapports affich&eacute;s dans les services Crystal, choisissez-en un et faites-le glisser dans le Web Form ou le
Windows Form. Une fois dans le formulaire, le rapport est ajout&eacute; &agrave; une classe wrapper de rapport, puis affich&eacute;
sous forme d'instance dans la barre d'&eacute;tat des composants.
Remarque
Il existe plusieurs types de classes wrapper de rapport, en fonction de la source du rapport sur le serveur et du
protocole de connexion. Ceux-ci varient en fonction des versions de SAP Crystal Reports.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
187
Installation des services Crystal
Les services Crystal ne sont pas install&eacute;s par d&eacute;faut lors de l'installation de Visual Studio .NET 2003. Pour ajouter
les services Crystal, chargez le CD d'installation de Microsoft Visual Studio .NET, localisez Crystal Reports,
s&eacute;lectionnez les services Web Crystal, puis cliquez sur le bouton Mettre &agrave; jour.
Avantages
●
Les rapports Crystal Enterprise sont facilement accessibles &agrave; partir d'une application Web ou Windows.
Inconv&eacute;nients
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
Remarque
Dans SAP Crystal Reports 9 et 10, les services Crystal sont mis &agrave; niveau vers une classe wrapper et un
protocole de connexion diff&eacute;rents.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
Utilisation des services Crystal [page 84]
Liaison aux fichiers serveur (Visual Studio 2005 et versions ult&eacute;rieures) [page 190]
1.4.5.3.1.5.2.1
Pour acc&eacute;der &agrave; Services
Crystal &gt; Crystal Enterprise dans l'Explorateur de serveurs
Proc&eacute;dure
1.
Dans le menu Affichage, cliquez sur Autres fen&ecirc;tres, puis sur Explorateur de serveurs.
2.
Si votre serveur Crystal Enterprise ne se trouve pas sur votre ordinateur local (recommand&eacute;) :
a) Cliquez avec le bouton droit de la souris sur Serveurs, puis cliquez sur Ajouter un serveur.
b) Dans le champ Ordinateur de la bo&icirc;te de dialogue Ajouter un serveur, saisissez le nom r&eacute;seau du serveur
Crystal Enterprise, puis cliquez sur OK.
c) Dans le nœud Serveurs, d&eacute;veloppez le sous-nœud du serveur ajout&eacute;, puis d&eacute;veloppez le sous-nœud
Services Crystal de celui-ci.
188
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
d) Dans la bo&icirc;te de dialogue Ouverture d'une session Enterprise, saisissez les valeurs dans les champs Nom
d'utilisateur et Mot de passe, puis cliquez sur OK.
3.
Si votre serveur Crystal Enterprise est install&eacute; sur votre ordinateur local :
a) Dans le nœud Serveurs, d&eacute;veloppez le sous-nœud correspondant &agrave; votre ordinateur local, puis
d&eacute;veloppez le sous-nœud Services Crystal de celui-ci.
b) Dans la bo&icirc;te de dialogue Ouverture d'une session Enterprise, saisissez les valeurs dans les champs Nom
d'utilisateur et Mot de passe, puis cliquez sur OK.
R&eacute;sultats
Vous pouvez maintenant configurer Services Crystal &gt; Crystal Enterprise dans votre projet Web ou Windows.
1.4.5.3.1.5.2.2
Pour configurer un rapport Services
Crystal &gt; Crystal Enterprise
Pr&eacute;requis
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et de
code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
S&eacute;lectionnez un rapport dans le sous-nœud Crystal Enterprise, puis faites-le glisser dans votre Web Form ou
votre Windows Form.
Au bas du formulaire, dans la barre d'&eacute;tat des composants, un objet enterpriseReport1 s'affiche.
2.
Passez en mode code et ouvrez la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form ou Windows Form.
Remarque
Une classe EnterpriseReport a &eacute;t&eacute; instanci&eacute;e et configur&eacute;e dans cette r&eacute;gion.
3.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), affectez l'instance d'EnterpriseReport &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = enterpriseReport1
crystalReportViewer.ReportSource = enterpriseReport1;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
189
4.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.1.5.3
Liaison aux fichiers serveur (Visual Studio 2005
et versions ult&eacute;rieures)
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports se trouvent dans un dossier situ&eacute; dans le r&eacute;pertoire de fichiers local. Ces rapports sont expos&eacute;s en
tant que services Web de rapports.
Pr&eacute;sentation g&eacute;n&eacute;rale des fichiers serveur
Ce sc&eacute;nario de liaison s'applique aux rapports accessibles en tant que fichiers serveur par l'interm&eacute;diaire d'un
service Web.
Description
Le service Web Fichiers serveur acc&egrave;de aux rapports qui ont &eacute;t&eacute; expos&eacute;s comme services Web de rapports &agrave;
partir du r&eacute;pertoire de fichiers local, puis les affiche. Dans Visual Studio 2005 et versions ult&eacute;rieures, les fichiers
serveur sont accessibles par programmation.
Avantages
●
Acc&egrave;s centralis&eacute; aux rapports : offre un point d'acc&egrave;s unique &agrave; tous les rapports situ&eacute;s dans votre r&eacute;pertoire
d'exemples de rapports, ce qui cr&eacute;e un r&eacute;f&eacute;rentiel de rapports efficace sur votre disque dur local.
Inconv&eacute;nients
●
190
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Configuration des fichiers serveur
Dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, les fichiers serveur sont accessibles
par programmation. Chaque &eacute;dition de SAP Crystal Reports Developer continue &agrave; prendre en charge par
programmation les fichiers serveur dans le SDK.
Informations associ&eacute;es
Configuration des fichiers serveur dans Visual Studio 2005 et les versions plus r&eacute;centes [page 89]
1.4.5.3.1.5.3.1
Pour coder manuellement les fichiers serveur
Pr&eacute;requis
●
Un service Web de rapports permettant d'acc&eacute;der par programmation aux fichiers serveur doit &ecirc;tre
configur&eacute;.
●
Ou SAP Crystal Reports Developer est install&eacute; et en cours de fonctionnement.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), d&eacute;clarez une instance de ServerFileReport.
Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _New
CrystalDecisions.Shared.ServerFileReport()
CrystalDecisions.Shared.ServerFileReport serverFileReport = new
CrystalDecisions.Shared.ServerFileReport();
2.
Attribuez &agrave; la propri&eacute;t&eacute; ObjectType de ServerFileReport la valeur REPORT.
myServerFileReport.ObjectType = CrystalDecisions.
[Shared].EnumServerFileType.REPORT
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
191
serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;
3.
D&eacute;finissez la propri&eacute;t&eacute; ReportPath de la classe ServerFileReport sur le rapport et son sous-r&eacute;pertoire.
myServerFileReport.ReportPath = &quot;\General Business\World Sales
Report.rpt&quot;
serverFileReport.ReportPath = &quot;\\General Business\\World Sales
Report.rpt&quot;;
4.
D&eacute;finissez la propri&eacute;t&eacute; WebServiceURL de ServerFileReport sur l'emplacement du service Web de rapports.
Si vous disposez de SAP Crystal Reports Developer, cet emplacement correspond au r&eacute;pertoire virtuel du
visualiseur de la version install&eacute;e de SAP Crystal Reports (voir R&eacute;pertoire des visualiseurs [page 14]). Si vous
ne disposez pas de SAP Crystal Reports Developer, il s'agit de l'URL du service Web de rapports que vous
avez cr&eacute;&eacute; dans Configuration des fichiers serveur dans Visual Studio 2005 et les versions plus r&eacute;centes [page
89].
Remarque
Dans le code ci-dessous, le r&eacute;pertoire virtuel des visualiseurs est configur&eacute; pour SAP Crystal Reports pour
Visual Studio 2005.
myServerFileReport.WebServiceUrl =
&quot;http://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx&quot;
serverFileReport.WebServiceUrl =
&quot;http://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx&quot;;
5.
Attribuez &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer l'instance ServerFileReport.
myCrystalReportViewer.ReportSource = myServerFileReport
crystalReportViewer.ReportSource = serverFileReport1;
1.4.5.3.1.5.4
Liaison &agrave; SAP Crystal Reports Server ou &agrave; la
plateforme SAP BusinessObjects Business Intelligence
(Visual Studio)
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer (voir Liaison de rapports &agrave; l'aide
du mod&egrave;le d'objet CrystalReportViewer [page 172]).
192
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Emplacement des rapports
Les rapports sont situ&eacute;s sur le WCS (Web Component Server) de SAP Crystal Reports Server ou de la plateforme
SAP BusinessObjects Business Intelligence. Les rapports issus du serveur WCS sont expos&eacute;s comme services
Web de rapports par le biais du service Web EnterpriseReportService.asmx. Ce service Web se trouve dans le
r&eacute;pertoire virtuel des visualiseurs du WCS.
Pr&eacute;sentation des services Crystal
Ce sc&eacute;nario de liaison de rapports s'applique aux rapports accessibles depuis le nœud du serveur de services
Crystal dans l'Explorateur de serveurs.
Cette section pr&eacute;sente le sous-nœud Services SAP Crystal Reports des services Crystal dans Visual Studio.
[NOMSERVEUR]
●
Services SAP Crystal Reports
○
Rapports du serveur
Description
Le sous-nœud de la plateforme SAP BusinessObjects Business Intelligence acc&egrave;de aux rapports qui ont &eacute;t&eacute;
fournis en tant que services Web de rapports &agrave; partir d'un serveur WCS de plateforme SAP BusinessObjects
Business Intelligence, puis les affiche.
Pour que le sous-nœud de la plateforme SAP BusinessObjects Business Intelligence acc&egrave;de &agrave; une liste de
rapports depuis le serveur WCS de la plateforme SAP BusinessObjects Business Intelligence et les affiche
correctement, les conditions suivantes doivent &ecirc;tre remplies :
●
Le serveur que vous visualisez actuellement dans l'Explorateur de serveurs ex&eacute;cute la plateforme SAP
BusinessObjects Business Intelligence.
●
Pour configurer les services Web de rapports dans la plateforme SAP BusinessObjects Business Intelligence,
vous devez installer Visual Studio sur le serveur de la plateforme SAP BusinessObjects Business Intelligence,
puis ex&eacute;cuter une installation personnalis&eacute;e pour ajouter sp&eacute;cifiquement les services Crystal.
Remarque
L'installation de Visual Studio sur le serveur de la plateforme SAP BusinessObjects Business Intelligence et
l'installation personnalis&eacute;e des services Crystal sont n&eacute;cessaires pour que le fichier
EnterpriseReportService.asmx soit correctement install&eacute; et configur&eacute; dans le r&eacute;pertoire virtuel des
visualiseurs.
Si l'administrateur de Crystal Enterprise ne souhaite pas installer une version compl&egrave;te de Visual Studio sur le
serveur de la plateforme SAP BusinessObjects Business Intelligence, il peut proc&eacute;der comme suit :
○
Installer le module de fusion managed.msm.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
193
○
Rechercher le r&eacute;pertoire virtuel des visualiseurs install&eacute; sur l'ordinateur de d&eacute;veloppement et copier le
fichier EnterpriseReportService.asmx de ce r&eacute;pertoire vers le r&eacute;pertoire virtuel des visualiseurs de
l'ordinateur serveur.
Une fois que les rapports s'affichent dans les services SAP BusinessObjects, vous pouvez lier un contr&ocirc;le
CrystalReportsViewer &agrave; n'importe quel rapport r&eacute;pertori&eacute;. Pour en savoir plus, voir la documentation relative
&agrave; la plateforme SAP BusinessObjects Business Intelligence.
Avantages
●
Les rapports de la plateforme SAP BusinessObjects Business Intelligence sont facilement accessibles depuis
une application Web ou Windows.
Inconv&eacute;nients
●
Mod&egrave;le d'objet limit&eacute; : ce sc&eacute;nario de liaison n'offre qu'un mod&egrave;le d'objet limit&eacute; qui fait partie du contr&ocirc;le
CrystalReportViewer.
Remarque
Dans SAP Crystal Reports 9 et 10, les services Crystal sont mis &agrave; niveau vers une classe wrapper et un
protocole de connexion diff&eacute;rents.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
Utilisation des services Crystal [page 84]
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
1.4.5.3.1.5.4.1
Pour lier un rapport par l'interm&eacute;diaire du
chemin d'acc&egrave;s &agrave; son r&eacute;pertoire de fichiers &agrave; l'aide de la
fen&ecirc;tre Propri&eacute;t&eacute;s
Proc&eacute;dure
1.
Cr&eacute;ez un projet Web ou Windows.
2.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le CrystalReportViewer dans un Web Form ou un
Windows Form.
194
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
4.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, affectez &agrave; la propri&eacute;t&eacute; ReportSource le chemin d'acc&egrave;s &agrave; un r&eacute;pertoire de
fichiers.
Remarque
Le chemin d'acc&egrave;s au r&eacute;pertoire de fichiers pointe sur les exemples de rapports de Visual Studio 2005.
En raison de la fonctionnalit&eacute; d'aper&ccedil;u au moment de la conception, le rapport s'affiche en mode Aper&ccedil;u.
C:\Program Files\Microsoft Visual Studio 8.0\Crystal Reports\Samples\fr\Reports
\Feature Examples\Hierarchical Grouping.rpt
5.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.1.6
Liaison &agrave; ReportSource
(SAP Crystal Reports Server ou
SAP BusinessObjects Enterprise 11)
Remarque
Les fonctionnalit&eacute;s d&eacute;crites dans cette page ne sont pas disponibles dans SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio mais le sont dans l'une des versions mises &agrave; niveau.
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet CrystalReportViewer.
Emplacement des rapports
Les rapports sont accessibles depuis le Page Server de la plateforme SAP BusinessObjects Business Intelligence.
Description
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence permet de distribuer des
rapports &agrave; partir de serveurs au sein d'une structure Enterprise. Un rapport stock&eacute; dans
SAP Crystal Reports Server ou dans la plateforme SAP BusinessObjects Business Intelligence peut &ecirc;tre affich&eacute;
par diff&eacute;rents serveurs &agrave; diff&eacute;rents moments, selon vos besoins. Dans SAP Crystal Reports Server ou la
plateforme SAP BusinessObjects Business Intelligence, si vous voulez afficher un rapport avec les meilleures
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
195
performances possibles et que vous ne souhaitez pas lui apporter de modifications importantes par
programmation, affichez-le directement depuis le Page Server avec la classe ReportSource.
La classe ReportSource n'est associ&eacute;e &agrave; aucun mod&egrave;le d'objet. Si vous souhaitez modifier des param&egrave;tres ou
des informations de connexion &agrave; la base de donn&eacute;es, vous pouvez utiliser le mod&egrave;le d'objet limit&eacute; fourni par le
contr&ocirc;le CrystalReportViewer. Toutefois, pour une interaction par programmation plus complexe avec le
rapport, utilisez l'un des autres sc&eacute;narios de liaison de rapports SAP Crystal Reports Server ou de plateforme SAP
BusinessObjects Business Intelligence.
Remarque
Pour une comparaison de plusieurs sc&eacute;narios utilisant des serveurs diff&eacute;rents dans
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence, voir les sc&eacute;narios de
liaison recommand&eacute;s pour SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business
Intelligence &agrave; la section Sc&eacute;narios de liaison de rapports [page 170].
Il se peut que vous deviez ajuster vos param&egrave;tres de pare-feu afin d'acc&eacute;der au CMS de la plateforme SAP
BusinessObjects Business Intelligence. Le port par d&eacute;faut pour le CMS est 6400. Contactez votre administrateur
syst&egrave;me pour plus d'informations sur l'adresse r&eacute;seau et les param&egrave;tres de port de votre syst&egrave;me de plateforme
SAP BusinessObjects Business Intelligence. Pour plus d'informations sur la personnalisation des ports, voir le
Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
Avantages
●
Sc&eacute;nario le plus rapide : offre les meilleures performances d'affichage d'un rapport dans
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence.
Inconv&eacute;nients
●
Mod&egrave;le d'objet limit&eacute; : les modifications par programmation qui peuvent &ecirc;tre apport&eacute;es aux param&egrave;tres ou
aux informations de connexion &agrave; la base de donn&eacute;es sont limit&eacute;es au mod&egrave;le d'objet
CrystalReportViewer.
●
Disponibilit&eacute; limit&eacute;e : ce sc&eacute;nario est uniquement disponible dans Crystal Enterprise version 10,
SAP Crystal Reports Server ou SAP BusinessObjects Enterprise XI.
Informations associ&eacute;es
Liaison de rapports &agrave; l'aide du mod&egrave;le d'objet ReportDocument [page 200]
196
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.5.3.1.6.1
Liaison du contr&ocirc;le CrystalReportViewer &agrave; un
rapport pris en charge en dehors du Page Server de
SAP Crystal Reports Server ou de la plateforme SAP
BusinessObjects Business Intelligence
Pr&eacute;requis
●
SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence doit &ecirc;tre install&eacute; et
en cours de fonctionnement.
●
Le SDK SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence (y
compris les assemblys .NET) doit &ecirc;tre install&eacute; et en cours de fonctionnement.
Remarque
Si vous avez install&eacute; SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business
Intelligence sur votre ordinateur de d&eacute;veloppement, le SDK est inclus dans cette installation.
Proc&eacute;dure
1.
Localisez et notez le nom d'un serveur SAP Crystal Reports Server ou de plateforme SAP BusinessObjects
Business Intelligence. Pour cet exemple, le nom du serveur est &quot;BOE01&quot;.
a) Pour rechercher le nom du serveur, cliquez avec le bouton droit de la souris sur l'ic&ocirc;ne Poste de travail,
puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
b) Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s syst&egrave;me, cliquez sur l'onglet Identification r&eacute;seau.
c) Le nom de l'ordinateur appara&icirc;t dans le champ &quot;Nom complet de l'ordinateur&quot;.
2.
Utilisez l'Assistant de publication pour publier le rapport Chart.rpt sur le serveur SAP Crystal Reports Server
ou de plateforme SAP BusinessObjects Business Intelligence.
Remarque
Pour savoir comment utiliser l'Assistant de publication, consultez la documentation utilisateur de
SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.
3.
4.
Ajoutez les r&eacute;f&eacute;rences d'assembly suivantes &agrave; votre projet :
○
CrystalDecisions.Enterprise.Framework
○
CrystalDecisions.Enterprise.InfoStore
○
CrystalDecisions.Enterprise.Viewing.ReportSource
○
CrystalDecisions.ReportAppServer.Controllers
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind du Web Form ou du Windows
Form. Au-dessus de la classe, ajoutez une instruction &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] pour
l'espace de noms CrystalDecisions.Enterprise.
Imports CrystalDecisions.Enterprise
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
197
Imports CrystalDecisions.Enterprise.Viewing
Imports CrystalDecisions.ReportAppServer.Controllers
using CrystalDecisions.Enterprise;
using CrystalDecisions.Enterprise.Viewing;
using CrystalDecisions.ReportAppServer.Controllers;
1.4.5.3.1.6.2
Connexion &agrave; SAP Crystal Reports Server ou
SAP BusinessObjects Enterprise
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans Configuration d'un projet [page
15]), d&eacute;clarez une variable de cha&icirc;ne serverName et attribuez-lui le nom du serveur
SAP Crystal Reports Server ou du serveur SAP BusinessObjects Enterprise.
Dim serverName As String = &quot;BOE01&quot;
string serverName = &quot;BOE01&quot;;
2.
D&eacute;clarez et instanciez la classe SessionMgr.
Dim mySessionMgr As SessionMgr = New SessionMgr()
SessionMgr sessionMgr = new SessionMgr();
3.
Transmettez le nom de l'utilisateur (Administrator), le mot de passe (vide), la variable serverName et le type
de connexion (secEnterprise) &agrave; la m&eacute;thode de connexion de l'instance de SessionMgr, puis extrayez-la
comme une instance d'EnterpriseSession.
Dim myEnterpriseSession As EnterpriseSession = mySessionMgr.Logon( _
&quot;Administrator&quot;, &quot;&quot;, serverName, &quot;secEnterprise&quot;)
EnterpriseSession enterpriseSession = sessionMgr.Logon(
&quot;Administrator&quot;, &quot;&quot;, serverName, &quot;secEnterprise&quot;);
4.
Extrayez le service InfoStore (en tant que EnterpriseService), de la m&eacute;thode GetService
d'EnterpriseSession.
Dim myEnterpriseService As EnterpriseService = _
myEnterpriseSession.GetService(&quot;InfoStore&quot;)
EnterpriseService enterpriseService = enterpriseSession.GetService(&quot;InfoStore&quot;);
198
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
D&eacute;clarez et instanciez InfoStore, puis transmettez &agrave; InfoStore le service EnterpriseService extrait
comme un param&egrave;tre.
Dim myInfoStore As InfoStore = New InfoStore(myEnterpriseService)
InfoStore infoStore = new InfoStore(enterpriseService);
1.4.5.3.1.6.3
Extraction du rapport Hierarchical Grouping de
SAP Crystal Reports Server ou de
SAP BusinessObjects Enterprise
Proc&eacute;dure
1.
Pour r&eacute;attribuer la valeur de l'instance d'EnterpriseService au service de r&eacute;f&eacute;rence de rapport du Page Server,
transmettez la cha&icirc;ne &quot;PSReportFactory&quot; &agrave; la m&eacute;thode GetService() d'EnterpriseService.
myEnterpriseService = myEnterpriseSession.GetService(&quot;PSReportFactory&quot;)
enterpriseService = enterpriseSession.GetService(&quot;PSReportFactory&quot;);
2.
Renvoyez la propri&eacute;t&eacute; Interface de l'instance EnterpriseService en tant que variable objet.
Dim psrfObject As Object = myEnterpriseService.Interface
Object psrfObject = enterpriseService.Interface;
3.
Effectuez un cast de la variable objet en une instance de PSReportFactory.
Dim myPSReportFactory As PSReportFactory = CType(psrfObject, PSReportFactory)
PSReportFactory psReportFactory = (PSReportFactory)psrfObject;
4.
Saisissez la cha&icirc;ne de requ&ecirc;te suivante pour interroger SAP Crystal Reports Server ou
SAP BusinessObjects Enterprise sur le rapport.
Dim queryString As String = &quot;Select SI_ID, SI_NAME, SI_PARENTID From
CI_INFOOBJECTS &quot; _
&amp; &quot;Where SI_PROGID='CrystalEnterprise.Report' &quot; _
&amp; &quot;And SI_NAME Like 'Chart'&quot;
string queryString = &quot;Select SI_ID, SI_NAME, SI_PARENTID From CI_INFOOBJECTS &quot;
+ &quot;Where SI_PROGID='CrystalEnterprise.Report' &quot;
+ &quot;And SI_NAME Like 'Chart'&quot;;
5.
Transmettez la cha&icirc;ne de requ&ecirc;te &agrave; la m&eacute;thode Query d'InfoStore pour extraire une classe index&eacute;e
InfoObjects qui contient le r&eacute;sultat de la requ&ecirc;te.
Dim myInfoObjects As InfoObjects = myInfoStore.Query(queryString)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
199
InfoObjects infoObjects = infoStore.Query(queryString);
6.
Extrayez l'InfoObject de la premi&egrave;re colonne de la classe index&eacute;e InfoObjects.
Dim myInfoObject As InfoObject = myInfoObjects(1)
InfoObject infoObject = infoObjects[1];
7.
D&eacute;clarez et remplissez une instance de ReportSource &agrave; partir de la m&eacute;thode OpenReportSource() de
l'instance de PSReportFactory en transmettant la propri&eacute;t&eacute; ID d'InfoObject.
Dim myReportSource As ReportSource =
myPSReportFactory.OpenReportSource(myInfoObject.ID)
ReportSource reportSource = psReportFactory.OpenReportSource(infoObject.ID);
8.
Liez l'instance ReportSource &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = myReportSource
crystalReportViewer.ReportSource = reportSource;
9.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
Le rapport s'affiche d&eacute;sormais depuis le Page Server de SAP Crystal Reports Server ou de
SAP BusinessObjects Enterprise en fonction de son ID. Si vous utilisez une autre m&eacute;thode pour acc&eacute;der &agrave;
reportID (en s&eacute;lectionnant l'ID dans une liste de rapports dans un contr&ocirc;le DropDownList par exemple),
vous n'aurez pas &agrave; rechercher InfoStore ni &agrave; g&eacute;n&eacute;rer une classe InfoObject pour extraire reportID.
1.4.5.3.2
Liaison de rapports &agrave; l'aide du mod&egrave;le d'objet
ReportDocument
Le mod&egrave;le d'objet ReportDocument est le plus puissant et le plus complet des mod&egrave;les d'objet fournis avec
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio. Il s'agit du mod&egrave;le d'objet privil&eacute;gi&eacute; pour
d&eacute;velopper un projet avec SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
1.4.5.3.2.1
Liaison &agrave; une classe de rapport incorpor&eacute;
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
Emplacement des rapports
Les rapports sont incorpor&eacute;s dans le projet.
200
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Dans les pr&eacute;c&eacute;dentes versions de cette documentation, les rapports incorpor&eacute;s &eacute;taient appel&eacute;s &quot;rapports
fortement typ&eacute;s&quot;. Le principal terme d&eacute;sormais utilis&eacute; pour faire r&eacute;f&eacute;rence &agrave; un rapport qui a &eacute;t&eacute; ajout&eacute; ou
import&eacute; dans un projet Visual Studio est &quot;incorpor&eacute;&quot;.
Description
Dans ce sc&eacute;nario, un rapport est incorpor&eacute; dans un projet. Pour incorporer un rapport, vous pouvez soit cr&eacute;er un
rapport &agrave; l'aide du SAP Crystal Reports Designer incorpor&eacute; (inclus dans Visual Studio), soit importer un rapport
existant dans le projet. Une fois le rapport cr&eacute;&eacute; ou import&eacute;, une classe wrapper repr&eacute;sentant ce rapport est
automatiquement g&eacute;n&eacute;r&eacute;e. Cette classe wrapper porte le m&ecirc;me nom que le rapport. D&eacute;riv&eacute;e de la classe de base
ReportDocument, elle h&eacute;rite naturellement de toutes les propri&eacute;t&eacute;s et m&eacute;thodes de la classe ReportDocument qui
fait partie du mod&egrave;le d'objet ReportDocument.
Avantages
●
S&eacute;curit&eacute; renforc&eacute;e : les rapports sont incorpor&eacute;s et donc distribu&eacute;s en tant que partie de l'application.
●
Interaction par programmation &eacute;tendue : fournit un acc&egrave;s au puissant mod&egrave;le d'objet ReportDocument.
●
S&eacute;curit&eacute; renforc&eacute;e : offre le contr&ocirc;le le plus complet sur l'acc&egrave;s aux sources des rapports.
●
Utilisation la plus courante : la plupart des d&eacute;veloppeurs consid&egrave;rent que ce sc&eacute;nario offre le plus grand
nombre d'avantages.
Inconv&eacute;nients
●
Maintenance suppl&eacute;mentaire : toute modification apport&eacute;e aux rapports n&eacute;cessite la recompilation et la
redistribution de l'application.
1.4.5.3.2.1.1
Pour lier &agrave; une classe de rapport incorpor&eacute;
Contexte
Une fois un rapport cr&eacute;&eacute; ou import&eacute;, une classe wrapper repr&eacute;sentant ce rapport est automatiquement g&eacute;n&eacute;r&eacute;e.
Cette classe wrapper porte le m&ecirc;me nom que le rapport. D&eacute;riv&eacute;e de la classe de base ReportDocument, elle h&eacute;rite
naturellement de toutes les propri&eacute;t&eacute;s et m&eacute;thodes de la classe ReportDocument qui fait partie du mod&egrave;le d'objet
ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
201
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; un Windows Form.
Remarque
Toutes les versions de SAP Crystal Reports prennent en charge la liaison &agrave; une classe de rapport
incorpor&eacute;e pour les applications Windows. Certaines configurations fournissent une prise en charge de ce
sc&eacute;nario de liaison pour les sites Web gr&acirc;ce &agrave; un fournisseur int&eacute;gr&eacute; am&eacute;lior&eacute;.
2.
Ajoutez un rapport au projet. Cela g&eacute;n&egrave;re automatiquement une classe wrapper ayant le m&ecirc;me nom que le
rapport.
3.
Instanciez la classe wrapper du rapport.
Dim myReport As New QuarterlySalesReport()
QuarterlySalesReport myReport = new QuarterlySalesReport();
4.
Affectez-la &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = myReport
crystalReportViewer.ReportSource = myReport;
1.4.5.3.2.2
Liaison &agrave; un rapport non incorpor&eacute; charg&eacute; dans la
classe ReportDocument
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
Emplacement des rapports
Les rapports se trouvent dans le r&eacute;pertoire de fichiers.
Description
Ce sc&eacute;nario de liaison de rapports permet d'utiliser ReportDocument, le mod&egrave;le d'objet le plus puissant, avec des
rapports non incorpor&eacute;s (externes &agrave; votre projet).
202
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Dans le sc&eacute;nario Liaison au chemin d'acc&egrave;s d'un r&eacute;pertoire de fichiers par code [page 172], vous liez les rapports
par l'interm&eacute;diaire de leur chemin d'acc&egrave;s &agrave; un r&eacute;pertoire de fichiers, mais au lieu de les lier directement au
visualiseur, vous les transmettez &agrave; la m&eacute;thode ReportDocument.Load(). Cela vous permet d'utiliser le mod&egrave;le
d'objet ReportDocument.
Par ailleurs, chaque rapport externe &eacute;tant charg&eacute; dans la classe ReportDocument commune, vous pouvez
d&eacute;velopper un processus de s&eacute;lection de rapports qui permet le partage du code de liaison avec tous les rapports.
Avantages
●
Peu de maintenance : les rapports sont ajout&eacute;s, supprim&eacute;s ou modifi&eacute;s sans avoir &agrave; recompiler l'application.
●
Interaction par programmation &eacute;tendue : fournit un acc&egrave;s au puissant mod&egrave;le d'objet ReportDocument.
●
Moins de codage gr&acirc;ce au partage de code : les rapports peuvent partager le m&ecirc;me code, car ils sont tous
charg&eacute;s dans la classe ReportDocument commune.
Inconv&eacute;nients
●
Distribution limit&eacute;e : les rapports doivent se trouver sur le m&ecirc;me ordinateur que l'application. (L'acc&egrave;s &agrave;
d'autres serveurs du r&eacute;seau &agrave; partir du compte utilisateur ASPNET du serveur Web est g&eacute;n&eacute;ralement limit&eacute;.)
●
Effort de d&eacute;ploiement accru : les rapports doivent &ecirc;tre distribu&eacute;s avec l'application en utilisant le chemin
relatif correct.
●
Source des rapports moins s&eacute;curis&eacute;e : les rapports peuvent &ecirc;tre d&eacute;plac&eacute;s ou supprim&eacute;s sur l'ordinateur de
d&eacute;ploiement au moment de l'ex&eacute;cution.
1.4.5.3.2.2.1
Pour lier &agrave; une classe de rapport non incorpor&eacute;
&agrave; l'aide du mod&egrave;le d'objet ReportDocument
Pr&eacute;requis
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
203
Proc&eacute;dure
1.
Ajoutez une instruction &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au d&eacute;but de la classe pour
l'espace de noms CrystalDecisions.CrystalReports.Engine.
Remarque
Vous devez d&eacute;clarer cet espace de noms pour pouvoir acc&eacute;der &agrave; la classe ReportDocument sans pr&eacute;fixe
d'espace de noms.
Imports CrystalDecisions.CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
2.
Recherchez le fichier World Sales Report.rpt dans le sous-r&eacute;pertoire General Business de votre version
SAP Crystal Reports.
3.
Copiez dans le Presse-papiers le chemin d'acc&egrave;s complet au r&eacute;pertoire de fichiers en incluant World Sales
Report.rpt.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), d&eacute;clarez une variable cha&icirc;ne reportPath et affectez-lui une cha&icirc;ne contenant le chemin
d'acc&egrave;s au fichier World Sales Report copi&eacute; lors de l'&eacute;tape pr&eacute;c&eacute;dente.
Dim reportPath As String = _
&quot;C:\Program Files\Microsoft Visual Studio 9.0\&quot; _ &amp; &quot;Crystal Reports\Samples
\fr\Reports\General Business\&quot; _ &amp; &quot;World Sales Report.rpt&quot;
string reportPath =
&quot;C:\\Program Files\\Microsoft Visual Studio 9.0\\&quot; + &quot;Crystal Reports\\Samples
\\fr\\Reports\\General Business\\&quot; + &quot;World Sales Report.rpt&quot;;
5.
Sous la cha&icirc;ne d&eacute;clar&eacute;e, d&eacute;clarez une instance de ReportDocument.
Dim myReportDocument As ReportDocument = New ReportDocument()
ReportDocument reportDocument = new ReportDocument();
6.
Chargez la variable cha&icirc;ne li&eacute;e &agrave; la classe de rapport non incorpor&eacute; et contenant le chemin d'acc&egrave;s au
r&eacute;pertoire de fichiers dans ReportDocument.
myReportDocument.Load(reportPath)
reportDocument.Load(reportPath);
204
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
Affectez l'instance de ReportDocument (qui contient maintenant la classe de rapport non incorpor&eacute;
charg&eacute;e) &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = myReportDocument
crystalReportViewer.ReportSource = reportDocument;
8.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.2.3
en cache
Liaison &agrave; une classe de rapport incorpor&eacute; et mis
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
Emplacement des rapports
Les rapports sont incorpor&eacute;s dans le projet.
Description
Lorsqu'un rapport est incorpor&eacute; dans un projet Visual Studio, une classe wrapper, qui repr&eacute;sente le rapport dans
le projet, est automatiquement g&eacute;n&eacute;r&eacute;e. Parall&egrave;lement, une classe utilitaire de gestion du cache pour ce rapport
est &eacute;galement cr&eacute;&eacute;e.
Dans ce sc&eacute;nario, vous liez le contr&ocirc;le CrystalReportViewer &agrave; la classe utilitaire de gestion du cache de mani&egrave;re &agrave;
ce que la mise en m&eacute;moire cache des rapports dans l'objet Cache ASP.NET soit g&eacute;r&eacute;e automatiquement.
Utilisation de la mise en cache
La mise en cache doit &ecirc;tre utilis&eacute;e dans des cas particuliers et limit&eacute;s car elle peut &quot;surconsommer&quot; des
ressources syst&egrave;me lorsqu'elle n'est pas g&eacute;r&eacute;e avec pr&eacute;caution.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
205
Mise en cache des rapports non incorpor&eacute;s
Si vous souhaitez g&eacute;rer la mise en cache de rapports non incorpor&eacute;s, vous devez cr&eacute;er votre propre classe
utilitaire de gestion du cache. Pour en savoir plus, voir Liaison &agrave; un rapport non incorpor&eacute; charg&eacute; dans une classe
utilitaire de gestion du cache [page 207].
Avantages
●
Con&ccedil;u pour le partage : id&eacute;al pour stocker les rapports qui pr&eacute;sentent un fort potentiel de partage et peu de
modifications &agrave; apporter aux param&egrave;tres ou aux informations de connexion.
●
Acc&egrave;s aux donn&eacute;es optimis&eacute; : si les rapports &agrave; fort potentiel de partage sont tr&egrave;s volumineux ou s'ils
contiennent une requ&ecirc;te tellement complexe que l'extraction prend plusieurs minutes, la classe utilitaire de
gestion du cache permet d'acc&eacute;der plus rapidement aux donn&eacute;es.
Inconv&eacute;nients
●
Charge du serveur : les rapports stock&eacute;s dans l'objet Cache ASP.NET peuvent &quot;surcharger&quot; les ressources
m&eacute;moire sur le serveur.
●
Probl&egrave;mes de persistance : le cache poss&egrave;de certaines d&eacute;pendances qui permettent la v&eacute;rification des
modifications apport&eacute;es &agrave; l'instance d'un rapport et la remise en cache de cette instance. Toutefois, si la base
de donn&eacute;es est modifi&eacute;e, l'instance du rapport stock&eacute;e dans l'objet Cache n'est pas actualis&eacute;e en
cons&eacute;quence.
●
Consommation de ressources : un rapport dont les param&egrave;tres sont appel&eacute;s fr&eacute;quemment &agrave; l'aide de
diff&eacute;rentes cha&icirc;nes de param&egrave;tre(particuli&egrave;rement si l'un de ces param&egrave;tres correspond &agrave; l'ID utilisateur)
implique &agrave; chaque fois la mise en cache d'un nouveau rapport. Ce processus consomme des ressources
syst&egrave;me. Si le rapport ne pr&eacute;sente pas un fort potentiel de partage, affectez son instance &agrave; un objet Session.
Informations associ&eacute;es
Utilisation de rapports standard ou mis en cache ? [page 221]
Mod&egrave;le d'objet ReportDocument [page 37]
Session et persistance du mod&egrave;le d'objet ReportDocument [page 57]
206
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.5.3.2.3.1
cache
Pour lier &agrave; une classe utilitaire de gestion du
Pr&eacute;requis
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), supprimez les lignes de code existantes pour remplacer la classe wrapper par la classe
utilitaire de gestion du cache.
2.
Instanciez la classe utilitaire de gestion du cache associ&eacute;e au rapport Hierarchical Grouping.rpt.
Dim cachedHierarchicalGroupingReport As CachedHierarchical_Grouping
= New CachedHierarchical_Grouping()
CachedHierarchical_Grouping cachedHierarchicalGroupingReport = new
CachedHierarchical_Grouping();
3.
Transmettez l'instance de la classe utilitaire de gestion du cache au contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = cachedHierarchicalGroupingReport
crystalReportViewer.ReportSource = cachedHierarchicalGroupingReport;
4.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.2.4
Liaison &agrave; un rapport non incorpor&eacute; charg&eacute; dans
une classe utilitaire de gestion du cache
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
207
Emplacement des rapports
Les rapports se trouvent dans le r&eacute;pertoire de fichiers.
Description
Ce sc&eacute;nario de liaison de rapports est semblable au sc&eacute;nario Liaison &agrave; une classe de rapport incorpor&eacute; et mis en
cache [page 205]. La diff&eacute;rence tient au fait que dans ce sc&eacute;nario les rapports ne sont pas incorpor&eacute;s. Pour en
savoir plus sur les rapports incorpor&eacute;s, voir Utilisation de rapports incorpor&eacute;s ou non incorpor&eacute;s ?Comparaison
des rapports incorpor&eacute;s et non incorpor&eacute;s [page 165]
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio est fourni avec deux fonctionnalit&eacute;s d'aide
&agrave; la mise en cache des rapports avec l'objet Cache ASP.NET :
●
Une structure int&eacute;gr&eacute;e de gestion de la mise en cache des rapports qui d&eacute;tecte des rapports identiques
poss&eacute;dant des param&egrave;tres ou des informations de connexion uniques qui n&eacute;cessitent une cl&eacute; unique pour
chaque instance mise en cache.
●
Une interface, ICachedReport, qui identifie les classes utilitaire de gestion du cache aupr&egrave;s de la structure
de gestion de la mise en cache des rapports.
Dans Liaison &agrave; une classe de rapport incorpor&eacute; et mis en cache [page 205], vous en avez appris davantage sur la
classe Cached[NomRapport] qui est automatiquement g&eacute;n&eacute;r&eacute;e lorsqu'un rapport est incorpor&eacute; dans un projet.
Vous pouvez toutefois cr&eacute;er manuellement une classe utilitaire de gestion du cache pour g&eacute;rer les rapports non
incorpor&eacute;s. Pour obtenir un exemple de code, voir la section Impl&eacute;mentation ci-dessous.
Utilisation de la mise en cache
La mise en cache doit &ecirc;tre utilis&eacute;e dans des cas particuliers et limit&eacute;s car elle peut &quot;surconsommer&quot; des
ressources syst&egrave;me lorsqu'elle n'est pas g&eacute;r&eacute;e avec pr&eacute;caution.
Avantages
●
Con&ccedil;u pour le partage : id&eacute;al pour stocker les rapports qui pr&eacute;sentent un fort potentiel de partage et peu de
modifications &agrave; apporter aux param&egrave;tres ou aux informations de connexion.
●
Acc&egrave;s aux donn&eacute;es optimis&eacute; : si les rapports &agrave; fort potentiel de partage sont tr&egrave;s volumineux ou s'ils
contiennent une requ&ecirc;te tellement complexe que l'extraction prend plusieurs minutes, la classe utilitaire de
gestion du cache permet d'acc&eacute;der plus rapidement aux donn&eacute;es.
208
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Inconv&eacute;nients
●
Charge du serveur : les rapports stock&eacute;s dans l'objet Cache ASP.NET peuvent &quot;surcharger&quot; les ressources
m&eacute;moire sur le serveur.
●
Probl&egrave;mes de persistance : le cache poss&egrave;de certaines d&eacute;pendances qui permettent la v&eacute;rification des
modifications apport&eacute;es &agrave; l'instance d'un rapport et la remise en cache de cette instance. Toutefois, si la base
de donn&eacute;es est modifi&eacute;e, l'instance du rapport stock&eacute;e dans l'objet Cache n'est pas actualis&eacute;e en
cons&eacute;quence.
●
Consommation de ressources : un rapport dont les param&egrave;tres sont appel&eacute;s fr&eacute;quemment &agrave; l'aide de
diff&eacute;rentes cha&icirc;nes de param&egrave;tre(particuli&egrave;rement si l'un de ces param&egrave;tres correspond &agrave; l'ID utilisateur)
implique &agrave; chaque fois la mise en cache d'un nouveau rapport. Ce processus consomme des ressources
syst&egrave;me. Si le rapport ne pr&eacute;sente pas un fort potentiel de partage, affectez son instance &agrave; un objet Session.
Informations associ&eacute;es
Liaison avec le composant ReportDocument [page 214]
Mod&egrave;le d'objet ReportDocument [page 37]
Session et persistance du mod&egrave;le d'objet ReportDocument [page 57]
1.4.5.3.2.4.1
Pour mettre en cache une classe de rapport non
incorpor&eacute;, puis la lier au contr&ocirc;le CrystalReportViewer
Pr&eacute;requis
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Recherchez le fichier World Sales Report.rpt dans le sous-r&eacute;pertoire General Business.
2.
Copiez dans le Presse-papiers le chemin d'acc&egrave;s complet au r&eacute;pertoire de fichiers en incluant World Sales
Report.rpt.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
209
3.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), d&eacute;clarez une variable cha&icirc;ne reportPath et affectez-lui une cha&icirc;ne contenant le chemin
d'acc&egrave;s au fichier World Sales Report copi&eacute; lors de l'&eacute;tape pr&eacute;c&eacute;dente.
Dim reportPath As String = _
&quot;C:\Program Files\Microsoft Visual Studio 9.0\&quot; _
&amp; &quot;Crystal Reports\Samples\En\Reports\General Business\&quot; _
&amp; &quot;World Sales Report.rpt&quot;
string reportPath =
&quot;C:\\Program Files\\Microsoft Visual Studio 9.0\\&quot;
+ &quot;Crystal Reports\\Samples\\En\\Reports\\General Business\\&quot;
+ &quot;World Sales Report.rpt&quot;;
4.
D&eacute;clarez et instanciez la classe NonEmbeddedReportCacher, puis transmettez-lui la variable cha&icirc;ne
reportFile.
Remarque
Pour apprendre &agrave; cr&eacute;er la classe NonEmbeddedReportCacher, voir la proc&eacute;dure d&eacute;crite juste apr&egrave;s cette
proc&eacute;dure.
Dim myNonEmbeddedReportCacher As NonEmbeddedReportCacher = _New
NonEmbeddedReportCacher(reportFile)
NonEmbeddedReportCacher nonEmbeddedReportCacher = new
NonEmbeddedReportCacher(reportFile);
5.
Affectez l'instance de la classe utilitaire de gestion du cache &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = myNonEmbeddedReportCacher
crystalReportViewer.ReportSource = nonEmbeddedReportCacher;
1.4.5.3.2.4.2
Pour cr&eacute;er la classe utilitaire de gestion du
cache NonEmbeddedReportCacher
Proc&eacute;dure
1.
Cr&eacute;ez dans votre projet une classe nomm&eacute;e NonEmbeddedReportCacher.
Public Class NonEmbeddedReportCacher
End Class
210
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
using System;
namespace MyWebApplication
{
public class NonEmbeddedReportCacher
{
public NonEmbeddedReportCacher()
{
}
}
}
2.
Ajoutez l'interface ICachedReport &agrave; la signature de la classe.
Public Class NonEmbeddedReportCacher
Implements ICachedReport
public class NonEmbeddedReportCacher : ICachedReport
3.
Ajoutez trois instructions &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] au d&eacute;but de la classe.
Imports CrystalDecisions.Shared
Imports CrystalDecisions.ReportSource
Imports CrystalDecisions.CrystalReports.Engine
using CrystalDecisions.Shared;
using CrystalDecisions.ReportSource;
using CrystalDecisions.CrystalReports.Engine;
4.
Dans la classe, d&eacute;clarez deux instances de niveau classe : une instance cha&icirc;ne nomm&eacute;e reportFileName et
une instance de ReportDocument nomm&eacute;e nonEmbeddedReportDocument.
Private reportFileName As String
Private nonEmbeddedReportDocument As ReportDocument
private string reportFileName;
private ReportDocument nonEmbeddedReportDocument;
5.
Configurez le constructeur de mani&egrave;re &agrave; ce qu'il accepte une cha&icirc;ne reportFileName et dans le constructeur,
attribuez cette cha&icirc;ne &agrave; la variable de classe reportFileName.
Public Sub New(ByVal reportFileName As String)
Me.reportFileName = reportFileName
End Sub
public NonEmbeddedReportCacher(string reportFileName)
{
this.reportFileName = reportFileName;
}
Les &eacute;tapes suivantes impl&eacute;mentent les propri&eacute;t&eacute;s et les m&eacute;thodes requises par l'interface :
○
IsCacheable
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
211
6.
○
ShareDBLogonInfo
○
CacheTimeOut
○
CreateReport()
○
GetCustomizedCacheKey(requ&ecirc;te RequestContext)
Cr&eacute;ez la propri&eacute;t&eacute; IsCacheable qui renvoie la valeur True.
Public Overridable Property IsCacheable() As Boolean Implements
ICachedReport.IsCacheable
Get
Return True
End Get
Set(ByVal Value As Boolean)
End Set
End Property
public virtual Boolean IsCacheable
{
get
{
return true;
}
set
{
}
}
7.
Cr&eacute;ez la propri&eacute;t&eacute; ShareDBLogonInfo qui renvoie la valeur False.
Public Overridable Property ShareDBLogonInfo() As Boolean Implements
ICachedReport.ShareDBLogonInfo
Get
Return False
End Get
Set(ByVal Value As Boolean)
End Set
End Property
public virtual Boolean ShareDBLogonInfo
{
get
{
return false;
}
set
{
}
}
8.
Cr&eacute;ez la propri&eacute;t&eacute; CacheTimeOut qui renvoie une valeur de constante depuis la classe
CachedReportConstants.
Public Overridable Property CacheTimeOut() As TimeSpan Implements
ICachedReport.CacheTimeOut
Get
Return CachedReportConstants.DEFAULT_TIMEOUT
End Get
Set(ByVal Value As TimeSpan)
212
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
End Set
End Property
public virtual TimeSpan CacheTimeOut
{
get
{
return CachedReportConstants.DEFAULT_TIMEOUT;
}
set
{
}
}
9.
Cr&eacute;ez la m&eacute;thode CreateReport(), qui renvoie un rapport non incorpor&eacute; charg&eacute; dans l'instance de niveau
classe ReportDocument.
Public Overridable Function CreateReport() As ReportDocument Implements
ICachedReport.CreateReport
nonEmbeddedReportDocument = New ReportDocument()
nonEmbeddedReportDocument.Load(reportFileName)
Return nonEmbeddedReportDocument
End Function
public virtual ReportDocument CreateReport()
{
nonEmbeddedReportDocument = new ReportDocument();
nonEmbeddedReportDocument.Load(reportFileName);
return nonEmbeddedReportDocument;
}
10. Cr&eacute;ez la m&eacute;thode GetCustomizedCacheKey() qui renvoie une valeur nulle.
Remarque
Le fait que cette m&eacute;thode renvoie une valeur nulle indique au SDK de SAP Crystal Reports .NET qu'il doit
g&eacute;rer la cl&eacute; de recherche du cache lui-m&ecirc;me. Vous avez &eacute;galement la possibilit&eacute; de cr&eacute;er et d'ajouter ici
votre propre m&eacute;thode de cl&eacute; de cache.
Public Overridable Function GetCustomizedCacheKey(ByVal request As
RequestContext) As String Implements ICachedReport.GetCustomizedCacheKey
Return Nothing
End Function
public virtual String GetCustomizedCacheKey(RequestContext request)
{
return null;
}
11. Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
213
1.4.5.3.2.5
Liaison avec le composant ReportDocument
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
Emplacement des rapports
Les rapports se trouvent dans le r&eacute;pertoire de fichiers.
Description
Le composant ReportDocument se trouve dans la bo&icirc;te &agrave; outils et fournit une m&eacute;thode bas&eacute;e sur une interface
utilisateur graphique pour g&eacute;n&eacute;rer un code d'instanciation de classe du rapport dans la classe code-behind. Vous
pouvez sp&eacute;cifier un rapport non incorpor&eacute;, un rapport incorpor&eacute; ou un rapport incorpor&eacute; mis en cache.
Remarque
La bo&icirc;te de dialogue utilise les anciens termes &quot;rapport non typ&eacute;&quot; pour d&eacute;signer un rapport non incorpor&eacute; et
&quot;rapport fortement typ&eacute;&quot; pour d&eacute;signer un rapport incorpor&eacute;.
En utilisant cette bo&icirc;te de dialogue pour ajouter ReportDocument en tant que composant, la classe
ReportDocument (ou la classe wrapper du rapport incorpor&eacute;) est instanci&eacute;e dans la r&eacute;gion g&eacute;n&eacute;r&eacute;e
automatiquement de la classe code-behind. En m&ecirc;me temps, une ic&ocirc;ne appara&icirc;t dans la barre d'&eacute;tat des
composants de l'environnement de d&eacute;veloppement int&eacute;gr&eacute; pour repr&eacute;senter visuellement la classe de rapport
instanci&eacute;e.
Remarque
Il est inutile d'ajouter un composant ReportDocument &agrave; votre projet pour instancier le rapport dans la classe
code-behind. Pour mieux contr&ocirc;ler votre code, il est recommand&eacute; d'ajouter le code d'instanciation de classe
manuellement.
Informations associ&eacute;es
Mod&egrave;le d'objet ReportDocument [page 37]
214
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.5.3.2.6
Sc&eacute;narios de liaison ReportDocument utilisant
les services Crystal (VS .NET 2003)
Les services Crystal offrent un acc&egrave;s pratique aux rapports dans Visual Studio 2003. Cette fonctionnalit&eacute; n'est
pas disponible dans Visual Studio 2005 ou Visual Studio 2008. Une fois SAP Crystal Reports et les services
Crystal install&eacute;s, Services Crystal appara&icirc;t sous la forme d'un sous-nœud situ&eacute; sous chaque serveur du nœud
Serveurs de l'Explorateur de serveurs. Le nœud Services Crystal peut &ecirc;tre d&eacute;velopp&eacute; pour afficher des listes de
rapports situ&eacute;s &agrave; divers emplacements :
●
R&eacute;pertoire de fichiers local sur votre disque dur
●
Report Application Server (RAS)
●
Plateforme SAP BusinessObjects Business Intelligence (BIP)
Vous pouvez placer n'importe quel rapport r&eacute;pertori&eacute; dans ces listes dans un Web Form ou un Windows Form &agrave;
l'aide d'une op&eacute;ration glisser-d&eacute;placer.
Selon la version de SAP Crystal Reports que vous avez install&eacute;e et les licences suppl&eacute;mentaires que vous avez
&eacute;ventuellement acquises pour le RAS (Report Application Server) ou la plateforme SAP BusinessObjects Business
Intelligence, les services Crystal fournissent g&eacute;n&eacute;ralement deux nœuds qui peuvent &ecirc;tre d&eacute;velopp&eacute;s. Le tableau
situ&eacute; dans la section suivante d&eacute;crit les conditions requises pour acc&eacute;der &agrave; un nœud particulier.
Remarque
Certaines versions de la plateforme SAP BusinessObjects Business Intelligence ne comprennent pas la prise en
charge des services Crystal. Pour en savoir plus, consultez la documentation relative &agrave; la plateforme SAP
BusinessObjects Business Intelligence.
Il se peut que vous deviez ajuster vos param&egrave;tres de pare-feu afin d'acc&eacute;der au CMS de la plateforme SAP
BusinessObjects Business Intelligence. Le port par d&eacute;faut pour le CMS est 6400. Contactez votre administrateur
syst&egrave;me pour plus d'informations sur l'adresse r&eacute;seau et les param&egrave;tres de port de votre syst&egrave;me de plateforme
SAP BusinessObjects Business Intelligence. Pour plus d'informations sur la personnalisation des ports, voir le
Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
Classes wrapper
Lorsque vous faites glisser un rapport depuis les services Crystal vers un Web Form ou un Windows Form, cela
cr&eacute;e une instance de classe wrapper qui r&eacute;f&eacute;rence le rapport dans la r&eacute;gion du code de la classe code-behind
g&eacute;n&eacute;r&eacute; par le Web Form ou Windows Form.
Remarque
Le type de classe wrapper varie selon les versions de SAP Crystal Reports. Voir le tableau ci-dessous.
Les services Crystal r&eacute;pertori&eacute;s dans le tableau ci-dessous exposent les types de la classe wrapper
ReportDocument.
Ces deux services Crystal sont fournis avec SAP Crystal Reports 10. Ils fournissent des groupes de rapports pris
en charge depuis un serveur RAS g&eacute;r&eacute; ou non g&eacute;r&eacute;. ReportDocument correspond d&eacute;sormais &agrave; la classe wrapper
(depuis SAP Crystal Reports 9).
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
215
Classe wrapper ex&shy; Nom du nœud sous
pos&eacute;e par le biais
les services Crystal
des services Crystal
Versions de
SAP Crystal Re&shy;
ports
Description
Conditions requises
pour acc&eacute;der au
nœud
ReportDocument
Report Application
Server
SAP Crystal Re&shy;
ports 10
Expose les rapports Installez un serveur
situ&eacute;s sur un serveur RAS non g&eacute;r&eacute;.
RAS charg&eacute; dans Re&shy;
portDocument. Pour
en savoir plus, voir
Liaison au Report
Application Server
(SAP Crystal Re&shy;
ports 10 et versions
ult&eacute;rieures) [page
216].
ReportDocument
Crystal Enterprise
SAP Crystal Re&shy;
ports 10
Expose les rapports Installez Crystal En&shy;
situ&eacute;s sur le serveur terprise.
RAS g&eacute;r&eacute; charg&eacute;
dans ReportDocu&shy;
ment. Pour en savoir
plus, voir Liaison &agrave;
Crystal Enterprise
(SAP Crystal Re&shy;
ports 10 et versions
ult&eacute;rieures) [page
219].
Les pr&eacute;c&eacute;dentes versions des services Crystal exposent des types de classes wrapper qui n'utilisent pas le
mod&egrave;le d'objet ReportDocument. Elles d&eacute;pendent donc du mod&egrave;le d'objet limit&eacute; fourni par le contr&ocirc;le
CrystalReportViewer. Pour en savoir plus, voir Sc&eacute;narios de liaison CrystalReportViewer avec les services Crystal
[page 180].
1.4.5.3.2.6.1
Liaison au Report Application Server
(SAP Crystal Reports 10 et versions ult&eacute;rieures)
Remarque
Les fonctionnalit&eacute;s d&eacute;crites dans cette page ne sont pas disponibles dans SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio mais le sont dans l'une des versions mises &agrave; niveau.
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
216
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Emplacement des rapports
Les rapports se trouvent sur le serveur RAS non g&eacute;r&eacute;. Ils sont inclus dans la classe ReportDocument.
Pr&eacute;sentation des services Crystal
Ce sc&eacute;nario de liaison de rapports s'applique aux rapports accessibles depuis le nœud du serveur de services
Crystal dans l'Explorateur de serveurs.
Cette section pr&eacute;sente le sous-nœud Report Application Server des services Crystal dans
SAP Crystal Reports Developer.
[NOMSERVEUR]
●
Services Crystal
○
Report Application Server
Description
Le sous-nœud Report Application Server acc&egrave;de aux rapports qui ont &eacute;t&eacute; expos&eacute;s par un serveur RAS non g&eacute;r&eacute;,
puis les affiche. Le nœud RAS fonctionne uniquement lorsque le serveur RAS non g&eacute;r&eacute; a &eacute;t&eacute; install&eacute; sur votre
ordinateur de d&eacute;veloppement.
Lorsque vous d&eacute;placez un rapport par glisser-d&eacute;poser depuis le nœud Services Crystal &gt; Plateforme SAP
BusinessObjects Business Intelligence vers un Web Form ou un Windows Form, une instance de ReportDocument
est g&eacute;n&eacute;r&eacute;e. La classe ReportDocument fonctionne comme une classe wrapper. Son r&ocirc;le consiste &agrave; repr&eacute;senter le
rapport transmis depuis le serveur RAS non g&eacute;r&eacute;.
Avantages
●
Acc&egrave;s simple : les rapports situ&eacute;s sur le serveur RAS non g&eacute;r&eacute; peuvent &ecirc;tre facilement visualis&eacute;s dans une
arborescence et d&eacute;plac&eacute;s &agrave; l'aide d'une simple op&eacute;ration glisser dans un Web Form.
●
Interaction par programmation &eacute;tendue : fournit un acc&egrave;s au puissant mod&egrave;le d'objet ReportDocument. La
classe wrapper dans cette version est ReportDocument. Il s'agit de la premi&egrave;re version des Services Crystal
donnant acc&egrave;s au mod&egrave;le d'objet ReportDocument.
Inconv&eacute;nients
●
Codage moins direct : le codage des rapports RAS est moins direct que lorsqu'il est effectu&eacute; &agrave; l'aide du
mod&egrave;le d'objet ReportClientDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
217
Informations associ&eacute;es
Liaison &agrave; Crystal Enterprise (SAP Crystal Reports 10 et versions ult&eacute;rieures) [page 219]
Mod&egrave;le d'objet ReportDocument [page 37]
Utilisation des services Crystal [page 84]
1.4.5.3.2.6.1.1
Pour utiliser les services Crystal &gt; Report
Application Server
Pr&eacute;requis
●
SAP Crystal Reports 10 ou une version ult&eacute;rieure doit &ecirc;tre install&eacute;e et en cours de fonctionnement.
●
Le serveur RAS non g&eacute;r&eacute; doit &ecirc;tre install&eacute; et en cours de fonctionnement.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans Visual Studio, ouvrez l'Explorateur de serveurs.
2.
D&eacute;veloppez le nœud Services Crystal, puis le nœud Report Application Server.
3.
S&eacute;lectionnez un rapport dans l'arborescence Report Application Server, puis faites-le glisser dans votre
Web Form ou votre Windows Form.
En mode Design, un objet reportDocument1 s'affiche au bas du formulaire.
Remarque
Lorsqu'un rapport Report Application Server est plac&eacute; dans votre formulaire, une instance de la classe
ReportDocument est ajout&eacute;e &agrave; la zone Code g&eacute;n&eacute;r&eacute; par le concepteur de votre formulaire.
Lorsqu'une classe qui h&eacute;rite de System.ComponentModel.Component (telle que ReportDocument) est
instanci&eacute;e et configur&eacute;e dans la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur, une ic&ocirc;ne correspondant &agrave; cette
classe instanci&eacute;e s'affiche au bas du formulaire en mode Design.
4.
Passez en mode code et ouvrez la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form ou Windows Form.
Remarque
Une classe ReportDocument a &eacute;t&eacute; instanci&eacute;e et configur&eacute;e dans cette r&eacute;gion.
218
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), affectez l'instance de ReportDocument &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = reportDocument1
crystalReportViewer.ReportSource = reportDocument1;
6.
Pour visualiser le rapport, g&eacute;n&eacute;rez et ex&eacute;cutez votre projet.
1.4.5.3.2.6.2
Liaison &agrave; Crystal Enterprise
(SAP Crystal Reports 10 et versions ult&eacute;rieures)
Remarque
Les fonctionnalit&eacute;s d&eacute;crites dans cette page ne sont pas disponibles dans SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio mais le sont dans l'une des versions mises &agrave; niveau.
Mod&egrave;le d'objet
Ce sc&eacute;nario de liaison de rapports utilise le mod&egrave;le d'objet ReportDocument.
Emplacement des rapports
Les rapports se trouvent sur le serveur RAS g&eacute;r&eacute;. Ils sont inclus dans la classe ReportDocument.
Pr&eacute;sentation des services Crystal
Ce sc&eacute;nario de liaison de rapports s'applique aux rapports accessibles depuis le nœud du serveur de services
Crystal dans l'Explorateur de serveurs.
Cette section pr&eacute;sente le sous-nœud de la plateforme SAP BusinessObjects Business Intelligence des services
Crystal dans SAP Crystal Reports Developer.
[NOMSERVEUR]
●
Services Crystal
○
Crystal Enterprise
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
219
Description
Le sous-nœud de la plateforme SAP BusinessObjects Business Intelligence acc&egrave;de aux rapports qui ont &eacute;t&eacute;
fournis par un serveur RAS g&eacute;r&eacute; dans la plateforme SAP BusinessObjects Business Intelligence, puis les affiche.
Le nœud Services Crystal &gt; Plateforme SAP BusinessObjects Business Intelligence fournit les rapports de Crystal
Enterprise via le serveur RAS g&eacute;r&eacute;. Le nœud de la plateforme SAP BusinessObjects Business Intelligence
fonctionne, mais si la plateforme SAP BusinessObjects Business Intelligence n'a pas &eacute;t&eacute; install&eacute;e sur l'ordinateur
de d&eacute;veloppement, acc&eacute;dez aux propri&eacute;t&eacute;s de ce nœud et d&eacute;finissez le nom du serveur de la plateforme SAP
BusinessObjects Business Intelligence sur le r&eacute;seau.
Lorsque vous d&eacute;placez un rapport par glisser-d&eacute;poser depuis le nœud Services Crystal &gt; Plateforme SAP
BusinessObjects Business Intelligence vers un Web Form ou un Windows Form, une instance de ReportDocument
est g&eacute;n&eacute;r&eacute;e. La classe ReportDocument fonctionne comme une classe wrapper. Son r&ocirc;le consiste &agrave; repr&eacute;senter le
rapport transmis depuis le serveur RAS dans Crystal Enterprise.
Avantages
●
Acc&egrave;s facile : les rapports situ&eacute;s sur le serveur RAS dans Crystal Enterprise sont facilement accessibles &agrave;
partir d'une application Web.
●
Interaction par programmation &eacute;tendue : fournit un acc&egrave;s au puissant mod&egrave;le d'objet ReportDocument. La
classe wrapper dans cette version est ReportDocument. C'est la premi&egrave;re version des services Crystal qui
donne acc&egrave;s au mod&egrave;le d'objet ReportDocument.
Inconv&eacute;nients
●
Codage moins direct : le codage des rapports RAS est moins direct que lorsqu'il est effectu&eacute; &agrave; l'aide du
mod&egrave;le d'objet ReportClientDocument.
Informations associ&eacute;es
Utilisation des services Crystal [page 84]
1.4.5.3.2.6.2.1
Pour utiliser les Services
Crystal &gt; Crystal Enterprise
Pr&eacute;requis
●
220
SAP Crystal Reports 10 ou XI doit &ecirc;tre install&eacute; et en cours de fonctionnement.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans Visual Studio, ouvrez l'Explorateur de serveurs.
2.
D&eacute;veloppez le nœud Services Crystal, puis le nœud Crystal Enterprise.
3.
S&eacute;lectionnez un rapport dans l'arborescence Crystal Enterprise, puis faites-le glisser dans votre formulaire.
En mode Design, un objet reportDocument1 s'affiche au bas du formulaire.
Remarque
Lorsqu'un rapport Crystal Enterprise est plac&eacute; dans votre formulaire, une instance de la classe
ReportDocument est ajout&eacute;e &agrave; la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur de votre formulaire.
Lorsqu'une classe qui h&eacute;rite de System.ComponentModel.Component (telle que ReportDocument) est
instanci&eacute;e et configur&eacute;e dans la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur, une ic&ocirc;ne correspondant &agrave; cette
classe instanci&eacute;e s'affiche au bas du formulaire en mode Design.
4.
Passez en mode code et ouvrez la r&eacute;gion du code g&eacute;n&eacute;r&eacute; par le Concepteur Web Form ou Windows Form.
Une classe ReportDocument a &eacute;t&eacute; instanci&eacute;e et configur&eacute;e dans cette r&eacute;gion.
5.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), affectez l'instance ReportDocument de &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = reportDocument1
crystalReportViewer.ReportSource = reportDocument1;
6.
G&eacute;n&eacute;rez puis ex&eacute;cutez votre projet Web pour visualiser le rapport.
1.4.5.4
Utilisation de rapports standard ou mis en cache ?
Lorsque vous envisagez de g&eacute;n&eacute;rer une application &agrave; l'aide du SDK de SAP Crystal Reports, l'un des points les
plus importants &agrave; d&eacute;terminer concerne l'utilisation de rapports standard ou de rapports mis en cache. Conna&icirc;tre
les principes fondamentaux du SDK qui influencent la mise en cache des rapports vous aidera &agrave; choisir la
structure la mieux adapt&eacute;e &agrave; votre projet SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
221
Qu'est-ce qu'un rapport mis en cache ?
Un rapport mis en cache est un objet de rapport qui a &eacute;t&eacute; stock&eacute; dans l'objet Cache ASP.NET dans le but
d'augmenter les performances et l'&eacute;volutivit&eacute;. SAP Crystal Reports fournit une structure particuli&egrave;re pour la mise
en cache des instances de ReportDocument. Cette structure met automatiquement en cache tout rapport qui
impl&eacute;mente l'interface ICachedReport.
Qu'est ce que l'objet Cache ASP.NET ?
Dans ASP comme dans ASP.NET, les objets de rapport sont plac&eacute;s dans Session ou dans Application sur le
serveur Web pour deux raisons :
1.
Pour garantir la persistance des objets de rapport au fur et &agrave; mesure que les pages sont recharg&eacute;es.
2.
Pour accro&icirc;tre l'&eacute;volutivit&eacute; et les performances en pla&ccedil;ant les rapports volumineux ou lents &agrave; se charger dans
la m&eacute;moire du serveur.
Dans ASP.NET, une version plus avanc&eacute;e de l'objet Application, appel&eacute;e Cache, a &eacute;t&eacute; introduite. Tout comme
l'objet Application, l'objet Cache rend les instances uniques d'un objet de rapport persistantes. Cache permet en
outre de rechercher des d&eacute;pendances bas&eacute;es sur des fichiers, des cl&eacute;s ou des d&eacute;lais. Ces d&eacute;pendances peuvent
arriver &agrave; expiration automatiquement et actualiser les objets de rapport stock&eacute;s dans le cache afin que le contenu
de ce dernier soit toujours actuel.
Les rapports stock&eacute;s dans Cache sont propres &agrave; l'utilisateur et &agrave; la session.
Remarque
Les termes &quot;objet Cache&quot; et &quot;Cache&quot;, tout comme les termes &quot;objet Session&quot; et &quot;Session&quot; ou &quot;objet
Application&quot; et &quot;Application&quot; sont utilis&eacute;s de mani&egrave;re interchangeable et signifient la m&ecirc;me chose. Le terme
&quot;objet&quot; souligne le fait qu'il s'agit d'objets qui garantissent la persistance et s'ex&eacute;cutent dans l'espace m&eacute;moire
du .NET Framework sur le serveur Web.
Comment les objets de rapport sont-ils plac&eacute;s dans l'objet Cache ASP.NET ?
Il existe deux mani&egrave;res de placer les objets de rapport dans l'objet Cache ASP.NET :
●
En affectant les objets de rapport &agrave; l'objet Cache &agrave; l'aide de la m&ecirc;me syntaxe que celle utilis&eacute;e pour une
affectation &agrave; l'objet Session ou Application (affectation explicite).
●
En instanciant une version du rapport qui impl&eacute;mente l'interface ICachedReport. Le moteur de rapport
recherche alors tous les objets de rapport qui impl&eacute;mentent cette interface et place automatiquement ces
objets dans l'objet Cache (affectation implicite).
Qu'est-ce que l'interface ICachedReport ?
L'interface ICachedReport marque d'un indicateur toutes les classes de rapport qui lui permettent de fonctionner
avec la structure de mise en m&eacute;moire cache de SAP Crystal Reports. Cette structure personnalis&eacute;e fournit une
222
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
couche sur l'objet Cache ASP.NET afin de r&eacute;pondre &agrave; des besoins sp&eacute;cifiques de mise en m&eacute;moire cache des
rapports.
L'interface ICachedReport comporte des signatures de m&eacute;thodes qui, lorsqu'elles sont impl&eacute;ment&eacute;es dans la
classe de rapport, indiquent &agrave; la structure comment mettre en cache cette classe.
Quelles sont les fonctionnalit&eacute;s de mise en m&eacute;moire cache fournies lors de
l'incorporation d'un rapport dans un projet Visual Studio ?
Lorsque vous cr&eacute;ez ou importez un rapport dans un projet Visual Studio, ce rapport est incorpor&eacute; dans le projet et
deux classes sont automatiquement g&eacute;n&eacute;r&eacute;es :
●
Une classe wrapper (du m&ecirc;me nom que le rapport).
Cette classe wrapper repr&eacute;sente le rapport dans le projet et h&eacute;rite de toutes les propri&eacute;t&eacute;s et m&eacute;thodes de
ReportDocument. Pour en savoir plus, voir Comparaison des rapports incorpor&eacute;s et non incorpor&eacute;s [page
165].
●
Une classe utilitaire de gestion du cache (nomm&eacute;e classe Cached[NomRapport]).
Cette classe g&egrave;re la mise en cache du rapport incorpor&eacute; &agrave; l'aide de l'objet Cache ASP.NET et de la structure
de mise en m&eacute;moire cache construite dans le SDK de SAP Crystal Reports.
La table suivante pr&eacute;sente les &eacute;l&eacute;ments g&eacute;n&eacute;r&eacute;s lors de l'ajout du rapport de regroupement hi&eacute;rarchique :
Nom des &eacute;l&eacute;ments
Correspond
Hierarchical Grouping.rpt
au rapport
Classe Hierarchical_Grouping
&agrave; la classe wrapper du rapport
Classe CachedHierarchical_Grouping
&agrave; la classe utilitaire de gestion du cache servant &agrave; g&eacute;rer
la mise en m&eacute;moire cache de la classe wrapper du rap&shy;
port
La classe wrapper de rapport et la classe utilitaire de gestion du cache ont des r&ocirc;les distincts :
●
La classe wrapper de rapport h&eacute;rite de ReportDocument et, par cons&eacute;quent, a acc&egrave;s au mod&egrave;le d'objet
ReportDocument dans son int&eacute;gralit&eacute;. Il s'agit de la classe principale que vous programmez pour interagir
avec le rapport.
●
La classe utilitaire de gestion du cache g&egrave;re et stocke les instances de la classe wrapper de rapport dans
l'objet Cache ASP.NET. Elle identifie les diff&eacute;rentes instances de la classe wrapper et &eacute;vite qu'elles ne
s'&eacute;crasent mutuellement dans le Cache. Par exemple, elle distingue les diff&eacute;rences g&eacute;n&eacute;r&eacute;es lorsque les
param&egrave;tres et les informations de connexion sont modifi&eacute;s. Pour cela, elle affecte une cl&eacute; unique &agrave; chaque
instance de la classe wrapper de rapport.
●
Pour s'identifier aupr&egrave;s de la fonction de mise en cache du .NET Framework de SAP Crystal Reports, la classe
utilitaire de gestion du cache impl&eacute;mente l'interface ICachedReport.
La classe wrapper de rapport et la classe utilitaire de gestion du cache sont toutes deux g&eacute;n&eacute;r&eacute;es dans le m&ecirc;me
fichier de classe. Pour les visualiser, cliquez avec le bouton droit de la souris sur le fichier de classe dans
l'Explorateur de solutions, puis s&eacute;lectionnez Afficher le code. Dans le fichier ouvert, le code correspondant &agrave; la
classe wrapper est affich&eacute; dans le haut du fichier et le code relatif &agrave; la classe utilitaire de gestion du cache est
affich&eacute; plus bas, &agrave; mi-fichier.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
223
Remarque
Pour apprendre &agrave; lier le contr&ocirc;le CrystalReportViewer &agrave; la classe utilitaire de gestion du cache, voir Liaison &agrave;
une classe de rapport incorpor&eacute; et mis en cache [page 205]. Pour cr&eacute;er votre propre classe utilitaire de gestion
du cache afin de la lier &agrave; des rapports non incorpor&eacute;s, voir Liaison &agrave; un rapport non incorpor&eacute; charg&eacute; dans une
classe utilitaire de gestion du cache [page 207].
Quand mettre les rapports en cache ?
Ne placez qu'un nombre restreint d'objets de rapport dans l'objet Cache ASP.NET. La plupart des objets de
rapport pr&eacute;sentent un faible potentiel de partage (en d'autres termes, ils ne sont pas utilis&eacute;s en tant que
ressources partag&eacute;es avec d'autres objets). Ils viendraient en quelque sorte &quot;encombrer&quot; le Cache. S'ils doivent
&ecirc;tre rendus persistants, placez plut&ocirc;t les objets de rapport dans l'objet Session de l'utilisateur.
Placez l'objet de rapport dans Cache ASP.NET uniquement si le rapport doit &ecirc;tre affich&eacute; &agrave; de nombreuses
reprises par le m&ecirc;me utilisateur au cours d'une session donn&eacute;e. Ceci est particuli&egrave;rement important si un objet de
rapport est tr&egrave;s volumineux ou s'il contient une requ&ecirc;te si complexe que l'extraction de ses donn&eacute;es prend
plusieurs minutes.
Informations associ&eacute;es
Liaison &agrave; une classe de rapport incorpor&eacute; et mis en cache [page 205]
1.4.5.5
Affichage d'un rapport au moment de la conception
SAP Crystal Reports vous permet d'afficher l'aper&ccedil;u d'un rapport au moment de la conception dans Visual Studio.
Lorsqu'un rapport est affect&eacute; &agrave; la propri&eacute;t&eacute; ReportSource dans la fen&ecirc;tre Propri&eacute;t&eacute;s, il s'affiche sous forme
d'aper&ccedil;u dans le Windows Form ou la page ASPX.
Les donn&eacute;es statiques, telles que les dates, images ou champs de texte, s'affichent comme au moment de
l'ex&eacute;cution. Les donn&eacute;es dynamiques, telles que les donn&eacute;es provenant d'une base de donn&eacute;es, peuvent utiliser
des valeurs artificielles &agrave; la place des donn&eacute;es de votre source de donn&eacute;es. Si votre rapport contient des donn&eacute;e
enregistr&eacute;es, celles-ci apparaissent dans l'aper&ccedil;u lors de la conception.
Le SAP Crystal Reports Designer incorpor&eacute; fournit des fonctionnalit&eacute;s d'affichage suppl&eacute;mentaires via l'onglet
Aper&ccedil;u. Lorsque vous affichez votre rapport dans l'onglet Aper&ccedil;u, SAP Crystal Reports tente d'extraire les
nouvelles donn&eacute;es de la source de donn&eacute;es sp&eacute;cifi&eacute;e. L'aper&ccedil;u au moment de la conception ne tente pas
d'extraire de donn&eacute;es. Il affiche les donn&eacute;es actuellement enregistr&eacute;es dans le rapport.
Remarque
L'onglet Aper&ccedil;u n'est pas disponible dans le SAP Crystal Reports Designer pour Visual Studio .NET 2003
incorpor&eacute;.
224
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Onglet Aper&ccedil;u [page 658]
1.4.6
Personnalisation du contr&ocirc;le CrystalReportViewer
Le contr&ocirc;le CrystalReportViewer permet de lier et d'afficher des rapports dans le .NET Framework. Le contr&ocirc;le
CrystalReportViewer par d&eacute;faut inclut des &eacute;l&eacute;ments d'interface utilisateur pour vous aider &agrave; afficher, enregistrer
et parcourir un rapport.
En fonction de votre application, vous pouvez modifier certains &eacute;l&eacute;ments du contr&ocirc;le par d&eacute;faut.
SAP Crystal Reports vous permet de personnaliser l'aspect et la convivialit&eacute; du visualiseur dans votre application
de diff&eacute;rentes mani&egrave;res, notamment :
●
La barre d'outils CrystalReportViewer peut &ecirc;tre supprim&eacute;e du visualiseur.
●
Les boutons de la barre d'outils CrystalReportViewer peuvent &ecirc;tre ajout&eacute;s ou supprim&eacute;s par programmation.
●
Le contr&ocirc;le CrystalReportViewer prend en charge la personnalisation via CSS ou Th&egrave;mes.
Cette section explique comment modifier le contr&ocirc;le du visualiseur pour votre application.
Classes utilis&eacute;es pour la visualisation de rapports
●
CrystalDecisions.Windows.Forms.CrystalReportViewer
Fournit des propri&eacute;t&eacute;s, des m&eacute;thodes et des &eacute;v&eacute;nements permettant de modifier ou d'extraire les
informations sur la mani&egrave;re dont fonctionne et s'affiche le contr&ocirc;le CrystalReportViewer.
●
CrystalDecisions.Web.CrystalReportViewer
Fournit des propri&eacute;t&eacute;s, des m&eacute;thodes et des &eacute;v&eacute;nements permettant de modifier ou d'extraire les
informations sur la mani&egrave;re dont fonctionne et s'affiche le contr&ocirc;le CrystalReportViewer.
Informations associ&eacute;es
Comment utiliser les contr&ocirc;les visualiseur de rapports ? [page 43]
1.4.6.1
Indicateur de traitement de rapport
L'indicateur de traitement de rapport fournit une indication visuelle du temps de traitement sur votre site Web
SAP Crystal Reports. Lorsque le temps de traitement du rapport d&eacute;passe un seuil sp&eacute;cifi&eacute;, une bo&icirc;te de dialogue
appara&icirc;t pour fournir une indication sur le progr&egrave;s de l'action en cours.
Le texte de la bo&icirc;te de dialogue et le d&eacute;lai pr&eacute;alable &agrave; l'apparition de la bo&icirc;te de dialogue peuvent &ecirc;tre sp&eacute;cifi&eacute;s
dans le fichier Web.Config de votre site Web.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
225
Le texte par d&eacute;faut est : Veuillez patienter pendant le traitement du document.
Le d&eacute;lai par d&eacute;faut pr&eacute;alable &agrave; l'apparition de l'indicateur de traitement de rapport est de 200 ms.
Informations associ&eacute;es
Configuration du fichier Web.Config [page 20]
1.4.6.1.1
Personnalisation du texte de l'indicateur de
traitement de rapport
Contexte
Le texte du message de l'indicateur de traitement de rapport est configur&eacute; dans le fichier Web.Config de votre
site Web.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
Ouvrez votre fichier Web.config.
Si vous ne disposez pas de fichier Web.Config, cliquez sur
D&eacute;boguer
D&eacute;marrer le d&eacute;bogage
pour
d&eacute;boguer votre application. Visual Studio vous invite &agrave; cr&eacute;er un fichier Web.Config. Cliquez sur OK pour cr&eacute;er
le fichier.
3.
Dans votre fichier Web.Config, ajoutez le param&egrave;tre NameValueSectionHandler en tant que premier
enfant de l'&eacute;l&eacute;ment de configuration.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
L'&eacute;l&eacute;ment configSections doit &ecirc;tre l'unique premier enfant de l'&eacute;l&eacute;ment configuration. Si vous disposez
d&eacute;j&agrave; d'un &eacute;l&eacute;ment configSections pour SAP Crystal Reports, ajoutez l'&eacute;l&eacute;ment section de
CrystalReportViewer au nœud configSections existant.
4.
Ajoutez le param&egrave;tre processingIndicatorText directement apr&egrave;s l'&eacute;l&eacute;ment configSections.
&lt;businessObjects&gt;
&lt;crystalReports&gt;
226
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorText&quot; value=&quot;Thank you for waiting&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
5.
Remplacez le texte de l'attribut value par le message &agrave; afficher dans l'indicateur de traitement de rapport.
L'&eacute;l&eacute;ment processingIndicatorText contr&ocirc;le le texte affich&eacute; dans l'indicateur de traitement de rapport.
Le texte par d&eacute;faut est : Veuillez patienter pendant le traitement du document.
R&eacute;sultats
Le contr&ocirc;le CrystalReportViewer doit &agrave; pr&eacute;sent utiliser le message personnalis&eacute; dans l'indicateur de traitement de
rapport.
Exemple
Cet exemple r&eacute;duit le d&eacute;lai de l'indicateur de traitement de rapport &agrave; 20 ms et remplace le message affich&eacute; par
“Merci d'avoir patient&eacute;”.
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;configuration&gt;
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorText&quot; value=&quot;Thank you for waiting.&quot;/&gt;
&lt;add key=&quot;processingIndicatorDelay&quot; value=&quot;20&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
&lt;appSettings&gt;
&lt;add key=&quot;CrystalImageCleaner-AutoStart&quot; value=&quot;true&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Sleep&quot; value=&quot;60000&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Age&quot; value=&quot;120000&quot;/&gt;
&lt;/appSettings&gt;
&lt;connectionStrings/&gt;
&lt;system.web&gt;
&lt;compilation debug=&quot;true&quot;&gt;
&lt;assemblies&gt;
&lt;add assembly=&quot;CrystalDecisions.Web, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.Shared, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.ReportSource, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.CrystalReports.Engine,
Version=12.0.2000.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;/assemblies&gt;
&lt;/compilation&gt;
&lt;authentication mode=&quot;Windows&quot;/&gt;
&lt;httpHandlers&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
227
&lt;add verb=&quot;GET&quot; path=&quot;CrystalImageHandler.aspx&quot;
type=&quot;CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web,
Version=12.0.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304&quot;/&gt;
&lt;/httpHandlers&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;
1.4.6.1.2
Modification du d&eacute;lai pr&eacute;alable &agrave; l'apparition de
l'indicateur de traitement de rapport
Contexte
Le d&eacute;lai pr&eacute;alable &agrave; l'apparition de l'indicateur de traitement de rapport est configur&eacute; dans le fichier Web.Config
de votre site Web. L'&eacute;l&eacute;ment processingIndicatorDelay contr&ocirc;le le d&eacute;lai pr&eacute;alable &agrave; l'apparition de
l'indicateur de traitement de rapport.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
Ouvrez votre fichier Web.config.
Si vous ne disposez pas de fichier Web.Config, cliquez sur
D&eacute;boguer
D&eacute;marrer le d&eacute;bogage
pour
d&eacute;boguer votre application. Visual Studio vous invite &agrave; cr&eacute;er un fichier Web.Config. Cliquez sur OK pour cr&eacute;er
le fichier.
3.
Dans votre fichier Web.Config, ajoutez le param&egrave;tre NameValueSectionHandler en tant que premier
enfant de l'&eacute;l&eacute;ment de configuration.
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
L'&eacute;l&eacute;ment configSections doit &ecirc;tre l'unique premier enfant de l'&eacute;l&eacute;ment configuration. Si vous disposez
d&eacute;j&agrave; d'un &eacute;l&eacute;ment configSections pour SAP Crystal Reports, ajoutez l'&eacute;l&eacute;ment section de
CrystalReportViewer au nœud configSections existant.
4.
Ajoutez le param&egrave;tre processingIndicatorDelay directement apr&egrave;s l'&eacute;l&eacute;ment configSections.
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorDelay&quot; value=&quot;20&quot;/&gt;
&lt;/crystalReportViewer&gt;
228
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
5.
Remplacez le texte de l'attribut value par la dur&eacute;e qui doit s'&eacute;couler avant l'apparition de l'indicateur de
traitement de rapport.
La valeur est sp&eacute;cifi&eacute;e en millisecondes. Le fait de d&eacute;finir cette valeur sur 0 d&eacute;sactive l'indicateur de
traitement de rapport. La valeur par d&eacute;faut est de 200 ms.
Exemple
Cet exemple r&eacute;duit le d&eacute;lai de l'indicateur de traitement de rapport &agrave; 20 ms et remplace le message affich&eacute; par
“Merci d'avoir patient&eacute;”.
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;configuration&gt;
&lt;configSections&gt;
&lt;sectionGroup name=&quot;businessObjects&quot;&gt;
&lt;sectionGroup name=&quot;crystalReports&quot;&gt;
&lt;section name=&quot;crystalReportViewer&quot;
type=&quot;System.Configuration.NameValueSectionHandler&quot; /&gt;
&lt;/sectionGroup&gt;
&lt;/sectionGroup&gt;
&lt;/configSections&gt;
&lt;businessObjects&gt;
&lt;crystalReports&gt;
&lt;crystalReportViewer&gt;
&lt;add key=&quot;processingIndicatorText&quot; value=&quot;Thank you for waiting.&quot;/&gt;
&lt;add key=&quot;processingIndicatorDelay&quot; value=&quot;20&quot;/&gt;
&lt;/crystalReportViewer&gt;
&lt;/crystalReports&gt;
&lt;/businessObjects&gt;
&lt;appSettings&gt;
&lt;add key=&quot;CrystalImageCleaner-AutoStart&quot; value=&quot;true&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Sleep&quot; value=&quot;60000&quot;/&gt;
&lt;add key=&quot;CrystalImageCleaner-Age&quot; value=&quot;120000&quot;/&gt;
&lt;/appSettings&gt;
&lt;connectionStrings/&gt;
&lt;system.web&gt;
&lt;compilation debug=&quot;true&quot;&gt;
&lt;assemblies&gt;
&lt;add assembly=&quot;CrystalDecisions.Web, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.Shared, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.ReportSource, Version=12.0.2000.0,
Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;add assembly=&quot;CrystalDecisions.CrystalReports.Engine,
Version=12.0.2000.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304&quot;/&gt;
&lt;/assemblies&gt;
&lt;/compilation&gt;
&lt;authentication mode=&quot;Windows&quot;/&gt;
&lt;httpHandlers&gt;
&lt;add verb=&quot;GET&quot; path=&quot;CrystalImageHandler.aspx&quot;
type=&quot;CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web,
Version=12.0.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304&quot;/&gt;
&lt;/httpHandlers&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
229
1.4.6.2 Prise en charge de plusieurs langues avec le contr&ocirc;le
CrystalReportViewer
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio inclut la prise en charge des clients Web et
Windows multilingues via une localisation dynamique.
La localisation dynamique permet aux utilisateurs d'afficher des info-bulles ainsi que d'autres contenus du
contr&ocirc;le CrystalReportViewer dans la langue de leur choix. Pour activer la localisation dynamique, vous devez
rendre disponible les fichiers de ressources de langue dans la langue souhait&eacute;e.
Informations associ&eacute;es
Tutoriel : Configuration de la prise en charge de client multilingue [page 590]
Dans ce tutoriel, vous allez apprendre &agrave; configurer la prise en charge de client multilingue dans un site Web ou
un projet Windows.
1.4.6.2.1
Fichiers de ressources de langue
Les fichiers de ressources de langue contiennent une s&eacute;rie de paires cl&eacute;s/valeurs qui fournissent le texte affich&eacute;
dans l'application. Pour chaque &eacute;l&eacute;ment de texte qui appara&icirc;t dans une application de rapport Crystal, il existe une
valeur correspondante dans le fichier de ressources de langue qui sp&eacute;cifie la mani&egrave;re dont doit appara&icirc;tre le texte
dans chaque langue.
Fichiers de ressources de langue
Sur le serveur Web ou le client Windows, vous pouvez acc&eacute;der aux ressources de langue du contr&ocirc;le
CrystalReportViewer &agrave; partir de deux sources diff&eacute;rentes :
●
●
230
Les fichiers DLL de ressources de langue par d&eacute;faut, comprenant les langues suivantes :
○
Anglais (en)
○
Fran&ccedil;ais (fr)
○
Allemand (de)
○
Espagnol (es)
○
Italien (it)
○
Japonais (jp)
○
Cor&eacute;en (ko)
○
Chinois simplifi&eacute; (zh-chs)
○
Chinois traditionnel (zh-cht)
Les fichiers de ressources de langue personnalis&eacute;es, qui sont cr&eacute;&eacute;s sous forme de cha&icirc;nes de texte, puis
compil&eacute;s en tant que fichiers DLL de ressources de langue personnalis&eacute;es.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Ressources neutres et non neutres
Les ressources de langue comprennent des ressources neutres et non neutres.
Les ressources neutres repr&eacute;sentent un param&egrave;tre de langue g&eacute;n&eacute;ral, tel que en (pour l'anglais), fr (pour le
fran&ccedil;ais) et jp (pour le japonais).
Les ressources non neutres repr&eacute;sentent une version de la langue qualifi&eacute;e par des crit&egrave;res suppl&eacute;mentaires, tels
que la r&eacute;gion : par exemple, de-AT pour Allemand (Autriche).
Ressources globales et locales
Les ressources de langue par d&eacute;faut sont install&eacute;es dans le GAC et sont donc toujours disponibles de mani&egrave;re
globale, mais les ressources de langue personnalis&eacute;e sont accessibles de mani&egrave;re globale ou locale.
Le dossier des ressources de langue peut &ecirc;tre stock&eacute; dans un emplacement central et partag&eacute; &agrave; partir de cet
emplacement ou bien il peut &ecirc;tre copi&eacute; dans un r&eacute;pertoire local de l'application Web ou Windows.
Lorsque les ressources de langue sont stock&eacute;es dans un emplacement central, on les appelle des ressources
globales. Dans ce sc&eacute;nario, l'application Web ou Windows doit &ecirc;tre inform&eacute;e de leur emplacement gr&acirc;ce aux
param&egrave;tres d'un fichier de configuration XML. Pour que le chargement d'une ressource globale s'effectue
correctement, le nom du dossier contenant les fichiers de la ressource doit correspondre aux param&egrave;tres
r&eacute;gionaux de la langue.
Si les ressources de langue sont copi&eacute;es dans le r&eacute;pertoire local, on les appelle des ressources locales. Dans ce
sc&eacute;nario, aucun fichier de configuration n'est n&eacute;cessaire. Pour que le chargement d'une ressource locale
s'effectue correctement, la culture des fichiers de ressource et le nom du dossier contenant les fichiers de
ressource doivent correspondre aux param&egrave;tres r&eacute;gionaux de langue.
Choix entre ressources globales et ressources locales
Choisissez de pr&eacute;f&eacute;rence les ressources globales lorsque les ressources doivent &ecirc;tre partag&eacute;es avec plusieurs
applications. Par exemple, l'utilisation des ressources globales est plus adapt&eacute;e &agrave; un serveur Web contenant
plusieurs sites Web requ&eacute;rant le partage d'un ensemble de ressources de langues &agrave; travers tous les sites Web.
Choisissez de pr&eacute;f&eacute;rence les ressources locales lorsque les ressources sont utilis&eacute;es par une seule application,
dont la large distribution requiert une configuration simple. Par exemple, l'utilisation des ressources locales est
plus adapt&eacute;e &agrave; une application Windows compos&eacute;e d'un seul dossier d'application destin&eacute; &agrave; une large distribution.
La plupart du temps, les applications Web sont plus adapt&eacute;es aux ressources globales et les applications
Windows sont plus adapt&eacute;es aux ressources locales.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
231
Quelle ressource est charg&eacute;e en premier ?
Si vous configurez des ressources globales et locales pour une application particuli&egrave;re, les ressources locales sont
prioritaires (elles sont charg&eacute;es en premier). Si vous souhaitez garantir l'utilisation des ressources globales,
v&eacute;rifiez que votre fichier de configuration est correct et supprimez le dossier de ressources locales.
Les ressources neutres et non neutres sont &eacute;galement influenc&eacute;es par l'ordre de chargement des ressources. Si
vous avez configur&eacute; des ressources neutres et non neutres pour une langue donn&eacute;e (telles que &quot;allemand
(Autriche)&quot; et &quot;allemand&quot;), les ressources non neutres sont v&eacute;rifi&eacute;es en premier.
Dans les deux cas, le sp&eacute;cifique pr&eacute;vaut sur le g&eacute;n&eacute;ral.
Affichage c&ocirc;t&eacute; client
Les facteurs suivants d&eacute;terminent la langue affich&eacute;e par l'application cliente au moment de l'ex&eacute;cution :
Dans une application Windows :
●
les param&egrave;tres r&eacute;gionaux de l'ordinateur de chaque utilisateur.
Dans un site Web :
●
les param&egrave;tres r&eacute;gionaux du serveur Web ;
●
les param&egrave;tres de langue du navigateur client ;
●
la propri&eacute;t&eacute; Culture que vous d&eacute;finissez sur une autre page ASPX.
1.4.6.2.2
Prise en charge des standards de codage de
caract&egrave;res Unicode et GB18030
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio inclut la prise en charge des caract&egrave;res
internationaux selon les standards de codage de caract&egrave;res suivants :
●
Unicode
●
GB18030
Pour comprendre comment SAP Crystal Reports prend en charge le codage de caract&egrave;res Unicode et GB18030,
vous devez conna&icirc;tre les trois diff&eacute;rentes vues de caract&egrave;res (r&eacute;pertoire de caract&egrave;res, caract&egrave;res sous forme de
points de code, caract&egrave;res sous forme de donn&eacute;es cod&eacute;es). Vous devez &eacute;galement conna&icirc;tre la relation entre les
points de code (terme plus pr&eacute;cis d&eacute;signant les caract&egrave;res cod&eacute;s) et les unit&eacute;s de code.
1.4.6.2.2.1
Vues des caract&egrave;res
Pour comprendre les standards de codage de caract&egrave;res, vous devez faire la distinction entre trois vues de
caract&egrave;res :
232
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Le r&eacute;pertoire de caract&egrave;res (la liste r&eacute;sum&eacute;e des caract&egrave;res).
●
Les caract&egrave;res sous forme de points de code avec valeurs scalaires.
●
Les caract&egrave;res sous forme de donn&eacute;es cod&eacute;es.
R&eacute;pertoire de caract&egrave;res (liste r&eacute;sum&eacute;e des caract&egrave;res)
Le r&eacute;pertoire de caract&egrave;res est une liste r&eacute;sum&eacute;e de plus d'un million de caract&egrave;res que l'on retrouve dans une
grande diversit&eacute; de scripts, notamment le latin, le cyrillique, le chinois, le cor&eacute;en, le japonais, l'h&eacute;breu et
l'aram&eacute;en. D'autres symboles tels que des notes de musique sont &eacute;galement inclus dans le r&eacute;pertoire de
caract&egrave;res.
Les standards de codage de caract&egrave;res Unicode et GB18030 poss&egrave;dent tous deux un r&eacute;pertoire de caract&egrave;res.
Lorsque de nouveaux caract&egrave;res sont ajout&eacute;s &agrave; un standard, l'autre standard ajoute &eacute;galement ces caract&egrave;res
pour maintenir la parit&eacute;.
Caract&egrave;res sous forme de points de code avec valeurs scalaires
Remarque
Cette seconde vue des caract&egrave;res s'applique uniquement au format Unicode, et non &agrave; GB18030.
Chaque caract&egrave;re du r&eacute;pertoire de caract&egrave;res est affect&eacute; &agrave; un point de code. Chaque point de code a une valeur
num&eacute;rique sp&eacute;cifique que l'on appelle valeur scalaire. La valeur scalaire est souvent exprim&eacute;e en hexad&eacute;cimaux.
Les points de code se situent dans un espace de code. Cet espace de code contient diff&eacute;rentes valeurs scalaires
qui se r&eacute;partissent sur deux plans :
●
Le plan BMP (Basic Multilingual Plane) (taille : 64k).
Dans le standard Unicode, l'expression en hexad&eacute;cimaux des valeurs de ce plan inf&eacute;rieur se situe entre U
+0000 et U+FFFF.
●
Plan SMP (Supplemental Multilingual Plane) (16 sections suppl&eacute;mentaires d'une taille de 64k).
Dans le standard Unicode, l'expression en hexad&eacute;cimaux des valeurs de ce plan sup&eacute;rieur se situe entre U
+10000 to U+10FFFF.
L'espace de code complet pour toutes les valeurs scalaires possibles est &eacute;gal &agrave; une taille de 17 * 64k
(1 088 000 valeurs possibles).
Caract&egrave;res sous forme de donn&eacute;es cod&eacute;es
Chaque format de codage convertit des caract&egrave;res du r&eacute;pertoire de caract&egrave;res en donn&eacute;es cod&eacute;es.
Dans le format GB18030, les donn&eacute;es cod&eacute;es sont directement d&eacute;riv&eacute;es du r&eacute;pertoire de caract&egrave;res : le concept
d'une valeur scalaire jouant le r&ocirc;le d'interm&eacute;diaire entre le r&eacute;pertoire de caract&egrave;res et les donn&eacute;es cod&eacute;es
s'applique uniquement &agrave; Unicode.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
233
Dans le format Unicode, les donn&eacute;es cod&eacute;es sont obtenues en appliquant un algorithme &agrave; la valeur scalaire.
Unicode d&eacute;finit trois formats de codage de caract&egrave;res :
●
UTF-8
●
UTF-16
●
UTF-32
1.4.6.2.2.2
code
Relation entre les points de code et les unit&eacute;s de
Pour comprendre comment SAP Crystal Reports, version d&eacute;veloppeur pour Visual Studio&lt;/nom_produit&gt; prend
en charge GB18030 et Unicode, il est important de comprendre la relation entre les points de code et les unit&eacute;s de
code.
Points de code et unit&eacute;s de code
Dans chaque format de codage, les points de code sont mis en correspondance avec une ou plusieurs unit&eacute;s de
code.
Une unit&eacute; de code est une unit&eacute; unique au sein de chaque format de codage. La taille de l'unit&eacute; de code est
&eacute;quivalente &agrave; la valeur en bits du format de codage concern&eacute; :
●
Une unit&eacute; de code UTF-8 est &eacute;gale &agrave; 8 bits.
●
Une unit&eacute; de code UTF-16 est &eacute;gale &agrave; 16 bits.
●
Une unit&eacute; de code UTF-32 est &eacute;gale &agrave; 32 bits.
●
Avec GB18030, une unit&eacute; de code est &eacute;gale &agrave; 8 bits.
Nombre d'unit&eacute;s de code dans chaque point de code
Le nombre d'unit&eacute;s de code devant &ecirc;tre mises en correspondance avec un point de code varie en fonction des
formats de codage :
●
UTF-8
Le codage UTF-8 comporte souvent plusieurs unit&eacute;s de code par point de code, car les unit&eacute;s de code sont
plus petites. Les points de code sont mis en correspondance avec une, deux, trois ou quatre unit&eacute;s de code.
●
UTF-16
Les unit&eacute;s de code UTF-16 sont deux fois plus volumineuses que les unit&eacute;s de code 8 bits. Par cons&eacute;quent, un
point de code dont la valeur scalaire est inf&eacute;rieure &agrave; U+10000 est cod&eacute; avec une seule unit&eacute; de code.
Pour les points de code dont la valeur scalaire est sup&eacute;rieure ou &eacute;gale &agrave; U+10000, deux unit&eacute;s de code sont
n&eacute;cessaires par point de code. Ces paires d'unit&eacute;s de code sont d&eacute;sign&eacute;es par un terme unique en codage
UTF-16 : &quot;paires de substitution Unicode&quot;.
234
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
La prise en charge des paires de substitution est abord&eacute;e ci-dessous.
●
UTF-32
L'unit&eacute; de code 32 bits utilis&eacute;e dans le codage UTF-32 est suffisamment volumineuse pour que chaque point
de code soit cod&eacute; avec une seule unit&eacute; de code.
●
GB18030
Le codage GB18030 comporte souvent plusieurs unit&eacute;s de code par point de code, car les unit&eacute;s de code sont
plus petites. Les points de code sont mis en correspondance avec une, deux ou quatre unit&eacute;s de code.
Prise en charge des paires de substitution Unicode
Certains scripts pris en charge par le standard Unicode contiennent des caract&egrave;res dont les points de code ont
une valeur scalaire sup&eacute;rieure ou &eacute;gale &agrave; U+10000. Dans le codage UTF-16, ces points de code sont cod&eacute;s &agrave; l'aide
de paires de substitution.
Il est important que les paires de substitution Unicode soient manipul&eacute;es correctement. Par exemple, lorsque
vous travaillez sur un texte dans une application utilisant le codage UTF-16, le curseur doit se d&eacute;placer sur chaque
point de code comme s'il s'agissait d'un caract&egrave;re texte unique lors de l'ajout, de la suppression ou de la s&eacute;lection
de caract&egrave;res &agrave; couper, copier ou coller.
1.4.6.2.2.3
Prise en charge de GB18030 via Unicode par
SAP Crystal Reports
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio&lt;/nom_produit&gt; ne prend pas
directement en charge le codage GB18030. Il acc&egrave;de au standard GB18030 par le biais de valeurs qui ont d&eacute;j&agrave; &eacute;t&eacute;
converties dans l'un des formats de codage Unicode.
Les conversions sont effectu&eacute;es par diff&eacute;rentes sources, notamment le .NET Framework, certains pilotes de
bases de donn&eacute;es et le syst&egrave;me d'exploitation Windows. Le texte est g&eacute;n&eacute;ralement stock&eacute; sur le disque dur au
format UTF-8, puis charg&eacute; en m&eacute;moire au format UTF-16. SAP Crystal Reports prend en charge les paires de
substitution Unicode en UTF-16.
Exemples de prise en charge du format GB18030 via Unicode
Les principaux cas de figure de prise en charge du format GB18030 via la conversion en Unicode sont les
suivants :
●
Bases de donn&eacute;es contenant des donn&eacute;es cod&eacute;es en GB18030
Les donn&eacute;es cod&eacute;es en GB18030 sont prises en charge uniquement lorsque le pilote de la base de donn&eacute;es
convertit les donn&eacute;es en UTF-16 au moment de leur extraction.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
235
Remarque
Microsoft SQL Server 2005 convertit les donn&eacute;es GB18030 en UTF-16 au moment de leur extraction. Pour
les autres serveurs, consultez le fournisseur de votre base de donn&eacute;es.
●
DataSets exposant les donn&eacute;es issues d'une source GB18030
Quelle que soit la source d'origine, les DataSets sont format&eacute;s en XML, lequel est encod&eacute; en UTF-8.
●
Services Web qui exposent des donn&eacute;es issues d'une source GB18030
Le texte envoy&eacute; ou re&ccedil;u via un service Web est d&eacute;j&agrave; converti en Unicode.
Sc&eacute;narios GB18030 non pris en charge
SAP Crystal Reports ne permet pas d'acc&eacute;der aux fichiers texte cod&eacute;s au format GB18030, ni de les importer.
Le fichier texte cod&eacute; au format GB18030 doit d'abord &ecirc;tre converti au format Unicode par un tiers afin que
SAP Crystal Reports puisse ensuite interagir avec le fichier texte cod&eacute; au format Unicode.
1.4.6.3
Gestion des &eacute;v&eacute;nements Error
Dans les pr&eacute;c&eacute;dentes versions de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, chaque
fois que vous utilisiez le contr&ocirc;le CrystalReportViewer, vous deviez intercepter toutes les &eacute;ventuelles
exceptions renvoy&eacute;es. Toute exception non intercept&eacute;e interrompait le traitement des pages et g&eacute;n&eacute;rait un
message d'erreur.
Afin d'&eacute;viter les interruptions et les erreurs, un nouvel &eacute;v&eacute;nement &agrave; &eacute;t&eacute; ajout&eacute; au contr&ocirc;le
CrystalReportViewer : l'&eacute;v&eacute;nement Error. Lorsque cet &eacute;v&eacute;nement est utilis&eacute;, des messages d'exception
s'affichent au d&eacute;but du contr&ocirc;le CrystalReportViewer sans entra&icirc;ner d'interruption.
1.4.6.3.1
Pour supprimer la page d'erreur &agrave; l'aide de la
m&eacute;thode d'&eacute;v&eacute;nement Error
Contexte
Pour supprimer l'exception renvoy&eacute;e, vous devez appeler la m&eacute;thode d'&eacute;v&eacute;nement Error et d&eacute;finir
ErrorEventArgs.Handled sur True dans le gestionnaire d'&eacute;v&eacute;nements.
Proc&eacute;dure
1.
236
Ajoutez la m&eacute;thode d'&eacute;v&eacute;nement Error &agrave; votre classe code-behind.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
D&eacute;finissez ErrorEventArgs.Handled sur True dans le gestionnaire d'&eacute;v&eacute;nements.
Exemple
Sub myCrystalReportViewer_Error(ByVal source As Object, ByVal e As
CrystalDecisions.Web.ErrorEventArgs)
e.Handled = True
End Sub
void crystalReportViewer_Error(object source,
CrystalDecisions.Web.ErrorEventArgs e)
{
e.Handled = true;
}
1.4.6.4 Personnalisation du contr&ocirc;le CrystalReportViewer
avec la CSS
L'apparence visuelle du contr&ocirc;le CrystalReportViewer est cr&eacute;&eacute;e gr&acirc;ce &agrave; des graphiques et des feuilles de style en
cascade (CSS).
La feuille de style, nomm&eacute;e default.css, est stock&eacute;e dans un sous-r&eacute;pertoire du r&eacute;pertoire virtuel du
visualiseur nomm&eacute; css.
Remarque
Dans Visual Studio 2005 et versions ult&eacute;rieures (ainsi que dans ASP.NET version 2.0), l'aspect des contr&ocirc;les
visuels peut &ecirc;tre g&eacute;r&eacute; par un nouvel outil appel&eacute; Th&egrave;mes. Les th&egrave;mes peuvent &ecirc;tre appliqu&eacute;s au contr&ocirc;le
CrystalReportViewer afin de garantir la coh&eacute;rence de l'aspect des contr&ocirc;les au sein d'une m&ecirc;me page ou dans
l'int&eacute;gralit&eacute; d'un site Web.
Informations associ&eacute;es
Personnalisation du contr&ocirc;le CrystalReportViewer avec Th&egrave;mes [page 238]
Bo&icirc;te de dialogue D&eacute;finir la classe CSS [page 953]
Mise en forme de rapports &agrave; l'aide de feuilles de style en cascade [page 743]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
237
1.4.6.4.1
Personnalisation de la CSS pour le contr&ocirc;le
CrystalReportViewer
Contexte
Cette feuille de style est accessible via la propri&eacute;t&eacute; CssFileName du contr&ocirc;le CrystalReportViewer et peut
&ecirc;tre visualis&eacute;e dans la fen&ecirc;tre Propri&eacute;t&eacute;s lorsque leCrystalReportViewer contr&ocirc;le est s&eacute;lectionn&eacute; en mode
Design.
Proc&eacute;dure
1.
Cr&eacute;ez un site Web contenant un contr&ocirc;le CrystalReportViewer et un rapport Crystal.
2.
Compilez et ex&eacute;cutez le projet au moins une fois pour visualiser le contr&ocirc;le CrystalReportViewer avec ses
param&egrave;tres de style par d&eacute;faut, puis quittez le mode d&eacute;bogage.
3.
Ouvrez la page Default.aspx en mode Design.
4.
Cliquez une fois sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
5.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, localisez le chemin d'acc&egrave;s au r&eacute;pertoire du fichier default.css dans la propri&eacute;t&eacute;
CssFileName.
6.
Dans l'Explorateur Windows, localisez ce fichier et copiez-le dans le r&eacute;pertoire de votre site Web.
7.
Renommez le fichier en custom.css.
8.
Modifiez la propri&eacute;t&eacute; CssFileName de sorte qu'elle pointe sur le r&eacute;pertoire du site Web et sur le fichier
custom.css.
9.
Recompilez votre projet et assurez-vous que le contr&ocirc;le CrystalReportViewer voit le fichier custom.css dans le
r&eacute;pertoire de votre site Web local.
10. Quittez le mode d&eacute;bogage.
11. Ouvrez le fichier custom.css, puis modifiez la feuille de style.
12. Recompilez le projet et v&eacute;rifiez que vos modifications ont &eacute;t&eacute; appliqu&eacute;es au contr&ocirc;le CrystalReportViewer.
1.4.6.5 Personnalisation du contr&ocirc;le CrystalReportViewer
avec Th&egrave;mes
Th&egrave;mes est un outil qui permet de donner un aspect et une convivialit&eacute; identique &agrave; tous les contr&ocirc;les visuels d'une
page (ou de tout un site Web).
Pour g&eacute;rer l'aspect des contr&ocirc;les visuels au niveau de la page, affectez le nom d'un th&egrave;me &agrave; la propri&eacute;t&eacute; Theme
d'un contr&ocirc;le visuel. Ce th&egrave;me sera alors appliqu&eacute; &agrave; tous les contr&ocirc;les visuels de la page.
Le contr&ocirc;le CrystalReportViewer est compatible avec les th&egrave;mes ASP.NET 2.0. Toute modification apport&eacute;e &agrave; un
th&egrave;me est r&eacute;percut&eacute;e sur le contr&ocirc;le CrystalReportViewer ainsi que sur tous les autres contr&ocirc;les de la page.
Pour en savoir plus sur la configuration et la personnalisation des th&egrave;mes dans ASP.NET 2.0, voir la
documentation de .NET Framework version 2.0.
238
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
Personnalisation du contr&ocirc;le CrystalReportViewer avec la CSS [page 237]
1.4.6.6 Personnalisation de la barre d'outils
CrystalReportViewer
La barre d'outils CrystalReportViewer contient des boutons contr&ocirc;lant les fonctions courantes du contr&ocirc;le
CrystalReportViewer, telles que l'impression, l'exportation ou le changement de la page en cours d'affichage.
Personnalisation des boutons de la barre d'outils
La barre d'outils CrystalReportViewer contient des boutons contr&ocirc;lant les fonctions courantes du contr&ocirc;le
CrystalReportViewer, telles que l'impression, l'exportation ou le changement de la page en cours d'affichage.
La visibilit&eacute; de chaque bouton sur le contr&ocirc;le CrystalReportViewer est contr&ocirc;l&eacute;e via une propri&eacute;t&eacute; correspondante
de la classe CrystalReportViewer. Les noms des propri&eacute;t&eacute;s diff&egrave;rent entre les versions Windows et Web du
contr&ocirc;le CrystalReportViewer.
Sur un site Web, l'apparence de la barre d'outils peut &ecirc;tre contr&ocirc;l&eacute;e via la CSS ou via Th&egrave;mes ASP .Net. Vous
pouvez modifier l'apparence des ic&ocirc;nes de boutons par d&eacute;faut en modifiant les images dans le r&eacute;pertoire virtuel
du visualiseur.
Suppression de la barre d'outils
Vous pouvez supprimer la barre d'outils du contr&ocirc;le CrystalReportViewer par programmation ou via le panneau
T&acirc;ches guid&eacute;es. Vous pouvez cr&eacute;er des contr&ocirc;les personnalis&eacute;s pour r&eacute;pliquer le comportement de nombreux
boutons de la barre d'outils CrystalReportViewer.
Informations associ&eacute;es
Personnalisation du contr&ocirc;le CrystalReportViewer avec la CSS [page 237]
Personnalisation du contr&ocirc;le CrystalReportViewer avec Th&egrave;mes [page 238]
R&eacute;pertoire des visualiseurs [page 14]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
239
1.4.6.6.1
Contr&ocirc;le des boutons apparaissant sur la barre
d'outils CrystalReportViewer
Chacun des boutons de la barre d'outils CrystalReportViewer peut &ecirc;tre activ&eacute; ou d&eacute;sactiv&eacute; individuellement.
La visibilit&eacute; de chaque bouton sur le contr&ocirc;le CrystalReportViewer est contr&ocirc;l&eacute;e via une propri&eacute;t&eacute; correspondante
de la classe CrystalReportViewer. Il existe deux contr&ocirc;les CrystalReportViewer dans le SDK
SAP Crystal Reports .NET. Pour un site Web, utilisez la classe
CrystalDecisions.Web.CrystalReportViewer. Pour une application Windows, utilisez la classe
CrystalDecisions.Windows.Forms.CrystalReportViewer.
Le nom de la propri&eacute;t&eacute; qui contr&ocirc;le la visibilit&eacute; d'un bouton de la barre d'outils diff&egrave;re selon la version du contr&ocirc;le
CrystalReportViewer que vous utilisez. Pour la classe CrystalDecisions.Web.CrystalReportViewer,
chaque propri&eacute;t&eacute; commence par “Has”, comme HasExportButton, HasPrintButton ou HasSearchButton.
En ce qui concerne la classe CrystalDecisions.Windows.Forms.CrystalReportViewer, chaque propri&eacute;t&eacute;
commence par “Show”, comme ShowExportButton, ShowPrintButton ou ShowSearchButton.
Pour en savoir plus sur la classe CrystalDecisions.Web.CrystalReportViewer ou la classe
CrystalDecisions.Windows.Forms.CrystalReportViewer, voir la R&eacute;f&eacute;rence de l'API .NET
SAP Crystal Reports.
Remarque
La suppression d'un bouton de la barre d'outils ne d&eacute;sactive pas le comportement correspondant.
Exemple
Cet exemple montre comment supprimer plusieurs boutons de la barre d'outils CrystalReportViewer dans un
site Web.
Private Sub ConfigureCrystalReports()
CrystalReportViewer1.HasPrintButton = False
CrystalReportViewer1.HasExportButton = False
CrystalReportViewer1.HasSearchButton = False
End Sub
private void ConfigureCrystalReports()
{
InitializeComponent();
crystalReportViewer1.HasPrintButton = false;
crystalReportViewer1.HasExportButton = false;
crystalReportViewer1.HasSearchButton = false;
}
Informations associ&eacute;es
Suppression du bouton d'impression depuis le contr&ocirc;le CrystalReportViewer [page 115]
Suppression du bouton d'exportation depuis le contr&ocirc;le CrystalReportViewer [page 128]
240
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.6.6.2 Suppression de la barre d'outils
CrystalReportViewer
Contexte
Conseil
La barre d'outils peut &ecirc;tre supprim&eacute;e de votre application par programmation ou en d&eacute;cochant la case Afficher
la barre d'outils dans le panneau T&acirc;ches guid&eacute;es des T&acirc;ches CrystalReportViewer.
Proc&eacute;dure
1.
Ajoutez un contr&ocirc;le CrystalReportViewer &agrave; votre application.
2.
D&eacute;finissez la propri&eacute;t&eacute; CrystalReportViewer.DisplayToolbar sur False.
R&eacute;sultats
Lorsque vous ex&eacute;cuterez votre application, la barre d'outils ne devrait plus appara&icirc;tre sur le contr&ocirc;le
CrystalReportViewer.
Exemple
Private Sub ConfigureCrystalReports()
CrystalReportViewer1.DisplayToolbar = False
End Sub
private void ConfigureCrystalReports()
{
InitializeComponent();
crystalReportViewer1.DisplayToolbar = false;
}
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
241
1.4.6.6.3 Modification des boutons de la barre d'outils par
d&eacute;faut dans le visualiseur Web
Contexte
La barre d'outils CrystalReportViewer se compose de diff&eacute;rents graphiques qui repr&eacute;sentent la plupart des
propri&eacute;t&eacute;s disponibles. Les graphiques sont stock&eacute;s dans le r&eacute;pertoire virtuel du visualiseur de votre version de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
Pour un site Web, la barre d'outils utilise des graphiques qui repr&eacute;sentent les propri&eacute;t&eacute;s suivantes :
●
Arborescence des groupes
●
Exporter
●
Imprimer
●
Explorer en amont
●
Navigation : premi&egrave;re page, derni&egrave;re page, page pr&eacute;c&eacute;dente et page suivante
●
Aller &agrave; la page
●
Rechercher
●
Logo SAP BusinessObjects
Il est possible de remplacer ces boutons par votre propre jeu d'ic&ocirc;nes personnalis&eacute;es.
Proc&eacute;dure
1.
Naviguez jusqu'au r&eacute;pertoire virtuel du visualiseur.
2.
Cliquez deux fois sur le dossier images.
3.
Cliquez deux fois sur le dossier toolbar.
Dans le dossier &quot;toolbar&quot;, vous trouverez toutes les images utilis&eacute;es pour la barre d'outils
CrystalReportViewer.
4.
Remplacez les images par d'autres images de votre choix ou ouvrez les images dans un &eacute;diteur de graphiques
pour les modifier. Le nom de l'image doit toutefois rester le m&ecirc;me.
R&eacute;sultats
Les images de la barre d'outils CrystalReportViewer sont remplac&eacute;es pour toutes les applications Web
utilisant le r&eacute;pertoire virtuel du visualiseur.
Informations associ&eacute;es
R&eacute;pertoire des visualiseurs [page 14]
242
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.4.7
Utilisation des rapports SAP Crystal Reports Read-Only
(RPTR)
Les rapports SAP Crystal Reports Read-Only (RPTR) sont des rapports Crystal qui peuvent &ecirc;tre visualis&eacute;s avec
des applications de visualiseur de rapport, mais qui ne peuvent pas &ecirc;tre modifi&eacute;s avec le SDK ni ouverts par des
applications de concepteur de rapports. Cela vous permet de prot&eacute;ger votre propri&eacute;t&eacute; intellectuelle en emp&ecirc;chant
les utilisateurs de modifier le rapport ou d'obtenir les informations en lien avec votre logique m&eacute;tier stock&eacute;es dans
la d&eacute;finition du rapport.
Les rapports au format SAP Crystal Reports Read-Only utilisent l'extension de fichier RPTR &agrave; la place de
l'extension de fichier RPT utilis&eacute;e par les rapports Crystal. Vous pouvez cr&eacute;er un rapport RPTR en exportant un
rapport RPT au format RPTR. Cependant, la conversion d'un rapport RPTR en rapport RPT n'est pas prise en
charge.
La d&eacute;finition d'un rapport RPTR ne pouvant pas &ecirc;tre modifi&eacute;e, il n'est pas possible d'utiliser ce SDK pour d&eacute;finir
l'emplacement de la source de donn&eacute;es d'un rapport RPTR via le contr&ocirc;leur de base de donn&eacute;es. Il est en
revanche possible d'actualiser les donn&eacute;es d'un rapport RPTR au moment de l'ex&eacute;cution.
Vous pouvez utiliser ce SDK pour ex&eacute;cuter les t&acirc;ches suivantes :
●
Cr&eacute;er un rapport RPTR en exportant un rapport Crystal (RPT) au format RPTR.
Remarque
Seuls les rapports cr&eacute;&eacute;s par SAP Crystal Reports 2011 peuvent &ecirc;tre export&eacute;s au format RPTR.
●
Afficher un rapport RPTR en obtenant la source du rapport et en la transmettant au visualiseur.
●
Actualiser les donn&eacute;es d'un rapport RPTR au moment de l'ex&eacute;cution.
●
Ouvrir un rapport RPTR et l'exporter sous d'autres formats que RPT.
Vous ne pouvez en revanche pas utiliser ce SDK pour ex&eacute;cuter les t&acirc;ches suivantes :
●
Modifier la d&eacute;finition du rapport d'un rapport RPTR.
●
D&eacute;finir l'emplacement de la source de donn&eacute;es du rapport.
●
Extraire les informations relatives &agrave; la d&eacute;finition d'un rapport RPTR, notamment les formules, les champs, les
sections et les objets du rapport.
●
Exporter un rapport RPTR au format RPT.
●
Ajouter un rapport RPTR en tant que sous-rapport d'un rapport RPT.
1.5
1.5.1
Tutoriels
Tutoriels du mod&egrave;le d'objet CrystalReportViewer
Les tutoriels pr&eacute;sent&eacute;s dans cette section utilisent des m&eacute;thodes et des propri&eacute;t&eacute;s de la classe
CrystalReportViewer et les classes de l'espace de noms CrystalDecisions.Shared.
Les tutoriels pr&eacute;sent&eacute;s dans cette section utilisent des m&eacute;thodes et des propri&eacute;t&eacute;s de la classe
CrystalReportViewer et les classes de l'espace de noms CrystalDecisions.Shared.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
243
1.5.1.1
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e
Dans ce tutoriel, vous allez apprendre &agrave; ajouter un code de connexion afin d'afficher un rapport contenant des
informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Introduction
Lorsque vous utilisez le mod&egrave;le d'objet CrystalReportViewer pour vous connecter &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e, vous devez utiliser les classes de l'espace de noms CrystalDecisions.Shared.
Les propri&eacute;t&eacute;s de la classe ConnectionInfo permettent la connexion au serveur de base de donn&eacute;es ou aux
sources de donn&eacute;es ODBC. Dans ce tutoriel, vous allez d&eacute;finir les propri&eacute;t&eacute;s ServerName, DatabaseName, UserID
et Password. Si vous d&eacute;finissez uniquement les propri&eacute;t&eacute;s DatabaseName, UserID et Password, vous &ecirc;tes
connect&eacute; au serveur par d&eacute;faut de la base de donn&eacute;es sp&eacute;cifi&eacute;e dans le rapport. Toutefois, si vous affectez une
autre propri&eacute;t&eacute; ServerName, vous pouvez rediriger le rapport vers un serveur diff&eacute;rent au moment de l'ex&eacute;cution.
Vous extrayez l'instance TableLogOnInfos de la propri&eacute;t&eacute; LogOnInfo du contr&ocirc;le CrystalReportViewer. Vous
affectez ensuite l'instance ConnectionInfo &agrave; chaque objet TableLogOnInfo de l'instance TableLogOnInfos.
Le code de connexion de ce tutoriel s'applique &eacute;galement aux sous-rapports ins&eacute;r&eacute;s dans le rapport principal.
Pour le mod&egrave;le d'objet ReportDocument, vous devez modifier le code pour l'adapter aux sous-rapports (voir
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e avec un sous-rapport [page 382]).
Pour cr&eacute;er ce tutoriel &agrave; l'aide du mod&egrave;le d'objet ReportDocument, voir Tutoriel : Connexion &agrave; une base de donn&eacute;es
SQL Server s&eacute;curis&eacute;e [page 244] utilisant le mod&egrave;le d'objet ReportDocument. Il est recommand&eacute; d'utiliser le
mod&egrave;le d'objet ReportDocument plut&ocirc;t que le mod&egrave;le d'objet CrystalReportViewer.
Exemple de code
Chaque tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez
les instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir
d'une version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_CRVObjMod_DBLogon
●
Projet Windows C# : CS_Win_CRVObjMod_DBLogon
●
Site Web Visual Basic : VB_Web_CRVObjMod_DBLogon
●
Projet Windows Visual Basic : VB_Win_CRVObjMod_DBLogon
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
244
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.1.1.1
Cr&eacute;ation d'un rapport connect&eacute; &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e
Pr&eacute;requis
●
Configuration de SQL Server :
○
Si vous disposez de SQL Server (ou de la version OEM, MSDE), il doit &ecirc;tre configur&eacute; de mani&egrave;re &agrave; exiger
une authentification SQL Server.
○
Si vous ne disposez pas de SQL Server (ou de la version OEM, MSDE), vous devez installer MSDE en
attribuant &agrave; l'authentification SQL Server la valeur True.
●
La base de donn&eacute;es Northwind fournie avec SQL Server doit &ecirc;tre install&eacute;e et vous devez v&eacute;rifier que
l'authentification SQL Server est bien requise.
●
Vous devez cr&eacute;er un compte &agrave; acc&egrave;s limit&eacute; qui sera utilis&eacute; au sein du site Web.
Contexte
Apr&egrave;s avoir configur&eacute; SQL Server et la base de donn&eacute;es Northwind conform&eacute;ment aux instructions des sections
ci-dessus, vous &ecirc;tes pr&ecirc;t &agrave; cr&eacute;er un rapport dont les informations proviennent, de fa&ccedil;on s&eacute;curis&eacute;e, de la base de
donn&eacute;es Northwind.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom &quot;NorthwindCustomers.rpt&quot;, puis cliquez sur Ouvrir.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
La fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard s'affiche.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
245
6.
Dans le panneau Sources de donn&eacute;es disponibles, d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier OLE DB (ADO).
La fen&ecirc;tre OLE DB (ADO) s'affiche.
8.
S&eacute;lectionnez Microsoft OLE DB Provider for SQL Server, puis cliquez sur Suivant.
9.
Saisissez les valeurs correspondant &agrave; votre serveur de base de donn&eacute;es, l'ID utilisateur et le mot de passe
dans les champs Serveur, ID utilisateur et Mot de passe.
10. Dans la liste d&eacute;roulante Base de donn&eacute;es, s&eacute;lectionnez &quot;Northwind&quot;.
Laissez la case &agrave; cocher S&eacute;curit&eacute; int&eacute;gr&eacute;e d&eacute;sactiv&eacute;e, car vous utilisez l'authentification SQL Server au lieu de
l'authentification NT.
11. Cliquez sur Terminer.
Le dossier OLE DB est maintenant d&eacute;velopp&eacute;, affichant votre serveur de base de donn&eacute;es et, &agrave; l'int&eacute;rieur de
celui-ci, la base de donn&eacute;es Northwind.
12. D&eacute;veloppez les nœuds Northwind, dbo et Tables, puis s&eacute;lectionnez la table Customers.
13. Cliquez sur le bouton &gt; pour d&eacute;placer la table dans le panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
14. D&eacute;veloppez la table Customers, maintenez la touche Ctrl enfonc&eacute;e et cliquez sur CompanyName,
ContactName et City.
15. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
16. Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Customer.City, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport NorthwindCustomers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
1.5.1.1.2
Liaison du rapport sans code de connexion
Durant la proc&eacute;dure Configuration d'un projet [page 15], vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer dans un
Web Form ou un Windows Form. Lors de l'&eacute;tape pr&eacute;c&eacute;dente, vous avez ajout&eacute; un rapport NorthwindCustomers au
projet.
Dans cette section, vous allez lier le chemin d'acc&egrave;s au r&eacute;pertoire du rapport NorthwindCustomers au contr&ocirc;le
CrystalReportViewer. Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement lorsque le code de connexion
&agrave; la base de donn&eacute;es n'a pas &eacute;t&eacute; d&eacute;fini.
1.5.1.1.2.1
Pour lier le chemin d'acc&egrave;s au r&eacute;pertoire du
rapport NorthwindCustomers au contr&ocirc;le CrystalReportViewer.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
246
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Localisez la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration
d'un projet [page 15]).
4.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;)
string reportPath = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;NorthwindCustomers.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;NorthwindCustomers.rpt&quot;;
5.
Affectez le chemin d'acc&egrave;s au r&eacute;pertoire du fichier du rapport NorthwindCustomers &agrave; la propri&eacute;t&eacute;
ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = reportPath
crystalReportViewer.ReportSource = reportPath;
1.5.1.1.2.2
Pour tester le chargement du rapport
NorthwindCustomers
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Dans la mesure o&ugrave; le code permettant de se
connecter &agrave; la base de donn&eacute;es n'a pas encore &eacute;t&eacute; &eacute;crit, le chargement du rapport doit &eacute;chouer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
247
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\debug\, puis copiez le rapport dans ce sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers ne s'affiche pas. Il s'affiche apr&egrave;s que vous avez ajout&eacute; le code de connexion
&agrave; la base de donn&eacute;es.
Remarque
Les r&eacute;sultats peuvent varier selon la version de SAP Crystal Reports utilis&eacute;e. Par exemple, si vous utilisez
SAP Crystal Reports 10 ou une version ult&eacute;rieure, vous &ecirc;tes invit&eacute; &agrave; saisir les informations de connexion &agrave;
la base de donn&eacute;es pour le rapport. Si vous ex&eacute;cutez une version ant&eacute;rieure de SAP Crystal Reports, une
exception est renvoy&eacute;e. Dans les deux cas, vous devez effectuer la proc&eacute;dure suivante pour cr&eacute;er une
application enti&egrave;rement fonctionnelle.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.1.3
Ajout du code de connexion au rapport
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; ajouter le code de connexion &agrave; la classe code-behind. Vous commencez par cr&eacute;er
une m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e SetDBLogonForReport().
1.5.1.1.3.1
Pour cr&eacute;er et coder la m&eacute;thode
SetDBLogonForReport()
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e SetDBLogonForReport() avec la
variable ConnectionInfo dans la signature de la m&eacute;thode.
Private Sub SetDBLogonForReport(ByVal myConnectionInfo As ConnectionInfo)
End Sub
248
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
private void SetDBLogonForReport(ConnectionInfo connectionInfo)
{
}
3.
Dans cette m&eacute;thode, extrayez l'instance TableLogOnInfos de la propri&eacute;t&eacute; LogOnInfo de la classe
CrystalReportViewer.
Remarque
TableLogOnInfos est une classe index&eacute;e contenant des instances de la classe TableLogOnInfo.
Dim myTableLogOnInfos As TableLogOnInfos = myCrystalReportViewer.LogOnInfo
TableLogOnInfos tableLogOnInfos = crystalReportViewer.LogOnInfo;
4.
Cr&eacute;ez une boucle foreach qui effectue une boucle sur chaque instance TableLogOnInfode l'instance de
classe index&eacute;e TableLogOnInfos.
For Each myTableLogOnInfo As TableLogOnInfo In myTableLogOnInfos
Next
foreach(TableLogOnInfo tableLogOnInfo in tableLogOnInfos)
{
}
5.
Dans la boucle foreach, affectez &agrave; la propri&eacute;t&eacute; ConnectionInfo de TableLogOnInfo le param&egrave;tre
ConnectionInfo.
myTableLogOnInfo.ConnectionInfo = myConnectionInfo
tableLogOnInfo.ConnectionInfo = connectionInfo;
1.5.1.1.3.2
Pour modifier la m&eacute;thode
ConfigureCrystalReports() selon le code de connexion &agrave; la base
de donn&eacute;es
Contexte
Cette proc&eacute;dure a cr&eacute;&eacute; une m&eacute;thode permettant de d&eacute;finir les informations de connexion &agrave; la base de donn&eacute;es.
Toutefois, vous devez modifier la m&eacute;thode ConfigureCrystalReports() pour d&eacute;signer cette m&eacute;thode afin que
le rapport sache qu'il dispose des informations de connexion &agrave; la base de donn&eacute;es.
La modification de la m&eacute;thode ConfigureCrystalReports() se d&eacute;roule en deux &eacute;tapes :
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
249
●
Configurer l'instance ConnectionInfo.
●
Appeler la m&eacute;thode SetDBLogonForReport().
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), d&eacute;clarez et instanciez la classe ConnectionInfo endessous du code qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Dim myConnectionInfo As ConnectionInfo = New ConnectionInfo()
ConnectionInfo connectionInfo = new ConnectionInfo();
2.
Sur la ligne suivante, appelez la m&eacute;thode SetDBLogonForReport() en transmettant l'instance
ConnectionInfo.
SetDBLogonForReport(myConnectionInfo)
SetDBLogonForReport(connectionInfo);
3.
D&eacute;finissez les propri&eacute;t&eacute;s DatabaseName, UserIDet Password de l'instance ConnectionInfo.
Remarque
Pour des raisons de s&eacute;curit&eacute;, il est important que vous utilisiez un compte de base de donn&eacute;es &agrave; acc&egrave;s
limit&eacute;.
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
myConnectionInfo.DatabaseName = &quot;Northwind&quot;
myConnectionInfo.UserID = &quot;limitedPermissionAccount&quot;
myConnectionInfo.Password = &quot;1234&quot;
connectionInfo.DatabaseName = &quot;Northwind&quot;;
connectionInfo.UserID = &quot;limitedPermissionAccount&quot;;
connectionInfo.Password = &quot;1234&quot;;
250
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.1.3.3
Pour tester le chargement du rapport
NorthwindCustomers
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport doit se charger correctement, car vous
avez ajout&eacute; le code de connexion &agrave; la base de donn&eacute;es.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.1.4
Ajout de la possibilit&eacute; de modifier l'emplacement
de la base de donn&eacute;es au moment de l'ex&eacute;cution
Dans cette section, vous allez apprendre &agrave; modifier l'emplacement de la base de donn&eacute;es au moment de
l'ex&eacute;cution. Cette op&eacute;ration n&eacute;cessite simplement une l&eacute;g&egrave;re modification de l'instance ConnectionInfo.
Remarque
Dans ce tutoriel, vous allez changer le nom du serveur de base de donn&eacute;es, et non le nom de la base de
donn&eacute;es. Il est impossible de changer le nom de la base de donn&eacute;es avec le contr&ocirc;le CrystalReportViewer.
1.5.1.1.4.1
Pour modifier l'emplacement de la base de
donn&eacute;es au moment de l'ex&eacute;cution
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la ligne
qui appelle la m&eacute;thode SetDBLogonForReport().
2.
Dans les sauts de ligne, d&eacute;finissez la propri&eacute;t&eacute; ServerName de l'instance ConnectionInfo.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
251
Remarque
Dans le code que vous &eacute;crivez, remplacez l'exemple de nom de serveur DevDatabaseServer (indiqu&eacute; cidessous) par votre propre nom de serveur.
myConnectionInfo.ServerName = &quot;DevDatabaseServer&quot;
connectionInfo.ServerName = &quot;DevDatabaseServer&quot;;
1.5.1.1.4.2
Pour v&eacute;rifier si un autre serveur de base de
donn&eacute;es peut &ecirc;tre red&eacute;fini pour le rapport au moment de
l'ex&eacute;cution
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport devrait se rediriger vers l'autre serveur
de base de donn&eacute;es au moment de l'ex&eacute;cution.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.2
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
discrets
Dans ce tutoriel, vous allez apprendre &agrave; cr&eacute;er un rapport dont les donn&eacute;es peuvent &ecirc;tre filtr&eacute;es en fonction d'un
param&egrave;tre discret.
Introduction
Un param&egrave;tre discret est une valeur unique alors qu'un param&egrave;tre de plage fait r&eacute;f&eacute;rence &agrave; une plage de valeurs.
Les &eacute;l&eacute;ments textuels (tels que les villes) sont g&eacute;n&eacute;ralement accessibles via des param&egrave;tres discrets. Les
252
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&eacute;l&eacute;ments num&eacute;riques (tels que les salaires des employ&eacute;s) sont g&eacute;n&eacute;ralement accessibles via des param&egrave;tres de
plage.
Dans ce tutoriel, vous allez d&eacute;finir une valeur de param&egrave;tre discret afin d'afficher un rapport sur les clients bas&eacute;
sur un champ. Ce rapport affiche uniquement les clients vivant dans les villes s&eacute;lectionn&eacute;es dans une liste de
villes. Cette liste provient des valeurs par d&eacute;faut du param&egrave;tre Ville. Les valeurs par d&eacute;faut du param&egrave;tre Ville sont
encapsul&eacute;es dans le rapport.
Cr&eacute;ez tout d'abord un rapport sur les clients avec un param&egrave;tre de ville. Les donn&eacute;es du rapport proviennent de
l'exemple de base de donn&eacute;es fourni avec SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
Lorsque vous instanciez le rapport dans le code, vous cr&eacute;ez une instance ArrayList contenant des noms de ville
(Paris, Tokyo), puis transmettez cette instance &agrave; une m&eacute;thode d'assistance qui d&eacute;finit ces noms de ville comme
les valeurs actuelles du param&egrave;tre Ville. Vous liez ensuite le rapport au contr&ocirc;le CrystalReportViewer et seuls les
clients vivant &agrave; Paris ou &agrave; Tokyo sont affich&eacute;s dans ce rapport.
Dans la partie suivante du tutoriel, vous allez effectuer les op&eacute;rations suivantes :
●
Cr&eacute;er une m&eacute;thode qui extrait toutes les valeurs par d&eacute;faut et les renvoie dans une instance ArrayList.
●
Ajouter un contr&ocirc;le ListBox au formulaire et le remplir avec les valeurs provenant de l'ArrayList.
●
Ajouter un contr&ocirc;le Button pour r&eacute;afficher le rapport en fonction des s&eacute;lections ListBox.
Dans la derni&egrave;re partie du tutoriel, vous coderez l'&eacute;v&eacute;nement de clic pour extraire les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s &agrave;
partir du contr&ocirc;le ListBox et d&eacute;finir les valeurs actuelles du param&egrave;tre Ville. Le rapport est r&eacute;affich&eacute;, indiquant
uniquement les clients qui vivent dans les villes s&eacute;lectionn&eacute;es dans le contr&ocirc;le ListBox.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_CRVObjMod_Parameters
●
Projet Windows C# : CS_Win_CRVObjMod_Parameters
●
Site Web Visual Basic : VB_Web_CRVObjMod_Parameters
●
Projet Windows Visual Basic : VB_Win_CRVObjMod_Parameters
Base de donn&eacute;es Xtreme
La base de donn&eacute;es Xtreme est utilis&eacute;e par certains tutoriels. Elle figure dans le package d'exemples de code qui
peut &ecirc;tre t&eacute;l&eacute;charg&eacute; &agrave; l'adresse suivante : http://www.sdn.sap.com/irj/boc/sdklibrary
manuellement une connexion ODBC &agrave; la base de donn&eacute;es.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
. Vous devez cr&eacute;er
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
253
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.1.2.1
Cr&eacute;ation d'un rapport avec des param&egrave;tres
Commencez par cr&eacute;er un rapport &agrave; partir des informations de la base de donn&eacute;es Xtreme.
1.5.1.2.1.1
Pour cr&eacute;er un rapport avec des param&egrave;tres
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom CustomersByCity.rpt, puis cliquez sur Ajouter.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
8.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; la base de donn&eacute;es Xtreme,
puis cliquez sur Terminer.
9.
D&eacute;veloppez le nœud Tables, cliquez deux fois sur la table Clients pour la d&eacute;placer dans le panneau Tables
s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
10. D&eacute;veloppez la table Clients, puis utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner les champs
Nom du client, Titre, Adresse 1, Nom du contact et Ville.
11. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur le
bouton Suivant.
12. Dans le panneau Champs disponibles, sous Champs du rapport, cliquez deux fois sur Clients.Ville pour
d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport CustomersByCity est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
254
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.2.1.2
Pour ajouter un param&egrave;tre Ville
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; ajouter un param&egrave;tre appel&eacute; Ville et &agrave; le remplir avec des valeurs par d&eacute;faut.
L'Explorateur de champs doit &ecirc;tre visible, car il permet d'acc&eacute;der &agrave; plusieurs fonctions du rapport, notamment
aux param&egrave;tres. Pour rendre l'Explorateur de champs visible, dans le menu Crystal Reports, cliquez sur
Explorateur de champs.
Proc&eacute;dure
1.
Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/D&eacute;sactiver l'affichage du champ dans la barre
d'outils Crystal Reports.
Conseil
Vous pouvez &eacute;galement afficher l'Explorateur de champs en ouvrant le menu Crystal Reports, puis en
cliquant sur Explorateur de champs.
2.
Dans l'Explorateur de champs, cliquez avec le bouton droit de la souris sur Champs de param&egrave;tre, puis
s&eacute;lectionnez Nouveau.
3.
Dans la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre :
a) Attribuez &agrave; Nom la valeur Ville.
b) Attribuez &agrave; Type la valeur Cha&icirc;ne. Attribuez &agrave; Texte de l'invite la valeur S&eacute;lectionnez une ou
plusieurs villes.
c) Attribuez &agrave; Champ de valeur la valeur Ville.
d) Cliquez sur Actions, puis s&eacute;lectionnez Ajouter toutes les valeurs de la base de donn&eacute;es. La liste compl&egrave;te
des villes appara&icirc;t dans le volet du milieu.
e) Dans le volet Options de valeur, attribuez &agrave; Texte de l'invite la valeur S&eacute;lectionnez une ou
plusieurs villes.
f)
Dans ce m&ecirc;me volet, attribuez &agrave; Autoriser plusieurs valeurs la valeur True.
g) Attribuez &agrave; Autoriser les valeurs discr&egrave;tes la valeur True.
4.
Cliquez sur OK pour fermer la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre.
1.5.1.2.1.3
Pour connecter le param&egrave;tre Ville &agrave; la colonne
Ville de la base de donn&eacute;es
Contexte
Vous venez de d&eacute;finir les valeurs par d&eacute;faut de sorte qu'elles contiennent une liste importante de villes. Plus loin
dans ce tutoriel, vous acc&eacute;derez par programmation &agrave; cette m&ecirc;me liste de valeurs par d&eacute;faut, via la propri&eacute;t&eacute;
ParameterFieldInfo de la classe CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
255
Vous devez maintenant utiliser l'Expert S&eacute;lection pour d&eacute;finir une formule permettant de connecter la colonne
Ville de la base de donn&eacute;es au champ de param&egrave;tre Ville que vous venez de cr&eacute;er.
Proc&eacute;dure
1.
Dans la barre d'outils Crystal Reports, cliquez sur Expert S&eacute;lection.
2.
Dans la bo&icirc;te de dialogue Choisir un champ, sous Champs du rapport, s&eacute;lectionnez Clients.Ville, puis cliquez
sur OK.
3.
Dans la bo&icirc;te de dialogue Select Expert, dans l'onglet Customer.City, choisissez &quot;est &eacute;gal &agrave;&quot; dans la liste
d&eacute;roulante.
4.
Dans la nouvelle liste d&eacute;roulante qui s'affiche &agrave; droite, s&eacute;lectionnez le premier &eacute;l&eacute;ment de la liste, {?Ville}, puis
cliquez sur OK.
Remarque
Cette s&eacute;lection, {?City}, correspond au param&egrave;tre Ville que vous avez cr&eacute;&eacute; pr&eacute;c&eacute;demment.
5.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; lier le rapport au contr&ocirc;le CrystalReportViewer et &agrave; d&eacute;finir le param&egrave;tre Ville avec
deux valeurs d'origine, Paris et Tokyo.
1.5.1.2.2
Liaison du rapport
Lorsque vous avez s&eacute;lectionn&eacute; les instructions de la proc&eacute;dure Configuration d'un projet [page 15] en pr&eacute;paration
de ce tutoriel, vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer sur le Web Form ou le Windows Form. Au cours
des &eacute;tapes pr&eacute;c&eacute;dentes, vous avez ajout&eacute; un rapport CustomersByCity au projet.
Dans cette section, vous allez lier le chemin d'acc&egrave;s au r&eacute;pertoire du rapport CustomersByCity au contr&ocirc;le
CrystalReportViewer. Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement lorsque les valeurs
actuelles n'ont pas &eacute;t&eacute; d&eacute;finies pour ce param&egrave;tre.
256
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.2.2.1
Pour lier le chemin d'acc&egrave;s au r&eacute;pertoire du
rapport CustomersByCity au contr&ocirc;le CrystalReportViewer.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind du Web Form ou du Windows
Form.
3.
Localisez la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration
d'un projet [page 15]).
4.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;CustomersByCity.rpt&quot;)
string reportPath = Server.MapPath(&quot;CustomersByCity.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;CustomersByCity.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;CustomersByCity.rpt&quot;;
5.
Affectez le chemin d'acc&egrave;s au r&eacute;pertoire du fichier du rapport CustomersByCity &agrave; la propri&eacute;t&eacute; ReportSource
du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = reportPath
crystalReportViewer.ReportSource = reportPath;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
257
1.5.1.2.2.2
Pour tester le chargement du rapport
CustomersByCity
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le chargement du rapport doit &eacute;chouer, car le code
permettant de d&eacute;finir une valeur pour le champ de param&egrave;tre Ville n'a pas encore &eacute;t&eacute; &eacute;crit.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport CustomersByCity ne s'affiche pas. Il s'affiche apr&egrave;s que vous avez ajout&eacute; une valeur au param&egrave;tre
Ville plus loin dans ce tutoriel.
Remarque
Les r&eacute;sultats peuvent varier selon la version de SAP Crystal Reports utilis&eacute;e. Dans les versions plus
r&eacute;centes, un formulaire s'affiche vous demandant de fournir des valeurs de param&egrave;tre pour ce rapport.
Dans les versions ant&eacute;rieures, une exception &quot;Valeur actuelle du champ de param&egrave;tre introuvable&quot; est
renvoy&eacute;e. Dans les deux cas, vous devez ajouter du code suppl&eacute;mentaire pour cr&eacute;er une application
enti&egrave;rement fonctionnelle.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.2.3
D&eacute;finition manuelle des param&egrave;tres dans le code
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er deux valeurs (&quot;Paris&quot; et &quot;Tokyo&quot;) dans le champ de param&egrave;tre Ville du rapport
CustomersByCity.
Cette op&eacute;ration n&eacute;cessite un code qui peut &ecirc;tre d&eacute;compos&eacute; selon les processus suivants :
●
Une constante PARAMETER_FIELD_NAME est n&eacute;cessaire pour contenir le champ de param&egrave;tre &quot;Ville&quot;.
●
Le code permettant d'ajouter les valeurs actuelles au param&egrave;tre Ville &eacute;tant utilis&eacute; dans diff&eacute;rents
emplacements dans ce tutoriel, il est pr&eacute;f&eacute;rable de cr&eacute;er ce code en tant que m&eacute;thode d'assistance distincte.
258
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Dans la m&eacute;thode ConfigureCrystalReports(), vous devez ajouter les param&egrave;tres &quot;Paris&quot; et &quot;Tokyo&quot; &agrave;
une instance ArrayList, puis transmettre le rapport et l'instance &agrave; la m&eacute;thode d'assistance pour le traitement.
1.5.1.2.3.1
Pour cr&eacute;er une constante
PARAMETER_FIELD_NAME
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
Au niveau de la classe, cr&eacute;ez une constante cha&icirc;ne, PARAMETER_FIELD_NAME, et attribuez-lui la valeur &quot;Ville.&quot;
Private Const PARAMETER_FIELD_NAME As String = &quot;City&quot;
private const string PARAMETER_FIELD_NAME = &quot;City&quot;;
1.5.1.2.3.2
Pour cr&eacute;er une m&eacute;thode d'assistance permettant
d'ajouter les valeurs actuelles au param&egrave;tre dans le rapport
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er la m&eacute;thode d'assistance qui permet d'ajouter les valeurs actuelles au
param&egrave;tre dans le rapport.
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe de l'espace de noms System.Collections (si cet espace de noms n'a pas d&eacute;j&agrave; &eacute;t&eacute;
d&eacute;clar&eacute;).
Remarque
Cette d&eacute;claration est n&eacute;cessaire pour acc&eacute;der &agrave; la classe ArrayList.
Imports System.Collections
using System.Collections;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
259
3.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e
SetCurrentValuesForParameterField() avec deux variables dans la signature de la m&eacute;thode :
ParameterFields et ArrayList.
Private Sub SetCurrentValuesForParameterField(ByVal myParameterFields As
ParameterFields, ByVal myArrayList As
ArrayList)
End Sub
private void SetCurrentValuesForParameterField(ParameterFields parameterFields,
ArrayList arrayList)
{
}
4.
Dans cette m&eacute;thode, d&eacute;clarez et instanciez la classeParameterValues en tant que variable
currentParameterValues.
Remarque
Pour que la classe ParameterValues soit accessible, vous devez avoir inclus une d&eacute;claration &quot;Imports&quot;
[Visual Basic] ou &quot;using&quot; [C#] dans la partie sup&eacute;rieure de la classe code-behind pour l'espace de
noms CrystalDecisions.Shared. (Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un
projet [page 15].)
Dim currentParameterValues As ParameterValues = New ParameterValues()
ParameterValues currentParameterValues = new ParameterValues();
5.
Cr&eacute;ez une boucle foreach pour extraire toutes les valeurs envoy&eacute;es (comme type Object) de l'instance
ArrayList.
Remarque
Dans cette m&eacute;thode, vous extrayez les valeurs d'ArrayList. Par la suite, vous &eacute;crirez du code permettant
d'ajouter des valeurs &agrave; l'ArrayList.
For Each submittedValue As Object In myArrayList
Next
foreach(object submittedValue in arrayList)
{
}
6.
Dans la boucle foreach, d&eacute;clarez et instanciez la classe ParameterDiscreteValue.
Dim myParameterDiscreteValue As ParameterDiscreteValue = New
ParameterDiscreteValue()
260
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ParameterDiscreteValue parameterDiscreteValue = new ParameterDiscreteValue();
7.
Dans la boucle foreach, convertissez la submittedValue en cha&icirc;ne et transmettez-la &agrave; la propri&eacute;t&eacute; Value
de l'instance ParameterDiscreteValue.
myParameterDiscreteValue.Value = submittedValue.ToString()
parameterDiscreteValue.Value = submittedValue.ToString();
8.
Dans la boucle foreach, ajoutez l'instance ParameterDiscreteValue dans la classe index&eacute;e
currentParameterValues.
L'&eacute;criture de code dans la boucle foreach est &agrave; pr&eacute;sent termin&eacute;e. Vous placez le code restant (&agrave; l'aide des
&eacute;tapes suivantes) apr&egrave;s la boucle foreach.
currentParameterValues.Add(myParameterDiscreteValue)
currentParameterValues.Add(parameterDiscreteValue);
9.
En dehors de la boucle foreach, extrayez l'instance ParameterField de la classe index&eacute;e
ParameterFields, qui se base sur l'entr&eacute;e d'index de la constante PARAMETER_FIELD_NAME.
Dim myParameterField As ParameterField = myParameterFields(PARAMETER_FIELD_NAME)
ParameterField parameterField = parameterFields[PARAMETER_FIELD_NAME];
10. Transmettez l'instance currentParameterValues &agrave; la propri&eacute;t&eacute; CurrentValues de l'instance
ParameterField.
myParameterField.CurrentValues = currentParameterValues
parameterField.CurrentValues = currentParameterValues;
1.5.1.2.3.3
Pour appeler la m&eacute;thode
SetCurrentValuesForParameterField () avant la liaison du
rapport au contr&ocirc;le CrystalReportViewer
Contexte
Cette proc&eacute;dure a permis de cr&eacute;er une m&eacute;thode qui extrait les valeurs envoy&eacute;es d'une instance ArrayList et les
place comme valeurs actuelles dans une instance ParameterField. Vous devez maintenant appeler cette
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
261
m&eacute;thode avant que votre rapport ne soit li&eacute; au contr&ocirc;le CrystalReportViewer afin que le rapport sache qu'il
dispose de param&egrave;tres.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), d&eacute;clarez et instanciez une ArrayList au-dessus de la ligne
qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
2.
Ajoutez les noms de ville &quot;Paris&quot; et &quot;Tokyo&quot; comme cha&icirc;nes &agrave; l'instance ArrayList.
myArrayList.Add(&quot;Paris&quot;)
myArrayList.Add(&quot;Tokyo&quot;)
arrayList.Add(&quot;Paris&quot;);
arrayList.Add(&quot;Tokyo&quot;);
3.
Sous le code qui lie le contr&ocirc;le CrystalReportViewer, extrayez l'instance ParameterFields de la
propri&eacute;t&eacute; ParameterFieldInfo du contr&ocirc;le CrystalReportViewer.
Dim myParameterFields As ParameterFields =
myCrystalReportViewer.ParameterFieldInfo
ParameterFields parameterFields = crystalReportViewer.ParameterFieldInfo;
4.
Appelez la m&eacute;thode SetCurrentValuesForParameterField(), puis transmettez l'instance
ParameterFields et l'instance ArrayList.
SetCurrentValuesForParameterField(myParameterFields, myArrayList)
SetCurrentValuesForParameterField(parameterFields, arrayList);
262
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.2.3.4
Pour tester le chargement du rapport
CustomersByCity
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport doit s'afficher correctement, car le code
d&eacute;finissant les valeurs actuelles dans le champ de param&egrave;tre est d&eacute;sormais &eacute;crit.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Dans la section suivante, vous allez apprendre &agrave; extraire les valeurs par d&eacute;faut du champ de param&egrave;tre et &agrave; d&eacute;finir
ces valeurs dans un contr&ocirc;le ListBox. Ces valeurs seront utilis&eacute;es &agrave; la fin du tutoriel pour s&eacute;lectionner de fa&ccedil;on
dynamique de nouvelles villes et filtrer le rapport en fonction des nouvelles villes s&eacute;lectionn&eacute;es.
1.5.1.2.4
Cr&eacute;ation d'un contr&ocirc;le ListBox qui affiche les
param&egrave;tres par d&eacute;faut
Le reste du tutoriel concerne l'affichage de la liste compl&egrave;te des valeurs par d&eacute;faut du champ de param&egrave;tre dans
un contr&ocirc;le ListBox et le refiltrage du contenu du rapport en fonction des s&eacute;lections effectu&eacute;es &agrave; partir du
contr&ocirc;le ListBox.
Dans cette section, vous allez apprendre &agrave; remplir le contr&ocirc;le ListBox &agrave; partir des valeurs par d&eacute;faut du champ
de param&egrave;tre.
Remarque
N'oubliez pas que vous avez d&eacute;fini les valeurs par d&eacute;faut, une liste importante de villes, lors de la cr&eacute;ation du
rapport au d&eacute;but de ce tutoriel.
Pour ce faire, vous devez ajouter et configurer un contr&ocirc;le ListBox, puis cr&eacute;er une m&eacute;thode d'assistance pour
remplir ce contr&ocirc;le ListBox.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
263
1.5.1.2.4.1
Pour cr&eacute;er et configurer un contr&ocirc;le ListBox sur
le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Appuyez sur la FLECHE GAUCHE du clavier afin de faire appara&icirc;tre un curseur clignotant, puis appuyez
sur ENTREE.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Dock la valeur &quot;Bottom&quot;.
c) Redimensionnez le contr&ocirc;le CrystalReportViewer pour laisser assez d'espace au-dessus afin d'ajouter un
contr&ocirc;le ListBox.
d) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
5.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le ListBox au-dessus du contr&ocirc;le CrystalReportViewer.
6.
Cliquez sur le contr&ocirc;le ListBox pour le s&eacute;lectionner.
7.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, proc&eacute;dez comme suit :
a) Attribuez &agrave; ID ou Name la valeur &quot;defaultParameterValuesList&quot;.
b) Attribuez &agrave; SelectionMode la valeur &quot;Multiple&quot; (ou &quot;MultiExtended&quot; dans un projet Windows).
8.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.1.2.4.2
Pour cr&eacute;er une m&eacute;thode d'assistance qui extrait
les valeurs par d&eacute;faut du champ de param&egrave;tre
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er une m&eacute;thode d'assistance qui extrait les valeurs par d&eacute;faut du champ de
param&egrave;tre.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
264
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e
GetDefaultValuesFromParameterField() qui renvoie une instance ArrayList, en transmettant
ParameterFields dans la signature de la m&eacute;thode.
Private Function GetDefaultValuesFromParameterField(ByVal
myParameterFields As ParameterFields) As ArrayList
End Function
private ArrayList
GetDefaultValuesFromParameterField(ParameterFields parameterFields)
{
}
4.
Extrayez l'instance ParameterField de la classe index&eacute;e ParameterFields, bas&eacute;e sur l'entr&eacute;e d'index de
la constante PARAMETER_FIELD_NAME.
Dim myParameterField As ParameterField =
myParameterFields(PARAMETER_FIELD_NAME)
ParameterField parameterField =
parameterFields[PARAMETER_FIELD_NAME];
5.
Extrayez une classe index&eacute;e ParameterValues (en tant que variable defaultParameterValues) de la
propri&eacute;t&eacute; DefaultValues de l'instance ParameterField.
Dim defaultParameterValues As ParameterValues =
myParameterField.DefaultValues
ParameterValues defaultParameterValues =
parameterField.DefaultValues;
6.
D&eacute;clarez et instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
7.
Cr&eacute;ez une boucle foreach pour extraire chaque instance ParameterValue de la variable
defaultParameterValues.
Dans la boucle foreach, cr&eacute;ez maintenant un bloc conditionnel imbriqu&eacute; qui recherche des valeurs de
param&egrave;tre discret (par opposition aux valeurs de param&egrave;tre de plage). Il existe deux versions de ce bloc
conditionnel, car l'API a subi de l&eacute;g&egrave;res modifications au cours de l'&eacute;volution des versions de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio. V&eacute;rifiez votre API (&agrave; l'aide
d'IntelliSense) pour conna&icirc;tre la propri&eacute;t&eacute; disponible sous ParameterValue :
For Each myParameterValue As ParameterValue In
defaultParameterValues
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
265
Next
foreach(ParameterValue parameterValue in defaultParameterValues)
{
}
8.
Si la propri&eacute;t&eacute; disponible est IsRange, saisissez le code suivant dans la boucle foreach :
If (Not myParameterValue.IsRange) Then
End If
if(!parameterValue.IsRange)
{
}
9.
Ou, si la propri&eacute;t&eacute; disponible est Kind (DiscreteOrRangeKind, une &eacute;num&eacute;ration comportant trois valeurs :
DiscreteValue, RangeValue, DiscreteAndRangeValue), saisissez le code suivant dans la boucle
foreach :
If (myParameterValue.Kind = DiscreteOrRangeKind.DiscreteValue) Then
End If
if(parameterValue.Kind == DiscreteOrRangeKind.DiscreteValue)
{
}
10. Dans le bloc conditionnel imbriqu&eacute;, effectuez un cast de l'instance ParameterValue en sa classe &eacute;tendue
DiscreteParameterValue.
Dim myParameterDiscreteValue As ParameterDiscreteValue =
CType(myParameterValue, ParameterDiscreteValue)
ParameterDiscreteValue parameterDiscreteValue =
(ParameterDiscreteValue)parameterValue;
11. Dans le bloc conditionnel imbriqu&eacute;, ajoutez la propri&eacute;t&eacute; Value de l'instance ParameterDiscreteValue
(convertie en cha&icirc;ne) dans l'instance ArrayList.
myArrayList.Add(myParameterDiscreteValue.Value.ToString())
arrayList.Add(parameterDiscreteValue.Value.ToString());
12. En dehors du bloc conditionnel et de la boucle foreach, en fin de m&eacute;thode, renvoyez l'instance ArrayList
depuis la m&eacute;thode.
Return myArrayList
266
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
return arrayList;
1.5.1.2.4.3
Pour lier l'ArrayList renvoy&eacute;e de la m&eacute;thode au
contr&ocirc;le ListBox dans un projet Web
Contexte
Vous avez extrait les valeurs par d&eacute;faut du champ de param&egrave;tre et les avez renvoy&eacute;es de la m&eacute;thode sous la
forme d'une ArrayList. Vous allez maintenant lier cette ArrayList au contr&ocirc;le ListBox
defaultParameterValuesList.
Le code varie l&eacute;g&egrave;rement selon que vous utilisez un projet Web ou un projet Windows ; en cons&eacute;quence, vous ne
devez effectuer que l'une des proc&eacute;dures Web ou Windows ci-apr&egrave;s.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code,
imm&eacute;diatement apr&egrave;s la ligne de code qui extrait l'instance ParameterFields.
2.
Dans les sauts de ligne, cr&eacute;ez un bloc conditionnel Not IsPostBack.
Remarque
Le bloc conditionnel Not IsPostBack est utilis&eacute; pour encapsuler du code devant &ecirc;tre ex&eacute;cut&eacute;
uniquement lors du premier chargement de la page. Les contr&ocirc;les sont g&eacute;n&eacute;ralement li&eacute;s aux valeurs de
donn&eacute;es dans des blocs conditionnels Not IsPostBack afin que leurs valeurs de donn&eacute;es (et tout
&eacute;v&eacute;nement de contr&ocirc;le suivant) ne soient pas red&eacute;finies lorsque les pages sont recharg&eacute;es.
If Not IsPostBack Then
End If
if(!IsPostBack)
{
}
3.
Dans le bloc conditionnel Not IsPostBack, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox
defaultParameterValuesList la m&eacute;thode d'assistance GetDefaultValuesFromParameterField(),
en transmettant l'instance ParameterFields en tant que param&egrave;tre de m&eacute;thode.
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(myParameterFields)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
267
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(parameterFields);
4.
Toujours dans le bloc conditionnel Not IsPostBack, appelez la m&eacute;thode DataBind() du contr&ocirc;le ListBox
defaultParameterValuesList.
defaultParameterValuesList.DataBind()
defaultParameterValuesList.DataBind();
1.5.1.2.4.4
Pour lier l'ArrayList renvoy&eacute;e de la m&eacute;thode au
contr&ocirc;le ListBox dans un projet Windows
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code,
imm&eacute;diatement apr&egrave;s la ligne de code qui extrait l'instance ParameterFields.
Dans ces sauts de ligne, vous pouvez &agrave; pr&eacute;sent saisir un code suppl&eacute;mentaire d&eacute;finissant la source de
donn&eacute;es du contr&ocirc;le ListBox defaultParameterValuesList lors du premier chargement de la page.
2.
Dans les sauts de lignes, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox defaultParameterValuesList
la m&eacute;thode d'assistance GetDefaultValuesFromParameterField(), en transmettant l'instance
ParameterFields en tant que param&egrave;tre de m&eacute;thode.
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(myParameterFields)
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(parameterFields);
1.5.1.2.4.5
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er et ex&eacute;cuter le projet pour v&eacute;rifier si la zone de texte
defaultParameterValuesList est renseign&eacute;e.
268
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le contr&ocirc;le ListBox ListBox defaultParameterValuesList affiche la liste compl&egrave;te des valeurs par
d&eacute;faut (dans ce tutoriel, il s'agit de villes).
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.2.5
ListBox
D&eacute;finition des param&egrave;tres &agrave; partir des s&eacute;lections
Dans cette section, vous allez ajouter un bouton pour r&eacute;afficher le rapport en fonction des s&eacute;lections du contr&ocirc;le
ListBox defaultParameterValuesList. Dans la m&eacute;thode d'&eacute;v&eacute;nement de ce bouton, vous appellerez la
m&ecirc;me m&eacute;thode que celle appel&eacute;e lors du premier chargement de la page :
SetCurrentValuesForParameterField(). Mais cette fois, au lieu de transmettre des valeurs arbitraires
(Paris et Tokyo), vous transmettrez les valeurs s&eacute;lectionn&eacute;es depuis le contr&ocirc;le ListBox
defaultParameterValuesList.
1.5.1.2.5.1
Pour cr&eacute;er et configurer un contr&ocirc;le Button de
r&eacute;affichage sur le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button &agrave; droite du contr&ocirc;le ListBox.
4.
Cliquez sur le contr&ocirc;le Button pour le s&eacute;lectionner.
5.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, proc&eacute;dez comme suit :
a) Attribuez &agrave; ID ou Name la valeur &quot;redisplay&quot;.
b) Attribuez &agrave; Text la valeur &quot;R&eacute;afficher le rapport&quot;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
269
1.5.1.2.5.2
Pour cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement de clic du
contr&ocirc;le Button de r&eacute;affichage dans un projet Web
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er une m&eacute;thode d'&eacute;v&eacute;nement de clic qui recherche des &eacute;l&eacute;ments s&eacute;lectionn&eacute;s
dans le contr&ocirc;le ListBox et les transmet &agrave; la m&eacute;thode SetCurrentValuesForParameterField().
Le code varie l&eacute;g&egrave;rement pour un projet Web ou un projet Windows ; en cons&eacute;quence, vous ne devez effectuer
que l'une des proc&eacute;dures Web ou Windows ci-apr&egrave;s.
Proc&eacute;dure
1.
Cliquez deux fois sur le bouton R&eacute;afficher le rapport.
Cette op&eacute;ration affiche la classe code-behind dans laquelle une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click()
a &eacute;t&eacute; g&eacute;n&eacute;r&eacute;e automatiquement.
2.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe de l'espace de noms System.Web.UI.WebControls (si cet espace de noms n'a pas
d&eacute;j&agrave; &eacute;t&eacute; d&eacute;clar&eacute;).
Imports System.Web.UI.WebControls
using System.Web.UI.WebControls;
3.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() qui vient d'&ecirc;tre automatiquement g&eacute;n&eacute;r&eacute;e, d&eacute;clarez et
instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
4.
Cr&eacute;ez une boucle foreach pour extraire chaque instance ListItem de la propri&eacute;t&eacute; Items du contr&ocirc;le
ListBox defaultParameterValuesList.
For Each item As ListItem In defaultParameterValuesList.Items
Next
foreach(ListItem item in defaultParameterValuesList.Items)
{
}
270
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Dans la boucle foreach, cr&eacute;ez un bloc conditionnel imbriqu&eacute; qui v&eacute;rifie si la propri&eacute;t&eacute; Selected de l'instance
actuelle Item a pour valeur True.
If item.Selected Then
End If
if(item.Selected)
{
}
6.
Dans le bloc conditionnel, ajoutez la propri&eacute;t&eacute; Value de l'instance Item &agrave; l'instance ArrayList.
myArrayList.Add(item.Value)
arrayList.Add(item.Value);
7.
En dehors du bloc conditionnel et de la boucle foreach, liez &agrave; nouveau le chemin d'acc&egrave;s au r&eacute;pertoire du
rapport CustomersByCity &agrave; la propri&eacute;t&eacute; ReportSource de la classe CrystalReportViewer.
Remarque
Le chemin d'acc&egrave;s au fichier indiqu&eacute; ci-dessous s'applique &agrave; un projet Visual Studio. &quot;NomProjet&quot; est
remplac&eacute; par le nom de votre site Web. &quot;NomUtilisateur&quot; est remplac&eacute; par votre nom de connexion.
Le chemin par d&eacute;faut d'un projet de site Web est le suivant :
myCrystalReportViewer.ReportSource = &quot;C:\WebSites\NomProjet\CustomersByCity.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\WebSites\\ NomProjet\
\CustomersByCity.rpt&quot;;
8.
Extrayez l'instance ParameterFields de la propri&eacute;t&eacute; ParameterFieldInfo du contr&ocirc;le
CrystalReportViewer.
Dim myParameterFields As ParameterFields =
myCrystalReportViewer.ParameterFieldInfo
ParameterFields parameterFields =
crystalReportViewer.ParameterFieldInfo;
9.
Transmettez l'instance ParameterFields et l'instance ArrayList &agrave; la m&eacute;thode
SetCurrentValuesForParameterField().
SetCurrentValuesForParameterField(myParameterFields, myArrayList)
SetCurrentValuesForParameterField(parameterFields, arrayList);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
271
1.5.1.2.5.3
Pour cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement de clic du
contr&ocirc;le Button de r&eacute;affichage dans un projet Windows
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button de r&eacute;affichage.
Cette op&eacute;ration affiche la classe code-behind dans laquelle une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click()
a &eacute;t&eacute; g&eacute;n&eacute;r&eacute;e automatiquement.
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() qui vient d'&ecirc;tre automatiquement g&eacute;n&eacute;r&eacute;e, d&eacute;clarez et
instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
3.
Cr&eacute;ez une boucle foreach pour extraire chaque &eacute;l&eacute;ment (sous forme de cha&icirc;ne) de la propri&eacute;t&eacute;
SelectedItems du contr&ocirc;le ListBox defaultParameterValuesList.
For Each item As String In defaultParameterValuesList.SelectedItems
Next
foreach(string item in defaultParameterValuesList.SelectedItems)
{
}
4.
Dans la boucle foreach, ajoutez l'instance cha&icirc;ne item &agrave; l'instance ArrayList.
myArrayList.Add(item)
arrayList.Add(item);
5.
En dehors de la boucle foreach, liez &agrave; nouveau le chemin d'acc&egrave;s au r&eacute;pertoire du rapport CustomersByCity &agrave;
la propri&eacute;t&eacute; ReportSource de la classe CrystalReportViewer.
Remarque
Le chemin d'acc&egrave;s au fichier indiqu&eacute; ci-dessous s'applique &agrave; un projet Visual Studio. &quot;NomProjet&quot; est
remplac&eacute; par le nom de votre projet Windows. &quot;NomUtilisateur&quot; est remplac&eacute; par votre nom de connexion.
Le chemin par d&eacute;faut d'un projet Windows est le suivant :
myCrystalReportViewer.ReportSource = &quot;C:\Documents and Settings\NomUtilisateur
\Mes Documents\Visual Studio\Projects\NomProjet\CustomersByCity.rpt&quot;
272
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
crystalReportViewer.ReportSource = &quot;C:\\Documents and Settings\\NomUtilisateur\
\Mes Documents\\Visual Studio\\Projects\\NomProjet\\CustomersByCity.rpt&quot;;
6.
Extrayez l'instance ParameterFields de la propri&eacute;t&eacute; ParameterFieldInfo du contr&ocirc;le
CrystalReportViewer.
Dim myParameterFields As ParameterFields =
myCrystalReportViewer.ParameterFieldInfo
ParameterFields parameterFields =
crystalReportViewer.ParameterFieldInfo;
7.
Transmettez l'instance ParameterFields et l'instance ArrayList &agrave; la m&eacute;thode
SetCurrentValuesForParameterField().
SetCurrentValuesForParameterField(myParameterFields, myArrayList)
SetCurrentValuesForParameterField(parameterFields, arrayList);
1.5.1.2.5.4
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Contexte
Les valeurs s&eacute;lectionn&eacute;es du contr&ocirc;le ListBox ayant &eacute;t&eacute; appliqu&eacute;es comme valeurs actuelles du champ de
param&egrave;tre, vous &ecirc;tes maintenant pr&ecirc;t &agrave; r&eacute;afficher le rapport.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier si le champ de param&egrave;tre a bien &eacute;t&eacute;
correctement red&eacute;fini.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, cliquez sur des villes diff&eacute;rentes dans la liste en maintenant la touche Ctrl enfonc&eacute;e.
5.
Cliquez sur le bouton R&eacute;afficher le rapport.
La page est recharg&eacute;e, affichant les enregistrements des clients qui vivent dans les villes s&eacute;lectionn&eacute;es dans
la liste.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
273
1.5.1.2.6
Configuration de la persistance des param&egrave;tres
Dans cette section, vous allez configurer la persistance (dans un tutoriel via le Web) des s&eacute;lections des champs de
param&egrave;tre effectu&eacute;es &agrave; partir du contr&ocirc;le ListBox.
1.5.1.2.6.1
Pour ajouter un code de persistance &agrave; la m&eacute;thode
ConfigureCrystalReports()
Contexte
Vous devez ajouter un code de persistance &agrave; votre application afin que les modifications apport&eacute;es soient rendues
persistantes lorsque les pages Web sont recharg&eacute;es.
Pour commencer, vous allez ajouter un code de persistance &agrave; la m&eacute;thode ConfigureCrystalReports() en
ajoutant un bloc Else au bloc conditionnel If Not IsPostBack. Vous allez ensuite d&eacute;finir des valeurs uniques
pour l'instance ArrayList pour l'une des deux conditions du bloc conditionnel. A l'ouverture de la page, vous
allez d&eacute;finir les valeurs par d&eacute;faut (&quot;Paris&quot; et &quot;Tokyo&quot;) dans l'instance ArrayList. Au rechargement de la page,
vous allez extraire l'instance ArrayList stock&eacute;e dans Session.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), coupez et collez au bas du bloc conditionnel Not
IsPostBack les deux lignes de code permettant d'ajouter Paris et Tokyo &agrave; l'instance ArrayList.
Lorsque vous avez termin&eacute;, le bloc conditionnel doit ressembler &agrave; ceci :
If Not IsPostBack Then
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(myParameterFields)
defaultParameterValuesList.DataBind()
myArrayList.Add(&quot;Paris&quot;)
myArrayList.Add(&quot;Tokyo&quot;)
End If
if (!IsPostBack)
{
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(parameterFields);
defaultParameterValuesList.DataBind();
arrayList.Add(&quot;Paris&quot;);
arrayList.Add(&quot;Tokyo&quot;);
}
2.
274
Ajoutez une ligne de code finale au bloc conditionnel qui affecte l'instance ArrayList &agrave; Session.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Vous pouvez utiliser le nom de variable comme identificateur de cha&icirc;ne pour la Session ajout&eacute;e.
Session(&quot;myArrayList&quot;) = myArrayList
Session[&quot;arrayList&quot;] = arrayList;
3.
Ajoutez une condition Else au bloc conditionnel Not IsPostBack.
4.
Dans le bloc Else, extrayez l'instance ArrayList de Session, puis effectuez un cast de celle-ci en instance
ArrayList.
myArrayList = Ctype(Session(&quot;myArrayList&quot;), ArrayList)
arrayList = (ArrayList)Session[&quot;arrayList&quot;];
R&eacute;sultats
Lorsque vous avez termin&eacute;, le bloc conditionnel doit ressembler &agrave; ceci :
If Not IsPostBack Then
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(myParameterFields)
defaultParameterValuesList.DataBind()
myArrayList.Add(&quot;Paris&quot;)
myArrayList.Add(&quot;Tokyo&quot;)
Session(&quot;myArrayList&quot;) = myArrayList
Else
myArrayList = Ctype(Session(&quot;myArrayList&quot;), ArrayList)
End If
if (!IsPostBack)
{
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(parameterFields);
defaultParameterValuesList.DataBind();
arrayList.Add(&quot;Paris&quot;);
arrayList.Add(&quot;Tokyo&quot;);
Session[&quot;arrayList&quot;] = arrayList;
}
else
{
arrayList = (ArrayList)Session[&quot;arrayList&quot;];
}
Ces modifications apport&eacute;es &agrave; la m&eacute;thode ConfigureCrystalReports() permettent de garantir que l'instance
actuelle ArrayList est toujours disponible pour &ecirc;tre transmise &agrave; la m&eacute;thode
SetCurrentValuesForParameterField().
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
275
Dans la section suivante, vous allez apporter deux modifications au code dans l'&eacute;v&eacute;nement de clic :
●
S&eacute;lectionner l'instance ArrayList cr&eacute;&eacute;e et l'affecter &agrave; Session.
●
Remplacer les deux derni&egrave;res lignes de code (qui configurent et affichent le rapport) par un appel &agrave; la
m&eacute;thode ConfigureCrystalReports() afin d'ex&eacute;cuter cette fonctionnalit&eacute; sur un bloc de code commun.
1.5.1.2.6.2
Pour modifier le code de la m&eacute;thode d'&eacute;v&eacute;nement
de clic selon la persistance Session
Proc&eacute;dure
1.
Supprimez les trois derni&egrave;res lignes de code dans la m&eacute;thode d'&eacute;v&eacute;nement de clic.
○
La premi&egrave;re ligne de code &agrave; supprimer repr&eacute;sente le code qui lie le chemin d'acc&egrave;s au r&eacute;pertoire de
fichiers du rapport &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
○
La deuxi&egrave;me ligne de code &agrave; supprimer repr&eacute;sente le code qui extrait l'instance ParameterFields de la
propri&eacute;t&eacute; ParameterFieldInfo du contr&ocirc;le CrystalReportViewer.
○
La troisi&egrave;me ligne de code &agrave; supprimer repr&eacute;sente l'appel &agrave; la m&eacute;thode
SetCurrentValuesForParameterField().
Dans l'&eacute;tape suivante, vous allez ajouter deux nouvelles lignes de code pour remplacer le code supprim&eacute;.
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement de clic, imm&eacute;diatement en dehors de la boucle foreach, ajoutez une ligne de
code qui affecte l'instance ArrayList &agrave; Session.
Remarque
Vous pouvez utiliser le nom de variable comme identificateur de cha&icirc;ne pour la Session ajout&eacute;e.
Session(&quot;myArrayList&quot;) = myArrayList
Session[&quot;arrayList&quot;] = arrayList;
3.
Appeler la m&eacute;thode ConfigureCrystalReports().
Cette m&eacute;thode extrait l'instance ArrayList, l'applique au rapport, puis lie le rapport au contr&ocirc;le
CrystalReportViewer.
ConfigureCrystalReports()
ConfigureCrystalReports();
276
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.2.6.3
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier si le champ de param&egrave;tre a bien &eacute;t&eacute;
correctement red&eacute;fini.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, utilisez la combinaison de touches MAJ-clic pour s&eacute;lectionner toutes les villes dans
la liste.
5.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge et affiche les enregistrements clients de tous les clients dans toutes les villes. Il s'agit
d'un rapport volumineux contenant de nombreuses pages.
6.
Dans la barre d'outils CrystalReportViewer, cliquez sur Page suivante.
7.
La liste des villes s&eacute;lectionn&eacute;es est d&eacute;sormais rendue persistante. La page 2 du rapport s'affiche.
8.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.3
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres de
plage d'un sous-rapport
Dans ce tutoriel, vous allez traiter un probl&egrave;me suppl&eacute;mentaire : que faire si un rapport contient un sous-rapport
n&eacute;cessitant des param&egrave;tres diff&eacute;rents ?
Introduction
Dans le tutoriel pr&eacute;c&eacute;dent, Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 252], vous avez appris &agrave;
cr&eacute;er un rapport avec un param&egrave;tre discret et &agrave; cr&eacute;er un code permettant de d&eacute;finir ce param&egrave;tre au moment de
l'ex&eacute;cution, en utilisant chaque fois des valeurs de param&egrave;tres cod&eacute;es en dur et des valeurs de param&egrave;tres
transmises &agrave; partir d'un contr&ocirc;le ListBox ou TextBox.
Dans ce tutoriel, vous allez apprendre &agrave; ajouter des param&egrave;tres de plage &agrave; un sous-rapport.
Vous devez apporter quatre modifications au projet que vous avez pr&eacute;c&eacute;demment cr&eacute;&eacute; :
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
277
●
Vous ajoutez un sous-rapport au rapport d'origine.
Ce sous-rapport d&eacute;signe la table Commandes de la base de donn&eacute;es Xtreme. La table Commandes est li&eacute;e &agrave;
la table Clients utilis&eacute;e dans le tutoriel pr&eacute;c&eacute;dent par la cl&eacute; externe ID client.
●
Vous ajoutez un param&egrave;tre de plage au sous-rapport qui effectue un filtrage selon une plage de dates de
commande.
●
Vous ajoutez deux contr&ocirc;les Text au formulaire : orderStartDate et orderEndDate afin de d&eacute;finir la plage des
dates de commande au moment de l'ex&eacute;cution.
●
Vous modifiez la m&eacute;thode SetCurrentValuesForParameter() que vous avez cr&eacute;&eacute;e lors du tutoriel pr&eacute;c&eacute;dent.
Cette m&eacute;thode cr&eacute;e une instance ParameterRangeValue contenant les valeurs startDate et endDate, puis
transmet cette instance ParameterRangeValue au param&egrave;tre de plage dans le sous-rapport.
Une fois le tutoriel termin&eacute;, vous pouvez filtrer les valeurs affich&eacute;es dans le rapport au moment de l'ex&eacute;cution. Le
code que vous ajoutez limite le nombre de villes affich&eacute;es dans le rapport principal ainsi que la plage de dates de
commande qui appara&icirc;tront dans le sous-rapport.
Ce tutoriel peut &eacute;galement &ecirc;tre effectu&eacute; avec des classes du mod&egrave;le d'objet ReportDocument ; voir Tutoriel :
Lecture et d&eacute;finition des param&egrave;tres avec un sous-rapport [page 418] utilisant le mod&egrave;le d'objet
ReportDocument.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_CRVObjMod_ParametersSubrpt
●
Projet Windows C# : CS_Win_CRVObjMod_ParametersSubrpt
●
Site Web Visual Basic : VB_Web_CRVObjMod_ParametersSubrpt
●
Projet Windows Visual Basic : VB_Win_CRVObjMod_ParametersSubrpt
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.1.3.1
Ajout d'un sous-rapport au rapport d'origine
Pour commencer, vous ajoutez un sous-rapport au rapport d'origine.
278
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.3.1.1
Pour ajouter un sous-rapport
Proc&eacute;dure
1.
Ouvrez le projet que vous avez cr&eacute;&eacute; dans le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
discrets [page 252].
2.
Dans l'Explorateur de solutions, cliquez deux fois sur le rapport CustomersByCity pour l'ouvrir.
3.
Cliquez avec le bouton droit de la souris sur la barre grise D&eacute;tails et s&eacute;lectionnez Ins&eacute;rer une section en
dessous.
4.
Cliquez avec le bouton droit de la souris sur la nouvelle section D&eacute;tails b que vous avez cr&eacute;&eacute;e, s&eacute;lectionnez
Ins&eacute;rer, puis cliquez sur Sous-rapport.
Un carr&eacute; gris encadre le curseur de la souris.
5.
Faites glisser le rectangle gris sur la nouvelle section D&eacute;tails b, puis rel&acirc;chez le bouton de la souris.
6.
Dans l'onglet Sous-rapport de la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez Cr&eacute;er un sous-rapport
&agrave; l'aide de l'Assistant de cr&eacute;ation de rapports.
Remarque
La bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport inclut d'autres options permettant de s&eacute;lectionner un rapport
existant et des sous-rapports &agrave; la demande. Pour en savoir plus sur ces fonctionnalit&eacute;s, voir Onglet Sousrapport (bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport) [page 939].
7.
Dans le champ Nom du nouveau rapport, saisissez &quot;CustomerOrders&quot;.
8.
Cliquez sur Assistant de cr&eacute;ation de rapports...
9.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
10. Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
11. Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; la base de donn&eacute;es Xtreme,
puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
12. S&eacute;lectionnez la table Commandes et cliquez sur le bouton &gt; pour la d&eacute;placer dans le panneau Tables
s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
13. Dans le panneau Champs disponibles, s&eacute;lectionnez ID commande, Date de commande, Date d'exp&eacute;dition et
Transporteur.
14. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Terminer.
15. Dans la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez l'onglet Mise en relation.
16. Dans la liste Champs disponibles du panneau Champs du rapport principal &agrave; mettre en relation, d&eacute;veloppez la
table Clients, s&eacute;lectionnez ID client, puis cliquez sur le bouton &gt;.
17. Dans le panneau Mise en relation du champ Clients.ID client qui s'affiche, laissez les s&eacute;lections par d&eacute;faut.
Ces s&eacute;lections de param&egrave;tres et de donn&eacute;es g&eacute;n&egrave;rent automatiquement une relation entre le rapport
principal et le sous-rapport.
18. Cliquez sur OK.
Le nouveau sous-rapport, CustomerOrders, s'affiche dans la section D&eacute;tails b du rapport principal.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
279
Remarque
Lorsque vous ajoutez un sous-rapport &agrave; la section D&eacute;tails, le sous-rapport s'affiche pour chaque ligne, ce
qui influe sur les performances du rapport. Si vous ne souhaitez pas obtenir des informations aussi
d&eacute;taill&eacute;es, placez le sous-rapport dans une section Groupe plut&ocirc;t qu'une section D&eacute;tails.
1.5.1.3.1.2
Pour v&eacute;rifier les param&egrave;tres du sous-rapport
Proc&eacute;dure
1.
Dans la section D&eacute;tails du rapport, cliquez deux fois sur le sous-rapport CustomerOrders pour l'afficher.
Des boutons de navigation apparaissent au bas de la fen&ecirc;tre du concepteur &agrave; la fois pour le rapport principal
et le sous-rapport CustomerOrders.
2.
Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/D&eacute;sactiver l'affichage du champ dans la barre
d'outils Crystal Reports.
Remarque
Vous pouvez &eacute;galement afficher l'Explorateur de champs en ouvrant le menu Crystal Reports, puis en
cliquant sur Explorateur de champs.
3.
Dans l'Explorateur de champs, d&eacute;veloppez Champs de param&egrave;tre.
4.
V&eacute;rifiez que le champ de param&egrave;tre Pm-Clients.ID Client a &eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute; lorsque le
sous-rapport a &eacute;t&eacute; reli&eacute;.
5.
Dans la barre d'outils Crystal Reports, cliquez sur Expert S&eacute;lection.
6.
Dans la bo&icirc;te de dialogue Expert S&eacute;lection, v&eacute;rifiez que le crit&egrave;re Commandes.ID Client est &eacute;gal &agrave;
{Pm-Clients.ID Client} est d&eacute;fini, puis cliquez sur OK.
7.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous avez r&eacute;ussi &agrave; ajouter un sous-rapport CustomerOrders au rapport CustomersByCity.
280
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.3.1.3
Pour ajouter un param&egrave;tre OrderDateRange au
sous-rapport
Proc&eacute;dure
1.
Dans l'Explorateur de champs, cliquez avec le bouton droit de la souris sur Champs de param&egrave;tre et
s&eacute;lectionnez Nouveau.
2.
Dans la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre :
a) Attribuez &agrave; Nom la valeur &quot;OrderDateRange&quot;.
b) Attribuez &agrave; Texte de l'invite la valeur &quot;Sp&eacute;cifiez une plage de dates des commandes &agrave; afficher&quot;.
c) Attribuez &agrave; Type de valeur la valeur &quot;Date&quot;.
d) Attribuez au param&egrave;tre Options une seule s&eacute;lection, &quot;Valeur(s) de plage&quot;.
3.
Cliquez sur OK.
4.
Dans la barre d'outils Crystal Reports, cliquez sur Expert S&eacute;lection.
5.
Cliquez sur l'onglet Nouveau.
6.
Dans la bo&icirc;te de dialogue Choisir un champ, d&eacute;veloppez la table Commandes, s&eacute;lectionnez Date de
commande, puis cliquez sur OK.
7.
Dans le nouvel onglet Commandes.date de commande, s&eacute;lectionnez formule dans la liste d&eacute;roulante des
crit&egrave;res : {Commandes.date de commande} in {?OrderDateRange}
8.
Cliquez sur OK.
9.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
Vous avez r&eacute;ussi &agrave; ajouter un param&egrave;tre OrderDateRange au sous-rapport et &agrave; l'associer &agrave; la colonne
Commandes.Date de commande. Dans la section suivante, vous allez ajouter un code afin de d&eacute;signer le
param&egrave;tre OrderDateRange dans le sous-rapport.
1.5.1.3.2
Ajout du code de param&egrave;tre au sous-rapport
Contexte
Vous allez &agrave; pr&eacute;sent ajouter le code de param&egrave;tre du sous-rapport &agrave; la classe code-behind. Vous commencez par
cr&eacute;er une m&eacute;thode d'assistance priv&eacute;e SetDateRangeForOrders().
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
281
3.
Au d&eacute;but de la classe, ajoutez deux nouvelles constantes sous la constante PARAMETER_FIELD_NAME
existante d&eacute;finie dans le tutoriel pr&eacute;c&eacute;dent.
Private Const SUBREPORT_PARAMETER_FIELD_NAME As String =
&quot;OrderDateRange&quot;
Private Const SUBREPORT_NAME As String = &quot;CustomerOrders&quot;
private const string SUBREPORT_PARAMETER_FIELD_NAME =
&quot;OrderDateRange&quot;;
private const string SUBREPORT_NAME = &quot;CustomerOrders&quot;;
4.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e SetDateRangeForOrders() avec
les trois param&egrave;tres suivants : ParameterFields, une cha&icirc;ne startDate et une cha&icirc;ne endDate.
Private Sub SetDateRangeForOrders(ByVal myParameterFields As
ParameterFields, ByVal startDate As String, ByVal endDate As
String)
End Sub
private void SetDateRangeForOrders(ParameterFields parameterFields,
string startDate, string endDate)
{
}
5.
Dans cette m&eacute;thode, d&eacute;clarez et instanciez la classe ParameterRangeValue.
Remarque
Pour que la classe ParameterRangeValue soit accessible, vous devez inclure une instruction &quot;Imports&quot;
[Visual Basic] ou &quot;using&quot; [C#] dans la partie sup&eacute;rieure de la classe code-behind pour l'espace de
noms CrystalDecisions.Shared. (Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration
d'un projet [page 15].)
Dim myParameterRangeValue As ParameterRangeValue = New
ParameterRangeValue()
ParameterRangeValue parameterRangeValue = new
ParameterRangeValue();
6.
Attribuez &agrave; la propri&eacute;t&eacute; StartValue de l'instance ParameterRangeValue le param&egrave;tre de m&eacute;thode
startDate.
Remarque
Les propri&eacute;t&eacute;s StartValue et EndValue de la classe ParameterRangeValue acceptent les valeurs de
type Object. Ce type g&eacute;n&eacute;rique permet de transmettre la valeur de plage sous plusieurs formes, y compris
texte, nombre, date, devise ou heure.
myParameterRangeValue.StartValue = startDate
282
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
parameterRangeValue.StartValue = startDate;
7.
Attribuez &agrave; la propri&eacute;t&eacute; EndValue de l'instance ParameterRangeValue le param&egrave;tre de m&eacute;thode endDate.
myParameterRangeValue.EndValue = endDate
parameterRangeValue.EndValue = endDate;
8.
D&eacute;finissez les limites inf&eacute;rieures et sup&eacute;rieures afin de les inclure.
Remarque
Pour le param&egrave;tre BoundInclusive, les valeurs de plage sup&eacute;rieures et inf&eacute;rieures sont incluses dans la
plage.
myParameterRangeValue.LowerBoundType =
RangeBoundType.BoundInclusive
myParameterRangeValue.UpperBoundType =
RangeBoundType.BoundInclusive
parameterRangeValue.LowerBoundType = RangeBoundType.BoundInclusive;
parameterRangeValue.UpperBoundType = RangeBoundType.BoundInclusive;
Vous allez &agrave; pr&eacute;sent affecter l'instance ParameterRangeValue au param&egrave;tre du sous-rapport.
9.
Extrayez l'instance ParameterField de la classe index&eacute;e ParameterFields, bas&eacute;e sur les deux valeurs
index&eacute;es suivantes : le nom du champ de param&egrave;tre du sous-rapport et le nom du sous-rapport. Transmettez
les deux valeurs de constante que vous avez d&eacute;clar&eacute;es au d&eacute;but de la classe.
Dim myParameterField As ParameterField =
myParameterFields(SUBREPORT_PARAMETER_FIELD_NAME, SUBREPORT_NAME)
ParameterField parameterField =
parameterFields[SUBREPORT_PARAMETER_FIELD_NAME, SUBREPORT_NAME];
10. Appelez la m&eacute;thode Clear() de la propri&eacute;t&eacute; CurrentValues de l'instance ParameterField afin de supprimer
les &eacute;ventuelles valeurs existantes de la propri&eacute;t&eacute; CurrentValues.
myParameterField.CurrentValues.Clear()
parameterField.CurrentValues.Clear();
11. Ajoutez l'instance ParameterRangeValue que vous venez de cr&eacute;er &agrave; la propri&eacute;t&eacute; CurrentValues de
l'instance ParameterField.
myParameterField.CurrentValues.Add(myParameterRangeValue)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
283
parameterField.CurrentValues.Add(parameterRangeValue);
R&eacute;sultats
Cette proc&eacute;dure a d&eacute;fini des valeurs de date de d&eacute;but et de fin dans une instance ParameterRangeValue et les a
transmises au param&egrave;tre OrderDateRange du sous-rapport CustomerOrders.
1.5.1.3.3
Ajout de contr&ocirc;les TextBox pour contenir les
valeurs de param&egrave;tres de plage
Dans cette section, vous allez ajouter deux contr&ocirc;les TextBox pour transmettre au param&egrave;tre de plage
OrderDateRange des valeurs de date de d&eacute;but et de date de fin au moment de l'ex&eacute;cution dans le sous-rapport
CustomerOrders.
Remarque
Si vous impl&eacute;mentez ce tutoriel dans un site Web, la persistance des valeurs de date que les utilisateurs
saisissent dans les zones de texte est conserv&eacute;e par ViewState.
1.5.1.3.3.1
Pour cr&eacute;er et configurer un contr&ocirc;le Button de
r&eacute;affichage sur le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez entre le contr&ocirc;le ListBox et le contr&ocirc;le Button.
b) Appuyez trois fois sur ENTREE pour ins&eacute;rer deux lignes entre le contr&ocirc;le ListBox et le contr&ocirc;le Button.
c) Sur la premi&egrave;re ligne cr&eacute;&eacute;e sous le contr&ocirc;le ListBox, saisissez Date de d&eacute;but de la commande.
d) Sur la seconde ligne cr&eacute;&eacute;e sous le contr&ocirc;le ListBox, saisissez Date de fin de la commande.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Dans la bo&icirc;te &agrave; outils, faites glisser deux contr&ocirc;les Label &agrave; droite du contr&ocirc;le ListBox. Placez une
&eacute;tiquette sur l'autre, en positionnant les deux &eacute;tiquettes au-dessus du contr&ocirc;le Button.
b) S&eacute;lectionnez le premier contr&ocirc;le Label, puis attribuez &agrave; la propri&eacute;t&eacute; Text la valeur Date de d&eacute;but de
la commande dans la fen&ecirc;tre Propri&eacute;t&eacute;s.
c) S&eacute;lectionnez le second contr&ocirc;le Label, puis attribuez &agrave; la propri&eacute;t&eacute; Text la valeur Date de fin de la
commande dans la fen&ecirc;tre Propri&eacute;t&eacute;s.
284
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le &agrave; droite de &quot;Date de d&eacute;but de la commande.&quot;
6.
Cliquez sur le contr&ocirc;le TextBox pour le s&eacute;lectionner.
7.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur orderStartDate.
8.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite de &quot;Date de fin de la commande.&quot;
9.
Cliquez sur le contr&ocirc;le TextBox pour le s&eacute;lectionner.
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur orderEndDate.
11. Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.1.3.4
Modification des m&eacute;thodes d'appel du sous-rapport
Vous devez &agrave; pr&eacute;sent modifier la m&eacute;thode ConfigureCrystalReports() et la m&eacute;thode d'&eacute;v&eacute;nement
redisplay_Click() pour recevoir des informations de ces contr&ocirc;les TextBox, les appliquer &agrave; la m&eacute;thode
SetDateRangeForOrders() et traiter les informations de param&egrave;tre pour les sous-rapports.
Dans le tutoriel pr&eacute;c&eacute;dent, Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 252], vous avez con&ccedil;u ces
m&eacute;thodes de deux fa&ccedil;ons diff&eacute;rentes si vous avez inclus la persistance Session.
Remarque
Les projets Windows ne n&eacute;cessitent aucune persistance Session. Les sites Web n&eacute;cessitent g&eacute;n&eacute;ralement la
persistance Session.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous. Modifiez les m&eacute;thodes qui excluent la
persistance Session ou les m&eacute;thodes qui incluent la persistance Session :
1.5.1.3.4.1
Modification des m&eacute;thodes qui excluent la
persistance Session
Si vous avez cr&eacute;&eacute; le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 252] et exclu
la persistance Session, effectuez les proc&eacute;dures suivantes. Sinon, effectuez la proc&eacute;dure Modification des
m&eacute;thodes qui incluent la persistance Session [page 287].
1.5.1.3.4.1.1
Pour modifier la m&eacute;thode
ConfigureCrystalReports() excluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s les lignes
qui affectent &quot;Paris&quot; et &quot;Tokyo&quot; comme variables ArrayList.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
285
2.
Dans les sauts de ligne, d&eacute;clarez et d&eacute;finissez des valeurs en code dur pour les deux variables cha&icirc;ne,
startDate et endDate.
Dim startDate As String = &quot;1/8/1997&quot;
Dim endDate As String = &quot;31/8/1997&quot;
string startDate = &quot;1/8/1997&quot;;
string endDate = &quot;31/8/1997&quot;;
3.
Sous le code qui appelle la m&eacute;thode SetCurrentValuesForParameterField(), appelez la m&eacute;thode
SetDateRangeForOrders() et transmettez l'instance ParameterFields et les variables startDate et
endDate.
SetDateRangeForOrders(myParameterFields, startDate, endDate)
SetDateRangeForOrders(parameterFields, startDate, endDate);
4.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.1.3.4.1.2
Pour modifier la m&eacute;thode redisplay_Click()
excluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus
de la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
2.
Dans les sauts de ligne, d&eacute;clarez et d&eacute;finissez les valeurs des deux variables cha&icirc;ne startDate et endDate &agrave;
partir des contr&ocirc;les TextBox que vous avez ajout&eacute;s au Web Form ou Windows Form.
Dim startDate As String = orderStartDate.Text
Dim endDate As String = orderEndDate.Text
string startDate = orderStartDate.Text;
string endDate = orderEndDate.Text;
3.
Sous le code qui appelle la m&eacute;thode SetCurrentValuesForParameterField(), appelez la m&eacute;thode
SetDateRangeForOrders() et transmettez l'instance ParameterFields et les variables startDate et
endDate.
SetDateRangeForOrders(myParameterFields, startDate, endDate)
SetDateRangeForOrders(parameterFields, startDate, endDate);
286
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
4.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.1.3.4.2
Modification des m&eacute;thodes qui incluent la
persistance Session
Si vous avez cr&eacute;&eacute; le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 252] et inclus
la persistance Session, effectuez les proc&eacute;dures suivantes. Sinon, effectuez la proc&eacute;dure Modification des
m&eacute;thodes qui excluent la persistance Session [page 285].
1.5.1.3.4.2.1
Pour modifier la m&eacute;thode
ConfigureCrystalReports() incluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la ligne
qui d&eacute;clare et instancie ArrayList.
2.
Dans les sauts de ligne, d&eacute;clarez deux variables cha&icirc;ne, startDate et endDate.
Dim startDate As String
Dim endDate As String
string startDate;
string endDate;
3.
Dans le bloc conditionnel Not IsPostBack, saisissez des valeurs par d&eacute;faut pour les variables startDate et
endDate.
startDate = &quot;1/8/1997&quot;
endDate = &quot;31/8/1997&quot;
startDate = &quot;1/8/1997&quot;;
endDate = &quot;31/8/1997&quot;;
4.
Dans le bloc conditionnel Not IsPostBack, affectez les variables startDate et endDate &agrave; Session.
Session(&quot;startDate&quot;) = startDate
Session(&quot;endDate&quot;) = endDate
Session[&quot;startDate&quot;] = startDate;
Session[&quot;endDate&quot;] = endDate;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
287
5.
Dans le bloc Else, apr&egrave;s l'extraction de l'instance ArrayList de Session, extrayez les variables startDate et
endDate de Session.
startDate = Session(&quot;startDate&quot;).ToString()
endDate = Session(&quot;endDate&quot;).ToString()
startDate = Session[&quot;startDate&quot;].ToString();
endDate = Session[&quot;endDate&quot;].ToString();
Cette approche permet d'atteindre la fin du bloc avec les variables de date affect&eacute;es dans les deux cas. Cette
m&eacute;thode suit la logique parall&egrave;le de l'affectation de la variable ArrayList que vous avez configur&eacute;e dans le
tutoriel pr&eacute;c&eacute;dent.
6.
Sous le code qui appelle la m&eacute;thode SetCurrentValuesForParameterField(), appelez la m&eacute;thode
SetDateRangeForOrders() et transmettez l'instance ParameterFields et les variables startDate et
endDate.
SetDateRangeForOrders(myParameterFields, startDate, endDate)
SetDateRangeForOrders(parameterFields, startDate, endDate);
7.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.1.3.4.2.2
Pour modifier la m&eacute;thode redisplay_Click()
incluant la persistance Session
Contexte
Modifiez &agrave; pr&eacute;sent la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click.
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la
ligne qui affecte l'instance ArrayList &agrave; Session.
2.
Dans les sauts de ligne, affectez la propri&eacute;t&eacute; Text des contr&ocirc;les TextBox orderStartDate et orderEndDate aux
variables Session.
Session(&quot;startDate&quot;) = orderStartDate.Text
Session(&quot;endDate&quot;) = orderEndDate.Text
Session[&quot;startDate&quot;] = orderStartDate.Text;
Session[&quot;endDate&quot;] = orderEndDate.Text;
288
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Ces valeurs Session startDate et endDate sont &agrave; pr&eacute;sent extraites et appliqu&eacute;es lors de l'appel de la m&eacute;thode
ConfigureCrystalReports().
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier que les valeurs TextBox red&eacute;finissent le
param&egrave;tre de plage dans le sous-rapport.
1.5.1.3.5
V&eacute;rification du param&egrave;tre du sous-rapport
Contexte
Vous allez &agrave; pr&eacute;sent v&eacute;rifier le param&egrave;tre du sous-rapport &agrave; partir des valeurs TextBox.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, cliquez sur au moins quatre villes diff&eacute;rentes dans la liste en maintenant la touche
Ctrl enfonc&eacute;e.
5.
Dans le contr&ocirc;le TextBox orderStartDate, saisissez 1/1/1997.
6.
Dans le contr&ocirc;le TextBox orderEndDate, saisissez 8/31/1997.
7.
Cliquez sur le bouton R&eacute;afficher le rapport.
La page se recharge et affiche les enregistrements des clients qui vivent dans les villes que vous venez de
s&eacute;lectionner dans la liste, ainsi qu'un sous-rapport indiquant les commandes correspondant &agrave; la plage de
dates sp&eacute;cifi&eacute;es ci-dessus.
8.
Dans le contr&ocirc;le CrystalReportViewer, augmentez le facteur de zoom &agrave; 125 %.
La page se recharge avec un facteur de zoom de 125 %. Les valeurs s&eacute;lectionn&eacute;es &agrave; la fois pour les villes et la
plage des dates de commande sont rendues persistantes.
9.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
289
1.5.1.4
Tutoriel : Filtrage des donn&eacute;es &agrave; l'aide des formules
de s&eacute;lection
Dans ce tutoriel, vous allez apprendre &agrave; utiliser des formules de s&eacute;lection afin de filtrer les enregistrements &agrave;
afficher dans un rapport Crystal.
Introduction
Les formules de s&eacute;lection servent &agrave; filtrer les enregistrements &agrave; afficher dans un rapport Crystal. Pour &eacute;crire des
formules de s&eacute;lection, vous pouvez utiliser la syntaxe Basic et la syntaxe Crystal.
Dans ce tutoriel, vous allez cr&eacute;er une formule de s&eacute;lection afin de filtrer les enregistrements clients dans lesquels
le champ Ventes de l'ann&eacute;e derni&egrave;re est sup&eacute;rieur &agrave; une valeur sp&eacute;cifique et le champ Nom du client est compar&eacute;
&agrave; une autre cha&icirc;ne. Un contr&ocirc;le ListBox sert &agrave; s&eacute;lectionner un op&eacute;rateur de comparaison pour le champ Nom du
client. Vous pouvez choisir d'afficher les noms de client qui sont &eacute;gaux, inf&eacute;rieurs, sup&eacute;rieurs, inf&eacute;rieurs ou &eacute;gaux,
sup&eacute;rieurs ou &eacute;gaux, ou pas &eacute;gaux &agrave; la valeur de cha&icirc;ne que vous avez sp&eacute;cifi&eacute;e.
La formule est transmise sous forme de variable cha&icirc;ne &agrave; la propri&eacute;t&eacute; SelectionFormula de la classe
CrystalReportViewer. Une fois la propri&eacute;t&eacute; d&eacute;finie, le rapport Crystal li&eacute; au contr&ocirc;le CrystalReportViewer est filtr&eacute;
avant d'&ecirc;tre affich&eacute;.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_CRVObjMod_FilteringData
●
Projet Windows C# : CS_Win_CRVObjMod_FilteringData
●
Site Web Visual Basic : VB_Web_CRVObjMod_FilteringData
●
Projet Windows Visual Basic : VB_Win_CRVObjMod_FilteringData
Informations associ&eacute;es
Formules - R&eacute;f&eacute;rence [page 786]
R&eacute;pertoire d'exemples de rapports [page 15]
290
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.4.1
s&eacute;lection
Cr&eacute;ation d'un rapport avec une formule de
Dans cette section, vous cr&eacute;ez un rapport &agrave; partir des informations de la base de donn&eacute;es Xtreme.
1.5.1.4.1.1
Pour cr&eacute;er un rapport avec des donn&eacute;es
s&eacute;curis&eacute;es de la base de donn&eacute;es Xtreme
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom CustomersBySalesName.rpt, puis cliquez sur Ajouter.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
8.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; l'exemple de base de donn&eacute;es
Xtreme, puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
9.
D&eacute;veloppez le nœud Tables, cliquez deux fois sur la table Clients pour la d&eacute;placer dans le panneau Tables
s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
10. D&eacute;veloppez la table Clients, puis utilisez la combinaison de touches Ctrl-clic pour s&eacute;lectionner les champs
Nom du client et Ventes de l'ann&eacute;e derni&egrave;re.
11. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
12. Dans le panneau Champs disponibles, sous Champs du rapport, cliquez deux fois sur Clients.Noms du client
pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport CustomersBySalesName est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
291
1.5.1.4.1.2
Pour cr&eacute;er une formule de s&eacute;lection en fonction
du champ Ventes de l'ann&eacute;e derni&egrave;re
Contexte
Vous allez ensuite cr&eacute;er une formule de s&eacute;lection pour filtrer les donn&eacute;es en fonction du champ Ventes de l'ann&eacute;e
derni&egrave;re.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind du Web Form ou du Windows
Form.
3.
Pour un site Web, dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section
Configuration d'un projet [page 15]), cr&eacute;ez un bloc conditionnel Not IsPostBack.
Remarque
Le bloc conditionnel Not IsPostBack encapsule du code devant &ecirc;tre ex&eacute;cut&eacute; uniquement lors du premier
chargement de la page.
If Not IsPostBack Then
End If
if(!IsPostBack)
{
}
4.
Pour un site Web, ajoutez les lignes de code suivantes dans le bloc conditionnel Not IsPostBack. Pour un
projet Windows, ajoutez le code &agrave; la m&eacute;thode ConfigureCrystalReports(), sans le bloc conditionnel Not
IsPostBack.
a) Saisissez la formule afin de s&eacute;lectionner uniquement les enregistrements Ventes de l'ann&eacute;e derni&egrave;re
sup&eacute;rieurs &agrave; 11 000 $ et les clients dont le nom commence par la lettre &quot;A&quot;.
Dim mySelectFormula As String = &quot;{Customer.Last Year's Sales} &gt;
11000.00 &quot; _
&amp; &quot;AND Mid({Customer.Customer Name}, 1, 1) = &quot;&quot;A&quot;&quot; &quot;
string selectFormula = &quot;{Customer.Last Year's Sales} &gt; 11000.00
&quot;
+ &quot;AND Mid({Customer.Customer Name}, 1, 1) = \&quot;A\&quot;&quot;;
292
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
b) Affectez la cha&icirc;ne de formule de s&eacute;lection &agrave; la propri&eacute;t&eacute; SelectionFormula du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.SelectionFormula = mySelectFormula
crystalReportViewer.SelectionFormula = selectFormula;
1.5.1.4.2
Liaison du rapport
Lorsque vous avez suivi les instructions de la proc&eacute;dure Configuration d'un projet [page 15] en pr&eacute;paration de ce
tutoriel, vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer sur le Web Form ou le Windows Form. Aux &eacute;tapes
pr&eacute;c&eacute;dentes, vous avez ajout&eacute; un rapport CustomersBySalesName et une formule de s&eacute;lection au projet.
Dans cette section, vous allez lier le chemin d'acc&egrave;s au r&eacute;pertoire du rapport CustomersBySalesName au
contr&ocirc;le CrystalReportViewer. Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement avec les rapports
filtr&eacute;s selon la formule de s&eacute;lection.
1.5.1.4.2.1
Pour lier le chemin d'acc&egrave;s au r&eacute;pertoire du
rapport CustomersBySalesName au contr&ocirc;le
CrystalReportViewer.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind du Web Form ou du Windows
Form.
3.
Localisez la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration
d'un projet [page 15]).
4.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String =
Server.MapPath(&quot;CustomersBySalesName.rpt&quot;)
string reportPath = Server.MapPath(&quot;CustomersBySalesName.rpt&quot;);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
293
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;CustomersBySalesName.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; +
&quot;CustomersBySalesName.rpt&quot;;
5.
Affectez le chemin d'acc&egrave;s au r&eacute;pertoire du fichier du rapport NorthwindCustomers &agrave; la propri&eacute;t&eacute;
ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = reportPath
crystalReportViewer.ReportSource = reportPath;
1.5.1.4.2.2
Pour v&eacute;rifier la formule de s&eacute;lection du rapport
CustomersBySalesName
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport Crystal affiche quatre enregistrements clients : Alley Cat Cycles, Ankara Bicycle Company,
Arsenault et Maurier ainsi que Athens Bicycle Co.
5.
294
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.4.3
Ajout de contr&ocirc;les dans la formule de s&eacute;lection
Contexte
Dans cette section, vous allez ajouter des contr&ocirc;les pour modifier de fa&ccedil;on dynamique les valeurs utilis&eacute;es dans la
formule de s&eacute;lection. Pour le champ Ventes de l'ann&eacute;e derni&egrave;re, vous ajoutez une zone de texte pour sp&eacute;cifier la
valeur minimale des ventes &agrave; afficher dans le rapport Crystal. Pour le champ Nom du client, vous ajoutez des
contr&ocirc;les DropDownList et TextBox pour sp&eacute;cifier les noms de client &agrave; afficher.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Appuyez sur la FLECHE GAUCHE du clavier afin de faire appara&icirc;tre un curseur clignotant, puis appuyez
trois fois sur ENTREE.
Le contr&ocirc;le CrystalReportViewer descend de trois lignes.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Dock la valeur &quot;Bottom&quot;.
c) Redimensionnez le contr&ocirc;le CrystalReportViewer afin d'afficher environ trois lignes au-dessus.
d) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
5.
Si vous d&eacute;veloppez un site Web, saisissez dans la premi&egrave;re ligne Saisissez la valeur minimale des
ventes de l'ann&eacute;e derni&egrave;re : $.
6.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label en haut du formulaire.
b) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur Saisissez la valeur minimale
des ventes de l'ann&eacute;e derni&egrave;re : $.
7.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite du texte.
8.
S&eacute;lectionnez le contr&ocirc;le TextBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur lastYearsSales.
b) Attribuez &agrave; Text la valeur 11000.00.
9.
Si vous d&eacute;veloppez un site Web, saisissez dans la deuxi&egrave;me ligne Afficher les noms des clients.
10. Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label sur la deuxi&egrave;me ligne du formulaire.
b) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Afficher les noms des clients&quot;.
11. Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList (ComboBox dans un projet Windows) &agrave; droite
du texte.
12. S&eacute;lectionnez le contr&ocirc;le DropDownList (ComboBox), puis attribuez &agrave; ID (ou Name) la valeur
&quot;selectOperatorList&quot; dans la fen&ecirc;tre Propri&eacute;t&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
295
13. Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite du contr&ocirc;le DropDownList.
14. S&eacute;lectionnez le contr&ocirc;le TextBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur customerName.
b) Attribuez &agrave; Text la valeur A.
15. Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button sur la troisi&egrave;me ligne du formulaire et au-dessus du
contr&ocirc;le CrystalReportViewer.
16. S&eacute;lectionnez le contr&ocirc;le Button, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur redisplay.
b) Attribuez &agrave; Text la valeur R&eacute;afficher le rapport.
1.5.1.4.4
le code
D&eacute;finition manuelle de la formule de s&eacute;lection dans
Vous allez &agrave; pr&eacute;sent ajouter un code pour modifier la formule de s&eacute;lection dans la classe code-behind.
1.5.1.4.4.1
Pour coder la formule de s&eacute;lection
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, s&eacute;lectionnez Concepteur.
3.
Cliquez deux fois sur R&eacute;afficher le rapport.
La classe code-behind du rapport s'affiche et indique qu'une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;e.
4.
Pour la formule de s&eacute;lection, cr&eacute;ez une variable cha&icirc;ne dont les valeurs proviennent des contr&ocirc;les TextBox.
La formule de s&eacute;lection est similaire au texte que vous avez saisi dans la m&eacute;thode
ConfigureCrystalReports(). Au lieu de sp&eacute;cifier une valeur minimale de ventes de 11 000 $, vous utilisez
la valeur provenant du contr&ocirc;le TextBox lastYearsSales. Pour le champ Nom du client, vous utilisez la
valeur provenant du contr&ocirc;le TextBox customerName.
Dim mySelectFormula As String = &quot;{Customer.Last Year's Sales} &gt;
&quot; &amp; lastYearsSales.Text _
&amp; &quot; AND Mid({Customer.Customer Name}, 1, 1) &gt; &quot;&quot;&quot; &amp;
customerName.Text &amp; &quot;&quot;&quot;&quot;
string selectFormula = &quot;{Customer.Last Year's Sales} &gt; &quot; +
lastYearsSales.Text
+ &quot; AND Mid({Customer.Customer Name}, 1, 1) &gt; \&quot;&quot; +
customerName.Text + &quot;\&quot;&quot;;
296
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Affectez la variable cha&icirc;ne &agrave; la propri&eacute;t&eacute; SelectionFormula du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.SelectionFormula = mySelectFormula
crystalReportViewer.SelectionFormula = selectFormula;
6.
Liez &agrave; nouveau le rapport CustomerBySalesName &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
Remarque
Le chemin d'acc&egrave;s au fichier indiqu&eacute; ici s'applique &agrave; un projet Visual Studio. NomProjet est remplac&eacute; par le
nom de votre projet Web ou Windows. NomUtilisateur est remplac&eacute; par votre nom de connexion.
○
Le chemin par d&eacute;faut d'un projet de site Web est le suivant :
myCrystalReportViewer.ReportSource = &quot;C:\WebSites\ NomProjet
\CustomersBySalesName.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\WebSites\\ NomProjet\
\CustomersBySalesName.rpt&quot;;
○
Le chemin par d&eacute;faut d'un projet de site Windows est le suivant :
myCrystalReportViewer.ReportSource = &quot;C:\Documents and Settings\
NomUtilisateur\Mes documents\Visual Studio\Projects\ NomProjet
\CustomersBySalesName.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\Documents and Settings\\
NomUtilisateur\\Mes documents\\Visual Studio\\Projects\\ NomProjet\
\CustomersBySalesName.rpt&quot;;
R&eacute;sultats
Vous venez de cr&eacute;er une formule de s&eacute;lection que vous pouvez modifier au moment de l'ex&eacute;cution.
1.5.1.4.4.2
Pour v&eacute;rifier la formule de s&eacute;lection
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
297
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le TextBox lastYearsSales, saisissez200000.
5.
Dans le contr&ocirc;le TextBox customerName, saisissez SAB.
6.
Cliquez sur R&eacute;afficher le rapport.
Le rapport Crystal affiche trois enregistrements clients : SAB Mountain, Tek Bikes et Tienda de Bicicletas El
Pardo.
Seuls les enregistrements clients dont le nom vient apr&egrave;s les lettres &quot;SAB&quot; et dont les ventes annuelles de
l'ann&eacute;e derni&egrave;re sont sup&eacute;rieures &agrave; la valeur &quot;200000&quot; s'affichent.
7.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.4.5
Utilisation d'un contr&ocirc;le DropDownList pour
modifier la formule de s&eacute;lection
Dans cette section, vous allez remplir le contr&ocirc;le DropDownList avec des op&eacute;rateurs de comparaison. Vous
cr&eacute;ez une &eacute;num&eacute;ration contenant les op&eacute;rateurs de comparaison.
Le contr&ocirc;le DropDownList permet de choisir d'afficher les noms de client qui sont &eacute;gaux, inf&eacute;rieurs, sup&eacute;rieurs,
inf&eacute;rieurs ou &eacute;gaux, sup&eacute;rieurs ou &eacute;gaux, ou pas &eacute;gaux au texte que vous avez saisi dans le contr&ocirc;le TextBox.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), vous modifiez la cha&icirc;ne actuellement affect&eacute;e &agrave; la propri&eacute;t&eacute;
SelectionFormula du contr&ocirc;le CrystalReportViewer.
1.5.1.4.5.1
Pour cr&eacute;er une &eacute;num&eacute;ration
CeComparisonOperator
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, s&eacute;lectionnez Classe dans la vue Mod&egrave;les.
3.
Dans le champ Nom, saisissez CeComparisonOperator, puis cliquez sur Ajouter.
Remarque
Vous pouvez &ecirc;tre invit&eacute; &agrave; placer cette classe dans un r&eacute;pertoire Code. Cliquez sur le bouton Oui.
4.
Dans la signature de classe, remplacez le mot class par enum pour convertir la classe en &eacute;num&eacute;ration.
Dans un projet Windows C# pour Visual Studio, vous devez &eacute;galement remplacer l'espace de noms par le
nom de votre projet.
298
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Dans Visual Basic, n'oubliez pas de remplacer les signatures d'ouverture et de fermeture de la classe par
enum.
5.
Les &eacute;num&eacute;rations ne comportant aucun constructeur, supprimez la m&eacute;thode constructeur par d&eacute;faut qui est
fournie dans la version C# du code.
6.
Dans l'&eacute;num&eacute;ration, saisissez les valeurs suivantes :
EqualTo
LessThan
GreaterThan
LessThan_or_EqualTo
GreaterThan_or_EqualTo
Not_EqualTo
EqualTo,
LessThan,
GreaterThan,
LessThan_or_EqualTo,
GreaterThan_or_EqualTo,
Not_EqualTo
1.5.1.4.5.2
Pour remplir le contr&ocirc;le DropDownList &agrave; l'aide de
l'&eacute;num&eacute;ration CeComparisonOperator pour un site Web
Contexte
Les proc&eacute;dures suivantes indiquent comment lier l'&eacute;num&eacute;ration CeComparisonOperator au contr&ocirc;le
DropDownList pour un site Web ou un projet Windows. Suivez les instructions de l'une des proc&eacute;dures ci-dessous.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans le bloc conditionnel Not IsPostBack de la m&eacute;thode ConfigureCrystalReports(), avant la
d&eacute;claration de cha&icirc;ne de la formule de s&eacute;lection, d&eacute;finissez la propri&eacute;t&eacute; DataSource du contr&ocirc;le
DropDownList selon les valeurs de l'&eacute;num&eacute;ration CeComparisonOperator.
selectOperatorList.DataSource =
System.Enum.GetValues(GetType(CeComparisonOperator))
selectOperatorList.DataSource =
System.Enum.GetValues(typeof(CeComparisonOperator));
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
299
4.
Appelez &agrave; pr&eacute;sent la m&eacute;thode DataBind() du contr&ocirc;le DropDownList selectOperatorList pour lier les valeurs
au contr&ocirc;le.
selectOperatorList.DataBind()
selectOperatorList.DataBind();
1.5.1.4.5.3
Pour remplir le contr&ocirc;le DropDownList &agrave; l'aide de
l'&eacute;num&eacute;ration CeComparisonOperator pour un projet Windows
Proc&eacute;dure
1.
Ouvrez le Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la m&eacute;thode ConfigureCrystalReports(), avant la d&eacute;claration de cha&icirc;ne de la formule de s&eacute;lection,
d&eacute;finissez la propri&eacute;t&eacute; DataSource du contr&ocirc;le ComboBox selectOperatorList selon les valeurs de
l'&eacute;num&eacute;ration CeComparisonOperator.
selectOperatorList.DataSource =
System.Enum.GetValues(GetType(CeComparisonOperator))
selectOperatorList.DataSource =
System.Enum.GetValues(typeof(CeComparisonOperator));
1.5.1.4.5.4
Pour cr&eacute;er la m&eacute;thode d'assistance
GetSelectedCompareOperator()
Contexte
Cr&eacute;ez ensuite la m&eacute;thode d'assistance GetSelectedCompareOperator() pour renvoyer l'index s&eacute;lectionn&eacute;
sous la forme d'une cha&icirc;ne repr&eacute;sentant un signe d'op&eacute;rateur de comparaison.
Proc&eacute;dure
1.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e intitul&eacute;e GetSelectedCompareOperator() qui
renvoie une variable cha&icirc;ne.
Private Function GetSelectedCompareOperator() As String
300
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
End Function
private string GetSelectedCompareOperator()
{
}
2.
Dans la m&eacute;thode, cr&eacute;ez une instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] qui
r&eacute;f&eacute;rence les membres de l'&eacute;num&eacute;ration CeComparisonOperator et renvoie le signe d'op&eacute;rateur de
comparaison sous la forme d'une variable cha&icirc;ne.
Select Case selectOperatorList.SelectedIndex
Case CeComparisonOperator.EqualTo
return &quot;=&quot;
Case CeComparisonOperator.LessThan
return &quot;&lt;&quot;
Case CeComparisonOperator.GreaterThan
return &quot;&gt;&quot;
Case CeComparisonOperator.LessThan_or_EqualTo
return &quot;&lt;=&quot;
Case CeComparisonOperator.GreaterThan_or_EqualTo
return &quot;&gt;=&quot;
Case CeComparisonOperator.Not_EqualTo
return &quot;&lt;&gt;&quot;
Case Else
return &quot;=&quot;
End Select
switch ((CeComparisonOperator)selectOperatorList.SelectedIndex)
{
case CeComparisonOperator.EqualTo:
return &quot;=&quot;;
case CeComparisonOperator.LessThan:
return &quot;&lt;&quot;;
case CeComparisonOperator.GreaterThan:
return &quot;&gt;&quot;;
case CeComparisonOperator.LessThan_or_EqualTo:
return &quot;&lt;=&quot;;
case CeComparisonOperator.GreaterThan_or_EqualTo:
return &quot;&gt;=&quot;;
case CeComparisonOperator.Not_EqualTo:
return &quot;&lt;&gt;&quot;;
default:
return &quot;=&quot;;
}
1.5.1.4.5.5
Pour modifier l'op&eacute;rateur de comparaison du
param&egrave;tre Nom du client affect&eacute; &agrave; la propri&eacute;t&eacute;
SelectionFormula
Contexte
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), un signe &quot;sup&eacute;rieur &agrave;&quot; (&quot;&gt;&quot;) est actuellement utilis&eacute; pour la
s&eacute;lection du champ Nom du client. Vous allez ensuite apprendre &agrave; remplacer le signe par l'op&eacute;rateur de
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
301
comparaison que vous avez s&eacute;lectionn&eacute; &agrave; partir du contr&ocirc;le DropDownList. Le signe s&eacute;lectionn&eacute; est renvoy&eacute;
sous la forme d'une cha&icirc;ne lorsque vous appelez la m&eacute;thode d'assistance GetSelectedCompareOperator().
Proc&eacute;dure
1.
Au d&eacute;but de la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), appelez la m&eacute;thode d'assistance
GetSelectedCompareOperator(), puis affectez le r&eacute;sultat &agrave; une variable cha&icirc;ne.
Dim mySelectedOperator As String = GetSelectedCompareOperator()
string selectedOperator = GetSelectedCompareOperator();
2.
Pour la variable cha&icirc;ne de la formule de s&eacute;lection, remplacez le signe &quot;sup&eacute;rieur &agrave;&quot; (&quot;&gt;&quot;) par la cha&icirc;ne de
l'op&eacute;rateur s&eacute;lectionn&eacute;e.
Dim mySelectFormula As String = &quot;{Customer.Last Year's Sales} &gt;
&quot; &amp; lastYearsSales.Text _
&amp; &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; &amp;
mySelectedOperator &amp; &quot; &quot;&quot;&quot; &amp; customerName.Text &amp; &quot;&quot;&quot;&quot;
string selectFormula = &quot;{Customer.Last Year's Sales} &gt; &quot; +
lastYearsSales.Text
+ &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; + selectedOperator + &quot;
\&quot;&quot; + customerName.Text + &quot;\&quot;&quot;;
1.5.1.4.5.6
Pour v&eacute;rifier la formule de s&eacute;lection du rapport
CustomersBySalesName
Contexte
Vous avez cr&eacute;&eacute; une formule de s&eacute;lection qui d&eacute;pend des valeurs saisies dans le champ Ventes de l'ann&eacute;e derni&egrave;re
et le champ Nom du client.
Vous pouvez &agrave; pr&eacute;sent cr&eacute;er et v&eacute;rifier la formule de s&eacute;lection.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
302
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
a) Dans le contr&ocirc;le TextBox lastYearsSales, saisissez 40000.
b) Dans le contr&ocirc;le TextBox customerName, saisissez Athens Bicycle Co.
c) Dans le contr&ocirc;le DropDownList, s&eacute;lectionnez LessThan.
d) Cliquez sur R&eacute;afficher le rapport.
Le rapport Crystal affiche deux enregistrements clients : Alley Cat Cycles et Ankara Bicycle Company.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5
Tutoriel : Personnalisation du contr&ocirc;le
CrystalReportViewer
Dans ce tutoriel, vous allez apprendre &agrave; personnaliser l'affichage du contr&ocirc;le CrystalReportViewer.
Introduction
Dans ce tutoriel, vous allez apprendre &agrave; personnaliser l'apparence du contr&ocirc;le CrystalReportViewer en utilisant
les propri&eacute;t&eacute;s de sa classe sous-jacente.
Vous allez &eacute;galement apprendre &agrave; utiliser les m&eacute;thodes de s&eacute;lection de la page, de zoom, de recherche et
d'impression.
Pour commencer, vous allez apprendre &agrave; personnaliser la barre d'outils CrystalReportViewer. Vous avez besoin
d'un contr&ocirc;le ListBox qui stocke les propri&eacute;t&eacute;s disponibles dans la barre d'outils. Seules les propri&eacute;t&eacute;s
s&eacute;lectionn&eacute;es dans le contr&ocirc;le ListBox s'affichent dans la barre d'outils CrystalReportViewer.
Vous allez ensuite ajouter un second contr&ocirc;le ListBox pour stocker les &eacute;l&eacute;ments du rapport. Pour un site Web,
vous pouvez &eacute;galement choisir d'afficher toutes les pages du rapport sous forme d'une page unique ou de pages
s&eacute;par&eacute;es.
Vous allez apprendre &agrave; personnaliser la couleur d'arri&egrave;re-plan &agrave; l'aide d'un contr&ocirc;le DropDownList.
Vous allez apprendre ensuite &agrave; s&eacute;lectionner la page de rapport que vous souhaitez visualiser. Vous avez besoin
d'un contr&ocirc;le TextBox pour saisir le num&eacute;ro de page et d'un contr&ocirc;le Button pour recharger le rapport &agrave; la page
s&eacute;lectionn&eacute;e. Vous avez &eacute;galement besoin d'un contr&ocirc;le TextBox et d'un contr&ocirc;le Button pour modifier le facteur
de zoom et rechercher un texte dans votre rapport.
Pour un site Web, vous disposez de propri&eacute;t&eacute;s du contr&ocirc;le CrystalReportViewer qui ne sont pas disponibles pour
un projet Windows : une propri&eacute;t&eacute; permettant de choisir le mode d'impression et d'autres propri&eacute;t&eacute;s permettant
de changer la largeur, le style e
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
303
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_CRVObjMod_CustomizeViewer
●
Projet Windows C# : CS_Win_CRVObjMod_CustomizeViewer
●
Site Web Visual Basic : VB_Web_CRVObjMod_CustomizeViewer
●
Projet Windows Visual Basic : VB_Win_CRVObjMod_CustomizeViewer
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.1.5.1
Cr&eacute;ation d'un tableau de param&egrave;tres personnalis&eacute;s
Dans cette section, vous allez cr&eacute;er et configurer un tableau (dans un site Web) ou un contr&ocirc;le TableLayoutPanel
(dans un projet Windows) contenant les diff&eacute;rents contr&ocirc;les qui constituent votre tableau de param&egrave;tres
personnalis&eacute;s.
Les sites Web et les projets Windows utilisant des types de tableau diff&eacute;rents, choisissez la proc&eacute;dure
correspondant &agrave; votre site Web ou votre projet Windows.
1.5.1.5.1.1
Pour cr&eacute;er un tableau de param&egrave;tres
personnalis&eacute;s pour un site Web
Proc&eacute;dure
1.
Ouvrez la page Default.aspx (le Web Form) en mode Design.
2.
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
3.
Cliquez sur la fl&egrave;che orient&eacute;e vers la gauche pour d&eacute;placer le curseur &agrave; gauche du contr&ocirc;le
CrystalReportViewer, puis appuyez sur Entr&eacute;e.
4.
Cliquez sur la fl&egrave;che orient&eacute;e vers le haut pour d&eacute;placer le curseur vers la ligne vide au-dessus du contr&ocirc;le
CrystalReportViewer.
5.
Dans le menu Disposition, cliquez sur Ins&eacute;rer un tableau.
6.
Dans la bo&icirc;te de dialogue Ins&eacute;rer un tableau, s&eacute;lectionnez l'option Personnalis&eacute;.
7.
Dans le panneau Disposition, cochez la case Largeur et conservez la valeur 100 %.
8.
Configurez pour Lignes le nombre 6 et pour Colonnes le nombre 4.
9.
Dans le panneau Attributs, cochez la case Bordure et attribuez-lui la valeur 1.
10. Cliquez sur le bouton Propri&eacute;t&eacute;s de la cellule.
11. Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la cellule du panneau Disposition, dans la liste d&eacute;roulante Alignement
vertical, s&eacute;lectionnez Top.
304
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
12. Cochez la case Pas de retour automatique &agrave; la ligne, puis cliquez sur OK.
13. Cliquez &agrave; nouveau sur OK pour fermer la bo&icirc;te de dialogue Ins&eacute;rer un tableau.
R&eacute;sultats
Vous pouvez maintenant ajouter des contr&ocirc;les personnalis&eacute;s pour votre site Web dans ce tableau.
Effectuez maintenant la proc&eacute;dure El&eacute;ments du rapport et de la barre d'outils du contr&ocirc;le CrystalReportViewer
[page 306].
1.5.1.5.1.2
Pour cr&eacute;er un tableau de param&egrave;tres
personnalis&eacute;s pour un projet Windows
Contexte
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Ouvrez le Windows Form en mode Design.
2.
Cliquez sur la barre de titre du Windows Form pour le s&eacute;lectionner enti&egrave;rement, puis faites glisser le coin
inf&eacute;rieur droit du formulaire pour l'agrandir jusqu'&agrave; ce qu'il remplisse la zone principale.
3.
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
4.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Dock la valeur &quot;Bottom&quot;.
5.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
6.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TableLayoutPanel en haut &agrave; gauche du Windows Form.
Un contr&ocirc;le TableLayoutPanel appara&icirc;t affichant deux colonnes et deux lignes.
7.
Si le panneau des t&acirc;ches guid&eacute;es n'est pas ouvert, cliquez sur le bouton triangulaire dans le coin sup&eacute;rieur
droit du contr&ocirc;le TableLayoutPanel.
Le panneau des t&acirc;ches guid&eacute;es &quot;T&acirc;ches TableLayoutPanel&quot; s'affiche.
8.
Dans le panneau T&acirc;ches TableLayoutPanel, cliquez sur le lien Modifier les lignes et les colonnes.
9.
Dans la bo&icirc;te de dialogue Styles de ligne et de colonne, dans la liste d&eacute;roulante Type de membre, s&eacute;lectionnez
Colonnes.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
305
10. Cliquez sur Ajouter jusqu'&agrave; ce que vous atteigniez quatre colonnes.
11. Pour chaque colonne, proc&eacute;dez de la mani&egrave;re suivante :
a) S&eacute;lectionnez la colonne.
b) Dans le panneau Type de taille, s&eacute;lectionnez Pourcentage.
c) D&eacute;finissez 25 % pour chaque valeur.
12. Dans la liste d&eacute;roulante Type de membre, s&eacute;lectionnez Lignes.
13. Cliquez sur Ajouter jusqu'&agrave; ce que vous atteigniez cinq lignes.
Remarque
Le tableau du projet Windows n&eacute;cessite une ligne de moins que le tableau d'un site Web parce qu'il y a un
peu moins d'options configurables sur le contr&ocirc;le CrystalReportViewer d'un projet Windows.
14. Pour chaque ligne, proc&eacute;dez de la mani&egrave;re suivante :
a) S&eacute;lectionnez la ligne.
b) Dans le panneau Type de taille, s&eacute;lectionnez Pourcentage.
c) D&eacute;finissez 40 % pour la valeur de la premi&egrave;re ligne, puis 15 % pour chaque ligne suivante.
Remarque
(1 x 40 %) et (4 x 15 %) = 100 % de l'espace disponible.
15. Cliquez sur OK.
16. Fermez le panneau des t&acirc;ches TableLayoutPanel.
17. Faites glisser le coin inf&eacute;rieur droit du contr&ocirc;le TableLayoutPanel pour agrandir le tableau jusqu'&agrave; ce qu'il
remplisse l'espace que vous avez cr&eacute;&eacute; au-dessus du contr&ocirc;le CrystalReportViewer.
R&eacute;sultats
Vous pouvez maintenant ajouter des contr&ocirc;les personnalis&eacute;s pour votre projet Windows dans ce tableau.
1.5.1.5.2
El&eacute;ments du rapport et de la barre d'outils du
contr&ocirc;le CrystalReportViewer
Dans ce tutoriel, vous allez manipuler les diff&eacute;rents &eacute;l&eacute;ments du rapport et de la barre d'outils du contr&ocirc;le
CrystalReportViewer.
El&eacute;ments du visualiseur
Les &eacute;l&eacute;ments par d&eacute;faut du contr&ocirc;le CrystalReportViewer varient l&eacute;g&egrave;rement en fonction des sites Web et des
projets Windows :
306
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Pour les sites Web et les projets Windows :
○
Barre d'outils : affiche une barre d'outils au-dessus de la zone principale du rapport. Chaque &eacute;l&eacute;ment de la
barre d'outils est contr&ocirc;l&eacute; s&eacute;par&eacute;ment.
Remarque
Pour en savoir plus, voir la section sur les &eacute;l&eacute;ments de la barre d'outils ci-dessous.
○
●
●
Arborescence des groupes : affiche les titres de chaque groupe du rapport, de la m&ecirc;me fa&ccedil;on qu'une
arborescence de r&eacute;pertoires ; elle s'affiche dans le panneau de la colonne gauche du rapport.
Pour les sites Web uniquement :
○
Page principale : affiche le rapport dans la zone principale de la page.
○
Activer les pages s&eacute;par&eacute;es : d&eacute;termine si le rapport doit &ecirc;tre affich&eacute; sur une seule page Web ou sous la
forme de pages s&eacute;par&eacute;es mises en forme.
Pour les projets Windows uniquement :
○
Barre d'&eacute;tat : affiche le num&eacute;ro de page en cours et d'autres informations sur le rapport au bas de la zone
du rapport.
El&eacute;ments de la barre d'outils
Les &eacute;l&eacute;ments par d&eacute;faut de la barre d'outils varient l&eacute;g&egrave;rement en fonction des sites Web et des projets Windows :
●
●
●
Pour les sites Web et les projets Windows :
○
Bouton d'arborescence des groupes : affiche ou masque la section Arborescence des groupes du rapport.
○
Exporter : enregistre le rapport Crystal sous un autre format de fichier tel que RPT, PDF, DOC, XLS ou
RTF.
○
Imprimer : imprime le rapport Crystal dans un fichier PDF ou appelle la bo&icirc;te de dialogue d'impression.
○
Navigation : permet de s&eacute;lectionner la page suivante, la page pr&eacute;c&eacute;dente, la derni&egrave;re page ou la premi&egrave;re
page &agrave; afficher.
○
Aller &agrave; la page : permet de saisir le num&eacute;ro de la page &agrave; afficher.
○
Rechercher : permet de saisir une cha&icirc;ne &agrave; rechercher dans le rapport.
○
Facteur de zoom : permet de s&eacute;lectionner le facteur de zoom du rapport.
Pour les sites Web uniquement :
○
Vue Liste (uniquement pour un site Web) : permet de choisir la vue du rapport &agrave; afficher (par exemple
sous-rapports, etc.).
○
Explorer en amont : ouvre une page fournissant des informations plus d&eacute;taill&eacute;es que la rubrique actuelle.
○
Logo Crystal : affiche le logo du produit SAP Crystal Reports.
Pour les projets Windows uniquement :
○
Actualiser : r&eacute;affiche le rapport.
○
Fermer la vue : ferme la vue actuelle du rapport si plusieurs vues sont ouvertes.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
307
1.5.1.5.3
Ajout d'un m&eacute;canisme d'affichage et de masquage
des &eacute;l&eacute;ments du rapport et de la barre d'outils
Contexte
Dans cette section, vous allez apprendre &agrave; ajouter un m&eacute;canisme d'affichage/masquage pour d&eacute;terminer quels
&eacute;l&eacute;ments doivent &ecirc;tre affich&eacute;s dans la barre d'outils CrystalReportViewer.
Vous allez commencer par ajouter les contr&ocirc;les ListBox et Button dans le tableau sur le Web Form ou le Windows
Form.
Vous allez ensuite cr&eacute;er deux &eacute;num&eacute;rations qui r&eacute;pertorient les &eacute;l&eacute;ments du rapport et les &eacute;l&eacute;ments de la barre
d'outils, puis vous allez remplir chaque contr&ocirc;le ListBox avec les valeurs de l'une des &eacute;num&eacute;rations.
Vous allez ensuite coder la m&eacute;thode d'&eacute;v&eacute;nement de clic du contr&ocirc;le Button pour mettre &agrave; jour les &eacute;l&eacute;ments du
rapport et de la barre d'outils.
Au sein du gestionnaire d'&eacute;v&eacute;nements, les propri&eacute;t&eacute;s de la classe CrystalReportViewer sont d&eacute;finies en fonction
des s&eacute;lections effectu&eacute;es dans les deux contr&ocirc;les ListBox. Si un &eacute;l&eacute;ment du contr&ocirc;le ListBox est s&eacute;lectionn&eacute;, la
propri&eacute;t&eacute; de la barre d'outils a la valeur True.
Plus loin dans ce tutoriel, vous utiliserez le contr&ocirc;le Button pour mettre &agrave; jour d'autres s&eacute;lections.
Au moment de l'ex&eacute;cution, vous pourrez choisir quels &eacute;l&eacute;ments du rapport et de la barre d'outils vous souhaitez
afficher.
Commencez par ajouter les contr&ocirc;les dans le tableau au bas du Web Form ou du Windows Form.
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label vers la premi&egrave;re ligne de la premi&egrave;re colonne du tableau.
3.
S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur
S&eacute;lectionner les &eacute;l&eacute;ments du rapport &agrave; afficher.
4.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le ListBox vers la premi&egrave;re ligne de la deuxi&egrave;me colonne du
tableau.
5.
S&eacute;lectionnez le contr&ocirc;le ListBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID la valeur listCRVReport.
b) Attribuez &agrave; SelectionMode la valeur Multiple (ou MultiExtended dans un projet Windows).
6.
Dans la Bo&icirc;te &agrave; outils, faites glisser un second contr&ocirc;le Label vers la premi&egrave;re ligne de la troisi&egrave;me colonne du
tableau.
7.
S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur
S&eacute;lectionner les &eacute;l&eacute;ments de la barre d'outils &agrave; afficher.
8.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button vers la troisi&egrave;me ligne de la premi&egrave;re colonne du
tableau.
9.
Cliquez sur le contr&ocirc;le Button pour le s&eacute;lectionner.
308
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID la valeur &quot;redisplay&quot;.
b) Attribuez &agrave; Text la valeur &quot;R&eacute;afficher le rapport&quot;.
11. Dans un projet Windows, redimensionnez le contr&ocirc;le Button pour afficher la totalit&eacute; du texte qu'il contient.
R&eacute;sultats
La prochaine proc&eacute;dure varie selon que vous cr&eacute;ez un site Web ou un projet Windows. Choisissez l'une des
proc&eacute;dures suivantes :
●
Configuration des contr&ocirc;les ListBox pour un site Web [page 309]
●
Configuration des contr&ocirc;les ListBox pour un projet Windows [page 315]
1.5.1.5.4
Web
Configuration des contr&ocirc;les ListBox pour un site
Cette section explique comment configurer les contr&ocirc;les ListBox d'un site Web. Si vous cr&eacute;ez un projet Windows,
voir Configuration des contr&ocirc;les ListBox pour un projet Windows [page 315].
Vous allez maintenant pouvoir cr&eacute;er le gestionnaire d'&eacute;v&eacute;nements de clic du contr&ocirc;le Button, puis ajouter du code
&agrave; ce gestionnaire d'&eacute;v&eacute;nements. Le gestionnaire d'&eacute;v&eacute;nements d&eacute;finit diff&eacute;rentes valeurs bool&eacute;ennes pour les
propri&eacute;t&eacute;s de la barre d'outils de la classe CrystalReportViewer en fonction des s&eacute;lections effectu&eacute;es par
l'utilisateur dans le contr&ocirc;le ListBox.
Avant de cr&eacute;er ce gestionnaire d'&eacute;v&eacute;nements, vous devez cr&eacute;er deux &eacute;num&eacute;rations : CeWebCRVReportOptions
et CeWebCRVToolbarOptions.
Ces &eacute;num&eacute;rations fournissent une liste d'&eacute;l&eacute;ments du rapport et d'&eacute;l&eacute;ments de la barre d'outils pouvant &ecirc;tre
s&eacute;lectionn&eacute;s.
1.5.1.5.4.1
Pour cr&eacute;er l'&eacute;num&eacute;ration
CeWebCRVReportOptions
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du site Web, pointez sur
Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, s&eacute;lectionnez Classe dans la vue Mod&egrave;les.
3.
Dans le champ Nom, saisissez &quot;CeWebCRVReportOptions&quot;, puis cliquez sur Ajouter.
Remarque
Vous pouvez &ecirc;tre invit&eacute; &agrave; placer cette classe dans un r&eacute;pertoire App_Code. Cliquez sur le bouton Oui.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
309
4.
Dans la signature de classe, remplacez le mot class par &quot;enum&quot; pour convertir la classe en &eacute;num&eacute;ration.
Remarque
Dans Visual Basic, n'oubliez pas de remplacer les signatures d'ouverture et de fermeture de la classe par
enum.
5.
Les &eacute;num&eacute;rations ne comportant aucun constructeur, supprimez la m&eacute;thode constructeur par d&eacute;faut qui est
fournie dans la version C# du code.
6.
Dans l'&eacute;num&eacute;ration, saisissez les valeurs suivantes :
Toolbar
Group_Tree
Main_Page
Enable_Separate_Pages
Toolbar,
Group_Tree,
Main_Page,
Enable_Separate_Pages
7.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.5.1.5.4.2
Pour cr&eacute;er l'&eacute;num&eacute;ration
CeWebCRVToolbarOptions
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du site Web, pointez sur
Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, s&eacute;lectionnez Classe dans la vue Mod&egrave;les.
3.
Dans le champ Nom, saisissez CeWebCRVToolbarOptions, puis cliquez sur Ajouter.
Remarque
Vous pouvez &ecirc;tre invit&eacute; &agrave; placer cette classe dans un r&eacute;pertoire App_Code. Cliquez sur le bouton Oui.
4.
Dans la signature de classe, remplacez le mot class par &quot;enum&quot; pour convertir la classe en &eacute;num&eacute;ration.
Remarque
Dans Visual Basic, n'oubliez pas de remplacer les signatures d'ouverture et de fermeture de la classe par
enum.
5.
Les &eacute;num&eacute;rations ne comportant aucun constructeur, supprimez la m&eacute;thode constructeur par d&eacute;faut qui est
fournie dans la version C# du code.
6.
Dans l'&eacute;num&eacute;ration, saisissez les valeurs suivantes :
Group_Tree_Button
310
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Export_Button
Print_Button
View_List_Button
Drill_Up_Button
Page_Navigation_Button
Go_to_Page_Button
Search_Button
Zoom_Button
Crystal_Logo
Group_Tree_Button,
Export_Button,
Print_Button,
View_List_Button,
Drill_Up_Button,
Page_Navigation_Button,
Go_to_Page_Button,
Search_Button,
Zoom_Button,
Crystal_Logo
7.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.5.1.5.4.3
Pour remplir les contr&ocirc;les ListBox &agrave; partir des
&eacute;num&eacute;rations
Contexte
Vous remplissez &agrave; pr&eacute;sent les contr&ocirc;les ListBox avec les valeurs d'&eacute;num&eacute;ration qui repr&eacute;sentent les propri&eacute;t&eacute;s
disponibles pour la barre d'outils CrystalReportViewer.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la m&eacute;thode ConfigureCrystalReports(), ajoutez un bloc conditionnel Not IsPostBack.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans la section Configuration d'un projet
[page 15] au d&eacute;but de ce tutoriel.
If Not IsPostBack Then
End If
if (!IsPostBack)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
311
{
}
4.
Dans le bloc conditionnel, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox listCRVReport les
valeurs de l'&eacute;num&eacute;ration CeWebCRVReportOptions.
listCRVReport.DataSource = System.Enum.GetValues(GetType(CeWebCRVReportOptions))
listCRVReport.DataSource = System.Enum.GetValues(typeof(CeWebCRVReportOptions));
5.
Appelez la m&eacute;thode DataBind() du contr&ocirc;le ListBox listCRVReport pour lier les valeurs au contr&ocirc;le.
listCRVReport.DataBind()
listCRVReport.DataBind();
6.
Attribuez ensuite &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox listCRVToolbar les valeurs de
l'&eacute;num&eacute;ration CeWebCRVToolbarOptions.
listCRVToolbar.DataSource =
System.Enum.GetValues(GetType(CeWebCRVToolbarOptions))
listCRVToolbar.DataSource =
System.Enum.GetValues(typeof(CeWebCRVToolbarOptions));
7.
Appelez &agrave; pr&eacute;sent la m&eacute;thode DataBind() du contr&ocirc;le ListBox listCRVToolbar pour lier les valeurs au
contr&ocirc;le.
listCRVToolbar.DataBind()
listCRVToolbar.DataBind();
8.
En dehors du bloc conditionnel Not IsPostBack, liez le fichier Chart.rpt &agrave; la propri&eacute;t&eacute; ReportSource du
contr&ocirc;le CrystalReportViewer.
Pour en savoir plus sur les exemples de rapports, voir R&eacute;pertoire d'exemples de rapports [page 15].
myCrystalReportViewer.ReportSource = &quot;C:\Program Files\Microsoft Visual Studio
9,0\Crystal Reports\Samples\fr\Reports\Feature Examples\Chart.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\Program Files\\Microsoft Visual Studio
9.0\\Crystal Reports\\Samples\\fr\\Reports\\Feature Examples\\Chart.rpt&quot;;
312
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.5.4.4
Pour coder le contr&ocirc;le Button de r&eacute;affichage pour
un site Web
Contexte
Vous pouvez &agrave; pr&eacute;sent ajouter le code &agrave; l'&eacute;v&eacute;nement de clic du contr&ocirc;le Button. La m&eacute;thode de clic doit d&eacute;finir
des valeurs bool&eacute;ennes pour les &eacute;l&eacute;ments du rapport et de la barre d'outils de la classe CrystalReportViewer.
Si un &eacute;l&eacute;ment est s&eacute;lectionn&eacute;, la valeur bool&eacute;enne est True et l'&eacute;l&eacute;ment du rapport ou de la barre d'outils s'affiche.
Si aucune propri&eacute;t&eacute; n'est s&eacute;lectionn&eacute;e, la valeur bool&eacute;enne est False et l'&eacute;l&eacute;ment du rapport ou de la barre d'outils
ne s'affiche pas.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button de r&eacute;affichage.
La classe code-behind du rapport s'affiche et indique qu'une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;e.
4.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), appelez la propri&eacute;t&eacute; Selected de chaque &eacute;l&eacute;ment des
contr&ocirc;les ListBox listCRVReport et listCRVToolbar.
La propri&eacute;t&eacute; Selected renvoie une valeur bool&eacute;enne afin de d&eacute;finir les propri&eacute;t&eacute;s de la barre d'outils
CrystalReportViewer.
Remarque
Les &eacute;l&eacute;ments du rapport et de la barre d'outils CrystalReportViewer sont d&eacute;finis sur leurs valeurs
correspondantes dans les &eacute;num&eacute;rations CeWebCRVReportOptions et CeWebCRVToolbarOptions. Les
valeurs de la classe enum renvoient une cha&icirc;ne que vous devez convertir en nombre entier.
myCrystalReportViewer.HasToggleGroupTreeButton =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Group_Tree_Button)).S
elected
myCrystalReportViewer.HasExportButton =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Export_Button)).Selec
ted
myCrystalReportViewer.HasPrintButton =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Print_Button)).Select
ed
myCrystalReportViewer.HasViewList =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.View_List_Button)).Se
lected
myCrystalReportViewer.HasDrillUpButton =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Drill_Up_Button)).Sel
ected
myCrystalReportViewer.HasPageNavigationButtons =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Page_Navigation_Butto
n)).Selected
myCrystalReportViewer.HasGotoPageButton =
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
313
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Go_to_Page_Button)).S
elected
myCrystalReportViewer.HasSearchButton =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Search_Button)).Selec
ted
myCrystalReportViewer.HasZoomFactorList =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Zoom_Button)).Selecte
d
myCrystalReportViewer.HasCrystalLogo =
listCRVToolbar.Items(Convert.ToInt32(CeWebCRVToolbarOptions.Crystal_Logo)).Select
ed
myCrystalReportViewer.DisplayToolbar =
listCRVReport.Items(Convert.ToInt32(CeWebCRVReportOptions.Toolbar)).Selected
myCrystalReportViewer.DisplayGroupTree =
listCRVReport.Items(Convert.ToInt32(CeWebCRVReportOptions.Group_Tree)).Selected
myCrystalReportViewer.DisplayPage =
listCRVReport.Items(Convert.ToInt32(CeWebCRVReportOptions.Main_Page)).Selected
myCrystalReportViewer.SeparatePages =
listCRVReport.Items(Convert.ToInt32(CeWebCRVReportOptions.Enable_Separate_Pages))
.Selected
crystalReportViewer.HasToggleGroupTreeButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Group_Tree_Button)].S
elected;
crystalReportViewer.HasExportButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Export_Button)].Selec
ted;
crystalReportViewer.HasPrintButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Print_Button)].Select
ed;
crystalReportViewer.HasViewList =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.View_List_Button)].Se
lected;
crystalReportViewer.HasDrillUpButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Drill_Up_Button)].Sel
ected;
crystalReportViewer.HasPageNavigationButtons =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Page_Navigation_Butto
n)].Selected;
crystalReportViewer.HasGotoPageButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Go_to_Page_Button)].S
elected;
crystalReportViewer.HasSearchButton =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Search_Button)].Selec
ted;
crystalReportViewer.HasZoomFactorList =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Zoom_Button)].Selecte
d;
crystalReportViewer.HasCrystalLogo =
listCRVToolbar.Items[Convert.ToInt32(CeWebCRVToolbarOptions.Crystal_Logo)].Select
ed;
crystalReportViewer.DisplayToolbar =
listCRVReport.Items[Convert.ToInt32(CeWebCRVReportOptions.Toolbar)].Selected;
crystalReportViewer.DisplayGroupTree =
listCRVReport.Items[Convert.ToInt32(CeWebCRVReportOptions.Group_Tree)].Selected;
crystalReportViewer.DisplayPage =
listCRVReport.Items[Convert.ToInt32(CeWebCRVReportOptions.Main_Page)].Selected;
crystalReportViewer.SeparatePages =
listCRVReport.Items[Convert.ToInt32(CeWebCRVReportOptions.Enable_Separate_Pages)]
.Selected;
314
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.5.4.5
Pour v&eacute;rifier le contr&ocirc;le Button de r&eacute;affichage
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet afin de personnaliser la barre d'outils
CrystalReportViewer.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Les contr&ocirc;les ListBox listCRVReport et listCRVToolbar affichent une liste compl&egrave;te des options du
rapport et de la barre d'outils CrystalReportViewer.
4.
Dans la liste des options de la barre d'outils, s&eacute;lectionnez &quot;Page_Navigation_Button&quot;, &quot;Print_Button&quot; et
&quot;Export_Button&quot;.
5.
Dans la liste des options du rapport, s&eacute;lectionnez &quot;Toolbar&quot;, &quot;Group_Tree&quot; et &quot;Main_Page&quot;.
6.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge et affiche un contr&ocirc;le CrystalReportViewer avec une barre d'outils, une arborescence
des groupes et une page principale visibles. Dans la barre d'outils, seuls les boutons Navigation, Imprimer et
Exporter sont visibles.
7.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.5
Windows
Configuration des contr&ocirc;les ListBox pour un projet
Cette section explique comment configurer les contr&ocirc;les ListBox d'un projet Windows. Si vous cr&eacute;ez un site Web,
voir Configuration des contr&ocirc;les ListBox pour un site Web [page 309].
Vous allez maintenant pouvoir cr&eacute;er le gestionnaire d'&eacute;v&eacute;nements de clic du contr&ocirc;le Button, puis ajouter du code
&agrave; ce gestionnaire d'&eacute;v&eacute;nements. Le gestionnaire d'&eacute;v&eacute;nements d&eacute;finit diff&eacute;rentes valeurs bool&eacute;ennes pour les
propri&eacute;t&eacute;s de la barre d'outils de la classe CrystalReportViewer en fonction des s&eacute;lections effectu&eacute;es par
l'utilisateur dans le contr&ocirc;le ListBox.
Avant de cr&eacute;er ce gestionnaire d'&eacute;v&eacute;nements, vous devez cr&eacute;er deux &eacute;num&eacute;rations : CeWinCRVReportOptions
et CeWinCRVToolbarOptions.
Ces &eacute;num&eacute;rations fournissent une liste d'&eacute;l&eacute;ments du rapport et d'&eacute;l&eacute;ments de la barre d'outils pouvant &ecirc;tre
s&eacute;lectionn&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
315
1.5.1.5.5.1
Pour cr&eacute;er l'&eacute;num&eacute;ration
CeWinCRVReportOptions
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Classe.
2.
Dans le champ Nom de la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, saisissez CeWinCRVReportOptions,
puis cliquez sur Ajouter.
Remarque
Dans Visual Studio, vous pouvez &ecirc;tre invit&eacute; &agrave; placer cette classe dans un r&eacute;pertoire App_Code. Cliquez sur
le bouton Oui.
3.
Dans la signature de classe, remplacez le mot class par &quot;enum&quot; pour convertir la classe en &eacute;num&eacute;ration.
Remarque
Dans Visual Basic, n'oubliez pas de remplacer les signatures d'ouverture et de fermeture de la classe par
enum.
4.
Les &eacute;num&eacute;rations ne comportant aucun constructeur, supprimez la m&eacute;thode constructeur par d&eacute;faut qui est
fournie dans la version C# du code.
5.
Dans l'&eacute;num&eacute;ration, saisissez les valeurs suivantes :
Toolbar
Group_Tree
Status_Bar
Toolbar,
Group_Tree,
Status_Bar
6.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.5.1.5.5.2
Pour cr&eacute;er l'&eacute;num&eacute;ration
CeWinCRVToolbarOptions
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Classe.
2.
Dans le champ Nom de la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, saisissez &quot;CeWinCRVToolbarOptions&quot;,
puis cliquez sur Ajouter.
316
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Vous pouvez &ecirc;tre invit&eacute; &agrave; placer cette classe dans un r&eacute;pertoire App_Code. Cliquez sur le bouton Oui.
3.
Dans la signature de classe, remplacez le mot class par &quot;enum&quot; pour convertir la classe en &eacute;num&eacute;ration.
Remarque
Dans Visual Basic, n'oubliez pas de remplacer les signatures d'ouverture et de fermeture de la classe par
enum.
4.
Les &eacute;num&eacute;rations ne comportant aucun constructeur, supprimez la m&eacute;thode constructeur par d&eacute;faut qui est
fournie dans la version C# du code.
5.
Dans l'&eacute;num&eacute;ration, saisissez les valeurs suivantes :
Page_Navigation_Button
Go_to_Page_Button
Close_View_Button
Print_Button
Refresh_Button
Export_Button
Group_Tree_Button
Zoom_Button
Search_Button
Page_Navigation_Button,
Go_to_Page_Button,
Close_View_Button,
Print_Button,
Refresh_Button,
Export_Button,
Group_Tree_Button,
Zoom_Button,
Search_Button
6.
Dans le menu Fichier, cliquez sur Enregistrer tout.
1.5.1.5.5.3
Pour remplir les contr&ocirc;les ListBox &agrave; partir des
&eacute;num&eacute;rations
Contexte
Vous remplissez &agrave; pr&eacute;sent les contr&ocirc;les ListBox avec les valeurs d'&eacute;num&eacute;ration qui repr&eacute;sentent les propri&eacute;t&eacute;s
disponibles pour la barre d'outils CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
317
Proc&eacute;dure
1.
Ouvrez le Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la m&eacute;thode ConfigureCrystalReports(), attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox
listCRVReport les valeurs de l'&eacute;num&eacute;ration CeWinCRVReportOptions.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans la section Configuration d'un projet
[page 15] au d&eacute;but de ce tutoriel.
listCRVReport.DataSource =
System.Enum.GetValues(GetType(CeWinCRVReportOptions))
listCRVReport.DataSource =
System.Enum.GetValues(typeof(CeWinCRVReportOptions));
4.
Attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox listCRVToolbar les valeurs de l'&eacute;num&eacute;ration
CeWinCRVToolbarOptions.
listCRVToolbar.DataSource =
System.Enum.GetValues(GetType(CeWinCRVToolbarOptions))
listCRVToolbar.DataSource =
System.Enum.GetValues(typeof(CeWinCRVToolbarOptions));
5.
Liez le fichier Chart.rpt &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewercontrol.
Pour en savoir plus sur les exemples de rapports, voir R&eacute;pertoire d'exemples de rapports [page 15].
myCrystalReportViewer.ReportSource = &quot;C:\Program Files\Microsoft Visual Studio
9,0\Crystal Reports\Samples\fr\Reports\Feature Examples\Chart.rpt&quot;
crystalReportViewer.ReportSource = &quot;C:\\Program Files\\Microsoft Visual Studio
9.0\\Crystal Reports\\Samples\\fr\\Reports\\Feature Examples\\Chart.rpt&quot;;
1.5.1.5.5.4
Pour coder le contr&ocirc;le Button de r&eacute;affichage pour
un projet Windows
Contexte
Vous pouvez &agrave; pr&eacute;sent ajouter le code &agrave; l'&eacute;v&eacute;nement de clic du contr&ocirc;le Button. La m&eacute;thode de clic doit d&eacute;finir
des valeurs bool&eacute;ennes pour les &eacute;l&eacute;ments du rapport et de la barre d'outils de la classe CrystalReportViewer.
318
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Si un &eacute;l&eacute;ment est s&eacute;lectionn&eacute;, la valeur bool&eacute;enne est True et l'&eacute;l&eacute;ment du rapport ou de la barre d'outils s'affiche.
Si aucune propri&eacute;t&eacute; n'est s&eacute;lectionn&eacute;e, la valeur bool&eacute;enne est False et l'&eacute;l&eacute;ment du rapport ou de la barre
d'outils ne s'affiche pas.
Proc&eacute;dure
1.
Ouvrez le Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button de r&eacute;affichage.
La classe code-behind du rapport s'affiche et indique qu'une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;e.
4.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), appelez la m&eacute;thode GetSelected(), puis transmettez
chaque &eacute;l&eacute;ment du contr&ocirc;le ListBox.
La m&eacute;thode GetSelected() renvoie une valeur bool&eacute;enne afin de d&eacute;finir les propri&eacute;t&eacute;s du rapport et de la
barre d'outils CrystalReportViewer.
Remarque
Les &eacute;l&eacute;ments du rapport et de la barre d'outils CrystalReportViewer sont d&eacute;finis sur leurs valeurs
correspondantes dans les &eacute;num&eacute;rations CeWinCRVReportOptions et CeWinCRVToolbarOptions.
myCrystalReportViewer.ShowPageNavigateButtons =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Page_Navigation_Button)
myCrystalReportViewer.ShowGotoPageButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Go_to_Page_Button)
myCrystalReportViewer.ShowCloseButton = listCRVToolbar.
GetSelected(CeWinCRVToolbarOptions.Close_View_Button)
myCrystalReportViewer.ShowPrintButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Print_Button)
myCrystalReportViewer.ShowRefreshButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Refresh_Button)
myCrystalReportViewer.ShowExportButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Export_Button)
myCrystalReportViewer.ShowGroupTreeButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Group_Tree_Button)
myCrystalReportViewer.ShowZoomButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Zoom_Button)
myCrystalReportViewer.ShowTextSearchButton =
listCRVToolbar.GetSelected(CeWinCRVToolbarOptions.Search_Button)
myCrystalReportViewer.DisplayToolbar =
listCRVReport.GetSelected(CeWinCRVReportOptions.Toolbar)
myCrystalReportViewer.DisplayGroupTree =
listCRVReport.GetSelected(CeWinCRVReportOptions.Group_Tree)
myCrystalReportViewer.DisplayStatusBar =
listCRVReport.GetSelected(CeWinCRVReportOptions.Status_Bar)
crystalReportViewer.ShowPageNavigateButtons =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Page_Navigation
_Button));
crystalReportViewer.ShowGotoPageButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Go_to_Page_Butt
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
319
on));
crystalReportViewer.ShowCloseButton = listCRVToolbar.
GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Close_View_Button));
crystalReportViewer.ShowPrintButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Print_Button));
crystalReportViewer.ShowRefreshButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Refresh_Button)
);
crystalReportViewer.ShowExportButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Export_Button))
;
crystalReportViewer.ShowGroupTreeButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Group_Tree_Butt
on));
crystalReportViewer.ShowZoomButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Zoom_Button));
crystalReportViewer.ShowTextSearchButton =
listCRVToolbar.GetSelected(Convert.ToInt32(CeWinCRVToolbarOptions.Search_Button))
;
crystalReportViewer.DisplayToolbar =
listCRVReport.GetSelected(Convert.ToInt32(CeWinCRVReportOptions.Toolbar));
crystalReportViewer.DisplayGroupTree =
listCRVReport.GetSelected(Convert.ToInt32(CeWinCRVReportOptions.Group_Tree));
crystalReportViewer.DisplayStatusBar =
listCRVReport.GetSelected(Convert.ToInt32(CeWinCRVReportOptions.Status_Bar));
1.5.1.5.5.5
Pour v&eacute;rifier le contr&ocirc;le Button de r&eacute;affichage
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet afin de personnaliser la barre d'outils
CrystalReportViewer.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Les contr&ocirc;les ListBox listCRVReportet listCRVToolbar affichent une liste compl&egrave;te des options de
CrystalReportViewer rapport et barre d'outils.
4.
Dans la liste des options de la barre d'outils, s&eacute;lectionnez &quot;Page_Navigation_Button&quot;, &quot;Print_Button&quot; et
&quot;Export_Button&quot;.
5.
Dans la liste des options du rapport, s&eacute;lectionnez &quot;Toolbar&quot;, &quot;Group_Tree&quot; et &quot;Main_Page&quot;.
6.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge et affiche un contr&ocirc;le CrystalReportViewer avec une barre d'outils, une arborescence
des groupes et une page principale visibles. Dans la barre d'outils, seuls les boutons Navigation, Imprimer et
Exporter sont visibles.
320
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.6
Modification de la couleur d'arri&egrave;re-plan du rapport
Dans cette section, vous allez apprendre &agrave; modifier la couleur d'arri&egrave;re-plan du rapport.
Vous allez commencer par ajouter un contr&ocirc;le DropDownList pour s&eacute;lectionner la couleur d'arri&egrave;re-plan.
1.5.1.5.6.1
Pour ajouter des contr&ocirc;les pour modifier la
couleur d'arri&egrave;re-plan
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label vers la seconde ligne de la premi&egrave;re colonne du tableau.
4.
S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur
S&eacute;lectionnez la couleur d'arri&egrave;re-plan.
5.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList (pour les sites Web) ou ComboBox (pour les
projets Windows) vers la seconde ligne de la deuxi&egrave;me colonne du tableau.
6.
S&eacute;lectionnez le contr&ocirc;le DropDownList/ComboBox, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID/Name la
valeur &quot;selectBackColor&quot;.
1.5.1.5.6.2
Pour d&eacute;finir les valeurs par d&eacute;faut des contr&ocirc;les
Contexte
Vous devez &agrave; pr&eacute;sent ajouter du code &agrave; la m&eacute;thode ConfigureCrystalReports() afin de d&eacute;finir les valeurs par
d&eacute;faut de la liste des couleurs d'arri&egrave;re-plan et des cases &agrave; cocher des composants du rapport.
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
Dans la m&eacute;thode ConfigureCrystalReports(), vous ajoutez ensuite du code pour d&eacute;finir les valeurs par
d&eacute;faut des contr&ocirc;les.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
321
Remarque
Si vous cr&eacute;ez un site Web, placez ces lignes de code dans le bloc conditionnel Not IsPostBack. Si vous
cr&eacute;ez un projet Windows, placez ces lignes de code dans la zone principale de la m&eacute;thode
ConfigureCrystalReports().
3.
Affectez l'&eacute;num&eacute;ration KnownColor &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le DropDownList
selectBackColor.
selectBackColor.DataSource = System.Enum.GetValues(GetType(KnownColor))
selectBackColor.DataSource = System.Enum.GetValues(typeof(KnownColor));
4.
Dans un site Web, liez la source de donn&eacute;es au contr&ocirc;le DropDownList selectBackColor.
selectBackColor.DataBind()
selectBackColor.DataBind();
1.5.1.5.6.3
Pour affecter la s&eacute;lection de couleur d'arri&egrave;replan dans un site Web
Contexte
Ajoutez ensuite du code &agrave; l'&eacute;v&eacute;nement de clic Button pour r&eacute;afficher le rapport en fonction de la s&eacute;lection
DropDownList selectBackColor.
Ce code est diff&eacute;rent pour un site Web et un projet Windows. S&eacute;lectionnez la proc&eacute;dure appropri&eacute;e &agrave; votre cas cidessous.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe pour l'espace de noms System.Drawing (si cet espace de noms n'a pas d&eacute;j&agrave; &eacute;t&eacute;
d&eacute;clar&eacute;).
Imports System.Drawing
322
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
using System.Drawing;
4.
Dans le gestionnaire d'&eacute;v&eacute;nements redisplay_Click(), ajoutez le code suivant : dans le contr&ocirc;le
DropDownList selectBackColor, extrayez l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; sous la forme d'une cha&icirc;ne, puis transmettezle &agrave; la m&eacute;thode FromName() de la classe Color. Affectez la valeur Color &agrave; la propri&eacute;t&eacute; BackColor du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.BackColor =
Color.FromName(selectBackColor.SelectedItem.Text)
crystalReportViewer.BackColor =
Color.FromName(selectBackColor.SelectedItem.Text);
1.5.1.5.6.4
Pour affecter la s&eacute;lection de couleur d'arri&egrave;replan dans un projet Windows
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; tester le bouton R&eacute;afficher le rapport. Passez &agrave; la section en question, ci-dessous.
Proc&eacute;dure
1.
Ouvrez le Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe pour l'espace de noms System.Drawing (si cet espace de noms n'a pas d&eacute;j&agrave; &eacute;t&eacute;
d&eacute;clar&eacute;).
Imports System.Drawing
using System.Drawing;
4.
Dans le gestionnaire d'&eacute;v&eacute;nements redisplay_Click(), ajoutez du code pour extraire l'&eacute;l&eacute;ment
s&eacute;lectionn&eacute; du contr&ocirc;le ComboBox selectBackColor et convertissez-le en une instance KnownColor.
Dim mySelectedKnownColor As KnownColor = CType(selectBackColor.SelectedItem,
KnownColor)
KnownColor selectedKnownColor = (KnownColor)selectBackColor.SelectedItem;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
323
5.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie que la couleur d'arri&egrave;re-plan s&eacute;lectionn&eacute;e n'est pas transparente.
If Not mySelectedKnownColor = KnownColor.Transparent Then
End If
if (selectedKnownColor != KnownColor.Transparent)
{
}
6.
Dans le bloc If, transmettez l'instance KnownColor &agrave; la m&eacute;thode FromKnownName() de la classe
System.Drawing.Color. Affectez la valeur Color &agrave; la propri&eacute;t&eacute; BackColor du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.BackColor =
System.Drawing.Color.FromKnownColor(mySelectedKnownColor)
crystalReportViewer.BackColor =
System.Drawing.Color.FromKnownColor(selectedKnownColor);
1.5.1.5.6.5
Pour v&eacute;rifier le contr&ocirc;le Button de r&eacute;affichage
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; tester le bouton R&eacute;afficher le rapport.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le contr&ocirc;le DropDownList/ComboBox s'affiche ainsi que les contr&ocirc;les ListBox et Button que vous avez
ajout&eacute;s &agrave; la proc&eacute;dure pr&eacute;c&eacute;dente.
4.
Dans le contr&ocirc;le DropDownList selectBackColor, s&eacute;lectionnez la couleur bleue.
Remarque
N'oubliez pas de s&eacute;lectionner les &eacute;l&eacute;ments de rapport, plus particuli&egrave;rement Main_Page, pour qu'ils soient
visibles.
5.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge pour afficher le rapport avec un arri&egrave;re-plan bleu.
6.
324
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.5.7
rapport
Ajout d'un code pour s&eacute;lectionner une page de
Dans cette section, vous allez apprendre &agrave; coder l'option &quot;Aller &agrave; la page&quot; de la barre d'outils
CrystalReportViewer.
La barre d'outils CrystalReportViewer comporte des boutons de navigation et une zone de texte permettant
de s&eacute;lectionner les pages du rapport. Vous pouvez utiliser les m&eacute;thodes suivantes de la classe
CrystalReportViewer pour coder manuellement les s&eacute;lections de page :
●
ShowFirstPage()
●
ShowLastPage()
●
ShowNextPage()
●
ShowNthPage(int PageNumber)
●
ShowPreviousPage()
Lorsque vous appelez l'une de ces m&eacute;thodes, la page s&eacute;lectionn&eacute;e s'affiche pour le rapport en cours.
1.5.1.5.7.1
Pour ajouter des contr&ocirc;les TextBox et Button &agrave;
l'option &quot;Aller &agrave; la page&quot;
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox vers la quatri&egrave;me ligne de la premi&egrave;re colonne du
tableau.
3.
S&eacute;lectionnez le contr&ocirc;le TextBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;pageNumber&quot;.
b) Laissez la propri&eacute;t&eacute; Text vide.
4.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button vers la quatri&egrave;me ligne de la deuxi&egrave;me colonne du
tableau.
5.
S&eacute;lectionnez le contr&ocirc;le Button, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;goToPage&quot;.
b) Attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Aller &agrave; la page&quot;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
325
1.5.1.5.7.2
Pour coder le gestionnaire d'&eacute;v&eacute;nements Click()
pour le contr&ocirc;le Button
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button Aller &agrave; la page.
La classe code-behind du rapport s'affiche et indique qu'un gestionnaire d'&eacute;v&eacute;nements goToPage_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;.
2.
Convertissez le texte saisi dans le contr&ocirc;le TextBox en un nombre entier, puis transmettez la valeur &agrave; la
m&eacute;thode ShowNthPage() du contr&ocirc;le CrystalReportViewer.
Remarque
Vous n'avez pas valid&eacute; l'entr&eacute;e d'un nombre entier dans le contr&ocirc;le TextBox. Dans des conditions r&eacute;elles,
vous ajouteriez un contr&ocirc;le de validation configur&eacute; par rapport au contr&ocirc;le TextBox.
myCrystalReportViewer.ShowNthPage(Convert.ToInt32(pageNumber.Text))
crystalReportViewer.ShowNthPage(Convert.ToInt32(pageNumber.Text));
1.5.1.5.7.3
Pour v&eacute;rifier le contr&ocirc;le Button goToPage
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport Chart et tous les contr&ocirc;les que vous avez ajout&eacute;s s'affichent.
4.
Saisissez 3 dans le contr&ocirc;le pageNumber TextBox, puis cliquez sur Aller &agrave; la page.
La page se recharge et affiche la page 3 du rapport.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.8
Modification du facteur de zoom
Par d&eacute;faut, la barre d'outils CrystalReportViewer permet de s&eacute;lectionner un facteur de zoom compris entre
25 % et 400 % par incr&eacute;ments fixes de 25 %, 50 % ou 100 %. Dans cette section, vous allez ajouter un code
permettant de s&eacute;lectionner n'importe quel facteur de zoom.
326
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Vous avez besoin d'un contr&ocirc;le TextBox dans lequel vous saisissez le facteur de zoom souhait&eacute; et d'un contr&ocirc;le
Button afin de recharger la page.
1.5.1.5.8.1
Pour ajouter des contr&ocirc;les TextBox et Button &agrave;
l'option Zoom
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox vers la quatri&egrave;me ligne de la troisi&egrave;me colonne du
tableau.
3.
S&eacute;lectionnez le contr&ocirc;le TextBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;zoomFactor&quot;.
b) Laissez la propri&eacute;t&eacute; Text vide.
4.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button vers la quatri&egrave;me ligne de la quatri&egrave;me colonne du
tableau.
5.
S&eacute;lectionnez le contr&ocirc;le Button, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;updateZoomFactor&quot;.
b) Attribuez &agrave; Text la valeur &quot;% Zoom&quot;.
1.5.1.5.8.2
Pour coder le gestionnaire d'&eacute;v&eacute;nements Click()
pour le contr&ocirc;le Button
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button updateZoomFactor.
La classe code-behind du rapport s'affiche et indique qu'un gestionnaire d'&eacute;v&eacute;nements
updateZoomFactor_Click() a &eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;.
2.
Convertissez le texte saisi dans le contr&ocirc;le TextBox en un nombre entier, puis transmettez la valeur &agrave; la
m&eacute;thode Zoom() du contr&ocirc;le CrystalReportViewer.
Remarque
Vous n'avez pas valid&eacute; l'entr&eacute;e d'un nombre entier dans le contr&ocirc;le TextBox. Dans des conditions r&eacute;elles,
vous ajouteriez un contr&ocirc;le de validation configur&eacute; par rapport au contr&ocirc;le TextBox.
myCrystalReportViewer.Zoom(Convert.ToInt32(zoomFactor.Text))
crystalReportViewer.Zoom(Convert.ToInt32(zoomFactor.Text));
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
327
1.5.1.5.8.3
Pour v&eacute;rifier le contr&ocirc;le Button
updateZoomFactor
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport Chart et tous les contr&ocirc;les que vous avez ajout&eacute;s s'affichent.
4.
Saisissez &quot;38&quot; dans la zone de texte zoomFactor, puis cliquez sur Zoom.
La page se recharge et affiche la page en cours &agrave; une taille 38 % inf&eacute;rieure &agrave; sa taille d'origine.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.9
Recherche dans le rapport
Dans cette section, vous allez apprendre &agrave; rechercher un texte dans un rapport Crystal li&eacute; au contr&ocirc;le
CrystalReportViewer.
Vous avez besoin d'un contr&ocirc;le TextBox pour y saisir la cha&icirc;ne recherch&eacute;e, d'un contr&ocirc;le Button pour lancer la
recherche dans le rapport et d'un contr&ocirc;le Label pour &ecirc;tre inform&eacute; de la r&eacute;ussite ou de l'&eacute;chec de la recherche.
1.5.1.5.9.1
Pour ajouter des contr&ocirc;les TextBox, Button et
Label &agrave; l'option Rechercher
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox vers la cinqui&egrave;me ligne de la premi&egrave;re colonne du
tableau.
3.
S&eacute;lectionnez le contr&ocirc;le TextBox, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;searchText&quot;.
b) Laissez la propri&eacute;t&eacute; Text vide.
4.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button vers la cinqui&egrave;me ligne de la deuxi&egrave;me colonne du
tableau.
5.
S&eacute;lectionnez le contr&ocirc;le Button, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;search&quot;.
b) Attribuez &agrave; Text la valeur &quot;Rechercher le texte&quot;.
6.
328
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label vers la cinqui&egrave;me ligne de la troisi&egrave;me colonne du
tableau.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
a) Attribuez &agrave; ID (ou Name) la valeur &quot;message&quot;.
b) Laissez la propri&eacute;t&eacute; Text vide.
c) Attribuez &agrave; ForeColor la valeur Red (couleur rouge).
7.
Cr&eacute;ez la classe MessageConstants pour stocker les r&eacute;ponses standard sous forme de constantes cha&icirc;ne pour
la recherche.
1.5.1.5.9.2
Pour coder le gestionnaire d'&eacute;v&eacute;nements
search_Click() d'un site Web
Contexte
Vous devez ensuite appeler la m&eacute;thode SearchAndHighlightText() dans le contr&ocirc;le Button de recherche.
Remarque
Le comportement de la m&eacute;thode SearchAndHighlightText() est diff&eacute;rent selon que vous cr&eacute;ez un site
Web ou un projet Windows.
Etant donn&eacute; que le comportement de la m&eacute;thode est diff&eacute;rent pour un site Web et pour un projet Windows, suivez
la proc&eacute;dure adapt&eacute;e &agrave; votre site Web ou votre projet Windows.
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button de recherche search.
La classe code-behind du rapport s'affiche et indique qu'un gestionnaire d'&eacute;v&eacute;nements search_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;.
2.
Extrayez le texte saisi dans le contr&ocirc;le TextBox, puis transmettez la valeur &agrave; la m&eacute;thode
SearchAndHighlightText() du contr&ocirc;le CrystalReportViewer. Affectez l'appel de m&eacute;thode &agrave; une variable
bool&eacute;enne.
Remarque
Pour que la classe SearchDirection soit accessible, vous devez inclure une instruction &quot;Imports&quot;
[Visual Basic] ou &quot;using&quot; [C#] au d&eacute;but de la classe code-behind pour l'espace de noms
CrystalDecisions.Shared. (Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un projet
[page 15].)
Dim mySearchResult As Boolean =
myCrystalReportViewer.SearchAndHighlightText(searchText.Text,
SearchDirection.Forward)
bool searchResult = crystalReportViewer.SearchAndHighlightText(searchText.Text,
SearchDirection.Forward);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
329
3.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si la recherche a &eacute;t&eacute; fructueuse.
If Not mySearchResult Then
Else
End If
if(!searchResult)
{
}
else
{
}
4.
Dans le bloc If, affectez la constante MessageConstants.SUCCESS &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label
message.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
5.
Dans le bloc Else, affectez la constante MessageConstants.FAILURE &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label
message.
message.Text = MessageConstants.FAILURE
message.Text = MessageConstants.FAILURE;
1.5.1.5.9.3
Pour coder le gestionnaire d'&eacute;v&eacute;nements
search_Click() d'un projet Windows
Contexte
Ignorez la proc&eacute;dure suivante pour les projets Windows et passez directement &agrave; la proc&eacute;dure de v&eacute;rification qui
suit.
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button de recherche search.
La classe code-behind du rapport s'affiche et indique qu'un gestionnaire d'&eacute;v&eacute;nements search_Click() a
&eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;.
330
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
Extrayez le texte saisi dans le contr&ocirc;le TextBox, puis transmettez la valeur &agrave; la m&eacute;thode
SearchAndHighlightText() du contr&ocirc;le CrystalReportViewer. Affectez l'appel de m&eacute;thode &agrave; une variable
bool&eacute;enne.
Dim mySearchResult As Boolean =
myCrystalReportViewer.SearchAndHighlightText(searchText.Text)
bool searchResult = crystalReportViewer.SearchAndHighlightText(searchText.Text);
3.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si la recherche a &eacute;t&eacute; fructueuse.
If mySearchResult Then
Else
End If
if(searchResult)
{
}
else
{
}
4.
Dans le bloc If, affectez la constante MessageConstants.SUCCESS &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label
message.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
5.
Dans le bloc Else, affectez la constante MessageConstants.FAILURE &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le
message Label.
message.Text = MessageConstants.FAILURE
message.Text = MessageConstants.FAILURE;
1.5.1.5.9.4
Pour v&eacute;rifier le contr&ocirc;le Button de recherche
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
331
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport Chart et tous les contr&ocirc;les que vous avez ajout&eacute;s s'affichent.
4.
Saisissez China dans la zone de texte searchText, puis cliquez sur Rechercher.
La page se recharge et affiche le r&eacute;sultat de la recherche ainsi qu'un message de r&eacute;ussite.
5.
Saisissez hello dans la zone de texte searchText, puis cliquez sur Rechercher.
La page se recharge et affiche un message d'&eacute;chec.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Les autres options de personnalisation sont disponibles uniquement pour la version Web du contr&ocirc;le
CrystalReportViewer. En cons&eacute;quence, si vous d&eacute;veloppez un site Web, effectuez la proc&eacute;dure Ajout d'une
bordure au rapport pour un site Web [page 332].
Si vous d&eacute;veloppez un projet Windows, vous avez maintenant termin&eacute; le tutoriel.
1.5.1.5.10
Ajout d'une bordure au rapport pour un site Web
Dans cette section, vous allez apprendre &agrave; ajouter une bordure personnalis&eacute;e au rapport Crystal pour un site Web.
Pour un projet Windows, les propri&eacute;t&eacute;s de largeur, de style et de couleur de la bordure ne sont pas disponibles.
Les styles de bordure sont r&eacute;pertori&eacute;s dans l'&eacute;num&eacute;ration BorderStyle. Les couleurs sont r&eacute;pertori&eacute;es dans
l'&eacute;num&eacute;ration KnownColor. Cependant, la propri&eacute;t&eacute; BorderColor du contr&ocirc;le CrystalReportViewer extrait les
valeurs de la classe Color. Vous devez par cons&eacute;quent convertir la valeur KnownColor en valeur Color.
Pour commencer, vous ajoutez les contr&ocirc;les n&eacute;cessaires au Web Form. Vous avez besoin d'un contr&ocirc;le TextBox,
de deux contr&ocirc;les DropDownList et d'un contr&ocirc;le Button pour dessiner la bordure.
1.5.1.5.10.1 Pour ajouter les contr&ocirc;les afin de d&eacute;finir la
largeur, le style et la couleur de la bordure
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label vers la sixi&egrave;me ligne de la premi&egrave;re colonne du tableau.
4.
S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Largeur
de la bordure&quot;.
5.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox dans la m&ecirc;me cellule du tableau que le contr&ocirc;le Label.
332
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
6.
S&eacute;lectionnez le contr&ocirc;le TextBox, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur
&quot;borderWidth&quot;.
7.
Dans la bo&icirc;te &agrave; outils, faites glisser un second contr&ocirc;le Label vers la sixi&egrave;me ligne de la deuxi&egrave;me colonne du
tableau.
8.
S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; Text la valeur &quot;Style de bordure&quot;.
9.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList dans la m&ecirc;me cellule du tableau que le contr&ocirc;le
Label.
10. S&eacute;lectionnez le contr&ocirc;le DropDownList, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur
&quot;selectBorderStyle&quot;.
11. Dans la bo&icirc;te &agrave; outils, faites glisser un troisi&egrave;me contr&ocirc;le Label vers la sixi&egrave;me ligne de la troisi&egrave;me colonne du
tableau.
12. S&eacute;lectionnez le contr&ocirc;le Label, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; Textla valeur &quot;Couleur de la
bordure&quot;.
13. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList dans la m&ecirc;me cellule du tableau que le contr&ocirc;le
Label.
14. S&eacute;lectionnez le contr&ocirc;le DropDownList, puis dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur
&quot;selectBorderColor&quot;.
15. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button vers la sixi&egrave;me ligne de la quatri&egrave;me colonne du
tableau.
16. S&eacute;lectionnez le contr&ocirc;le Button, puis effectuez les op&eacute;rations suivantes dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
a) Attribuez &agrave; ID (ou Name) la valeur &quot;drawBorder&quot;.
b) Attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Dessiner une bordure&quot;.
1.5.1.5.10.2
Pour remplir les contr&ocirc;les DropDownList
Contexte
Vous devez &agrave; pr&eacute;sent remplir les contr&ocirc;les DropDownList avec les styles ou les couleurs de bordure disponibles
pour le contr&ocirc;le CrystalReportViewer. Les contr&ocirc;les DropDownList sont remplis dans la m&eacute;thode
ConfigureCrystalReports().
Pour un site Web, les styles de bordure sont stock&eacute;s dans l'&eacute;num&eacute;ration
System.Web.UI.WebControls.BorderStyle. Les couleurs de bordure sont extraites &agrave; partir de l'&eacute;num&eacute;ration
System.Drawing.KnownColor.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
333
Proc&eacute;dure
1.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe de l'espace de noms System.Web.UI.WebControls et System.Drawing (si cet
espace de noms n'a pas d&eacute;j&agrave; &eacute;t&eacute; d&eacute;clar&eacute;).
Imports System.Web.UI.WebControls
Imports System.Drawing
using System.Web.UI.WebControls;
using System.Drawing;
2.
Dans le bloc conditionnel Not IsPostBack de la m&eacute;thode ConfigureCrystalReports(), affectez
l'&eacute;num&eacute;ration BorderStyle &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le DropDownList selectBorderStyle.
selectBorderStyle.DataSource = System.Enum.GetValues(GetType(BorderStyle))
selectBorderStyle.DataSource = System.Enum.GetValues(typeof(BorderStyle));
3.
Liez la source de donn&eacute;es au contr&ocirc;le DropDownList selectBorderStyle.
selectBorderStyle.DataBind()
selectBorderStyle.DataBind();
4.
Toujours dans le bloc conditionnel Not IsPostBack, affectez l'&eacute;num&eacute;ration BorderStyle &agrave; la propri&eacute;t&eacute;
DataSource du contr&ocirc;le DropDownList selectBorderStyle.
selectBorderColor.DataSource =
System.Enum.GetValues(GetType(KnownColor))
selectBorderColor.DataSource =
System.Enum.GetValues(typeof(KnownColor));
5.
Liez la source de donn&eacute;es au contr&ocirc;le DropDownList selectBorderColor.
selectBorderColor.DataBind()
selectBorderColor.DataBind();
334
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.5.10.3
bordure
Pour coder le contr&ocirc;le Button Dessiner une
Contexte
Ensuite, vous allez affecter les valeurs aux propri&eacute;t&eacute;s BorderWidth, BorderStyle et BorderColor du contr&ocirc;le
CrystalReportViewer.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button Dessiner une bordure.
La classe code-behind du rapport s'affiche et indique qu'un gestionnaire d'&eacute;v&eacute;nements
drawBorder_Click() a &eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute;.
4.
Dans le gestionnaire d'&eacute;v&eacute;nements drawBorder_Click(), affectez le texte saisi dans le contr&ocirc;le TextBox
borderWidth &agrave; la propri&eacute;t&eacute; BorderWidth du contr&ocirc;le CrystalReportViewer.
Remarque
Vous n'avez pas valid&eacute; l'entr&eacute;e d'un nombre entier dans le contr&ocirc;le TextBox. Dans des conditions r&eacute;elles,
vous ajouteriez un contr&ocirc;le de validation configur&eacute; par rapport au contr&ocirc;le TextBox.
myCrystalReportViewer.BorderWidth =
Unit.Parse(borderWidth.Text.ToString())
crystalReportViewer.BorderWidth =
Convert.ToInt32(borderWidth.Text);
5.
Dans le contr&ocirc;le DropDownList selectBorderStyle, extrayez l'index s&eacute;lectionn&eacute;, puis convertissez-le en
une valeur BorderStyle. Affectez la valeur BorderStyle &agrave; la propri&eacute;t&eacute; BorderStyle du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.BorderStyle = CType(selectBorderStyle.SelectedIndex,
BorderStyle)
crystalReportViewer.BorderStyle = (BorderStyle)selectBorderStyle.SelectedIndex;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
335
6.
Dans le contr&ocirc;le DropDownList selectBorderColor, extrayez l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; sous la forme d'une cha&icirc;ne,
puis transmettez-le &agrave; la m&eacute;thode FromName() de la classe Color. Affectez la valeur Color &agrave; la propri&eacute;t&eacute;
BorderColor du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.BorderColor =
Color.FromName(selectBorderColor.SelectedItem.Text)
crystalReportViewer.BorderColor =
Color.FromName(selectBorderColor.SelectedItem.Text);
1.5.1.5.10.4
Crystal
Pour dessiner une bordure autour du rapport
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Pour la largeur de la bordure, saisissez10.
5.
Pour le style de la bordure, s&eacute;lectionnez Double.
6.
Pour la couleur de la bordure, s&eacute;lectionnez SteelBlue.
7.
Cliquez sur le bouton Dessiner une bordure.
La page se recharge et affiche une bordure autour du rapport Crystal.
8.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.11
site Web
Configuration de la persistance Session pour un
Dans cette section, vous allez apprendre &agrave; configurer la persistance Session pour les &eacute;v&eacute;nements de clic.
Lorsqu'une page Web est recharg&eacute;e lors d'un &eacute;v&eacute;nement de clic, les modifications apport&eacute;es au mod&egrave;le d'objet
CrystalReportViewer sont perdues.
336
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.1.5.11.1
Web
Pour montrer le manque de persistance d'un site
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le DropDownList selectBackColor, s&eacute;lectionnez la couleur bleue.
5.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge pour afficher le rapport sans aucune barre d'outils, avec un arri&egrave;re-plan bleu.
6.
Pour la largeur de la bordure, saisissez &quot;10&quot;.
7.
Pour le style de la bordure, s&eacute;lectionnez &quot;Double&quot;.
8.
Pour la couleur de la bordure, s&eacute;lectionnez &quot;SteelBlue&quot;.
9.
Cliquez sur Dessiner Bordure.
La page se recharge pour afficher une bordure autour du rapport Crystal et la couleur bleue de l'arri&egrave;re-plan
dispara&icirc;t.
10. Saisissez &quot;3&quot; dans le contr&ocirc;le TextBox pageNumber, puis cliquez sur Aller &agrave; la page.
La page se recharge pour afficher la page 3 et la bordure du rapport n'est plus visible.
11. Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.1.5.11.2
Pour ajouter un code d'affectation Session au
gestionnaire d'&eacute;v&eacute;nements drawBorder_Click()
Contexte
Vous devez ajouter un code de persistance &agrave; votre application afin que les modifications apport&eacute;es au mod&egrave;le
d'objet CrystalReportViewer soient rendues persistantes lorsque les pages Web sont recharg&eacute;es.
Pour commencer, vous ajoutez un code de persistance pour les valeurs de bordure au gestionnaire d'&eacute;v&eacute;nements
drawBorder_Click(), auquel ces valeurs sont affect&eacute;es en premier. Puis, dans la m&eacute;thode
ConfigureCrystalReports(), les valeurs stock&eacute;es dans Session sont extraites et affect&eacute;es aux propri&eacute;t&eacute;s
respectives de la classe CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
337
Proc&eacute;dure
Dans le gestionnaire d'&eacute;v&eacute;nements drawBorder_Click(), &agrave; la suite du code existant, ajoutez les quatre
affectations Session BackColor, BorderColor, BorderStyle et BorderWidth.
Session(&quot;myBorderColor&quot;) =
myCrystalReportViewer.BorderColor.ToString()
Session(&quot;myBorderStyle&quot;) = myCrystalReportViewer.BorderStyle
Session(&quot;myBorderWidth&quot;) = myCrystalReportViewer.BorderWidth
Session[&quot;borderColor&quot;] =
crystalReportViewer.BorderColor.ToString();
Session[&quot;borderStyle&quot;] = crystalReportViewer.BorderStyle;
Session[&quot;borderWidth&quot;] = crystalReportViewer.BorderWidth;
1.5.1.5.11.3
Pour ajouter un code d'extraction Session &agrave; la
m&eacute;thode ConfigureCrystalReports()
Contexte
Vous pouvez maintenant extraire ces valeurs de Session dans la m&eacute;thode ConfigureCrystalReports().
Proc&eacute;dure
1.
A la fin de la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez un bloc If qui v&eacute;rifie si la variable Session
BackColor est null.
Si elle n'est pas null, dans le bloc If, extrayez la propri&eacute;t&eacute; BackColor de Session et effectuez un cast de
celle-ci en cha&icirc;ne. Transmettez la cha&icirc;ne &agrave; la m&eacute;thode FromName() de la classe Color et affectez l'instance
Color &agrave; la propri&eacute;t&eacute; BackColor de l'instance CrystalReportViewer.
If Not IsNothing(Session(&quot;myBackColor&quot;)) Then
myCrystalReportViewer.BackColor =
Color.FromName(CType(Session(&quot;myBackColor&quot;), String))
End If
if (Session[&quot;backColor&quot;] != null)
{
crystalReportViewer.BackColor = Color.FromName((string)Session[&quot;backColor&quot;]);
}
2.
Cr&eacute;ez un second bloc If qui v&eacute;rifie si la variable Session BorderColor est null. Si elle n'est pas null, dans le
bloc If, extrayez la propri&eacute;t&eacute; BorderColor de Session et effectuez un cast de celle-ci en cha&icirc;ne.
338
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Transmettez la cha&icirc;ne &agrave; la m&eacute;thode FromName() de la classe Color et affectez l'instance Color &agrave; la
propri&eacute;t&eacute; BorderColor de l'instance CrystalReportViewer.
If Not IsNothing(Session(&quot;myBorderColor&quot;)) Then
myCrystalReportViewer.BorderColor =
Color.FromName(CType(Session(&quot;myBorderColor&quot;), String))
End If
if (Session[&quot;borderColor&quot;] != null)
{
crystalReportViewer.BorderColor =
Color.FromName((string)Session[&quot;borderColor&quot;]);
}
3.
Cr&eacute;ez un troisi&egrave;me bloc If qui v&eacute;rifie si la variable Session BorderStyle est null. Si elle n'est pas null, dans le
bloc If, extrayez la propri&eacute;t&eacute; BorderStyle de Session et effectuez un cast de celle-ci en BorderStyle.
myCrystalReportViewer.BorderStyle = CType(Session(&quot;myBorderStyle&quot;), BorderStyle)
if (Session[&quot;borderStyle&quot;] != null)
{
crystalReportViewer.BorderStyle = (BorderStyle)Session[&quot;borderStyle&quot;];
}
4.
Cr&eacute;ez un quatri&egrave;me bloc If qui v&eacute;rifie si la variable Session BorderWidth est null. Si elle n'est pas null, dans le
bloc If, extrayez la propri&eacute;t&eacute; BorderWidth de Session et convertissez-la en entier.
myCrystalReportViewer.BorderWidth = Convert.ToInt32(Session(&quot;myBorderWidth&quot;))
if (Session[&quot;borderStyle&quot;] != null)
{
crystalReportViewer.BorderWidth = Convert.ToInt32(Session[&quot;borderStyle&quot;]);
}
1.5.1.5.11.4
Pour coder le contr&ocirc;le Button drawBorder
Contexte
Dans la proc&eacute;dure suivante, vous ajoutez une persistance Session au gestionnaire d'&eacute;v&eacute;nements de clic du
contr&ocirc;le Button de r&eacute;affichage.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
339
Proc&eacute;dure
1.
Dans le gestionnaire d'&eacute;v&eacute;nements redisplay_Click(), affectez l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; du contr&ocirc;le
DropDownList selectBackColor &agrave; Session.
Session(&quot;myBackColor&quot;) = selectBackColor.SelectedItem.Text
Session[&quot;backColor&quot;] = selectBackColor.SelectedItem.Text;
2.
Dans le gestionnaire d'&eacute;v&eacute;nements drawBorder_Click(), affectez la propri&eacute;t&eacute; Text du contr&ocirc;le TextBox
borderWidth &agrave; Session.
Session(&quot;myBorderWidth&quot;) = borderWidth.Text
Session[&quot;borderWidth&quot;] = borderWidth.Text;
3.
Affectez l'index s&eacute;lectionn&eacute; dans DropDownList selectBorderStyle &agrave; Session.
Session(&quot;myBorderStyle&quot;) = selectBorderStyle.SelectedIndex
Session[&quot;borderStyle&quot;] = selectBorderStyle.SelectedIndex;
4.
Affectez l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans DropDownList selectBorderColor &agrave; Session.
Session(&quot;myBorderColor&quot;) = selectBorderColor.SelectedItem.Text
Session[&quot;borderColor&quot;] = selectBorderColor.SelectedItem.Text;
R&eacute;sultats
Vous pouvez maintenant g&eacute;n&eacute;rer et ex&eacute;cuter le projet, afin de v&eacute;rifier que les changements apport&eacute;s au rapport
sont persistants entre les &eacute;v&eacute;nements de clic.
1.5.2
Tutoriels du mod&egrave;le d'objet ReportDocument
Cette section pr&eacute;sente divers tutoriels bas&eacute;s sur le mod&egrave;le d'objet ReportDocument.
Cette section pr&eacute;sente divers tutoriels bas&eacute;s sur le mod&egrave;le d'objet ReportDocument.
340
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.1
Tutoriel : Persistance du mod&egrave;le d'objet
ReportDocument &agrave; l'aide de Session
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution.
Dans ce tutoriel, vous allez utiliser le mod&egrave;le d'objet ReportDocument et effectuer des modifications par
programmation sur un rapport au moment de l'ex&eacute;cution. Vous apprendrez &eacute;galement &agrave; utiliser Session pour
garantir la persistance de ces modifications au fur et &agrave; mesure du rechargement des pages Web.
Seules les applications Web n&eacute;cessitant une persistance Session, ce tutoriel ne s'applique pas aux projets
Windows.
Introduction
Le projet que vous allez cr&eacute;er dans ce tutoriel utilise un Web Form contenant un contr&ocirc;le CrystalReportViewer et
deux boutons qui modifient l'ordre de tri du rapport dans le mod&egrave;le d'objet ReportDocument.
Vous allez tout d'abord cr&eacute;er le projet sans la m&eacute;thode de persistance Session. Sans la persistance, vous pouvez
constater que la modification de l'ordre de tri ne dure que le temps d'un &eacute;v&eacute;nement de clic.
Vous ajouterez ensuite la m&eacute;thode de persistance Session au projet. L'instance ReportDocument est plac&eacute;e
dans Session au moment de la cr&eacute;ation, ainsi qu'&agrave; chaque modification de l'&eacute;tat de cette instance
ReportDocument.
Chaque fois que le rapport doit &ecirc;tre r&eacute;affich&eacute;, l'instance ReportDocument est extraite de Session et li&eacute;e au
contr&ocirc;le CrystalReportViewer. Ceci permet de garantir que chaque fois que le rapport est affich&eacute;, l'utilisateur
visualise la version la plus r&eacute;cente de l'instance ReportDocument.
Remarque
Ce tutoriel utilise la m&eacute;thode Session, car vous allez rendre persistantes les modifications apport&eacute;es au mod&egrave;le
d'objet ReportDocument. Si vous envisagez d'utiliser uniquement le mod&egrave;le d'objet limit&eacute; contenu dans le
contr&ocirc;le CrystalReportViewer, utilisez exclusivement ViewState.
Lors de l'utilisation de Session pour rendre persistant un objet
ReportDocument, d'autres mod&egrave;les de persistance sont-ils utilis&eacute;s ?
Lors de l'utilisation de Session pour rendre persistant un objet ReportDocument, d'autres mod&egrave;les de persistance
sont-ils utilis&eacute;s ?
Oui. Dans une application Web ASP.NET, les objets utilisent g&eacute;n&eacute;ralement Session pour la persistance, tandis que
les contr&ocirc;les serveur Web utilisent ViewState. Du fait qu'une application SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio utilise des objets et des contr&ocirc;les serveur Web pour interagir avec les
rapports, la persistance est partag&eacute;e par Session et ViewState :
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
341
●
Session rend persistant le mod&egrave;le d'objet ReportDocument, qui interagit par programmation avec le rapport
au moment de l'ex&eacute;cution.
●
ViewState rend persistant le contr&ocirc;le CrystalReportViewer, qui affiche le rapport. Plus particuli&egrave;rement,
ViewState rend persistantes les propri&eacute;t&eacute;s affich&eacute;es, d&eacute;finies dans la barre d'outils de CrystalReportViewer.
ViewState rend &eacute;galement persistants les &eacute;v&eacute;nements (tels que zoom et NextPage) d&eacute;clench&eacute;s &agrave; partir des
boutons de la barre d'outils.
La persistance de ViewState est g&eacute;r&eacute;e automatiquement. Vous ne codez donc que la persistance de Session dans
ce tutoriel.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_Session
●
Site Web Visual Basic : VB_Web_RDObjMod_Session
Informations associ&eacute;es
Quelle m&eacute;thode de persistance utiliser avec SAP Crystal Reports ? [page 53]
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.1.1
Configuration des boutons sur le Web Form
Vous allez tout d'abord ajouter deux boutons au Web Form, leur donner un nom, puis cr&eacute;er des &eacute;v&eacute;nements de
clic pour chacun d'eux.
1.5.2.1.1.1
Pour ajouter des boutons au Web Form
Proc&eacute;dure
1.
Ouvrez la page Default.aspx.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez sur le contr&ocirc;le CrystalReportViewer et appuyez sur la FLECHE GAUCHE du clavier afin de faire
appara&icirc;tre un curseur clignotant, puis appuyez sur la touche ENTREE.
342
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Le contr&ocirc;le CrystalReportViewer descend d'une ligne.
4.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le serveur Web Button au-dessus du contr&ocirc;le
CrystalReportViewer.
5.
Cliquez &agrave; droite du contr&ocirc;le Button afin de faire appara&icirc;tre un curseur clignotant, puis appuyez deux fois sur la
barre espace.
6.
Dans la bo&icirc;te &agrave; outils, faites glisser un second contr&ocirc;le serveur Web Button &agrave; droite du premier contr&ocirc;le
Button.
1.5.2.1.1.2
Pour d&eacute;finir les propri&eacute;t&eacute;s Text et ID de chaque
contr&ocirc;le Button
Proc&eacute;dure
1.
Cliquez sur le premier contr&ocirc;le serveur Web Button pour le s&eacute;lectionner.
2.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
○
Attribuez &agrave; ID la valeur &quot;sortOrderDescending&quot;.
○
Attribuez &agrave; Text la valeur &quot;Trier par ordre d&eacute;croissant&quot;.
3.
Cliquez sur le second contr&ocirc;le serveur Web Button pour le s&eacute;lectionner.
4.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
○
Attribuez &agrave; ID la valeur &quot;sortOrderAscending&quot;.
○
Attribuez &agrave; Text la valeur &quot;Trier par ordre croissant&quot;.
1.5.2.1.1.3
Cr&eacute;ation d'&eacute;v&eacute;nements de clic pour chaque
contr&ocirc;le Button
Proc&eacute;dure
1.
Cliquez deux fois sur le premier contr&ocirc;le serveur Web Button.
La classe code-behind s'ouvre et une m&eacute;thode d'&eacute;v&eacute;nement sortOrderDescending_Click() est cr&eacute;&eacute;e
dans la partie inf&eacute;rieure de la classe.
2.
Revenez au mode Design de la page Default.aspx.
3.
Cliquez deux fois sur le second contr&ocirc;le serveur Web Button.
La classe code-behind s'ouvre et une m&eacute;thode d'&eacute;v&eacute;nement sortOrderAscending_Click() est cr&eacute;&eacute;e dans
la partie inf&eacute;rieure de la classe.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
343
1.5.2.1.2
Programmation des &eacute;v&eacute;nements Button avec un
ordre de tri
Dans cette proc&eacute;dure, vous allez programmer le mod&egrave;le d'objet ReportDocument du rapport dans la m&eacute;thode
d'&eacute;v&eacute;nement et d&eacute;finir un ordre de tri croissant dans une m&eacute;thode d'&eacute;v&eacute;nement et un ordre de tri d&eacute;croissant
dans l'autre m&eacute;thode d'&eacute;v&eacute;nement.
1.5.2.1.2.1
Pour programmer le mod&egrave;le d'objet
ReportDocument du rapport dans la m&eacute;thode d'&eacute;v&eacute;nement
sortOrderDescending_Click
Proc&eacute;dure
1.
Ouvrez la classe code-behind et recherchez la m&eacute;thode d'&eacute;v&eacute;nement sortOrderDescending_Click().
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement, extrayez la propri&eacute;t&eacute; SortFields de la propri&eacute;t&eacute; DataDefinition de
l'instance de rapport et affectez-la &agrave; une instance de la classe index&eacute;e SortFields.
Dim mySortFields As SortFields =
hierarchicalGroupingReport.DataDefinition.SortFields
SortFields sortFields = hierarchicalGroupingReport.DataDefinition.SortFields;
3.
Extrayez la premi&egrave;re instance SortField de la classe index&eacute;e SortFields et affectez-la &agrave; une variable
appel&eacute;e firstSortField.
Remarque
La classe index&eacute;e SortFields est bas&eacute;e sur 0.
Dim firstSortField As SortField = mySortFields(0)
SortField firstSortField = sortFields[0];
4.
Affectez &agrave; la propri&eacute;t&eacute; SortDirection de firstSortField un ordre d&eacute;croissant, en utilisant la s&eacute;lection
DescendingOrder de l'&eacute;num&eacute;ration SortDirection.
firstSortField.SortDirection = SortDirection.DescendingOrder
firstSortField.SortDirection = SortDirection.DescendingOrder;
344
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
R&eacute;affectez maintenant ce rapport (avec l'ordre de tri modifi&eacute; dans le mod&egrave;le d'objet ReportDocument) &agrave; la
propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = hierarchicalGroupingReport
crystalReportViewer.ReportSource = hierarchicalGroupingReport;
R&eacute;sultats
Dans la proc&eacute;dure suivante, vous allez saisir le code de la m&eacute;thode d'&eacute;v&eacute;nement
sortOrderAscending_Click(). Le code est identique, &agrave; l'exception du param&egrave;tre de propri&eacute;t&eacute;
SortDirection.
1.5.2.1.2.2
Pour programmer le mod&egrave;le d'objet
ReportDocument du rapport dans la m&eacute;thode d'&eacute;v&eacute;nement
sortOrderAscending_Click
Proc&eacute;dure
1.
Ouvrez la classe code-behind et recherchez la m&eacute;thode d'&eacute;v&eacute;nement sortOrderAscending_Click().
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement, extrayez la propri&eacute;t&eacute; SortFields de la propri&eacute;t&eacute; DataDefinition de
l'instance de rapport et affectez-la &agrave; une instance de la classe index&eacute;e SortFields.
Dim mySortFields As SortFields =
hierarchicalGroupingReport.DataDefinition.SortFields
SortFields sortFields = hierarchicalGroupingReport.DataDefinition.SortFields;
3.
Extrayez la premi&egrave;re instance SortField de la classe index&eacute;e SortFields et affectez-la &agrave; une variable
appel&eacute;e firstSortField.
Remarque
La classe index&eacute;e SortFields est bas&eacute;e sur 0.
Dim firstSortField As SortField = mySortFields(0)
SortField firstSortField = sortFields[0];
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
345
4.
Attribuez &agrave; la propri&eacute;t&eacute; SortDirection de l'instance firstSortField un ordre croissant, en utilisant la
s&eacute;lection AscendingOrder de l'&eacute;num&eacute;ration SortDirection.
firstSortField.SortDirection = SortDirection.AscendingOrder
firstSortField.SortDirection = SortDirection.AscendingOrder;
5.
R&eacute;affectez maintenant ce rapport (avec l'ordre de tri modifi&eacute; dans le mod&egrave;le d'objet ReportDocument) &agrave; la
propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
myCrystalReportViewer.ReportSource = hierarchicalGroupingReport
crystalReportViewer.ReportSource = hierarchicalGroupingReport;
R&eacute;sultats
La programmation du mod&egrave;le d'objet ReportDocument du rapport dans chaque m&eacute;thode d'&eacute;v&eacute;nement est
termin&eacute;e. La section suivante va permettre de v&eacute;rifier le bon fonctionnement de ces modifications d'ordre de tri et
leur persistance lorsque la m&eacute;thode Session n'est pas appliqu&eacute;e.
1.5.2.1.3
V&eacute;rification et d&eacute;termination des erreurs de
persistance
Dans cette section, vous verrez que, sans l'utilisation de la m&eacute;thode de persistance Session, les modifications de
tri ne sont pas conserv&eacute;es lorsque la page est recharg&eacute;e afin de refl&eacute;ter les changements apport&eacute;s aux
param&egrave;tres d'affichage.
1.5.2.1.3.1
Pour v&eacute;rifier les modifications par
programmation apport&eacute;es &agrave; l'ordre de tri cod&eacute; dans le projet
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Si vous ne rencontrez aucune erreur lors de la g&eacute;n&eacute;ration, la page Default.aspx est charg&eacute;e dans le
navigateur, avec le rapport Hierarchical Grouping g&eacute;n&eacute;r&eacute; dans le formulaire.
346
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
4.
Observez attentivement l'ordre de tri. Vous pouvez imprimer la page pour comparer les modifications dans
l'ordre de tri.
5.
Cliquez sur le bouton Trier par ordre d&eacute;croissant.
L'ordre de tri s'inverse.
6.
Cliquez sur le bouton Trier par ordre croissant.
L'ordre de tri reprend sa valeur d'origine (croissant).
1.5.2.1.3.2
Pour v&eacute;rifier si les modifications de tri sont
conserv&eacute;es lorsque les param&egrave;tres d'affichage sont modifi&eacute;s
Contexte
Dans la proc&eacute;dure suivante, vous allez v&eacute;rifier si l'ordre de tri est conserv&eacute; lorsque d'autres modifications (de
param&egrave;tres d'affichage, par exemple) sont apport&eacute;es &agrave; la page.
Proc&eacute;dure
1.
Cliquez sur le bouton Trier par ordre d&eacute;croissant.
L'ordre de tri s'inverse.
2.
Dans la barre d'outils du rapport, ajustez le zoom de 100 % &agrave; 125 %.
La page recharge le rapport avec un facteur de zoom &eacute;gal &agrave; 125 %, mais l'inversion du tri n'a pas &eacute;t&eacute;
conserv&eacute;e.
3.
Cliquez &agrave; nouveau sur le bouton Trier par ordre d&eacute;croissant.
L'ordre de tri s'inverse.
4.
Dans la barre d'outils du rapport, ajustez le zoom de 125 % &agrave; 100 %.
5.
La page recharge le rapport avec un facteur de zoom &eacute;gal &agrave; 100 %, mais l'inversion du tri n'a pas &eacute;t&eacute;
conserv&eacute;e.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Ce test permet de constater qu'&agrave; ce stade du tutoriel la persistance &eacute;choue. L'ordre de tri n'est appliqu&eacute; que
lorsque l'utilisateur clique sur l'un des boutons de tri. L'ordre de tri est annul&eacute; lorsque l'utilisateur interagit avec la
page pour r&eacute;gler le zoom ou ouvrir une autre page dans un rapport comprenant plusieurs pages. Par cons&eacute;quent,
vous devez ajouter du code pour rendre persistant le changement d'ordre de tri effectu&eacute; avec Session dans le
mod&egrave;le d'objet ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
347
1.5.2.1.4
Ajout de code Session
Dans cette section, vous allez apprendre &agrave; utiliser Session pour rendre persistant le changement d'ordre de tri du
rapport. Vous allez ajouter, &agrave; la m&eacute;thode ConfigureCrystalReports() cr&eacute;&eacute;e lors de la configuration de votre
projet (voir Configuration d'un projet [page 15]), du code permettant de rechercher Session et de recharger
imm&eacute;diatement l'instance du rapport dans Session lorsqu'un utilisateur modifie l'ordre de tri.
1.5.2.1.4.1
Pour ajouter &agrave; la m&eacute;thode
ConfigureCrystalReports() du code permettant de rechercher
Session
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), avant le code existant, cr&eacute;ez un bloc conditionnel if/else
v&eacute;rifiant si un objet Session nomm&eacute; hierarchicalGroupingReport existe.
Vous pouvez utiliser le nom d'identificateur de votre choix pour cet objet Session. Choisissez un identificateur
unique tel que le nom de l'instance de rapport.
If (Session(&quot;hierarchicalGroupingReport&quot;) Is Nothing) Then
Else
End If
if(Session[&quot;hierarchicalGroupingReport&quot;] == null)
{
}
else
{
}
2.
Si vous utilisez un rapport incorpor&eacute;, d&eacute;placez la ligne de code qui d&eacute;clare et instancie le rapport de son
emplacement actuel vers le bloc If.
If (Session(&quot;hierarchicalGroupingReport&quot;) Is Nothing) Then
hierarchicalGroupingReport = New Hierarchical_Grouping()
Else
End If
if (Session[&quot;hierarchicalGroupingReport&quot;] == null)
{
hierarchicalGroupingReport = new Hierarchical_Grouping();
}
else
{
}
348
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Si vous utilisez un rapport non incorpor&eacute;, d&eacute;placez les deux lignes de code qui d&eacute;clarent et instancient le
rapport, puis le chargent de son emplacement actuel dans le r&eacute;pertoire vers le bloc If.
Remarque
Consultez le lien R&eacute;pertoire d'exemples de rapports [page 15] pour d&eacute;terminer le chemin correct des
exemples de rapports.
If (Session(&quot;hierarchicalGroupingReport&quot;) Is Nothing) Then
hierarchicalGroupingReport = New ReportDocument()
hierarchicalGroupingReport.Load(&quot;C:\Program Files\Microsoft Visual Studio
9.0\Crystal Reports\Samples\fr\Reports\Feature Examples\Hierarchical
Grouping.rpt&quot;)
Else
End If
if(Session[&quot;hierarchicalGroupingReport&quot;] == null)
{
hierarchicalGroupingReport = new ReportDocument();
hierarchicalGroupingReport.Load(&quot;C:\Program Files\Microsoft Visual Studio
9.0\Crystal Reports\Samples\fr\Reports\Feature Examples\Hierarchical
Grouping.rpt&quot;);
}
else
{
}
4.
Dans le bloc If, affectez le rapport dans Session, en utilisant le nom de la variable du rapport comme
identificateur Session.
Session(&quot;hierarchicalGroupingReport&quot;) = hierarchicalGroupingReport
Session[&quot;hierarchicalGroupingReport&quot;] = hierarchicalGroupingReport;
Ce bloc est maintenant finalis&eacute;. Le bloc If est appliqu&eacute; si le rapport ne se trouve pas dans Session. Le bloc Else
est appliqu&eacute; si le rapport se trouve dans Session ; par cons&eacute;quent, le but du bloc Else est d'extraire le rapport
de Session vers une instance du rapport.
5.
Dans le bloc Else, affectez le rapport stock&eacute; dans Session &agrave; l'instance du rapport.
hierarchicalGroupingReport = CType(Session(&quot;hierarchicalGroupingReport&quot;),
ReportDocument)
hierarchicalGroupingReport =
(ReportDocument)Session[&quot;hierarchicalGroupingReport&quot;];
Remarque
Session ne renvoyant que des objets g&eacute;n&eacute;riques, vous devez effectuer un transtypage du rapport en type
de rapport. Que vous utilisiez des rapports incorpor&eacute;s ou non incorpor&eacute;s, effectuez un transtypage de
l'objet extrait en objet de type ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
349
En dehors et en dessous du bloc conditionnel, le code restant lie l'instance du rapport &agrave; la propri&eacute;t&eacute;
ReportSource du contr&ocirc;le CrystalReportViewer.
R&eacute;sultats
Comme cela est expliqu&eacute; dans la section Configuration d'un projet (voir Configuration d'un projet [page 15]), la
m&eacute;thode ConfigureCrystalReports() est appel&eacute;e &agrave; chaque rechargement de page. La modification de cette
m&eacute;thode garantit par cons&eacute;quent l'extraction et le chargement du rapport le plus r&eacute;cent (qu'il soit nouveau ou
stock&eacute; dans Session). Toutefois, rien n'a encore &eacute;t&eacute; &eacute;crit pour mettre r&eacute;ellement &agrave; jour l'instance du rapport.
Dans la section suivante, vous allez mettre &agrave; jour l'instance de rapport dans Session &agrave; chaque modification de
l'ordre de tri.
1.5.2.1.4.2
Pour mettre &agrave; jour l'instance de rapport dans
Session pour la m&eacute;thode d'&eacute;v&eacute;nement
sortOrderDescending_Click
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement sortOrderDescending_Click(), supprimez la derni&egrave;re ligne de code qui lie
le contr&ocirc;le CrystalReportViewer au rapport.
Vous devez donc obtenir les trois lignes de code permettant de modifier le sens du tri.
2.
Sous ces trois lignes de code, affectez l'instance hierarchicalGroupingReport (mise &agrave; jour avec un nouvel
ordre de tri) dans Session &agrave; l'aide du m&ecirc;me identificateur que celui utilis&eacute; dans la m&eacute;thode
ConfigureCrystalReports().
Remarque
Pour simplifier l'op&eacute;ration, copiez et collez cette ligne de code depuis la m&eacute;thode
ConfigureCrystalReports().
Session(&quot;hierarchicalGroupingReport&quot;) = hierarchicalGroupingReport
Session[&quot;hierarchicalGroupingReport&quot;] = hierarchicalGroupingReport;
3.
Enfin, ajoutez un appel &agrave; la m&eacute;thode ConfigureCrystalReports() afin d'obtenir la derni&egrave;re instance
hierarchicalGroupingReport de Session (celle que vous venez de mettre jour) et liez-la au contr&ocirc;le
CrystalReportViewer.
ConfigureCrystalReports()
ConfigureCrystalReports();
350
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;sultats
R&eacute;p&eacute;tez maintenant les m&ecirc;mes &eacute;tapes pour la seconde m&eacute;thode d'&eacute;v&eacute;nement.
1.5.2.1.4.3
Pour mettre &agrave; jour l'instance de rapport dans
Session pour la m&eacute;thode d'&eacute;v&eacute;nement
sortOrderAscending_Click
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement sortOrderAscending_Click(), supprimez la derni&egrave;re ligne de code qui lie
le contr&ocirc;le CrystalReportViewer au rapport.
Vous devez donc obtenir les trois lignes de code permettant de modifier le sens du tri.
2.
Sous ces trois lignes de code, affectez l'instance hierarchicalGroupingReport (mise &agrave; jour avec un nouvel
ordre de tri) dans Session &agrave; l'aide du m&ecirc;me identificateur que celui utilis&eacute; dans la m&eacute;thode
ConfigureCrystalReports().
Pour simplifier l'op&eacute;ration, copiez et collez cette ligne de code depuis la m&eacute;thode
ConfigureCrystalReports().
Session(&quot;hierarchicalGroupingReport&quot;) = hierarchicalGroupingReport
Session[&quot;hierarchicalGroupingReport&quot;] = hierarchicalGroupingReport;
3.
Enfin, ajoutez un appel &agrave; la m&eacute;thode ConfigureCrystalReports() afin d'obtenir la derni&egrave;re instance
hierarchicalGroupingReport de Session (celle que vous venez de mettre jour) et liez-la au contr&ocirc;le
CrystalReportViewer.
ConfigureCrystalReports()
ConfigureCrystalReports();
R&eacute;sultats
Vous pouvez &agrave; pr&eacute;sent v&eacute;rifier si les modifications de tri ont bien &eacute;t&eacute; rendues persistantes.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
351
1.5.2.1.5
V&eacute;rification et d&eacute;termination du caract&egrave;re correct
de la persistance
Dans cette section, vous allez v&eacute;rifier si les modifications de tri ont bien &eacute;t&eacute; rendues persistantes &agrave; pr&eacute;sent que
Session est utilis&eacute;e.
1.5.2.1.5.1
Pour v&eacute;rifier si les modifications de tri ont bien
&eacute;t&eacute; rendues persistantes
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, cliquez sur G&eacute;n&eacute;rer la solution.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
2.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Si vous ne rencontrez aucune erreur lors de la g&eacute;n&eacute;ration, la page Default.aspx est charg&eacute;e dans le
navigateur, avec le rapport Hierarchical Grouping g&eacute;n&eacute;r&eacute; dans le formulaire.
3.
Observez attentivement l'ordre de tri. Vous pouvez imprimer la page pour comparer les modifications dans
l'ordre de tri.
4.
Cliquez sur le bouton Trier par ordre d&eacute;croissant.
L'ordre de tri s'inverse.
5.
Dans la barre d'outils du rapport, ajustez le zoom de 100 % &agrave; 125 %.
La page recharge le rapport avec un facteur de zoom &eacute;gal &agrave; 125 %. L'inversion de l'ordre de tri a bien &eacute;t&eacute;
conserv&eacute;e.
6.
Cliquez sur le bouton Trier par ordre croissant.
L'ordre de tri est r&eacute;tabli.
7.
Dans la barre d'outils du rapport, ajustez le zoom de 125 % &agrave; 100 %.
La page recharge le rapport avec un facteur de zoom &eacute;gal &agrave; 100 %. L'ordre de tri a conserv&eacute; le param&eacute;trage
de l'&eacute;tape pr&eacute;c&eacute;dente.
R&eacute;sultats
Ce test permet de constater que la persistance fonctionne maintenant correctement.
352
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.2
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL
Dans ce tutoriel, vous allez apprendre &agrave; ajouter un code de connexion afin d'afficher un rapport contenant des
informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Introduction
Pour vous connecter &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e, vous utilisez des classes du mod&egrave;le d'objet
ReportDocument.
L'objet ReportDocument comporte une propri&eacute;t&eacute; Database qui renvoie une instance Database. Cette instance
Database contient les informations de base de donn&eacute;es pour le rapport, notamment une propri&eacute;t&eacute; Tables qui
renvoie une instance de classe index&eacute;e Tables. Chaque instance Table peut &ecirc;tre extraite de la classe index&eacute;e
Tables.
La connexion se produit au niveau granulaire de chaque instance Table, qui doit obtenir une autorisation d'acc&egrave;s
individuel &agrave; la base de donn&eacute;es SQL Server s&eacute;curis&eacute;e. Ceci s'effectue en pla&ccedil;ant les informations de connexion
dans une instance ConnectionInfo puis, &agrave; l'int&eacute;rieur d'une boucle for, en appliquant cette instance
ConnectionInfo &agrave; la propri&eacute;t&eacute; ConnectionInfo de chaque instance Table.
Les propri&eacute;t&eacute;s de la classe ConnectionInfo sont les suivantes :
●
ServerName
●
DatabaseName
●
UserID
●
Password
●
IntegratedSecurity (non utilis&eacute;e dans ce tutoriel)
Remarque
Si vous souhaitez suivre un tutoriel qui utilise l'authentification Windows (et utilise donc la propri&eacute;t&eacute;
IntegratedSecurity au lieu des propri&eacute;t&eacute;s UserID et Password), voir Tutoriel : Connexion &agrave; une base de donn&eacute;es
SQL Server s&eacute;curis&eacute;e &agrave; l'aide de la s&eacute;curit&eacute; int&eacute;gr&eacute;e [page 370].
Si vous d&eacute;finissez uniquement les propri&eacute;t&eacute;s DatabaseName, UserID et Password, vous serez connect&eacute; au
serveur et &agrave; la base de donn&eacute;es par d&eacute;faut sp&eacute;cifi&eacute;s dans le rapport. Toutefois, si vous affectez une autre
propri&eacute;t&eacute; ServerName, vous pouvez rediriger le rapport vers un serveur diff&eacute;rent au moment de l'ex&eacute;cution.
Vous allez tout d'abord cr&eacute;er un rapport contenant des donn&eacute;es d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Vous pouvez effectuer ce tutoriel en utilisant les classes du mod&egrave;le d'objet CrystalReportViewer ; cependant, il est
recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
353
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_DBLogon
●
Projet Windows C# : CS_Win_RDObjMod_DBLogon
●
Site Web Visual Basic : VB_Web_RDObjMod_DBLogon
●
Projet Windows Visual Basic : VB_Win_RDObjMod_DBLogon
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e [page 244]
Dans ce tutoriel, vous allez apprendre &agrave; ajouter un code de connexion afin d'afficher un rapport contenant des
informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.2.1
Cr&eacute;ation d'un rapport connect&eacute; &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e
Cr&eacute;ez tout d'abord un rapport dont les informations proviennent de la base de donn&eacute;es Northwind.
Remarque
Northwind est un exemple de base de donn&eacute;es fourni avec SQL Server.
Une configuration pr&eacute;alable est requise avant de commencer ce tutoriel.
Informations associ&eacute;es
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL [page 353]
Dans ce tutoriel, vous allez apprendre &agrave; ajouter un code de connexion afin d'afficher un rapport contenant des
informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
354
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.2.1.1
donn&eacute;es
Configuration pr&eacute;alable requise de la base de
Proc&eacute;dure
1.
Configuration de SQL Server :
○
Si vous disposez de SQL Server (ou de la version OEM, MSDE), il doit &ecirc;tre configur&eacute; de mani&egrave;re &agrave; exiger
une authentification SQL Server pour l'utiliser dans ce tutoriel.
○
Si vous ne disposez pas de SQL Server (ou de la version OEM, MSDE), vous devez installer MSDE en
attribuant &agrave; l'authentification SQL Server la valeur True pour l'utiliser dans ce tutoriel.
2.
La base de donn&eacute;es Northwind fournie avec SQL Server doit &ecirc;tre install&eacute;e et vous devez v&eacute;rifier que
l'authentification SQL Server est bien accept&eacute;e.
3.
Vous devez cr&eacute;er un compte &agrave; acc&egrave;s limit&eacute; qui sera utilis&eacute; au sein du site Web.
1.5.2.2.1.2
Pour cr&eacute;er un rapport avec des donn&eacute;es
s&eacute;curis&eacute;es &agrave; partir de la base de donn&eacute;es Northwind
Contexte
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom &quot;NorthwindCustomers.rpt&quot;, puis cliquez sur Ouvrir.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
La fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard s'affiche.
6.
Dans le panneau Sources de donn&eacute;es disponibles, d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier OLE DB (ADO).
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
355
La fen&ecirc;tre OLE DB (ADO) s'affiche.
8.
S&eacute;lectionnez Microsoft OLE DB Provider for SQL Server, puis cliquez sur Suivant.
9.
Saisissez les valeurs correspondant &agrave; votre serveur de base de donn&eacute;es, l'ID utilisateur et le mot de passe
dans les champs Serveur, ID utilisateur et Mot de passe.
10. Dans la liste d&eacute;roulante Base de donn&eacute;es, s&eacute;lectionnez &quot;Northwind&quot;.
Laissez la case &agrave; cocher S&eacute;curit&eacute; int&eacute;gr&eacute;e d&eacute;sactiv&eacute;e, car vous utilisez l'authentification SQL Server au lieu de
l'authentification NT.
11. Cliquez sur Terminer.
Le dossier OLE DB est maintenant d&eacute;velopp&eacute;, affichant votre serveur de base de donn&eacute;es et, &agrave; l'int&eacute;rieur de
celui-ci, la base de donn&eacute;es Northwind.
12. D&eacute;veloppez les nœuds Northwind, dbo et Tables, puis s&eacute;lectionnez la table Customers.
13. Cliquez sur le bouton &gt; pour d&eacute;placer la table dans le panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
14. Maintenez la touche CTRL enfonc&eacute;e et cliquez sur CompanyName, ContactName et City.
15. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
16. Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Customer.City, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport NorthwindCustomers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; lier le rapport au contr&ocirc;le CrystalReportViewer et &agrave; configurer par
programmation la connexion &agrave; la base de donn&eacute;es.
1.5.2.2.2
Liaison du rapport
Durant la proc&eacute;dure Configuration d'un projet [page 15], vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer dans un
Web Form ou Windows Form. Lors de l'&eacute;tape pr&eacute;c&eacute;dente, vous avez ajout&eacute; un rapport NorthwindCustomers au
projet.
Dans cette section, vous allez instancier le rapport NorthwindCustomers et le lier au contr&ocirc;le
CrystalReportViewer. Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement lorsque les valeurs actuelles
n'ont pas &eacute;t&eacute; d&eacute;finies pour ce param&egrave;tre.
Vous pouvez instancier et lier le rapport de deux fa&ccedil;ons :
●
En tant que rapport incorpor&eacute;.
●
En tant que rapport non incorpor&eacute;.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous.
●
Si vous utilisez des rapports incorpor&eacute;s, effectuez la proc&eacute;dure suivante afin d'instancier le rapport sous
forme de rapport incorpor&eacute;.
●
Si vous utilisez des rapports non incorpor&eacute;s, effectuez la seconde proc&eacute;dure afin d'instancier le rapport sous
forme de rapport non incorpor&eacute;.
356
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.2.2.1
Pour instancier le rapport NorthwindCustomers
sous forme de rapport incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport NorthwindCustomers, en
utilisant la variable northwindCustomersReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private northwindCustomersReport As NorthwindCustomers
private NorthwindCustomers northwindCustomersReport;
4.
Dans la m&eacute;thode ConfigureCrystalReports(), instanciez la classe wrapper du rapport.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans Configuration d'un projet [page 15].
northwindCustomersReport = New NorthwindCustomers()
northwindCustomersReport = new NorthwindCustomers();
5.
Sur la ligne suivante, au-dessous de l'instanciation du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; la classe de rapport instanci&eacute;e (nom de la variable : northwindCustomersReport).
myCrystalReportViewer.ReportSource = northwindCustomersReport
crystalReportViewer.ReportSource = northwindCustomersReport;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Dans la mesure o&ugrave; le code permettant de se
connecter &agrave; la base de donn&eacute;es n'a pas encore &eacute;t&eacute; &eacute;crit, le chargement du rapport doit &eacute;chouer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
357
1.5.2.2.2.2
Pour instancier le rapport NorthwindCustomers
sous forme de rapport non incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport ReportDocument, en
utilisant la variable northwindCustomersReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private northwindCustomersReport As ReportDocument
private ReportDocument northwindCustomersReport;
Remarque
La classe ReportDocument est un membre de l'espace de noms CrystalDecisions.CrystalReports.Engine.
Vous avez ajout&eacute; une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] pour cet espace de
noms dans la section Configuration d'un projet [page 15]. Lorsque vous instanciez ReportDocument et
chargez un rapport dans l'espace de noms, vous acc&eacute;dez au rapport via le SDK sans l'incorporer.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), instanciez la classe ReportDocument.
northwindCustomersReport = New ReportDocument()
northwindCustomersReport = new ReportDocument();
5.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;)
string reportPath = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
358
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;NorthwindCustomers.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;NorthwindCustomers.rpt&quot;;
6.
Appelez la m&eacute;thode Load() de l'instance ReportDocument et transmettez-lui la variable cha&icirc;ne reportPath.
northwindCustomersReport.Load(reportPath)
northwindCustomersReport.Load(reportPath);
7.
Liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer &agrave; l'instance ReportDocument.
myCrystalReportViewer.ReportSource = northwindCustomersReport
crystalReportViewer.ReportSource = northwindCustomersReport;
1.5.2.2.2.3
Pour tester le chargement du rapport
NorthwindCustomers
Contexte
Que vous ayez choisi d'instancier une classe de rapport incorpor&eacute; ou une classe de rapport non incorpor&eacute; via la
classe ReportDocument, le nom de la variable utilis&eacute;e est identique : northwindCustomersReport. Vous pouvez
ainsi utiliser un bloc de code commun dans les proc&eacute;dures suivantes.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Dans la mesure o&ugrave; le code permettant de se
connecter &agrave; la base de donn&eacute;es n'a pas encore &eacute;t&eacute; &eacute;crit, le chargement du rapport doit &eacute;chouer.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
359
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers ne s'affiche pas, car le code de connexion &agrave; la base de donn&eacute;es n'a pas &eacute;t&eacute;
ajout&eacute;.
Remarque
Les r&eacute;sultats peuvent varier selon la version de SAP Crystal Reports utilis&eacute;e. Par exemple, si vous avez
install&eacute; SAP Crystal Reports 10 ou une version ult&eacute;rieure, un formulaire appara&icirc;t et vous demande de
fournir les informations de connexion &agrave; la base de donn&eacute;es pour ce rapport. Il s'agit d'une nouvelle
fonctionnalit&eacute; de SAP Crystal Reports Developer. Si vous ex&eacute;cutez une version ant&eacute;rieure de
SAP Crystal Reports, une exception est renvoy&eacute;e. Dans les deux cas, vous devez effectuer la proc&eacute;dure
suivante pour cr&eacute;er une application enti&egrave;rement fonctionnelle.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.2.3
Ajout du code de connexion au rapport
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; ajouter le code de connexion &agrave; la classe code-behind. Vous commencez par cr&eacute;er
une m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e SetDBLogonForReport().
1.5.2.2.3.1
Pour cr&eacute;er et coder la m&eacute;thode
SetDBLogonForReport()
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
A la fin de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e SetDBLogonForReport() avec deux param&egrave;tres :
ConnectionInfo et ReportDocument.
Private Sub SetDBLogonForReport(ByVal myConnectionInfo As ConnectionInfo, ByVal
myReportDocument As ReportDocument)
End Sub
private void SetDBLogonForReport(ConnectionInfo connectionInfo, ReportDocument
reportDocument)
{
}
360
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Dans cette m&eacute;thode, extrayez l'instance Tables de la propri&eacute;t&eacute; Tables de la propri&eacute;t&eacute; Database du
param&egrave;tre ReportDocument.
Remarque
Tables est une classe index&eacute;e contenant des instances de la classe Table.
Dim myTables As Tables = myReportDocument.Database.Tables
Tables tables = reportDocument.Database.Tables;
4.
Cr&eacute;ez une boucle foreach qui effectue une boucle sur chaque instance Table de l'instance de classe index&eacute;e
Tables.
Remarque
Vous devez inclure le chemin d'acc&egrave;s de l'espace de noms &agrave; la classe Table afin de la distinguer de la
classe Table de l'espace de noms System.Web.UI.WebControls.
For Each myTable As CrystalDecisions.CrystalReports.Engine.Table In myTables
Next
foreach(CrystalDecisions.CrystalReports.Engine.Table table in tables)
{
}
5.
Dans la boucle foreach, extrayez l'instance TableLogonInfo de la propri&eacute;t&eacute; LogOnInfo de l'instance Table.
Dim myTableLogonInfo As TableLogOnInfo = myTable.LogOnInfo
TableLogOnInfo tableLogonInfo = table.LogOnInfo;
6.
Dans la boucle foreach, attribuez &agrave; la propri&eacute;t&eacute; ConnectionInfo de TableLogonInfo le param&egrave;tre
ConnectionInfo.
myTableLogonInfo.ConnectionInfo = myConnectionInfo
tableLogonInfo.ConnectionInfo = connectionInfo;
7.
Dans la boucle foreach, transmettez maintenant l'instance TableLogonInfo comme param&egrave;tre &agrave; la
m&eacute;thode ApplyLogonInfo de l'instance Table.
myTable.ApplyLogOnInfo(myTableLogonInfo)
table.ApplyLogOnInfo(tableLogonInfo);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
361
R&eacute;sultats
Cette proc&eacute;dure a cr&eacute;&eacute; une m&eacute;thode permettant de d&eacute;finir les informations de connexion &agrave; la base de donn&eacute;es.
Toutefois, vous devez modifier la m&eacute;thode ConfigureCrystalReports() pour d&eacute;signer cette m&eacute;thode afin que
le rapport sache qu'il dispose des informations de connexion &agrave; la base de donn&eacute;es.
La modification de la m&eacute;thode ConfigureCrystalReports() se d&eacute;roule en deux &eacute;tapes :
●
Configurer l'instance ConnectionInfo.
●
Appeler la m&eacute;thode SetDBLogonForReport().
1.5.2.2.3.2
Pour modifier la m&eacute;thode
ConfigureCrystalReports() selon le code de connexion &agrave; la base
de donn&eacute;es
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de
la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
2.
Dans les sauts de ligne, d&eacute;clarez et instanciez la classe ConnectionInfo.
Remarque
Pour que la classe ConnectionInfo soit accessible, incluez une instruction &quot;Imports&quot; [Visual Basic]
ou &quot;using&quot; [C#] au d&eacute;but de la classe code-behind pour l'espace de noms CrystalDecisions.Shared.
(Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un projet [page 15].)
Dim myConnectionInfo As ConnectionInfo = New ConnectionInfo()
ConnectionInfo connectionInfo = new ConnectionInfo();
3.
D&eacute;finissez les propri&eacute;t&eacute;s DatabaseName, UserID et Password de l'instance ConnectionInfo.
Remarque
Pour des raisons de s&eacute;curit&eacute;, il est important que vous utilisiez un compte de base de donn&eacute;es &agrave; acc&egrave;s
limit&eacute;.
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
myConnectionInfo.DatabaseName = &quot;Northwind&quot;
myConnectionInfo.UserID = &quot;limitedPermissionAccount&quot;
myConnectionInfo.Password = &quot;
1234&quot;
362
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
connectionInfo.DatabaseName = &quot;Northwind&quot;;
connectionInfo.UserID = &quot;limitedPermissionAccount&quot;;
connectionInfo.Password = &quot;
1234&quot;;
4.
Saisissez un appel &agrave; la m&eacute;thode SetDBLogonForReport() en transmettant l'instance ConnectionInfo et le
rapport NorthwindCustomers.
SetDBLogonForReport(myConnectionInfo, northwindCustomersReport)
SetDBLogonForReport(connectionInfo, northwindCustomersReport);
R&eacute;sultats
Cette proc&eacute;dure est suivie du code d'origine qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport doit se charger correctement, car vous
avez ajout&eacute; le code de connexion &agrave; la base de donn&eacute;es.
1.5.2.2.3.3
Pour tester le chargement du rapport
NorthwindCustomers
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Le rapport NorthwindCustomers s'affiche correctement.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
363
1.5.2.2.4
Ajout de la possibilit&eacute; de modifier l'emplacement
de la base de donn&eacute;es au moment de l'ex&eacute;cution
Dans cette section, vous allez apprendre &agrave; modifier l'emplacement de la base de donn&eacute;es au moment de
l'ex&eacute;cution. Cette op&eacute;ration n&eacute;cessite simplement une l&eacute;g&egrave;re modification de l'instance ConnectionInfo.
1.5.2.2.4.1
Pour modifier l'emplacement de la base de
donn&eacute;es au moment de l'ex&eacute;cution
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la ligne
qui d&eacute;clare et instancie la classe ConnectionInfo.
2.
Dans les sauts de ligne, d&eacute;finissez la propri&eacute;t&eacute; ServerName de l'instance ConnectionInfo.
Remarque
Dans votre propre code, remplacez l'exemple de nom de serveur DevDatabase (indiqu&eacute; ci-dessous) par
votre propre nom de serveur.
myConnectionInfo.ServerName = &quot;DevDatabase&quot;
connectionInfo.ServerName = &quot;DevDatabase&quot;;
1.5.2.2.4.2
Pour v&eacute;rifier si un autre serveur de base de
donn&eacute;es peut &ecirc;tre red&eacute;fini pour le rapport au moment de
l'ex&eacute;cution
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport devrait se rediriger vers l'autre serveur
de base de donn&eacute;es au moment de l'ex&eacute;cution.
Proc&eacute;dure
1.
364
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.2.5
Addenda : Am&eacute;liorations du code de connexion &agrave; la
base de donn&eacute;es
Vous avez correctement d&eacute;fini votre code pour modifier l'emplacement de la base de donn&eacute;es au moment de
l'ex&eacute;cution. Dans cet exemple, le serveur de base de donn&eacute;es est identique, la seule diff&eacute;rence est que vous l'avez
appel&eacute; explicitement par son nom.
Toutefois, vous pouvez maintenant modifier le nom de ce serveur de base de donn&eacute;es avec n'importe quel autre
serveur de base de donn&eacute;es contenant la base de donn&eacute;es Northwind. Si vous utilisez SAP Crystal Reports avec
Visual Studio 2005 ou 2008, vous avez acc&egrave;s aux fonctionnalit&eacute;s API am&eacute;lior&eacute;es pour la connexion &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e. La fonctionnalit&eacute; API de SAP Crystal Reports permet de r&eacute;duire la quantit&eacute; de
code n&eacute;cessaire &agrave; la connexion &agrave; la base de donn&eacute;es.
Dans les proc&eacute;dures pr&eacute;c&eacute;dentes, vous avez appris &agrave; cr&eacute;er la m&eacute;thode d'assistance SetDBLogonForReport(),
qui utilise une boucle foreach pour d&eacute;finir la propri&eacute;t&eacute; ConnectionInfo de chaque table du rapport Crystal.
Dans ce tutoriel, vous allez apprendre &agrave; supprimer la m&eacute;thode d'assistance et &agrave; ajouter un code afin d'utiliser la
classe DataSourceConnections provenant de l'espace de noms CrystalDecisions.Shared ou la m&eacute;thode
SetDatabaseLogon() provenant de la classe ReportDocument.
La classe DataSourceConnections est une ArrayList qui contient les instances ConnectionInfo pour chaque
connexion utilis&eacute;e par le rapport Crystal. Vous pouvez extraire les instances ConnectionInfo au niveau d'un
index donn&eacute;, puis appeler les m&eacute;thodes SetLogon() ou SetConnection() pour transmettre les informations
de connexion au rapport.
La m&eacute;thode SetLogon() permet de d&eacute;finir le nom d'utilisateur et le mot de passe. Cette m&eacute;thode utilise le
serveur et la base de donn&eacute;es par d&eacute;faut que vous avez sp&eacute;cifi&eacute;s dans le rapport. La m&eacute;thode SetConnection()
permet de d&eacute;finir le nom du serveur, le nom de la base de donn&eacute;es, le nom d'utilisateur et le mot de passe.
Pour utiliser le nouveau code API, vous devez suivre les instructions des sections Cr&eacute;ation d'un rapport connect&eacute; &agrave;
une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e [page 354] et Liaison du rapport [page 356] sans code de connexion.
Vous pouvez ensuite utiliser l'une des m&eacute;thodes API am&eacute;lior&eacute;es suivantes :
●
Utilisation de la classe DataSourceConnections pour la connexion &agrave; la base de donn&eacute;es [page 367]
●
Utilisation de la m&eacute;thode SetDatabaseLogon() de la classe ReportDocument [page 369]
Si vous avez effectu&eacute; toutes les proc&eacute;dures de la section Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL [page 353], vous devez d'abord supprimer certaines lignes de code
indiqu&eacute;es dans la section Modification du projet pour la connexion &agrave; la base de donn&eacute;es [page 366] avant de
pouvoir utiliser l'une des m&eacute;thodes API am&eacute;lior&eacute;es.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
365
1.5.2.2.5.1
Modification du projet pour la connexion &agrave; la base
de donn&eacute;es
Si vous avez effectu&eacute; toutes les proc&eacute;dures de la section Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL [page 353], vous devez d'abord supprimer certaines lignes de code
indiqu&eacute;es dans la proc&eacute;dure suivante.
1.5.2.2.5.1.1
Pour modifier le projet afin d'utiliser les
fonctionnalit&eacute;s API am&eacute;lior&eacute;es de SAP Crystal Reports
Proc&eacute;dure
1.
Ouvrez le projet termin&eacute; de ce tutoriel.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Supprimez la m&eacute;thode d'assistance SetDBLogonForReport().
5.
Dans la m&eacute;thode ConfigureCrystalReports(), supprimez les lignes de code suivantes :
a) Supprimez le code qui d&eacute;clare une instance de la classe ConnectionInfo.
b) Supprimez le code qui utilise les propri&eacute;t&eacute;s ServerName, DatabaseName, UserID et Password provenant
de la classe ConnectionInfo.
c) Supprimez l'appel &agrave; la m&eacute;thode SetDBLogonForReport().
R&eacute;sultats
La m&eacute;thode ConfigureCrystalReports() comporte &agrave; pr&eacute;sent deux lignes de code.
Private Sub ConfigureCrystalReports()
northwindCustomersReport = new NorthwindCustomers()
myCrystalReportViewer.ReportSource = northwindCustomersReport
End Sub
private void ConfigureCrystalReports()
{
northwindCustomersReport = new NorthwindCustomers();
crystalReportViewer.ReportSource = northwindCustomersReport;
}
Vous pouvez &agrave; pr&eacute;sent choisir d'utiliser l'une des m&eacute;thodes API am&eacute;lior&eacute;es suivantes :
●
Utilisation de la classe DataSourceConnections pour la connexion &agrave; la base de donn&eacute;es [page 367]
●
Utilisation de la m&eacute;thode SetDatabaseLogon() de la classe ReportDocument [page 369]
366
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.2.5.2
Utilisation de la classe DataSourceConnections
pour la connexion &agrave; la base de donn&eacute;es
Dans cette section, vous allez apprendre &agrave; ajouter deux lignes de code pour vous connecter &agrave; une base de
donn&eacute;es SQL Server. Vous devez extraire l'instance DataSourceConnections, puis d&eacute;finir les informations de
connexion &agrave; la base de donn&eacute;es &agrave; l'aide des m&eacute;thodes SetLogon() ou SetConnection().
●
Vous devez cr&eacute;er un projet bas&eacute; sur les instructions des sections Cr&eacute;ation d'un rapport connect&eacute; &agrave; une base
de donn&eacute;es SQL Server s&eacute;curis&eacute;e [page 354] et Liaison du rapport [page 356] sans code de connexion.
●
Ou vous devez cr&eacute;er un projet en suivant les instructions de la section Modification du projet pour la connexion
&agrave; la base de donn&eacute;es [page 366].
Si vous souhaitez utiliser le serveur et la base de donn&eacute;es par d&eacute;faut, appelez la m&eacute;thode SetLogon() &agrave; l'aide de
votre nom d'utilisateur et de votre mot de passe.
En revanche, si vous souhaitez modifier le serveur ou la base de donn&eacute;es, appelez la m&eacute;thode SetConnection()
&agrave; l'aide de vos nom de serveur, nom de base de donn&eacute;es, nom d'utilisateur et mot de passe.
1.5.2.2.5.2.1
Pour utiliser la m&eacute;thode SetLogon() de la classe
DataSourceConnections
Proc&eacute;dure
1.
Entre les deux lignes de code de la m&eacute;thode ConfigureCrystalReports(), extrayez l'instance
DataSourceConnections &agrave; partir de la propri&eacute;t&eacute; DataSourceConnections de l'instance
NorthwindCustomers.
Dim myDataSourceConnections As DataSourceConnections =
northwindCustomersReport.DataSourceConnections
DataSourceConnections dataSourceConnections =
northwindCustomersReport.DataSourceConnections;
2.
Extrayez l'&eacute;l&eacute;ment IConnectionInfo au niveau de l'index 0 de l'instance DataSourceConnections.
Dim myConnectInfo As IConnectionInfo = myDataSourceConnections(0)
IConnectionInfo connectInfo = dataSourceConnections[0];
3.
Appelez la m&eacute;thode SetLogon() &agrave; l'aide de votre nom d'utilisateur et votre mot de passe.
Remarque
Pour des raisons de s&eacute;curit&eacute;, il est important que vous utilisiez un compte de base de donn&eacute;es &agrave; acc&egrave;s
limit&eacute;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
367
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
myConnectInfo.SetLogon(&quot;limitedPermissionAccount&quot;, &quot;1234&quot;)
connectInfo.SetLogon(&quot;limitedPermissionAccount&quot;, &quot;1234&quot;);
1.5.2.2.5.2.2
Pour utiliser la m&eacute;thode SetConnection() de la
classe DataSourceConnections
Proc&eacute;dure
1.
Entre les deux lignes de code de la m&eacute;thode ConfigureCrystalReports(), extrayez l'instance
DataSourceConnections &agrave; partir de la propri&eacute;t&eacute; DataSourceConnections de l'instance NorthwindCustomers.
Dim myDataSourceConnections As DataSourceConnections =
northwindCustomersReport.DataSourceConnections
DataSourceConnections dataSourceConnections =
northwindCustomersReport.DataSourceConnections;
2.
Extrayez l'&eacute;l&eacute;ment IConnectionInfo au niveau de l'index 0 de l'instance DataSourceConnections.
Dim myConnectInfo As IConnectionInfo = myDataSourceConnections(0)
IConnectionInfo connectInfo = dataSourceConnections[0];
3.
Appelez la m&eacute;thode SetConnection() &agrave; l'aide de vos nom de serveur, nom de base de donn&eacute;es, nom
d'utilisateur et mot de passe.
Remarque
Pour des raisons de s&eacute;curit&eacute;, il est important que vous utilisiez un compte de base de donn&eacute;es &agrave; acc&egrave;s
limit&eacute;.
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
myConnectInfo.SetConnection(&quot;ServerName&quot;, &quot;Northwind&quot;,
&quot;limitedPermissionAccount&quot;, &quot;1234&quot;)
connectInfo.SetConnection(&quot;ServerName&quot;, &quot;Northwind&quot;, &quot;limitedPermissionAccount&quot;,
&quot;1234&quot;);
368
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet afin de vous connecter &agrave; la base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e.
1.5.2.2.5.3
Utilisation de la m&eacute;thode SetDatabaseLogon() de
la classe ReportDocument
Contexte
Entre les deux lignes de code dans la m&eacute;thode ConfigureCrystalReports(), appelez la m&eacute;thode
SetDatabaseLogon() de l'instance NorthwindCustomers, puis transmettez l'un des ensembles de param&egrave;tres
suivants :
Proc&eacute;dure
1.
Appelez la m&eacute;thode SetDatabaseLogon() &agrave; l'aide de votre nom d'utilisateur et votre mot de passe.
Remarque
Pour des raisons de s&eacute;curit&eacute;, il est important que vous utilisiez un compte de base de donn&eacute;es &agrave; acc&egrave;s
limit&eacute;.
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
northwindCustomersReport.SetDatabaseLogon(&quot;limitedPermissionAccount&quot;,&quot;1234&quot;)
northwindCustomersReport.SetDatabaseLogon(&quot;limitedPermissionAccount&quot;,&quot;1234&quot;);
2.
Ou appelez la m&eacute;thode SetDatabaseLogon() &agrave; l'aide de vos nom de serveur, nom de base de donn&eacute;es, nom
d'utilisateur et mot de passe.
Remarque
Cette m&eacute;thode ne modifie pas le serveur ni la base de donn&eacute;es. Vous &ecirc;tes limit&eacute; au serveur et &agrave; la base de
donn&eacute;es par d&eacute;faut sp&eacute;cifi&eacute;s dans le rapport.
Dans votre propre code, remplacez l'exemple de mot de passe 1234 (indiqu&eacute; ci-dessous) par votre propre
mot de passe.
northwindCustomersReport.SetDatabaseLogon(&quot;limitedPermissionAccount&quot;,&quot;1234&quot;,
&quot;ServerName&quot;, &quot;Northwind&quot;)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
369
northwindCustomersReport.SetDatabaseLogon(&quot;limitedPermissionAccount&quot;,&quot;1234&quot;,
&quot;ServerName&quot;, &quot;Northwind&quot;);
1.5.2.3
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e &agrave; l'aide de la s&eacute;curit&eacute; int&eacute;gr&eacute;e
Dans ce tutoriel, vous allez apprendre &agrave; ajouter un code de connexion afin d'afficher un rapport contenant des
informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Introduction
Pour vous connecter &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e, vous utilisez des classes du mod&egrave;le d'objet
ReportDocument.
L'objet ReportDocument comporte une propri&eacute;t&eacute; Database qui renvoie une instance Database. Cette instance
Database contient les informations de base de donn&eacute;es pour le rapport, notamment une propri&eacute;t&eacute; Tables qui
renvoie une instance de classe index&eacute;e Tables. Chaque instance Table peut &ecirc;tre extraite de la classe index&eacute;e
Tables.
La connexion se produit au niveau granulaire de chaque instance Table, qui doit obtenir une autorisation d'acc&egrave;s
individuel &agrave; la base de donn&eacute;es SQL Server s&eacute;curis&eacute;e. Ceci s'effectue en pla&ccedil;ant les informations de connexion
dans une instance ConnectionInfo puis, &agrave; l'int&eacute;rieur d'une boucle for, en appliquant cette instance
ConnectionInfo &agrave; la propri&eacute;t&eacute; ConnectionInfo de chaque instance Table.
Les propri&eacute;t&eacute;s de la classe ConnectionInfo sont les suivantes :
●
ServerName
●
DatabaseName
●
UserID (non utilis&eacute;e dans ce tutoriel)
●
Password (non utilis&eacute;e dans ce tutoriel)
●
IntegratedSecurity
Remarque
Si vous souhaitez suivre un tutoriel qui utilise l'authentification Windows (et utilise donc les propri&eacute;t&eacute;s UserID
et Password au lieu de la propri&eacute;t&eacute; IntegratedSecurity), voir Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL [page 353].
Si vous d&eacute;finissez uniquement les propri&eacute;t&eacute;s DatabaseName et IntegratedSecurity, vous serez connect&eacute; au
serveur et &agrave; la base de donn&eacute;es par d&eacute;faut sp&eacute;cifi&eacute;s dans le rapport. Toutefois, si vous affectez une autre
propri&eacute;t&eacute; ServerName, vous pouvez rediriger le rapport vers un serveur diff&eacute;rent au moment de l'ex&eacute;cution.
Vous allez tout d'abord cr&eacute;er un rapport contenant des donn&eacute;es d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Vous pouvez effectuer ce tutoriel en utilisant les classes du mod&egrave;le d'objet CrystalReportViewer ; cependant, il est
recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
370
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_DBLogonIntegratedSecurity
●
Projet Windows C# : CS_Win_RDObjMod_DBLogonIntegratedSecurity
●
Site Web Visual Basic : VB_Web_RDObjMod_DBLogonIntegratedSecurity
●
Projet Windows Visual Basic : VB_Win_RDObjMod_DBLogonIntegratedSecurity
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.3.1
Cr&eacute;ation d'un rapport connect&eacute; &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e &agrave; l'aide de la s&eacute;curit&eacute; int&eacute;gr&eacute;e
Cr&eacute;ez tout d'abord un rapport dont les informations proviennent de la base de donn&eacute;es Northwind.
Remarque
Northwind est un exemple de base de donn&eacute;es fourni avec SQL Server.
Une configuration pr&eacute;alable est requise avant de commencer ce tutoriel.
1.5.2.3.1.1
donn&eacute;es
Configuration pr&eacute;alable requise de la base de
Proc&eacute;dure
1.
Configuration de SQL Server :
○
Si vous disposez de SQL Server (ou de la version OEM, MSDE), il doit &ecirc;tre configur&eacute; pour accepter
l'authentification Windows dans ce tutoriel.
○
Si vous ne disposez pas de SQL Server (ou de la version OEM, MSDE), vous devez installer MSDE avec
l'authentification Windows (par d&eacute;faut) pour l'utiliser dans ce tutoriel.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
371
2.
La base de donn&eacute;es Northwind fournie avec SQL Server doit &ecirc;tre install&eacute;e et vous devez v&eacute;rifier que
l'authentification Windows est bien accept&eacute;e.
Apr&egrave;s avoir configur&eacute; SQL Server et la base de donn&eacute;es Northwind conform&eacute;ment aux instructions des
sections ci-dessus, vous &ecirc;tes pr&ecirc;t &agrave; cr&eacute;er un rapport dont les informations proviennent, de fa&ccedil;on s&eacute;curis&eacute;e,
de la base de donn&eacute;es Northwind.
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un
projet [page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces
de noms et de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure
sans cette configuration.
1.5.2.3.1.2
Pour cr&eacute;er un rapport avec des donn&eacute;es
s&eacute;curis&eacute;es &agrave; partir de la base de donn&eacute;es Northwind
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom &quot;NorthwindCustomers.rpt&quot;, puis cliquez sur Ouvrir.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
La fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard s'affiche.
6.
Dans le panneau Sources de donn&eacute;es disponibles, d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier OLE DB (ADO).
La fen&ecirc;tre OLE DB (ADO) s'affiche.
8.
S&eacute;lectionnez Microsoft OLE DB Provider for SQL Server, puis cliquez sur Suivant.
9.
Saisissez le nom de votre serveur de base de donn&eacute;es dans le champ Serveur.
10. Activez la case &agrave; cocher S&eacute;curit&eacute; int&eacute;gr&eacute;e.
11. Dans la liste d&eacute;roulante Base de donn&eacute;es, s&eacute;lectionnez &quot;Northwind&quot;.
12. Cliquez sur Terminer.
Le dossier OLE DB est maintenant d&eacute;velopp&eacute;, affichant votre serveur de base de donn&eacute;es et, &agrave; l'int&eacute;rieur de
celui-ci, la base de donn&eacute;es Northwind.
13. D&eacute;veloppez les nœuds Northwind, dbo et Tables, puis s&eacute;lectionnez la table Customers.
14. Cliquez sur le bouton &gt; pour d&eacute;placer la table dans le panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
15. Maintenez la touche CTRL enfonc&eacute;e et cliquez sur CompanyName, ContactName et City.
16. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
372
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
17. Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Customer.City, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport NorthwindCustomers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; lier le rapport au contr&ocirc;le CrystalReportViewer et &agrave; configurer par programmation la
connexion &agrave; la base de donn&eacute;es.
1.5.2.3.2
Liaison du rapport
Durant la proc&eacute;dure Configuration d'un projet [page 15], vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer
dans un Web Form ou un Windows Form. Lors de l'&eacute;tape pr&eacute;c&eacute;dente, vous avez ajout&eacute; un rapport
NorthwindCustomers au projet.
Dans cette section, vous allez instancier le rapport NorthwindCustomers et le lier au contr&ocirc;le
CrystalReportViewer. Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement lorsque les valeurs
actuelles n'ont pas &eacute;t&eacute; d&eacute;finies pour ce param&egrave;tre.
Vous pouvez instancier et lier le rapport de deux fa&ccedil;ons :
●
En tant que rapport incorpor&eacute;.
●
En tant que rapport non incorpor&eacute;.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous.
●
Si vous utilisez des rapports incorpor&eacute;s, effectuez la proc&eacute;dure suivante afin d'instancier le rapport sous
forme de rapport incorpor&eacute;.
●
Si vous utilisez des rapports non incorpor&eacute;s, effectuez la seconde proc&eacute;dure afin d'instancier le rapport sous
forme de rapport non incorpor&eacute;.
1.5.2.3.2.1
Pour instancier le rapport NorthwindCustomers
sous forme de rapport incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport NorthwindCustomers, en
utilisant la variable northwindCustomersReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private northwindCustomersReport As NorthwindCustomers
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
373
private NorthwindCustomers northwindCustomersReport;
4.
Dans la m&eacute;thode ConfigureCrystalReports(), instanciez la classe wrapper du rapport.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans Configuration d'un projet [page 15].
northwindCustomersReport = New NorthwindCustomers()
northwindCustomersReport = new NorthwindCustomers();
5.
Sur la ligne suivante, au-dessous de l'instanciation du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; la classe de rapport instanci&eacute;e (nom de la variable :
northwindCustomersReport).
myCrystalReportViewer.ReportSource = northwindCustomersReport
crystalReportViewer.ReportSource = northwindCustomersReport;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Dans la mesure o&ugrave; le code permettant de se
connecter &agrave; la base de donn&eacute;es n'a pas encore &eacute;t&eacute; &eacute;crit, le chargement du rapport doit &eacute;chouer.
1.5.2.3.2.2
Pour instancier le rapport NorthwindCustomers
sous forme de rapport non incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport ReportDocument, en
utilisant la variable northwindCustomersReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private northwindCustomersReport As ReportDocument
private ReportDocument northwindCustomersReport;
374
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
La classe ReportDocument est un membre de l'espace de noms CrystalDecisions.CrystalReports.Engine.
Vous avez ajout&eacute; une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] pour cet espace de
noms dans la section Configuration d'un projet [page 15]. Lorsque vous instanciez ReportDocument et
chargez un rapport dans l'espace de noms, vous acc&eacute;dez au rapport via le SDK sans l'incorporer.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), instanciez la classe ReportDocument.
northwindCustomersReport = New ReportDocument()
northwindCustomersReport = new ReportDocument();
5.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;)
string reportPath = Server.MapPath(&quot;NorthwindCustomers.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;NorthwindCustomers.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;NorthwindCustomers.rpt&quot;;
6.
Appelez la m&eacute;thode Load() de l'instance ReportDocument et transmettez-lui la variable cha&icirc;ne reportPath.
northwindCustomersReport.Load(reportPath)
northwindCustomersReport.Load(reportPath);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
375
7.
Liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer &agrave; l'instance ReportDocument.
myCrystalReportViewer.ReportSource = northwindCustomersReport
crystalReportViewer.ReportSource = northwindCustomersReport;
R&eacute;sultats
Que vous ayez choisi d'instancier une classe de rapport incorpor&eacute; ou une classe de rapport non incorpor&eacute; via la
classe ReportDocument, le nom de la variable utilis&eacute;e est identique : northwindCustomersReport. Vous pouvez
ainsi utiliser un bloc de code commun dans les proc&eacute;dures suivantes.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Dans la mesure o&ugrave; le code permettant de se
connecter &agrave; la base de donn&eacute;es n'a pas encore &eacute;t&eacute; &eacute;crit, le chargement du rapport doit &eacute;chouer.
1.5.2.3.2.3
Pour tester le chargement du rapport
NorthwindCustomers
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers ne s'affiche pas, car le code de connexion &agrave; la base de donn&eacute;es n'a pas &eacute;t&eacute;
ajout&eacute;.
Remarque
Les r&eacute;sultats peuvent varier selon la version de SAP Crystal Reports utilis&eacute;e. Par exemple, si vous avez
install&eacute; SAP Crystal Reports Developer, un formulaire appara&icirc;t et vous demande de fournir les informations
de connexion &agrave; la base de donn&eacute;es pour ce rapport. Il s'agit d'une nouvelle fonctionnalit&eacute; de
SAP Crystal Reports Developer. Si vous ex&eacute;cutez une version ant&eacute;rieure de SAP Crystal Reports, une
exception est renvoy&eacute;e. Dans les deux cas, vous devez effectuer la proc&eacute;dure suivante pour cr&eacute;er une
application enti&egrave;rement fonctionnelle.
376
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.3.3
Ajout du code de connexion au rapport
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; ajouter le code de connexion &agrave; la classe code-behind. Vous commencez par cr&eacute;er
une m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e SetDBLogonForReport().
1.5.2.3.3.1
Pour cr&eacute;er et coder la m&eacute;thode
SetDBLogonForReport()
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
A la fin de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e SetDBLogonForReport() avec deux param&egrave;tres :
ConnectionInfo et ReportDocument.
Private Sub SetDBLogonForReport(ByVal myConnectionInfo As ConnectionInfo, ByVal
myReportDocument As ReportDocument)
End Sub
private void SetDBLogonForReport(ConnectionInfo connectionInfo, ReportDocument
reportDocument)
{
}
3.
Dans cette m&eacute;thode, extrayez l'instance Tables de la propri&eacute;t&eacute; Tables de la propri&eacute;t&eacute; Database du param&egrave;tre
ReportDocument.
Remarque
Tables est une classe index&eacute;e contenant des instances de la classe Table.
Dim myTables As Tables = myReportDocument.Database.Tables
Tables tables = reportDocument.Database.Tables;
4.
Cr&eacute;ez une boucle foreach qui effectue une boucle sur chaque instance Table de l'instance de classe index&eacute;e
Tables.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
377
Remarque
Vous devez inclure le chemin d'acc&egrave;s de l'espace de noms &agrave; la classe Table afin de la distinguer de la classe
Table de l'espace de noms System.Web.UI.WebControls.
For Each myTable As CrystalDecisions.CrystalReports.Engine.Table In myTables
Next
foreach(CrystalDecisions.CrystalReports.Engine.Table table in tables)
{
}
5.
Dans la boucle foreach, extrayez l'instance TableLogonInfo de la propri&eacute;t&eacute; LogOnInfo de l'instance Table.
Dim myTableLogonInfo As TableLogOnInfo = myTable.LogOnInfo
TableLogOnInfo tableLogonInfo = table.LogOnInfo;
6.
Dans la boucle foreach, attribuez &agrave; la propri&eacute;t&eacute; ConnectionInfo de TableLogonInfo le param&egrave;tre
ConnectionInfo.
myTableLogonInfo.ConnectionInfo = myConnectionInfo
tableLogonInfo.ConnectionInfo = connectionInfo;
7.
Dans la boucle foreach, transmettez maintenant l'instance TableLogonInfo comme param&egrave;tre &agrave; la m&eacute;thode
ApplyLogonInfo de l'instance Table.
myTable.ApplyLogOnInfo(myTableLogonInfo)
table.ApplyLogOnInfo(tableLogonInfo);
R&eacute;sultats
Cette proc&eacute;dure a cr&eacute;&eacute; une m&eacute;thode permettant de d&eacute;finir les informations de connexion &agrave; la base de donn&eacute;es.
Toutefois, vous devez modifier la m&eacute;thode ConfigureCrystalReports() pour d&eacute;signer cette m&eacute;thode afin que
le rapport sache qu'il dispose des informations de connexion &agrave; la base de donn&eacute;es.
La modification de la m&eacute;thode ConfigureCrystalReports() se d&eacute;roule en deux &eacute;tapes :
●
Configurer l'instance ConnectionInfo.
●
Appeler la m&eacute;thode SetDBLogonForReport().
378
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.3.3.2
Pour modifier la m&eacute;thode
ConfigureCrystalReports() selon le code de connexion &agrave; la base
de donn&eacute;es
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de
la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
2.
Dans les sauts de ligne, d&eacute;clarez et instanciez la classe ConnectionInfo.
Remarque
Pour que la classe ConnectionInfo soit accessible, incluez une instruction &quot;Imports&quot; [Visual Basic]
ou &quot;using&quot; [C#] au d&eacute;but de la classe code-behind pour l'espace de noms CrystalDecisions.Shared.
(Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un projet [page 15].)
Dim myConnectionInfo As ConnectionInfo = New ConnectionInfo()
ConnectionInfo connectionInfo = new ConnectionInfo();
3.
D&eacute;finissez les propri&eacute;t&eacute;s DatabaseName et IntegratedSecurity de l'instance ConnectionInfo.
myConnectionInfo.DatabaseName = &quot;Northwind&quot;
myConnectionInfo.IntegratedSecurity = True
connectionInfo.DatabaseName = &quot;Northwind&quot;;
connectionInfo.IntegratedSecurity = true;
4.
Saisissez un appel &agrave; la m&eacute;thode SetDBLogonForReport() en transmettant l'instance ConnectionInfo et le
rapport NorthwindCustomers.
SetDBLogonForReport(myConnectionInfo, northwindCustomersReport)
SetDBLogonForReport(connectionInfo, northwindCustomersReport);
R&eacute;sultats
Cette proc&eacute;dure est suivie du code d'origine qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport doit se charger correctement, car vous
avez ajout&eacute; le code de connexion &agrave; la base de donn&eacute;es.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
379
1.5.2.3.3.3
Pour tester le chargement du rapport
NorthwindCustomers
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Dans la section suivante, vous allez apprendre &agrave; modifier l'emplacement de la base de donn&eacute;es au moment de
l'ex&eacute;cution.
1.5.2.3.4
Ajout de la possibilit&eacute; de modifier l'emplacement
de la base de donn&eacute;es au moment de l'ex&eacute;cution
Dans cette section, vous allez apprendre &agrave; modifier l'emplacement de la base de donn&eacute;es au moment de
l'ex&eacute;cution. Cette op&eacute;ration n&eacute;cessite simplement une l&eacute;g&egrave;re modification de l'instance ConnectionInfo.
1.5.2.3.4.1
Pour modifier l'emplacement de la base de
donn&eacute;es au moment de l'ex&eacute;cution
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la ligne
qui d&eacute;clare et instancie la classe ConnectionInfo.
2.
Dans les sauts de ligne, d&eacute;finissez la propri&eacute;t&eacute; ServerName de l'instance ConnectionInfo.
Remarque
Dans votre propre code, remplacez l'exemple de nom de serveur DevDatabase (indiqu&eacute; ci-dessous) par
votre propre nom de serveur.
myConnectionInfo.ServerName = &quot;DevDatabase&quot;
380
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
connectionInfo.ServerName = &quot;DevDatabase&quot;;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport devrait se rediriger vers l'autre serveur
de base de donn&eacute;es au moment de l'ex&eacute;cution.
1.5.2.3.4.2
Pour v&eacute;rifier si un autre serveur de base de
donn&eacute;es peut &ecirc;tre red&eacute;fini pour le rapport au moment de
l'ex&eacute;cution
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers s'affiche correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.3.5
Configuration avec la m&eacute;thode SetConnection
Contexte
Dans cette section, vous allez apprendre &agrave; appliquer trois modifications (modification du nom du serveur, du nom
de la base de donn&eacute;es et du param&egrave;tre de s&eacute;curit&eacute; int&eacute;gr&eacute;e) &agrave; l'aide de la m&eacute;thode SetConnection(). Cette
op&eacute;ration n&eacute;cessite simplement une l&eacute;g&egrave;re modification de l'instance ConnectionInfo.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), apr&egrave;s la ligne qui d&eacute;clare et instancie la classe
ConnectionInfo, supprimez les lignes de code qui affectent les propri&eacute;t&eacute;s et ServerName, DatabaseName
et IntegratedSecurity.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
381
2.
Saisissez une nouvelle ligne de code contenant un appel &agrave; la m&eacute;thode SetConnection() de l'instance
ConnectionInfo, en transmettant le nom du serveur, le nom de la base de donn&eacute;es et le param&egrave;tre de
s&eacute;curit&eacute; int&eacute;gr&eacute;e &agrave; cette m&eacute;thode.
myConnectionInfo.SetConnection(&quot;DevDatabase&quot;, &quot;Northwind&quot;, True)
connectionInfo.SetConnection(&quot;DevDatabase&quot;, &quot;Northwind&quot;, true);
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet.
1.5.2.4
Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e avec un sous-rapport
Dans ce tutoriel, vous allez traiter un probl&egrave;me suppl&eacute;mentaire concernant la connexion &agrave; une base de donn&eacute;es
SQL Server s&eacute;curis&eacute;e : que faire si le rapport qui n&eacute;cessite une connexion &agrave; une base de donn&eacute;es SQL Server
s&eacute;curis&eacute;e contient un sous-rapport ?
Introduction
Dans ce tutoriel, vous allez apprendre &agrave; remplir les conditions requises pour la connexion d'un sous-rapport.
Vous devez apporter deux modifications au projet cr&eacute;&eacute; dans le pr&eacute;c&eacute;dent tutoriel :
●
Vous ajoutez un sous-rapport au rapport d'origine.
Ce sous-rapport d&eacute;signe la table Orders de la base de donn&eacute;es Northwind. La table Orders est li&eacute;e &agrave; la table
Customers utilis&eacute;e par la cl&eacute; externe CustomerID dans le tutoriel pr&eacute;c&eacute;dent.
●
Vous ajoutez une nouvelle m&eacute;thode.
La m&eacute;thode extrait les sous-rapports du rapport principal, puis transmet chaque sous-rapport &agrave; la m&eacute;thode
d'assistance SetDBLogonForReport().
Vous pouvez &eacute;galement effectuer ce tutoriel en utilisant les classes du mod&egrave;le d'objet CrystalReportViewer, bien
qu'il soit recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
Pour cr&eacute;er ce tutoriel &agrave; l'aide du mod&egrave;le d'objet CrystalReportViewer, voir Tutoriel : Connexion &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e [page 244] &agrave; l'aide du mod&egrave;le d'objet CrystalReportViewer.
382
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_DBLogonSubrpt
●
Projet Windows C# : CS_Win_RDObjMod_DBLogonSubrpt
●
Site Web Visual Basic : VB_Web_RDObjMod_DBLogonSubrpt
●
Projet Windows Visual Basic : VB_Win_RDObjMod_DBLogonSubrpt
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.4.1
Ajout d'un sous-rapport au rapport d'origine
Pour commencer, vous ajoutez un sous-rapport au rapport d'origine.
1.5.2.4.1.1
Pour ajouter un sous-rapport
Proc&eacute;dure
1.
Ouvrez le projet que vous avez cr&eacute;&eacute; dans le tutoriel pr&eacute;c&eacute;dent Tutoriel : Connexion &agrave; une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e &agrave; l'aide de la s&eacute;curit&eacute; int&eacute;gr&eacute;e [page 370].
2.
Dans l'Explorateur de solutions, cliquez deux fois sur le rapport NorthwindCustomers pour l'ouvrir.
3.
Cliquez avec le bouton droit de la souris sur la barre grise D&eacute;tails et s&eacute;lectionnez Ins&eacute;rer une section en
dessous.
4.
Cliquez avec le bouton droit de la souris sur la nouvelle section D&eacute;tails b que vous avez cr&eacute;&eacute;e, s&eacute;lectionnez
Ins&eacute;rer, puis cliquez sur Sous-rapport.
Un carr&eacute; gris encadre le curseur de la souris.
5.
Faites glisser le rectangle gris sur la nouvelle section D&eacute;tails b, puis rel&acirc;chez le bouton de la souris.
6.
Dans l'onglet Sous-rapport de la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez Cr&eacute;er un sous-rapport
&agrave; l'aide de l'Assistant de cr&eacute;ation de rapports.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
383
Remarque
La bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport inclut d'autres options permettant de s&eacute;lectionner un rapport
existant et des sous-rapports &agrave; la demande. Pour en savoir plus sur ces fonctionnalit&eacute;s, voir Onglet Sousrapport (bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport) [page 939].
7.
Dans le champ Nom du nouveau rapport, saisissez &quot;CustomerOrders&quot;.
8.
Cliquez sur Assistant de cr&eacute;ation de rapports...
9.
Dans le panneau Sources de donn&eacute;es disponibles de la bo&icirc;te de dialogue Assistant de cr&eacute;ation de rapports
standard, d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
10. D&eacute;veloppez le dossier OLE DB (ADO).
Le dossier contient le serveur de base de donn&eacute;es qui a &eacute;t&eacute; configur&eacute; pour le rapport lorsque ce dernier a &eacute;t&eacute;
cr&eacute;&eacute;.
Remarque
Si le serveur ne s'affiche pas, suivez les instructions du tutoriel pr&eacute;c&eacute;dent pour vous connecter &agrave; la base de
donn&eacute;es SQL Server.
11. D&eacute;veloppez les nœuds Northwind, dbo et Tables.
12. S&eacute;lectionnez la table Commandes et cliquez sur le bouton &gt; pour la d&eacute;placer dans le panneau Tables
s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
13. Dans le panneau Champs disponibles, s&eacute;lectionnez Order ID, Order Date, Shipped Date et Ship Name.
14. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Terminer.
15. Dans la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez l'onglet Mise en relation.
16. Dans la liste Champs disponibles du panneau Champs du rapport principal &agrave; mettre en relation, d&eacute;veloppez la
table Customers, s&eacute;lectionnez CustomerID, puis cliquez sur le bouton &gt;.
17. Dans le panneau Mise en relation du champ Customers.CustomerID qui s'affiche, laissez les s&eacute;lections par
d&eacute;faut.
Ces s&eacute;lections de param&egrave;tres et de donn&eacute;es g&eacute;n&egrave;rent automatiquement une relation entre le rapport
principal et le sous-rapport.
18. Cliquez sur OK.
Le nouveau sous-rapport, CustomerOrders, s'affiche dans la section D&eacute;tails b du rapport principal.
Remarque
Lorsque vous ajoutez un sous-rapport &agrave; la section D&eacute;tails, le sous-rapport s'affiche pour chaque ligne, ce
qui influe sur les performances du rapport. Si vous ne souhaitez pas obtenir des informations aussi
d&eacute;taill&eacute;es, placez le sous-rapport dans une section Groupe plut&ocirc;t qu'une section D&eacute;tails.
R&eacute;sultats
Vous pouvez &agrave; pr&eacute;sent v&eacute;rifier les param&egrave;tres du sous-rapport.
384
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.4.1.2
Pour v&eacute;rifier les param&egrave;tres du sous-rapport
Proc&eacute;dure
1.
Dans la section D&eacute;tails du rapport, cliquez deux fois sur le sous-rapport CustomerOrders pour l'afficher.
Des boutons de navigation apparaissent au bas de la fen&ecirc;tre du concepteur &agrave; la fois pour le rapport principal
et le sous-rapport CustomerOrders.
2.
Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/D&eacute;sactiver l'affichage du champ dans la barre
d'outils Crystal Reports.
Remarque
Vous pouvez &eacute;galement afficher l'Explorateur de champs en ouvrant le menu Crystal Reports, puis en
cliquant sur Explorateur de champs.
3.
Dans l'Explorateur de champs, d&eacute;veloppez Champs de param&egrave;tre.
4.
V&eacute;rifiez que le champ de param&egrave;tre Pm-Customers.CustomerID a &eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute; lorsque le
sous-rapport a &eacute;t&eacute; reli&eacute;.
5.
Dans la barre d'outils, cliquez sur Expert S&eacute;lection.
6.
Dans la bo&icirc;te de dialogue Expert S&eacute;lection, v&eacute;rifiez que le crit&egrave;re Orders.CustomerID est &eacute;gal &agrave; {?PmCustomers.CustomerID} est d&eacute;fini, puis cliquez sur OK.
7.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous avez r&eacute;ussi &agrave; ajouter un sous-rapport CustomerOrders au rapport NorthwindCustomers. Dans la section
suivante, vous allez ajouter un code permettant de d&eacute;finir les informations de connexion &agrave; la base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e pour tous les sous-rapports pr&eacute;sents dans le rapport principal.
1.5.2.4.2
Ajout du code de connexion au sous-rapport
Vous allez &agrave; pr&eacute;sent ajouter le code de connexion du sous-rapport &agrave; la classe code-behind. Vous commencez par
cr&eacute;er une m&eacute;thode d'assistance priv&eacute;e nomm&eacute;e SetDBLogonForSubreports().
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
385
1.5.2.4.2.1
Pour cr&eacute;er et coder la m&eacute;thode
SetDBLogonForSubreports()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e SetDBLogonForSubreports() avec deux
param&egrave;tres : ConnectionInfo et ReportDocument.
Private Sub SetDBLogonForSubreports(ByVal myConnectionInfo As ConnectionInfo,
ByVal myReportDocument As ReportDocument)
End Sub
private void SetDBLogonForSubreports(ConnectionInfo connectionInfo,
ReportDocument reportDocument)
{
}
4.
Dans cette m&eacute;thode, extrayez l'instance Section de la propri&eacute;t&eacute; Sections de la propri&eacute;t&eacute; ReportDefinition
du param&egrave;tre ReportDocument.
Remarque
Sections est une classe index&eacute;e contenant des instances de la classeSection.
Dim mySections As Sections = myReportDocument.ReportDefinition.Sections
Sections sections = reportDocument.ReportDefinition.Sections;
5.
Cr&eacute;ez une boucle foreach qui effectue une boucle sur chaque instance Section de l'instance de classe
index&eacute;e Sections.
For Each mySection As Section In mySections
Next
foreach(Section section in sections)
{
}
6.
Dans la boucle foreach, extrayez l'instance ReportObjects de la propri&eacute;t&eacute; ReportObjects de l'instance
Section.
Dim myReportObjects As ReportObjects = mySection.ReportObjects
386
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ReportObjects reportObjects = section.ReportObjects;
7.
Dans chaque boucle foreach, cr&eacute;ez une boucle foreach imbriqu&eacute;e qui effectue une boucle sur chaque
instance ReportObject de l'instance de classe index&eacute;e ReportObjects.
For Each myReportObject As ReportObject In myReportObjects
Next
foreach(ReportObject reportObject in reportObjects)
{
}
8.
Dans la boucle foreach imbriqu&eacute;e, cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si la propri&eacute;t&eacute; Kind de l'instance
ReportObject &eacute;quivaut &agrave; la s&eacute;lection SubreportObject de l'&eacute;num&eacute;ration ReportObjectKind.
If myReportObject.Kind = ReportObjectKind.SubreportObject Then
End If
if(reportObject.Kind == ReportObjectKind.SubreportObject)
{
}
9.
Dans le bloc conditionnel, effectuez un cast de l'instance ReportObject en instance SubreportObject.
Dim mySubreportObject As SubreportObject = CType(myReportObject, SubreportObject)
SubreportObject subreportObject = (SubreportObject)reportObject;
10. Toujours dans le bloc conditionnel, d&eacute;clarez une nouvelle instance de ReportDocument sous la forme d'une
variable subReportDocument et remplissez-la en appelant la m&eacute;thode OpenSubreport() de l'instance
SubreportObject.
Dim subReportDocument As ReportDocument =
mySubreportObject.OpenSubreport(mySubreportObject.SubreportName)
ReportDocument subReportDocument =
subreportObject.OpenSubreport(subreportObject.SubreportName);
11. Dans le bloc conditionnel, appelez la m&eacute;thode SetDBLogonForReport() d'origine et transmettez-lui le
param&egrave;tre ConnectionInfo et la nouvelle variable subReportDocument.
SetDBLogonForReport(myConnectionInfo, subReportDocument)
SetDBLogonForReport(connectionInfo, subReportDocument);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
387
1.5.2.4.2.2
Pour modifier la m&eacute;thode
ConfigureCrystalReports() selon le code de connexion &agrave; la base
de donn&eacute;es des sous-rapports
Contexte
Cette proc&eacute;dure a cr&eacute;&eacute; une m&eacute;thode permettant d'extraire tous les sous-rapports possibles sous forme
d'instances ReportDocument. Chaque instance ReportDocument de sous-rapport est ensuite transmise &agrave; la
m&eacute;thode d'origine afin de d&eacute;finir la connexion &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Cependant, vous devez maintenant modifier la m&eacute;thode ConfigureCrystalReports() pour d&eacute;signer cette
m&eacute;thode et permettre le traitement des informations de connexion &agrave; la base de donn&eacute;es des sous-rapports.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de
la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
2.
Dans les sauts de ligne, saisissez un appel &agrave; la m&eacute;thode SetDBLogonForSubreports() en transmettant
l'instance ConnectionInfo et le rapport NorthwindCustomers.
SetDBLogonForSubreports(myConnectionInfo, northwindCustomersReport)
SetDBLogonForSubreports(connectionInfo, northwindCustomersReport);
1.5.2.4.2.3
Pour tester le chargement du rapport
NorthwindCustomers
Contexte
Cette proc&eacute;dure est suivie du code d'origine qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le chargement du rapport et de son sous-rapport
ne devrait poser aucun probl&egrave;me, car le code permettant de connecter n'importe quel sous-rapport &agrave; la base de
donn&eacute;es est maintenant &eacute;crit.
Proc&eacute;dure
1.
388
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport NorthwindCustomers et son nouveau sous-rapport CustomerOrders s'affichent correctement.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.5
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
discrets
Dans ce tutoriel, vous allez apprendre &agrave; cr&eacute;er un rapport dont les donn&eacute;es peuvent &ecirc;tre filtr&eacute;es en fonction d'un
param&egrave;tre discret.
Introduction
Un param&egrave;tre discret est une valeur unique alors qu'un param&egrave;tre de plage fait r&eacute;f&eacute;rence &agrave; une plage de valeurs.
Les &eacute;l&eacute;ments textuels (tels que les villes) sont g&eacute;n&eacute;ralement accessibles via des param&egrave;tres discrets. Les
&eacute;l&eacute;ments num&eacute;riques (tels que les salaires des employ&eacute;s) sont g&eacute;n&eacute;ralement accessibles via des param&egrave;tres de
plage.
Dans ce tutoriel, vous allez d&eacute;finir une valeur de param&egrave;tre discret afin d'afficher un rapport sur les clients bas&eacute;
sur un champ. Ce rapport affiche uniquement les clients vivant dans les villes s&eacute;lectionn&eacute;es dans une liste de
villes. Cette liste provient des valeurs par d&eacute;faut du param&egrave;tre Ville. Les valeurs par d&eacute;faut du param&egrave;tre Ville sont
encapsul&eacute;es dans le rapport.
Cr&eacute;ez tout d'abord un rapport sur les clients avec un param&egrave;tre de ville. Les donn&eacute;es du rapport proviennent de
l'exemple de base de donn&eacute;es fourni avec SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
Lorsque vous instanciez le rapport dans le code, vous cr&eacute;ez une instance ArrayList contenant des noms de ville
(Paris, Tokyo), puis transmettez cette instance &agrave; une m&eacute;thode d'assistance qui d&eacute;finit ces noms de ville comme
les valeurs actuelles du param&egrave;tre Ville. Vous liez ensuite le rapport au contr&ocirc;le CrystalReportViewer et seuls les
clients vivant &agrave; Paris ou &agrave; Tokyo sont affich&eacute;s dans ce rapport.
Dans la partie suivante du tutoriel, vous allez effectuer les op&eacute;rations suivantes :
●
Cr&eacute;er une m&eacute;thode qui extrait toutes les valeurs par d&eacute;faut et les renvoie dans une instance ArrayList.
●
Ajouter un contr&ocirc;le ListBox au formulaire et le remplir avec les valeurs provenant de l'ArrayList.
●
Ajouter un contr&ocirc;le Button pour r&eacute;afficher le rapport en fonction des s&eacute;lections ListBox.
Dans la derni&egrave;re partie du tutoriel, vous coderez l'&eacute;v&eacute;nement de clic pour extraire les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s &agrave;
partir du contr&ocirc;le ListBox et d&eacute;finir les valeurs actuelles du param&egrave;tre Ville. Le rapport est r&eacute;affich&eacute;, indiquant
uniquement les clients qui vivent dans les villes s&eacute;lectionn&eacute;es dans le contr&ocirc;le ListBox.
Ce tutoriel peut &eacute;galement &ecirc;tre effectu&eacute; avec des classes du mod&egrave;le d'objet CrystalReportViewer, bien qu'il soit
recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
Pour cr&eacute;er ce tutoriel &agrave; l'aide du mod&egrave;le d'objet CrystalReportViewer, voir Tutoriel : Connexion &agrave; une base de
donn&eacute;es SQL Server s&eacute;curis&eacute;e [page 244] &agrave; l'aide du mod&egrave;le d'objet CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
389
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_Parameters
●
Projet Windows C# : CS_Win_RDObjMod_Parameters
●
Site Web Visual Basic : VB_Web_RDObjMod_Parameters
●
Projet Windows Visual Basic : VB_Win_RDObjMod_Parameters
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.5.1
Cr&eacute;ation d'un rapport avec des param&egrave;tres
Commencez par cr&eacute;er un rapport &agrave; partir des informations de la base de donn&eacute;es Xtreme.
1.5.2.5.1.1
Pour cr&eacute;er un rapport avec des param&egrave;tres
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom CustomersByCity.rpt, puis cliquez sur Ajouter.
390
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
Remarque
Dans SAP Visual Studio .NET 2003, l'application SAP Crystal Reports n'a pas &eacute;t&eacute; mise &agrave; niveau vers la
version compl&egrave;te et le dossier Cr&eacute;er une nouvelle connexion n'existe pas ; le contenu est indiqu&eacute; au niveau
sup&eacute;rieur.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
8.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; la base de donn&eacute;es Xtreme,
puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
9.
D&eacute;veloppez le nœud Tables et s&eacute;lectionnez la table Clients.
10. Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
11. D&eacute;veloppez la table Clients, puis utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner les champs
Nom du client, Titre, Adresse 1, Nom du contact et Ville.
12. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur le
bouton Suivant.
13. Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Clients.Ville, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport CustomersByCity est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; ajouter un param&egrave;tre appel&eacute; Ville et &agrave; le remplir avec des valeurs par d&eacute;faut.
1.5.2.5.1.2
Pour ajouter un param&egrave;tre Ville
Contexte
L'Explorateur de champs doit &ecirc;tre visible, car il permet d'acc&eacute;der &agrave; plusieurs fonctions du rapport, notamment
aux param&egrave;tres.
Proc&eacute;dure
1.
Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/D&eacute;sactiver l'affichage du champ dans la barre
d'outils Crystal Reports.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
391
Remarque
Vous pouvez &eacute;galement afficher l'Explorateur de champs en ouvrant le menu Crystal Reports, puis en
cliquant sur Explorateur de champs.
2.
Dans l'Explorateur de champs, cliquez avec le bouton droit de la souris sur Champs de param&egrave;tre, puis
s&eacute;lectionnez Nouveau.
3.
Dans la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre :
a) Attribuez &agrave; Nom la valeur Ville.
b) Attribuez &agrave; Type la valeur Cha&icirc;ne. Attribuez &agrave; Texte de l'invite la valeur S&eacute;lectionnez une ou
plusieurs villes.
c) Attribuez &agrave; Champ de valeur la valeur Ville.
d) Cliquez sur Actions, puis s&eacute;lectionnez Ajouter toutes les valeurs de la base de donn&eacute;es. La liste compl&egrave;te
des villes appara&icirc;t dans le volet du milieu.
e) Dans le volet Options de valeur, attribuez &agrave; Texte de l'invite la valeur S&eacute;lectionnez une ou
plusieurs villes.
f)
Dans ce m&ecirc;me volet, attribuez &agrave; Autoriser plusieurs valeurs la valeur True.
g) Attribuez &agrave; Autoriser les valeurs discr&egrave;tes la valeur True.
4.
Cliquez sur OK pour fermer la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre.
R&eacute;sultats
Vous venez de d&eacute;finir les valeurs par d&eacute;faut de sorte qu'elles contiennent une liste importante de villes. Plus loin
dans ce tutoriel, vous acc&eacute;derez par programmation &agrave; cette m&ecirc;me liste de valeurs par d&eacute;faut, via la propri&eacute;t&eacute;
DefaultValues de la classe ParameterFieldDefinition.
Vous devez maintenant utiliser l'Expert S&eacute;lection pour d&eacute;finir une formule permettant de connecter la colonne
Ville de la base de donn&eacute;es au champ de param&egrave;tre Ville que vous venez de cr&eacute;er.
1.5.2.5.1.3
Pour connecter le param&egrave;tre Ville &agrave; la colonne
Ville de la base de donn&eacute;es
Proc&eacute;dure
1.
Dans la barre d'outils Crystal Reports, cliquez sur Expert S&eacute;lection.
2.
Dans la bo&icirc;te de dialogue Choisir un champ, sous Champs du rapport, s&eacute;lectionnez Clients.Ville, puis cliquez
sur OK.
3.
Dans la bo&icirc;te de dialogue Expert S&eacute;lection, dans l'onglet Clients.Ville, choisissez est &eacute;gal &agrave; dans la liste
d&eacute;roulante.
4.
Dans la nouvelle liste d&eacute;roulante qui s'affiche &agrave; droite, s&eacute;lectionnez le premier &eacute;l&eacute;ment de la liste, {?Ville}, puis
cliquez sur OK.
392
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Cette s&eacute;lection, {?Ville}, correspond au param&egrave;tre Ville que vous avez cr&eacute;&eacute; pr&eacute;c&eacute;demment.
5.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; lier le rapport au contr&ocirc;le CrystalReportViewer et &agrave; d&eacute;finir le param&egrave;tre Ville avec
deux valeurs d'origine, Paris et Tokyo.
1.5.2.5.2
Liaison du rapport
Lorsque vous avez suivi les instructions de la proc&eacute;dure Configuration d'un projet [page 15] en pr&eacute;paration de ce
tutoriel, vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer sur le Web Form ou le Windows Form. Aux &eacute;tapes
pr&eacute;c&eacute;dentes, vous avez ajout&eacute; un rapport CustomerByCity au projet.
Dans cette section, vous allez instancier le rapport CustomersByCity et le lier au contr&ocirc;le CrystalReportViewer.
Vous allez ensuite v&eacute;rifier si le rapport s'affiche correctement lorsque les valeurs actuelles n'ont pas &eacute;t&eacute; d&eacute;finies
pour ce param&egrave;tre.
Vous pouvez instancier et lier le rapport de deux fa&ccedil;ons :
●
En tant que rapport incorpor&eacute;.
●
En tant que rapport non incorpor&eacute;.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous.
●
Si vous utilisez des rapports incorpor&eacute;s, effectuez la proc&eacute;dure suivante afin d'instancier le rapport sous
forme de rapport incorpor&eacute;.
●
Si vous utilisez des rapports non incorpor&eacute;s, effectuez la seconde proc&eacute;dure afin d'instancier le rapport sous
forme de rapport non incorpor&eacute;.
1.5.2.5.2.1
Pour instancier le rapport CustomersByCity sous
forme de rapport incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind du Web Form ou du Windows
Form.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
393
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport CustomersByCity, avec
la variable customersByCityReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customersByCityReport As CustomersByCity
private CustomersByCity customersByCityReport;
4.
Dans la m&eacute;thode ConfigureCrystalReports(), instanciez la classe wrapper du rapport.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans Configuration d'un projet [page 15].
customersByCityReport = New CustomersByCity()
customersByCityReport = new CustomersByCity();
5.
Sur la ligne suivante, au-dessous de l'instanciation du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; la classe de rapport instanci&eacute;e (nom de la variable : customersByCityReport).
myCrystalReportViewer.ReportSource = customersByCityReport
crystalReportViewer.ReportSource = customersByCityReport;
Remarque
L'instance du contr&ocirc;le CrystalReportViewer est accessible dans le code, car vous avez ajout&eacute; le contr&ocirc;le &agrave;
votre Web Form ou Windows Form. Si IntelliSense ne reconna&icirc;t pas l'instance du contr&ocirc;le
CrystalReportViewer, v&eacute;rifiez que le contr&ocirc;le CrystalReportViewer a &eacute;t&eacute; ajout&eacute; sous la forme d'une
d&eacute;claration de niveau classe &agrave; cette classe code-behind.
1.5.2.5.2.2
Pour instancier le rapport CustomersByCity sous
forme de rapport non incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le chargement du rapport doit &eacute;chouer, car le code
permettant de d&eacute;finir une valeur pour le champ de param&egrave;tre Ville n'a pas encore &eacute;t&eacute; &eacute;crit.
394
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport ReportDocument, avec la
variable customersByCityReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customersByCityReport As ReportDocument
private ReportDocument customersByCityReport;
Remarque
La classe ReportDocument est un membre de l'espace de noms CrystalDecisions.CrystalReports.Engine.
Vous avez ajout&eacute; une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] pour cet espace de
noms dans la section Configuration d'un projet [page 15]. Lorsque vous instanciez ReportDocument et
chargez un rapport dans l'espace de noms, vous acc&eacute;dez au rapport via le SDK sans l'incorporer.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans l'une des proc&eacute;dures de la
section Configuration d'un projet [page 15]), instanciez la classe ReportDocument.
customersByCityReport = New ReportDocument()
customersByCityReport = new ReportDocument();
5.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;CustomersByCity.rpt&quot;)
string reportPath = Server.MapPath(&quot;CustomersByCity.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
395
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;CustomersByCity.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;CustomersByCity.rpt&quot;;
6.
Appelez la m&eacute;thode Load() de l'instance ReportDocument et transmettez-lui la variable cha&icirc;ne reportPath.
customersByCityReport.Load(reportPath)
customersByCityReport.Load(reportPath);
7.
Sur la ligne suivante, sous le chargement du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; l'instance ReportDocument.
myCrystalReportViewer.ReportSource = customersByCityReport
crystalReportViewer.ReportSource = customersByCityReport;
R&eacute;sultats
Que vous ayez choisi d'instancier une classe de rapport incorpor&eacute; ou une classe de rapport non incorpor&eacute; via la
classe ReportDocument, le nom de la variable utilis&eacute;e est identique : customersByCityReport. Vous pouvez ainsi
utiliser un bloc de code commun dans les proc&eacute;dures suivantes.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le chargement du rapport doit &eacute;chouer, car le code
permettant de d&eacute;finir une valeur pour le champ de param&egrave;tre Ville n'a pas encore &eacute;t&eacute; &eacute;crit. Vous ajouterez une
valeur au param&egrave;tre Ville plus loin dans ce tutoriel.
1.5.2.5.2.3
Pour tester le chargement du rapport
CustomersByCity
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
396
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport CustomersByCity ne s'affiche pas. Il s'affiche apr&egrave;s que vous avez ajout&eacute; une valeur au param&egrave;tre
Ville plus loin dans ce tutoriel.
Remarque
Les r&eacute;sultats peuvent varier selon la version de SAP Crystal Reports utilis&eacute;e. Dans les versions plus
r&eacute;centes, un formulaire s'affiche vous demandant de fournir des valeurs de param&egrave;tre pour ce rapport.
Dans les versions ant&eacute;rieures, une exception &quot;Valeur actuelle du champ de param&egrave;tre introuvable&quot; est
renvoy&eacute;e. Dans les deux cas, vous devez ajouter du code suppl&eacute;mentaire pour cr&eacute;er une application
enti&egrave;rement fonctionnelle.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.5.3
D&eacute;finition manuelle des param&egrave;tres dans le code
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er deux valeurs (&quot;Paris&quot; et &quot;Tokyo&quot;) dans le champ de param&egrave;tre Ville du rapport
CustomersByCity.
Cette op&eacute;ration n&eacute;cessite un code qui peut &ecirc;tre d&eacute;compos&eacute; selon les processus suivants :
●
Une constante PARAMETER_FIELD_NAME est n&eacute;cessaire pour contenir le champ de param&egrave;tre &quot;Ville&quot;, qui
est utilis&eacute; plusieurs fois dans l'ensemble du code.
●
Le code permettant d'ajouter les valeurs actuelles au param&egrave;tre &eacute;tant g&eacute;n&eacute;ralement utilis&eacute; dans deux
emplacements diff&eacute;rents dans ce tutoriel, il est pr&eacute;f&eacute;rable de cr&eacute;er ce code en tant que m&eacute;thode d'assistance
distincte.
●
Dans la m&eacute;thode ConfigureCrystalReports(), vous devez ajouter les param&egrave;tres &quot;Paris&quot; et &quot;Tokyo&quot; &agrave;
une instance ArrayList, puis transmettre le rapport et l'instance &agrave; la m&eacute;thode d'assistance pour le traitement.
Dans la section suivante, vous allez apprendre &agrave; extraire les valeurs par d&eacute;faut du champ de param&egrave;tre et &agrave; d&eacute;finir
ces valeurs dans un contr&ocirc;le ListBox. Ces valeurs seront utilis&eacute;es &agrave; la fin du tutoriel pour s&eacute;lectionner de fa&ccedil;on
dynamique de nouvelles villes et filtrer le rapport en fonction des nouvelles villes s&eacute;lectionn&eacute;es.
Effectuez maintenant la proc&eacute;dure Cr&eacute;ation d'un contr&ocirc;le ListBox qui affiche les param&egrave;tres par d&eacute;faut [page
402].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
397
1.5.2.5.3.1
Pour cr&eacute;er une constante
PARAMETER_FIELD_NAME
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
Au niveau de la classe, cr&eacute;ez une constante cha&icirc;ne, PARAMETER_FIELD_NAME, et attribuez-lui la valeur
&quot;Ville&quot;.
Private Const PARAMETER_FIELD_NAME As String = &quot;City&quot;
private const string PARAMETER_FIELD_NAME = &quot;City&quot;;
1.5.2.5.3.2
Pour cr&eacute;er une m&eacute;thode d'assistance permettant
d'ajouter les valeurs actuelles au param&egrave;tre dans le rapport
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er la m&eacute;thode d'assistance qui permet d'ajouter les valeurs actuelles au
param&egrave;tre dans le rapport.
Proc&eacute;dure
1.
Revenez &agrave; la classe code-behind de ce Web Form ou Windows Form.
2.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe de l'espace de noms System.Collections (si cet espace de noms n'a pas d&eacute;j&agrave; &eacute;t&eacute;
d&eacute;clar&eacute;).
Imports System.Collections
using System.Collections;
Remarque
Cette d&eacute;claration est n&eacute;cessaire pour acc&eacute;der &agrave; la classe ArrayList.
3.
398
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e
SetCurrentValuesForParameterField() avec deux variables dans la signature de la m&eacute;thode.
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Plus loin dans ce tutoriel, si vous avez utilis&eacute; un rapport incorpor&eacute;, vous transmettez votre classe de
rapport incorpor&eacute; au param&egrave;tre de la m&eacute;thode ReportDocument. Cette possibilit&eacute; s'explique par le fait que
Toutes les classes de rapport incorpor&eacute; pr&eacute;sentes dans SAP Crystal Reports h&eacute;ritent de la classe de base
ReportDocument.
Private Sub SetCurrentValuesForParameterField(ByVal myReportDocument As
ReportDocument, ByVal myArrayList As ArrayList)
End Sub
private void SetCurrentValuesForParameterField(ReportDocument reportDocument,
ArrayList arrayList)
{
}
4.
Dans cette m&eacute;thode, d&eacute;clarez et instanciez la classe index&eacute;e ParameterValues en tant que variable
currentParameterValues.
Remarque
Pour que la classe ParameterValues soit accessible, vous devez avoir inclus une d&eacute;claration &quot;Imports&quot;
[Visual Basic] ou &quot;using&quot; [C#] dans la partie sup&eacute;rieure de la classe code-behind pour l'espace de
noms CrystalDecisions.Shared. (Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un
projet [page 15].)
Dim currentParameterValues As ParameterValues = New ParameterValues()
ParameterValues currentParameterValues = new ParameterValues();
5.
Cr&eacute;ez une boucle foreach pour extraire toutes les valeurs envoy&eacute;es (comme type Objet) de l'instance
ArrayList.
Remarque
Dans cette m&eacute;thode, vous extrayez les valeurs d'ArrayList. Par la suite, vous &eacute;crirez du code permettant
d'ajouter des valeurs &agrave; l'ArrayList.
For Each submittedValue As Object In myArrayList
Next
foreach(object submittedValue in arrayList)
{
}
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
399
6.
Dans la boucle foreach, d&eacute;clarez et instanciez la classe ParameterDiscreteValue.
Dim myParameterDiscreteValue As ParameterDiscreteValue = New
ParameterDiscreteValue()
ParameterDiscreteValue parameterDiscreteValue = new ParameterDiscreteValue();
7.
Dans la boucle foreach, convertissez la valeur envoy&eacute;e en cha&icirc;ne et transmettez-la &agrave; la propri&eacute;t&eacute; Value de
l'instance ParameterDiscreteValue.
myParameterDiscreteValue.Value = submittedValue.ToString()
parameterDiscreteValue.Value = submittedValue.ToString();
8.
Dans la boucle foreach, ajoutez l'instance ParameterDiscreteValue dans la classe index&eacute;e
currentParameterValues.
currentParameterValues.Add(myParameterDiscreteValue)
currentParameterValues.Add(parameterDiscreteValue);
L'&eacute;criture de code dans la boucle foreach est &agrave; pr&eacute;sent termin&eacute;e. Vous placez le code restant (&agrave; l'aide des
&eacute;tapes suivantes) apr&egrave;s la boucle foreach.
9.
En dehors de la boucle foreach, extrayez la classe index&eacute;e ParameterFieldDefinitions provenant de la
propri&eacute;t&eacute; DataDefinition de l'instance ReportDocument.
Dim myParameterFieldDefinitions As ParameterFieldDefinitions =
myReportDocument.DataDefinition.ParameterFields
ParameterFieldDefinitions parameterFieldDefinitions =
reportDocument.DataDefinition.ParameterFields;
10. Extrayez l'instance ParameterFieldDefinition de la classe index&eacute;e ParameterFieldDefinitions qui se base sur
l'entr&eacute;e d'index de la constante PARAMETER_FIELD_NAME.
Dim myParameterFieldDefinition As ParameterFieldDefinition =
myParameterFieldDefinitions(PARAMETER_FIELD_NAME)
ParameterFieldDefinition parameterFieldDefinition =
parameterFieldDefinitions[PARAMETER_FIELD_NAME];
11. Transmettez l'instance currentParameterValues &agrave; la m&eacute;thode ApplyCurrentValues de l'instance
ParameterFieldDefinition.
myParameterFieldDefinition.ApplyCurrentValues(currentParameterValues)
400
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
parameterFieldDefinition.ApplyCurrentValues(currentParameterValues);
1.5.2.5.3.3
Pour appeler la m&eacute;thode
SetCurrentValuesForParameterField () avant la liaison du
rapport au contr&ocirc;le CrystalReportViewer
Contexte
Cette proc&eacute;dure a permis de cr&eacute;er une m&eacute;thode qui extrait les valeurs envoy&eacute;es d'une instance ArrayList et les
place comme valeurs actuelles dans une instance ParameterFieldDefinition. Vous devez maintenant appeler cette
m&eacute;thode avant que votre rapport ne soit li&eacute; au contr&ocirc;le CrystalReportViewer afin que le rapport sache qu'il
dispose de param&egrave;tres.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de
la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Dans ces sauts de ligne, vous pouvez saisir du code suppl&eacute;mentaire qui modifie le rapport avant qu'il ne soit
li&eacute; au visualiseur.
2.
Dans les sauts de lignes, d&eacute;clarez et instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
3.
Ajoutez les noms de ville &quot;Paris&quot; et &quot;Tokyo&quot; comme cha&icirc;nes &agrave; l'instance ArrayList.
myArrayList.Add(&quot;Paris&quot;)
myArrayList.Add(&quot;Tokyo&quot;)
arrayList.Add(&quot;Paris&quot;);
arrayList.Add(&quot;Tokyo&quot;);
4.
Appelez la m&eacute;thode SetCurrentValuesForParameterField(), puis transmettez l'instance
CustomersByCityReport et l'instance ArrayList.
SetCurrentValuesForParameterField(customersByCityReport,
myArrayList)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
401
SetCurrentValuesForParameterField(customersByCityReport,
arrayList);
1.5.2.5.3.4
Pour tester le chargement du rapport
CustomersByCity
Contexte
La derni&egrave;re ligne de code de la m&eacute;thode lie le rapport au contr&ocirc;le CrystalReportViewer.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le rapport doit s'afficher correctement, car le code
d&eacute;finissant les valeurs actuelles dans le champ de param&egrave;tre est d&eacute;sormais &eacute;crit.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport CustomersByCity s'affiche correctement, indiquant des listes de clients &agrave; Paris et &agrave; Tokyo.
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.5.4
Cr&eacute;ation d'un contr&ocirc;le ListBox qui affiche les
param&egrave;tres par d&eacute;faut
Le reste du tutoriel concerne l'affichage de la liste compl&egrave;te des valeurs par d&eacute;faut du champ de param&egrave;tre dans
un contr&ocirc;le ListBox et le refiltrage du contenu du rapport en fonction des s&eacute;lections effectu&eacute;es &agrave; partir du
contr&ocirc;le ListBox.
Dans cette section, vous allez apprendre &agrave; remplir le contr&ocirc;le ListBox &agrave; partir des valeurs par d&eacute;faut du champ de
param&egrave;tre.
Remarque
N'oubliez pas que vous avez d&eacute;fini les valeurs par d&eacute;faut, une liste importante de villes, lors de la cr&eacute;ation du
rapport au d&eacute;but de ce tutoriel.
Pour ce faire, vous devez ajouter et configurer un contr&ocirc;le ListBox, puis cr&eacute;er une m&eacute;thode d'assistance pour
remplir ce contr&ocirc;le.
402
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.5.4.1
Pour cr&eacute;er et configurer un contr&ocirc;le ListBox sur
le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
○
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
○
Appuyez sur la FLECHE GAUCHE du clavier afin de faire appara&icirc;tre un curseur clignotant, puis appuyez
sur ENTREE.
Le contr&ocirc;le CrystalReportViewer descend d'une ligne.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
○
Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
○
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Dock la valeur &quot;Bottom&quot;.
Remarque
Dans Visual Studio, lorsque vous s&eacute;lectionnez la propri&eacute;t&eacute; Dock, un cadre appara&icirc;t &agrave; la place d'une liste
d'options. S&eacute;lectionnez la partie du cadre correspondant &agrave; &quot;Bottom&quot;.
5.
○
Redimensionnez le Windows Form et le contr&ocirc;le CrystalReportViewer de mani&egrave;re &agrave; ce que ce dernier soit
suffisamment grand pour afficher le rapport. Laissez de l'espace au-dessus du contr&ocirc;le
CrystalReportViewer pour ajouter un contr&ocirc;le ListBox.
○
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
○
Redimensionnez le Windows Form et le contr&ocirc;le CrystalReportViewer de mani&egrave;re &agrave; ce que ce dernier soit
suffisamment grand pour afficher le rapport. Laissez de l'espace au-dessus du contr&ocirc;le
CrystalReportViewer pour ajouter un contr&ocirc;le ListBox.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le ListBox au-dessus du contr&ocirc;le CrystalReportViewer.
Remarque
Si une t&acirc;che guid&eacute;e appara&icirc;t dans le contr&ocirc;le ListBox (dans Visual Studio), appuyez sur Echap pour la
fermer.
6.
Cliquez sur le contr&ocirc;le ListBox pour le s&eacute;lectionner.
7.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
8.
○
Attribuez &agrave; ID ou Name la valeur &quot;defaultParameterValuesList&quot;.
○
Attribuez &agrave; SelectionMode la valeur &quot;Multiple&quot; (ou &quot;MultiExtended&quot; dans un projet Windows).
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
403
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er une m&eacute;thode d'assistance qui extrait les valeurs par d&eacute;faut du champ de
param&egrave;tre.
1.5.2.5.4.2
Pour cr&eacute;er une m&eacute;thode d'assistance qui extrait
les valeurs par d&eacute;faut du champ de param&egrave;tre
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e nomm&eacute;e
GetDefaultValuesFromParameterField() qui renvoie une instance ArrayList, en transmettant
ReportDocument dans la signature de la m&eacute;thode.
Private Function GetDefaultValuesFromParameterField(ByVal myReportDocument As
ReportDocument) As ArrayList
End Function
private ArrayList GetDefaultValuesFromParameterField(ReportDocument
reportDocument)
{
}
4.
Dans la m&eacute;thode GetDefaultValuesFromParameterField(), extrayez la classe index&eacute;e
ParameterFieldDefinitions provenant de la propri&eacute;t&eacute; DataDefinition de l'instance ReportDocument.
Dim myParameterFieldDefinitions As ParameterFieldDefinitions =
myReportDocument.DataDefinition.ParameterFields
ParameterFieldDefinitions parameterFieldDefinitions =
reportDocument.DataDefinition.ParameterFields;
5.
Extrayez l'instance ParameterFieldDefinition de la classe index&eacute;e ParameterFieldDefinitions, bas&eacute;e sur
l'entr&eacute;e d'index de la constante PARAMETER_FIELD_NAME.
Dim myParameterFieldDefinition As ParameterFieldDefinition =
myParameterFieldDefinitions(PARAMETER_FIELD_NAME)
ParameterFieldDefinition parameterFieldDefinition =
parameterFieldDefinitions[PARAMETER_FIELD_NAME];
404
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
6.
Extrayez une classe index&eacute;e ParameterValues (en tant que variable defaultParameterValues) de la propri&eacute;t&eacute;
DefaultValues de l'instance ParameterFieldDefinition.
Dim defaultParameterValues As ParameterValues =
myParameterFieldDefinition.DefaultValues
ParameterValues defaultParameterValues = parameterFieldDefinition.DefaultValues;
7.
D&eacute;clarez et instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
8.
Cr&eacute;ez une boucle foreach pour extraire chaque instance ParameterValue de la variable
defaultParameterValues.
For Each myParameterValue As ParameterValue In defaultParameterValues
Next
foreach(ParameterValue parameterValue in defaultParameterValues)
{
}
Dans la boucle foreach, cr&eacute;ez maintenant un bloc conditionnel imbriqu&eacute; qui recherche des valeurs de
param&egrave;tre discret (par opposition aux valeurs de param&egrave;tre de plage). Il existe deux versions de ce bloc
conditionnel, car l'API a subi de l&eacute;g&egrave;res modifications au cours de l'&eacute;volution des versions de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio. V&eacute;rifiez votre API (&agrave; l'aide
d'IntelliSense) pour conna&icirc;tre la propri&eacute;t&eacute; disponible sous ParameterValue :
9.
Si la propri&eacute;t&eacute; disponible est IsRange, saisissez le code suivant dans la boucle foreach :
If (Not myParameterValue.IsRange) Then
End If
if(!parameterValue.IsRange)
{
}
10. Ou, si la propri&eacute;t&eacute; disponible est Kind (DiscreteOrRangeKind, une &eacute;num&eacute;ration comportant trois valeurs :
DiscreteValue, RangeValue, DiscreteAndRangeValue) saisissez le code suivant dans la boucle foreach :
If (myParameterValue.Kind = DiscreteOrRangeKind.DiscreteValue) Then
End If
if(parameterValue.Kind == DiscreteOrRangeKind.DiscreteValue)
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
405
{
}
11. Dans le bloc conditionnel imbriqu&eacute;, effectuez un cast de l'instance ParameterValue en sa classe &eacute;tendue,
DiscreteParameterValue.
Dim myParameterDiscreteValue As ParameterDiscreteValue = CType(myParameterValue,
ParameterDiscreteValue)
ParameterDiscreteValue parameterDiscreteValue =
(ParameterDiscreteValue)parameterValue;
12. Dans le bloc conditionnel imbriqu&eacute;, ajoutez la propri&eacute;t&eacute; Value de l'instance ParameterDiscreteValue
(convertie en cha&icirc;ne) dans l'instance ArrayList.
myArrayList.Add(myParameterDiscreteValue.Value.ToString())
arrayList.Add(parameterDiscreteValue.Value.ToString());
13. En dehors du bloc conditionnel et de la boucle foreach, en fin de m&eacute;thode, renvoyez l'instance ArrayList
depuis la m&eacute;thode.
Return myArrayList
return arrayList;
1.5.2.5.4.3
Pour lier l'ArrayList renvoy&eacute;e de la m&eacute;thode au
contr&ocirc;le ListBox dans un projet Web
Contexte
Vous avez extrait les valeurs par d&eacute;faut du champ de param&egrave;tre et les avez renvoy&eacute;es de la m&eacute;thode sous la
forme d'une ArrayList. Vous allez maintenant lier cette ArrayList au contr&ocirc;le ListBox defaultParameterValuesList.
Le code varie l&eacute;g&egrave;rement selon que vous utilisez un projet Web ou un projet Windows ; en cons&eacute;quence, vous ne
devez effectuer que l'une des proc&eacute;dures Web ou Windows ci-apr&egrave;s.
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code
imm&eacute;diatement apr&egrave;s la ligne de code qui ajoute la valeur de cha&icirc;ne Tokyo &agrave; l'instance ArrayList.
Dans ces sauts de ligne, vous pouvez &agrave; pr&eacute;sent saisir un code suppl&eacute;mentaire d&eacute;finissant la source de
donn&eacute;es du contr&ocirc;le ListBox defaultParameterValuesList lors du premier chargement de la page.
406
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
2.
Dans les sauts de ligne, cr&eacute;ez un bloc conditionnel Not IsPostBack.
If Not IsPostBack Then
End If
if(!IsPostBack)
{
}
Remarque
Le bloc conditionnel Not IsPostBack est utilis&eacute; pour encapsuler du code devant &ecirc;tre ex&eacute;cut&eacute;
uniquement lors du premier chargement de la page. Les contr&ocirc;les sont g&eacute;n&eacute;ralement li&eacute;s aux valeurs de
donn&eacute;es dans des blocs conditionnels Not IsPostBack afin que leurs valeurs de donn&eacute;es (et tout
&eacute;v&eacute;nement de contr&ocirc;le suivant) ne soient pas red&eacute;finies lorsque les pages sont recharg&eacute;es.
3.
Dans le bloc conditionnel Not IsPostBack, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox
defaultParameterValuesList la m&eacute;thode d'assistance GetDefaultValuesFromParameterField() en
transmettant l'instance de rapport CustomersByCity en tant que param&egrave;tre de m&eacute;thode.
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport)
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport);
4.
Toujours dans le bloc conditionnel Not IsPostBack, appelez la m&eacute;thode DataBind() du contr&ocirc;le ListBox
defaultParameterValuesList.
defaultParameterValuesList.DataBind()
defaultParameterValuesList.DataBind();
1.5.2.5.4.4
Pour lier l'ArrayList renvoy&eacute;e de la m&eacute;thode au
contr&ocirc;le ListBox dans un projet Windows
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code
imm&eacute;diatement apr&egrave;s la ligne de code qui ajoute la valeur de cha&icirc;ne Tokyo &agrave; l'instance ArrayList.
Dans ces sauts de ligne, vous pouvez &agrave; pr&eacute;sent saisir un code suppl&eacute;mentaire d&eacute;finissant la source de
donn&eacute;es du contr&ocirc;le ListBox defaultParameterValuesList lors du premier chargement de la page.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
407
2.
Dans les sauts de lignes, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ListBox defaultParameterValuesList
la m&eacute;thode d'assistance GetDefaultValuesFromParameterField() en transmettant l'instance du
rapport CustomersByCity en tant que param&egrave;tre de m&eacute;thode.
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport)
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport);
1.5.2.5.4.5
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le contr&ocirc;le ListBox defaultParameterValuesList affiche la liste compl&egrave;te des valeurs par d&eacute;faut (dans ce
tutoriel, il s'agit de villes).
4.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Dans la section suivante, vous allez ajouter un bouton pour r&eacute;afficher le rapport en fonction des s&eacute;lections du
contr&ocirc;le ListBox defaultParameterValuesList.
1.5.2.5.5
ListBox
D&eacute;finition des param&egrave;tres &agrave; partir des s&eacute;lections
Dans cette section, vous allez ajouter un bouton pour r&eacute;afficher le rapport en fonction des s&eacute;lections du contr&ocirc;le
ListBox defaultParameterValuesList.
408
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Dans la m&eacute;thode d'&eacute;v&eacute;nement de ce bouton, vous appellerez la m&ecirc;me m&eacute;thode que celle appel&eacute;e lors du premier
chargement de la page : SetCurrentValuesForParameterField(). Mais cette fois, au lieu de transmettre des
valeurs arbitraires (Paris et Tokyo), vous transmettrez les valeurs s&eacute;lectionn&eacute;es depuis le contr&ocirc;le ListBox
defaultParameterValuesList.
1.5.2.5.5.1
Pour cr&eacute;er et configurer un contr&ocirc;le Button de
r&eacute;affichage sur le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button &agrave; droite du contr&ocirc;le ListBox.
4.
Cliquez sur le contr&ocirc;le Button pour le s&eacute;lectionner.
5.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s :
○
Attribuez &agrave; ID ou Name la valeur &quot;redisplay&quot;.
○
Attribuez &agrave; Text la valeur &quot;R&eacute;afficher le rapport&quot;.
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; cr&eacute;er une m&eacute;thode d'&eacute;v&eacute;nement de clic qui recherche des &eacute;l&eacute;ments s&eacute;lectionn&eacute;s
dans le contr&ocirc;le ListBox et les transmet &agrave; la m&eacute;thode SetCurrentValuesForParameterField().
Le code varie l&eacute;g&egrave;rement pour un projet Web ou un projet Windows ; en cons&eacute;quence, vous ne devez effectuer
que l'une des proc&eacute;dures Web ou Windows ci-apr&egrave;s.
1.5.2.5.5.2
Pour cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement de clic du
contr&ocirc;le Button de r&eacute;affichage dans un projet Web
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button de r&eacute;affichage.
Cette op&eacute;ration affiche la classe code-behind dans laquelle une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click()
a &eacute;t&eacute; g&eacute;n&eacute;r&eacute;e automatiquement.
2.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe de l'espace de noms System.Web.UI.WebControls (si cet espace de noms n'a pas
d&eacute;j&agrave; &eacute;t&eacute; d&eacute;clar&eacute;).
Imports System.Web.UI.WebControls
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
409
using System.Web.UI.WebControls;
Remarque
Cette d&eacute;claration est n&eacute;cessaire pour acc&eacute;der &agrave; la classe ListItem.
3.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() qui vient d'&ecirc;tre automatiquement g&eacute;n&eacute;r&eacute;e, d&eacute;clarez et
instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
4.
Cr&eacute;ez une boucle foreach pour extraire chaque instance ListItem de la propri&eacute;t&eacute; Items de
defaultParameterValuesList.
For Each item As ListItem In defaultParameterValuesList.Items
Next
foreach(ListItem item in defaultParameterValuesList.Items)
{
}
5.
Dans la boucle foreach, cr&eacute;ez un bloc conditionnel imbriqu&eacute; qui ajoute l'instance Item &agrave; l'instance Arraylist si
la propri&eacute;t&eacute; Selected de l'instance actuelle Item a pour valeur True.
If item.Selected Then
myArrayList.Add(item.Value)
End If
if(item.Selected)
{
arrayList.Add(item.Value);
}
6.
En dehors du bloc conditionnel et de la boucle foreach, appelez la m&eacute;thode
SetCurrentValuesForParameterField() et transmettez l'instance de rapport CustomersByCity et
l'instance ArrayList.
SetCurrentValuesForParameterField(customersByCityReport, myArrayList)
SetCurrentValuesForParameterField(customersByCityReport, arrayList);
Les valeurs s&eacute;lectionn&eacute;es du contr&ocirc;le ListBox ayant &eacute;t&eacute; appliqu&eacute;es comme valeurs actuelles du champ de
param&egrave;tre, vous &ecirc;tes maintenant pr&ecirc;t &agrave; r&eacute;afficher le rapport.
410
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
Liez &agrave; nouveau l'instance de rapport CustomersByCity &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = customersByCityReport
crystalReportViewer.ReportSource = customersByCityReport;
1.5.2.5.5.3
Pour cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement de clic du
contr&ocirc;le Button de r&eacute;affichage dans un projet Windows
Proc&eacute;dure
1.
Cliquez deux fois sur le contr&ocirc;le Button de r&eacute;affichage.
Cette op&eacute;ration affiche la classe code-behind dans laquelle une m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click()
a &eacute;t&eacute; g&eacute;n&eacute;r&eacute;e automatiquement.
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click() qui vient d'&ecirc;tre automatiquement g&eacute;n&eacute;r&eacute;e, d&eacute;clarez et
instanciez une ArrayList.
Dim myArrayList As ArrayList = New ArrayList()
ArrayList arrayList = new ArrayList();
3.
Cr&eacute;ez une boucle foreach pour extraire chaque &eacute;l&eacute;ment (sous forme de cha&icirc;ne) de la propri&eacute;t&eacute; SelectedItems
de defaultParameterValuesList.
For Each item As String In defaultParameterValuesList.SelectedItems
Next
foreach(string item in defaultParameterValuesList.SelectedItems)
{
}
4.
Dans le bloc conditionnel, ajoutez l'instance cha&icirc;ne Item &agrave; l'instance ArrayList.
myArrayList.Add(item)
arrayList.Add(item);
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
411
5.
En dehors du bloc conditionnel et de la boucle foreach, appelez la m&eacute;thode
SetCurrentValuesForParameterField() et transmettez l'instance de rapport CustomersByCity et
l'instance ArrayList.
SetCurrentValuesForParameterField(customersByCityReport, myArrayList)
SetCurrentValuesForParameterField(customersByCityReport, arrayList);
Les valeurs s&eacute;lectionn&eacute;es du contr&ocirc;le ListBox ayant &eacute;t&eacute; appliqu&eacute;es comme valeurs actuelles du champ de
param&egrave;tre, vous &ecirc;tes maintenant pr&ecirc;t &agrave; r&eacute;afficher le rapport.
6.
Liez &agrave; nouveau l'instance de rapport CustomersByCity &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
myCrystalReportViewer.ReportSource = customersByCityReport
crystalReportViewer.ReportSource = customersByCityReport;
1.5.2.5.5.4
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier si le champ de param&egrave;tre a bien &eacute;t&eacute;
correctement red&eacute;fini.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, cliquez sur au moins quatre villes diff&eacute;rentes dans la liste en maintenant la touche
Ctrl enfonc&eacute;e.
5.
Cliquez sur R&eacute;afficher le rapport.
La page est recharg&eacute;e, affichant les enregistrements des clients qui vivent dans les villes s&eacute;lectionn&eacute;es dans
la liste.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
412
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;sultats
Si vous d&eacute;veloppez une application Windows, vous avez &agrave; pr&eacute;sent termin&eacute;. Si vous d&eacute;veloppez un site Web,
effectuez maintenant la proc&eacute;dure Configuration de la persistance des param&egrave;tres [page 413].
1.5.2.5.6
Configuration de la persistance des param&egrave;tres
Dans cette section, vous allez configurer la persistance (dans un tutoriel via le Web) des s&eacute;lections des champs de
param&egrave;tre effectu&eacute;es &agrave; partir du contr&ocirc;le ListBox.
Comme le montre le tutoriel Tutoriel : Persistance du mod&egrave;le d'objet ReportDocument &agrave; l'aide de Session [page
341], les modifications apport&eacute;es au mod&egrave;le d'objet ReportDocument sont perdues lorsque la page est recharg&eacute;e,
chaque fois que des utilisateurs cliquent sur des boutons de la barre d'outils CrystalReportViewer (Page suivante
et Zoom par exemple).
1.5.2.5.6.1
Pour montrer le manque de persistance des
s&eacute;lections de param&egrave;tre
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, utilisez la combinaison de touches MAJ-clic pour s&eacute;lectionner toutes les villes dans
la liste.
5.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge, puis affiche les enregistrements clients de tous les clients dans toutes les villes. Il s'agit
d'un rapport volumineux contenant de nombreuses pages.
6.
Dans la barre d'outils CrystalReportViewer, cliquez sur Page suivante.
La liste des villes s&eacute;lectionn&eacute;es n'est pas rendue persistante. La page 2 du rapport ne s'affiche pas. A la place,
les param&egrave;tres de lancement apparaissent de nouveau (Paris et Tokyo).
7.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Vous devez ajouter un code de persistance &agrave; votre application afin que les modifications apport&eacute;es au mod&egrave;le
d'objet ReportDocument soient rendues persistantes lorsque les pages Web sont recharg&eacute;es.
Pour commencer, vous allez ajouter un code de persistance &agrave; la m&eacute;thode ConfigureCrystalReports() en
ajoutant un bloc Else au bloc conditionnel Not IsPostBack. Vous allez ensuite d&eacute;finir des valeurs uniques pour
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
413
l'instance ArrayList pour l'une des deux conditions du bloc conditionnel. A l'ouverture de la page, vous allez d&eacute;finir
les valeurs par d&eacute;faut (&quot;Paris&quot; et &quot;Tokyo&quot;) dans l'instance ArrayList. Au rechargement de la page, vous allez
extraire l'instance ArrayList stock&eacute;e dans Session.
1.5.2.5.6.2
Pour ajouter un code de persistance &agrave; la m&eacute;thode
ConfigureCrystalReports()
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), coupez et collez au bas du bloc conditionnel If Not
IsPostBack les deux lignes de code permettant d'ajouter Paris et Tokyo &agrave; l'instance ArrayList.
Lorsque vous avez termin&eacute;, le bloc conditionnel doit ressembler &agrave; ceci :
If Not IsPostBack Then
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport)
defaultParameterValuesList.DataBind()
myArrayList.Add(&quot;Paris&quot;)
myArrayList.Add(&quot;Tokyo&quot;)
End If
if (!IsPostBack)
{
defaultParameterValuesList.DataSource =
GetDefaultValuesFromParameterField(customersByCityReport);
defaultParameterValuesList.DataBind();
arrayList.Add(&quot;Paris&quot;);
arrayList.Add(&quot;Tokyo&quot;);
}
2.
Ajoutez une ligne de code finale au bloc conditionnel qui affecte l'instance ArrayList &agrave; Session.
Remarque
Vous pouvez utiliser le nom de variable comme identificateur de cha&icirc;ne pour la Session ajout&eacute;e.
Session(&quot;myArrayList&quot;) = myArrayList
Session[&quot;arrayList&quot;] = arrayList;
3.
Ajoutez une condition Else au bloc conditionnel Not IsPostBack.
4.
Dans le bloc Else, extrayez l'instance ArrayList de Session, puis effectuez un cast de celle-ci en objet
ArrayList.
myArrayList = Ctype(Session(&quot;myArrayList&quot;), ArrayList)
414
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
arrayList = (ArrayList)Session[&quot;arrayList&quot;];
R&eacute;sultats
Lorsque vous avez termin&eacute;, le bloc conditionnel doit ressembler &agrave; ceci :
Ces modifications apport&eacute;es &agrave; la m&eacute;thode ConfigureCrystalReports() permettent de garantir que l'instance
actuelle ArrayList est toujours disponible pour &ecirc;tre transmise &agrave; la m&eacute;thode
SetCurrentValuesForParameterField().
Dans la section suivante, vous allez apporter deux modifications au code dans l'&eacute;v&eacute;nement de clic :
●
S&eacute;lectionner l'instance ArrayList cr&eacute;&eacute;e et l'affecter &agrave; Session.
●
Remplacer les deux derni&egrave;res lignes de code (qui configurent et affichent le rapport) par un appel &agrave; la
m&eacute;thode ConfigureCrystalReports() afin d'ex&eacute;cuter cette fonctionnalit&eacute; sur un bloc de code commun.
1.5.2.5.6.3
Pour modifier le code de la m&eacute;thode d'&eacute;v&eacute;nement
de clic selon la persistance Session
Proc&eacute;dure
1.
Supprimez les deux derni&egrave;res lignes de code suivantes dans la m&eacute;thode d'&eacute;v&eacute;nement de clic.
La premi&egrave;re ligne de code &agrave; supprimer repr&eacute;sente l'appel &agrave; la m&eacute;thode
SetCurrentValuesForParameterField(). La deuxi&egrave;me ligne de code &agrave; supprimer repr&eacute;sente le code qui
lie l'instance customersByCityReport &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer.
Dans l'&eacute;tape suivante, vous allez ajouter deux nouvelles lignes de code pour remplacer le code supprim&eacute;.
2.
Dans la m&eacute;thode d'&eacute;v&eacute;nement de clic, imm&eacute;diatement en dehors de la boucle foreach, ajoutez une ligne de
code qui affecte l'instance ArrayList &agrave; Session.
Remarque
Vous pouvez utiliser le nom de variable comme identificateur de cha&icirc;ne pour la Session ajout&eacute;e.
Session(&quot;myArrayList&quot;) = myArrayList
Session[&quot;arrayList&quot;] = arrayList;
3.
Appeler la m&eacute;thode ConfigureCrystalReports().
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
415
Cette m&eacute;thode extrait l'instance ArrayList, l'applique au rapport, puis lie le rapport au contr&ocirc;le
CrystalReportViewer.
ConfigureCrystalReports()
ConfigureCrystalReports();
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier si le champ de param&egrave;tre a bien &eacute;t&eacute;
correctement red&eacute;fini.
Remarque
Une autre m&eacute;thode consiste &agrave; rendre persistante l'instance ReportDocument. Pour apprendre &agrave; rendre
persistante l'instance ReportDocument avec Session, voir le tutoriel Tutoriel : Persistance du mod&egrave;le d'objet
ReportDocument &agrave; l'aide de Session [page 341].
1.5.2.5.6.4
Pour v&eacute;rifier si le contr&ocirc;le ListBox
defaultParameterValuesList est rempli
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, utilisez la combinaison de touches MAJ-clic pour s&eacute;lectionner toutes les villes dans
la liste.
5.
Cliquez sur R&eacute;afficher le rapport.
La page se recharge et affiche les enregistrements clients de tous les clients dans toutes les villes. Il s'agit
d'un rapport volumineux contenant de nombreuses pages.
6.
Dans la barre d'outils CrystalReportViewer, cliquez sur Page suivante.
7.
La liste des villes s&eacute;lectionn&eacute;es est d&eacute;sormais rendue persistante. La page 2 du rapport s'affiche.
8.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
416
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.5.7
discrets
Addenda : Am&eacute;liorations du code des param&egrave;tres
Vous avez r&eacute;ussi &agrave; cr&eacute;er un rapport avec une valeur de param&egrave;tre discret et une m&eacute;thode d'assistance pouvant
accepter n'importe quel ensemble de valeurs dans un format commun (ArrayList). Vous avez aussi r&eacute;ussi &agrave;
appliquer ces valeurs &agrave; un rapport en fonction d'un nom de champ de param&egrave;tre sp&eacute;cifique (constante
PARAMETER_FIELD_NAME).
Si vous avez install&eacute; Visual Studio 2005 ou version ult&eacute;rieure, ou SAP Crystal Reports Developer, vous avez acc&egrave;s
&agrave; la fonctionnalit&eacute; API am&eacute;lior&eacute;e d&eacute;finissant les param&egrave;tres discrets dans le rapport Crystal. L'API de
SAP Crystal Reports Developer permet de r&eacute;duire la quantit&eacute; de code n&eacute;cessaire &agrave; la d&eacute;finition des param&egrave;tres
discrets.
Dans les proc&eacute;dures pr&eacute;c&eacute;dentes, vous avez appris &agrave; cr&eacute;er la m&eacute;thode d'assistance
SetCurrentValuesForParameterField().
Dans ce tutoriel, vous pouvez supprimer la m&eacute;thode d'assistance et appeler &agrave; la place la m&eacute;thode
SetParameterValue() de la classe ReportDocument.
La m&eacute;thode SetParameterValue() propose les m&eacute;thodes surcharg&eacute;es suivantes :
●
SetParameterValue(int index, object value)
●
SetParameterValue(string parameterFieldName, object value)
●
SetParameterValue(string parameterFieldName, object value, string subreport)
Vous pouvez transmettre n'importe quel type d'objet dont la valeur correspond aux valeurs par d&eacute;faut du champ
du param&egrave;tre. L'objet peut &ecirc;tre une instance Array qui stocke une liste de valeurs de param&egrave;tre.
Conditions pr&eacute;requises :
●
Vous devez cr&eacute;er un projet en suivant les instructions de la section Tutoriel : Lecture et d&eacute;finition des
param&egrave;tres discrets [page 389].
Toutefois, la section D&eacute;finition manuelle des param&egrave;tres dans le code [page 397] n&eacute;cessite uniquement la
cr&eacute;ation de la constante PARAMETER_FIELD_NAME. Vous n'avez pas besoin de cr&eacute;er la m&eacute;thode
d'assistance SetCurrentValuesForParameterField().
●
Si vous avez d&eacute;j&agrave; cr&eacute;&eacute; un projet &agrave; l'aide des instructions de la section Tutoriel : Lecture et d&eacute;finition des
param&egrave;tres discrets [page 389], supprimez la m&eacute;thode d'assistance SetCurrentValuesForParameterField() et
l'appel dans la m&eacute;thode ConfigureCrystalReports().
1.5.2.5.7.1
Pour utiliser la m&eacute;thode SetParameterValue()
avec des param&egrave;tres discrets
Proc&eacute;dure
1.
Ouvrez le projet termin&eacute; de ce tutoriel.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Dans la m&eacute;thode ConfigureCrystalReports(), au-dessus de la ligne qui lie le rapport &agrave; la propri&eacute;t&eacute;
ReportSource du contr&ocirc;le CrystalReportViewer, appelez la m&eacute;thode SetParameterValue() &agrave; partir de la
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
417
classe CustomerByCity. Transmettez le nom de champ et les valeurs de param&egrave;tre d'une instance Array &agrave; la
m&eacute;thode.
customersByCityReport.SetParameterValue(PARAMETER_FIELD_NAME,
arrayList.ToArray())
customersByCityReport.SetParameterValue(PARAMETER_FIELD_NAME,
arrayList.ToArray());
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour lire et d&eacute;finir des param&egrave;tres discrets.
1.5.2.6
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres avec
un sous-rapport
Dans ce tutoriel, vous allez traiter un probl&egrave;me suppl&eacute;mentaire : que faire si un rapport n&eacute;cessitant des
param&egrave;tres contient un sous-rapport n&eacute;cessitant des param&egrave;tres diff&eacute;rents ?
Remarque
Pour suivre ce tutoriel, vous devez terminer le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
discrets [page 389].
Introduction
Dans le tutoriel pr&eacute;c&eacute;dent, Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 389], vous avez appris &agrave;
cr&eacute;er un rapport avec un param&egrave;tre et &agrave; cr&eacute;er un code permettant de d&eacute;finir ce param&egrave;tre au moment de
l'ex&eacute;cution, en utilisant chaque fois des valeurs de param&egrave;tres cod&eacute;es en dur et des valeurs de param&egrave;tres
transmises &agrave; partir d'un contr&ocirc;le ListBox.
Dans ce tutoriel, vous allez apprendre &agrave; ajouter des param&egrave;tres &agrave; un sous-rapport.
Vous devez apporter quatre modifications au projet que vous avez cr&eacute;&eacute; lors de la proc&eacute;dure Tutoriel : Lecture et
d&eacute;finition des param&egrave;tres discrets [page 389] :
●
Vous ajoutez un sous-rapport au rapport d'origine.
Ce sous-rapport d&eacute;signe la table Commandes de la base de donn&eacute;es Xtreme. La table Commandes est li&eacute;e &agrave;
la table Clients utilis&eacute;e dans le tutoriel pr&eacute;c&eacute;dent par la cl&eacute; externe ID client.
●
Vous ajoutez un param&egrave;tre de plage au sous-rapport qui effectue un filtrage selon une plage de dates de
commande.
●
Vous ajoutez deux contr&ocirc;les Text au formulaire : orderStartDate et orderEndDate afin de d&eacute;finir la plage des
dates de commande au moment de l'ex&eacute;cution.
418
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Vous ajoutez une nouvelle m&eacute;thode.
Cette m&eacute;thode cr&eacute;e une instance ParameterRangeValue contenant les valeurs startDate et endDate, puis
transmet cette instance ParameterRangeValue au param&egrave;tre de plage dans le sous-rapport.
Une fois le tutoriel termin&eacute;, vous pouvez filtrer les valeurs affich&eacute;es dans le rapport au moment de l'ex&eacute;cution. Le
code que vous ajoutez limite le nombre de villes affich&eacute;es dans le rapport principal ainsi que la plage de dates de
commande qui appara&icirc;tront dans le sous-rapport.
Ce tutoriel peut &eacute;galement &ecirc;tre effectu&eacute; avec des classes du mod&egrave;le d'objet CrystalReportViewer, bien qu'il soit
recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_ParametersSubrpt
●
Projet Windows C# : CS_Win_RDObjMod_ParametersSubrpt
●
Site Web Visual Basic : VB_Web_RDObjMod_ParametersSubrpt
●
Projet Windows Visual Basic : VB_Win_RDObjMod_ParametersSubrpt
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
Tutoriel : Lecture et d&eacute;finition des param&egrave;tres de plage d'un sous-rapport [page 277]
Dans ce tutoriel, vous allez traiter un probl&egrave;me suppl&eacute;mentaire : que faire si un rapport contient un sousrapport n&eacute;cessitant des param&egrave;tres diff&eacute;rents ?
R&eacute;pertoire d'exemples de rapports [page 15]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
419
1.5.2.6.1
Ajout d'un sous-rapport au rapport d'origine
Pour commencer, vous ajoutez un sous-rapport au rapport d'origine.
1.5.2.6.1.1
Pour ajouter un sous-rapport
Proc&eacute;dure
1.
Ouvrez le projet que vous avez cr&eacute;&eacute; dans le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
discrets [page 389].
2.
Dans l'Explorateur de solutions, cliquez deux fois sur le rapport CustomersByCity pour l'ouvrir.
3.
Cliquez avec le bouton droit de la souris sur la barre grise D&eacute;tails et s&eacute;lectionnez Ins&eacute;rer une section en
dessous.
4.
Cliquez avec le bouton droit de la souris sur la nouvelle section D&eacute;tails b que vous avez cr&eacute;&eacute;e, s&eacute;lectionnez
Ins&eacute;rer, puis cliquez sur Sous-rapport.
Un carr&eacute; gris encadre le curseur de la souris.
5.
Faites glisser le rectangle gris sur la nouvelle section D&eacute;tails b, puis rel&acirc;chez le bouton de la souris.
6.
Dans l'onglet Sous-rapport de la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez Cr&eacute;er un sous-rapport
&agrave; l'aide de l'Assistant de cr&eacute;ation de rapports.
Remarque
La bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport inclut d'autres options permettant de s&eacute;lectionner un rapport
existant et des sous-rapports &agrave; la demande. Pour en savoir plus sur ces fonctionnalit&eacute;s, voir Onglet Sousrapport (bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport) [page 939].
7.
Dans le champ Nom du nouveau rapport, saisissez CustomerOrders.
8.
Cliquez sur Assistant de cr&eacute;ation de rapports...
9.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
10. Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
Le dossier contient le serveur de base de donn&eacute;es qui a &eacute;t&eacute; configur&eacute; pour le rapport lorsque ce dernier a &eacute;t&eacute;
cr&eacute;&eacute;.
Remarque
Si le serveur ne s'affiche pas, suivez les instructions du tutoriel pr&eacute;c&eacute;dent pour vous connecter &agrave; la base de
donn&eacute;es Xtreme.
11. S&eacute;lectionnez la table Commandes et cliquez sur le bouton &gt; pour la d&eacute;placer dans le panneau Tables
s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
12. Dans le panneau Champs disponibles, s&eacute;lectionnez ID commande, Date de commande, Date d'exp&eacute;dition et
Transporteur.
13. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Terminer.
420
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
14. Dans la bo&icirc;te de dialogue Ins&eacute;rer un sous-rapport, s&eacute;lectionnez l'onglet Mise en relation.
15. Dans la liste Champs disponibles du panneau Champs du rapport principal &agrave; mettre en relation, d&eacute;veloppez la
table Clients, s&eacute;lectionnez ID client, puis cliquez sur le bouton &gt;.
16. Dans le panneau Mise en relation du champ Clients.ID client qui s'affiche, laissez les s&eacute;lections par d&eacute;faut.
Ces s&eacute;lections de param&egrave;tres et de donn&eacute;es g&eacute;n&egrave;rent automatiquement une relation entre le rapport
principal et le sous-rapport.
17. Cliquez sur OK.
Le nouveau sous-rapport, CustomerOrders, s'affiche dans la section D&eacute;tails b du rapport principal.
Remarque
Lorsque vous ajoutez un sous-rapport &agrave; la section D&eacute;tails, le sous-rapport s'affiche pour chaque ligne, ce
qui influe sur les performances du rapport. Si vous ne souhaitez pas obtenir des informations aussi
d&eacute;taill&eacute;es, placez le sous-rapport dans une section Groupe plut&ocirc;t qu'une section D&eacute;tails.
R&eacute;sultats
Vous pouvez &agrave; pr&eacute;sent v&eacute;rifier les param&egrave;tres du sous-rapport.
1.5.2.6.1.2
Pour v&eacute;rifier les param&egrave;tres du sous-rapport
Proc&eacute;dure
1.
Dans la section D&eacute;tails du rapport, cliquez deux fois sur le sous-rapport CustomerOrders pour l'afficher.
Des boutons de navigation apparaissent au bas de la fen&ecirc;tre du concepteur &agrave; la fois pour le rapport principal
et le sous-rapport CustomerOrders.
2.
Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/D&eacute;sactiver l'affichage du champ dans la barre
d'outils Crystal Reports.
Remarque
Vous pouvez &eacute;galement afficher l'Explorateur de champs en ouvrant le menu Crystal Reports, puis en
cliquant sur Explorateur de champs.
3.
Dans l'Explorateur de champs, d&eacute;veloppez Champs de param&egrave;tre.
4.
V&eacute;rifiez que le champ de param&egrave;tre Pm-Clients.ID Client a &eacute;t&eacute; automatiquement g&eacute;n&eacute;r&eacute; lorsque le sousrapport a &eacute;t&eacute; reli&eacute;.
5.
Dans la barre d'outils, cliquez sur Expert S&eacute;lection.
6.
Dans la bo&icirc;te de dialogue Expert S&eacute;lection, v&eacute;rifiez que le crit&egrave;re Commandes.ID Client est &eacute;gal &agrave; {PmClients.ID Client} est d&eacute;fini, puis cliquez sur OK.
7.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
421
R&eacute;sultats
Vous avez r&eacute;ussi &agrave; ajouter un sous-rapport CustomerOrders au rapport CustomersByCity. Dans la section
suivante, vous allez ajouter un param&egrave;tre OrderDateRange au sous-rapport.
1.5.2.6.1.3
Pour ajouter un param&egrave;tre OrderDateRange au
sous-rapport
Proc&eacute;dure
1.
Dans l'Explorateur de champs, cliquez avec le bouton droit de la souris sur Champs de param&egrave;tre, puis
s&eacute;lectionnez Nouveau.
2.
Dans la bo&icirc;te de dialogue Cr&eacute;er un champ de param&egrave;tre :
○
Attribuez &agrave; Nom la valeur OrderDateRange.
○
Attribuez &agrave; Type de valeur la valeur Date.
○
Attribuez &agrave; Texte de l'invite la valeur Sp&eacute;cifiez une plage de dates des commandes &agrave; afficher.
○
Attribuez au param&egrave;tre Options une seule s&eacute;lection, la valeur Valeur(s) de plage.
3.
Cliquez sur OK.
4.
Dans la barre d'outils, cliquez sur Expert S&eacute;lection.
5.
Cliquez sur l'onglet Nouveau.
6.
Dans la bo&icirc;te de dialogue Choisir un champ, d&eacute;veloppez la table Commandes, s&eacute;lectionnez Date de
commande, puis cliquez sur OK.
7.
Dans le nouvel onglet Commandes.Date de commande s&eacute;lectionnez formule dans la liste d&eacute;roulante des
crit&egrave;res.
8.
Saisissez la formule suivante :{Commandes.Date de commande} in {?OrderDateRange}.
9.
Cliquez sur OK.
10. Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous avez r&eacute;ussi &agrave; ajouter un param&egrave;tre OrderDateRange au sous-rapport et &agrave; l'associer &agrave; la colonne
Commandes.Date de commande. Dans la section suivante, vous allez ajouter un code afin de d&eacute;signer le
param&egrave;tre OrderDateRange dans le sous-rapport.
1.5.2.6.2
Ajout du code de param&egrave;tre au sous-rapport
Vous allez &agrave; pr&eacute;sent ajouter le code de param&egrave;tre du sous-rapport &agrave; la classe code-behind. Vous commencez par
cr&eacute;er une m&eacute;thode d'assistance priv&eacute;e SetDateRangeForOrders().
422
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.6.2.1
Pour cr&eacute;er et coder la m&eacute;thode
SetDateRangeForOrders()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Au d&eacute;but de la classe, ajoutez deux nouvelles constantes sous la constante PARAMETER_FIELD_NAME
existante d&eacute;finie dans le tutoriel pr&eacute;c&eacute;dent.
Private Const SUBREPORT_PARAMETER_FIELD_NAME As String = &quot;OrderDateRange&quot;
Private Const SUBREPORT_NAME As String = &quot;CustomerOrders&quot;
private const string SUBREPORT_PARAMETER_FIELD_NAME = &quot;OrderDateRange&quot;;
private const string SUBREPORT_NAME = &quot;CustomerOrders&quot;;
4.
Dans la partie inf&eacute;rieure de la classe, cr&eacute;ez une m&eacute;thode priv&eacute;e appel&eacute;e SetDateRangeForOrders() avec
les trois param&egrave;tres suivants : ReportDocument, une cha&icirc;ne startDate et une cha&icirc;ne endDate.
Private Sub SetDateRangeForOrders(ByVal myReportDocument As ReportDocument,
ByVal startDate As String, ByVal endDate As String)
End Sub
private void SetDateRangeForOrders(ReportDocument reportDocument, string
startDate, string endDate)
{
}
5.
Dans cette m&eacute;thode, d&eacute;clarez et instanciez la classe ParameterRangeValue.
Dim myParameterRangeValue As ParameterRangeValue = New
ParameterRangeValue()
ParameterRangeValue parameterRangeValue = new
ParameterRangeValue();
Remarque
Pour que la classe ParameterRangeValue soit accessible, vous devez inclure une instruction &quot;Imports&quot;
[Visual Basic] ou &quot;using&quot; [C#] dans la partie sup&eacute;rieure de la classe code-behind pour l'espace de
noms CrystalDecisions.Shared. (Vous avez ajout&eacute; cette d&eacute;claration dans la proc&eacute;dure Configuration d'un
projet [page 15].)
6.
Attribuez &agrave; la propri&eacute;t&eacute; StartValue de l'instance ParameterRangeValue le param&egrave;tre de m&eacute;thode startDate.
myParameterRangeValue.StartValue = startDate
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
423
parameterRangeValue.StartValue = startDate;
Remarque
Les propri&eacute;t&eacute;s StartValue et EndValue de la classe ParameterRangeValue acceptent les valeurs de type
Objet. Ce type g&eacute;n&eacute;rique permet de transmettre la valeur de plage sous plusieurs formes, y compris texte,
nombre, date, devise ou heure.
7.
Attribuez &agrave; la propri&eacute;t&eacute; EndValue de l'instance ParameterRangeValue le param&egrave;tre de m&eacute;thode endDate.
myParameterRangeValue.EndValue = endDate
parameterRangeValue.EndValue = endDate;
8.
D&eacute;finissez les limites inf&eacute;rieures et sup&eacute;rieures afin de les inclure.
myParameterRangeValue.LowerBoundType = RangeBoundType.BoundInclusive
myParameterRangeValue.UpperBoundType = RangeBoundType.BoundInclusive
parameterRangeValue.LowerBoundType = RangeBoundType.BoundInclusive;
parameterRangeValue.UpperBoundType = RangeBoundType.BoundInclusive;
Remarque
Pour le param&egrave;tre BoundInclusive, les valeurs de plage sup&eacute;rieures et inf&eacute;rieures sont incluses dans la
plage.
Vous allez &agrave; pr&eacute;sent affecter l'instance ParameterRangeValue au param&egrave;tre du sous-rapport.
9.
Extrayez l'objet ParameterFieldDefinitions provenant de la propri&eacute;t&eacute; DataDefinition de l'instance
ReportDocument.
Remarque
ParameterFieldDefinitions est une classe index&eacute;e contenant des instances de la classe
ParameterFieldDefinition.
Dim myParameterFieldDefinitions As ParameterFieldDefinitions =
myReportDocument.DataDefinition.ParameterFields
ParameterFieldDefinitions parameterFieldDefinitions =
reportDocument.DataDefinition.ParameterFields;
10. Extrayez l'instance ParameterFieldDefinition de la classe index&eacute;e ParameterFieldDefinitions
bas&eacute;e sur les deux valeurs index&eacute;es suivantes : le nom du champ de param&egrave;tre du sous-rapport et le nom du
sous-rapport. Transmettez les deux valeurs de constante que vous avez d&eacute;clar&eacute;es au d&eacute;but de la classe.
Dim myParameterFieldDefinition As ParameterFieldDefinition =
424
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
myParameterFieldDefinitions(SUBREPORT_PARAMETER_FIELD_NAME,
SUBREPORT_NAME)
ParameterFieldDefinition parameterFieldDefinition =
parameterFieldDefinitions[SUBREPORT_PARAMETER_FIELD_NAME,
SUBREPORT_NAME];
11. Appelez la m&eacute;thode Clear() de la propri&eacute;t&eacute; CurrentValues de l'instance ParameterFieldDefinition
afin de supprimer les &eacute;ventuelles valeurs existantes de la propri&eacute;t&eacute; CurrentValues.
myParameterFieldDefinition.CurrentValues.Clear()
parameterFieldDefinition.CurrentValues.Clear();
12. Ajoutez l'instance ParameterRangeValue que vous venez de cr&eacute;er &agrave; la propri&eacute;t&eacute; CurrentValues de
l'instance ParameterFieldDefinition.
myParameterFieldDefinition.CurrentValues.Add(myParameterRangeValue)
parameterFieldDefinition.CurrentValues.Add(parameterRangeValue);
13. Appelez la m&eacute;thode ApplyCurrentValues() en lui transmettant la propri&eacute;t&eacute; CurrentValues de l'instance
ParameterFieldDefinition.
myParameterFieldDefinition.ApplyCurrentValues(myParameterFieldDefinition.CurrentV
alues)
parameterFieldDefinition.ApplyCurrentValues(parameterFieldDefinition.CurrentValue
s);
R&eacute;sultats
Cette proc&eacute;dure a d&eacute;fini des valeurs de date de d&eacute;but et de fin dans une instance ParameterRangeValue et les a
transmises au param&egrave;tre OrderDateRange du sous-rapport CustomerOrders.
1.5.2.6.3
Ajout de contr&ocirc;les TextBox pour contenir les
valeurs de param&egrave;tres de plage
Dans cette section, vous allez ajouter deux contr&ocirc;les TextBox pour transmettre au param&egrave;tre de plage
OrderDateRange des valeurs de date de d&eacute;but et de date de fin au moment de l'ex&eacute;cution dans le sous-rapport
CustomerOrders.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
425
Remarque
Si vous impl&eacute;mentez ce tutoriel dans un site Web, la persistance des valeurs de date que les utilisateurs
saisissent dans les zones de texte est conserv&eacute;e par ViewState.
1.5.2.6.3.1
Pour cr&eacute;er et configurer un contr&ocirc;le Button de
r&eacute;affichage sur le formulaire
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez entre le contr&ocirc;le ListBox et le contr&ocirc;le Button.
b) Appuyez trois fois sur ENTREE pour ins&eacute;rer deux lignes entre le contr&ocirc;le ListBox et le contr&ocirc;le Button.
c) Sur la premi&egrave;re ligne cr&eacute;&eacute;e sous le contr&ocirc;le ListBox, saisissez &quot;Date de d&eacute;but de la commande&quot;.
d) Sur la seconde ligne cr&eacute;&eacute;e sous le contr&ocirc;le ListBox, saisissez &quot;Date de fin de la commande&quot;.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Dans la bo&icirc;te &agrave; outils, faites glisser deux contr&ocirc;les Label &agrave; droite du contr&ocirc;le ListBox. Placez une &eacute;tiquette
sur l'autre, en positionnant les deux &eacute;tiquettes au-dessus du contr&ocirc;le Button.
b) S&eacute;lectionnez le premier contr&ocirc;le Label. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur
&quot;Date de d&eacute;but de la commande&quot;.
c) S&eacute;lectionnez le second contr&ocirc;le Label. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur
&quot;Date de fin de la commande&quot;.
5.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite de &quot;Date de d&eacute;but de la commande&quot;.
6.
Cliquez sur le contr&ocirc;le TextBox pour le s&eacute;lectionner.
7.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur &quot;orderStartDate.&quot;
8.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite de &quot;Date de fin de la commande.&quot;
9.
Cliquez sur le contr&ocirc;le TextBox pour le s&eacute;lectionner.
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID (ou Name) la valeur &quot;orderEndDate&quot;.
11. Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.2.6.4
Modification des m&eacute;thodes d'appel du sous-rapport
Vous devez &agrave; pr&eacute;sent modifier la m&eacute;thode ConfigureCrystalReports() et la m&eacute;thode d'&eacute;v&eacute;nement
redisplay_Click() pour recevoir des informations de ces contr&ocirc;les TextBox, les appliquer &agrave; la m&eacute;thode
SetDateRangeForOrders() et traiter les informations de param&egrave;tre pour les sous-rapports.
Dans le tutoriel pr&eacute;c&eacute;dent, Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 389], vous avez con&ccedil;u ces
m&eacute;thodes de deux fa&ccedil;ons diff&eacute;rentes si vous avez inclus la persistance Session.
426
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Les projets Windows ne n&eacute;cessitent aucune persistance Session. Les sites Web n&eacute;cessitent g&eacute;n&eacute;ralement la
persistance Session.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous. Modifiez les m&eacute;thodes qui excluent la
persistance Session ou les m&eacute;thodes qui incluent la persistance Session :
1.5.2.6.4.1
Modification des m&eacute;thodes qui excluent la
persistance Session
Si vous avez cr&eacute;&eacute; le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 389] et exclu
la persistance Session, effectuez les proc&eacute;dures suivantes. Si vous souhaitez inclure la persistance de Session,
voir Modification des m&eacute;thodes qui incluent la persistance Session [page 428].
1.5.2.6.4.1.1
Pour modifier la m&eacute;thode
ConfigureCrystalReports() excluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s les lignes
qui affectent &quot;Paris&quot; et &quot;Tokyo&quot; comme variables ArrayList.
2.
Dans les sauts de ligne, d&eacute;clarez et d&eacute;finissez des valeurs en code dur pour les deux variables cha&icirc;ne,
startDate et endDate.
Dim startDate As String = &quot;8/1/1997&quot;
Dim endDate As String = &quot;8/31/1997&quot;
string startDate = &quot;8/1/1997&quot;;
string endDate = &quot;8/31/1997&quot;;
3.
Cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de la ligne qui lie le rapport au contr&ocirc;le
CrystalReportViewer.
4.
Dans les sauts de ligne, saisissez un appel &agrave; la m&eacute;thode SetDateRangeForOrders(), puis transmettez le
rapport CustomersByCity et les variables startDate et endDate.
SetDateRangeForOrders(customersByCityReport, startDate, endDate)
SetDateRangeForOrders(customersByCityReport, startDate, endDate);
Cette proc&eacute;dure est suivie du code d'origine qui lie le rapport au contr&ocirc;le CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
427
5.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Modifiez ensuite la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click.
1.5.2.6.4.1.2
Pour modifier la m&eacute;thode redisplay_Click()
excluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus
de la ligne qui lie le rapport au contr&ocirc;le CrystalReportViewer.
2.
Dans les sauts de ligne, d&eacute;clarez et d&eacute;finissez les valeurs des deux variables cha&icirc;ne startDate et endDate &agrave;
partir des contr&ocirc;les TextBox que vous avez ajout&eacute;s au Web Form ou Windows Form.
Dim startDate As String = orderStartDate.Text
Dim endDate As String = orderEndDate.Text
string startDate = orderStartDate.Text;
string endDate = orderEndDate.Text;
3.
Saisissez un appel &agrave; la m&eacute;thode SetDateRangeForOrders(), puis transmettez le rapport CustomersByCity
et les variables startDate et endDate.
SetDateRangeForOrders(customersByCityReport, startDate, endDate)
SetDateRangeForOrders(customersByCityReport, startDate, endDate);
4.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
1.5.2.6.4.2
Modification des m&eacute;thodes qui incluent la
persistance Session
Si vous avez cr&eacute;&eacute; le tutoriel pr&eacute;c&eacute;dent Tutoriel : Lecture et d&eacute;finition des param&egrave;tres discrets [page 389] et inclus
la persistance Session, effectuez les proc&eacute;dures suivantes. Sinon, effectuez la proc&eacute;dure Modification des
m&eacute;thodes qui excluent la persistance Session [page 427].
428
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.6.4.2.1
Pour modifier la m&eacute;thode
ConfigureCrystalReports() incluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la ligne
qui d&eacute;clare et instancie ArrayList.
2.
Dans les sauts de ligne, d&eacute;clarez deux variables cha&icirc;ne, startDate et endDate.
Dim startDate As String
Dim endDate As String
string startDate;
string endDate;
3.
Dans le bloc conditionnel Not IsPostBack, saisissez des valeurs par d&eacute;faut pour les variables startDate et
endDate.
startDate = &quot;8/1/1997&quot;
endDate = &quot;8/31/1997&quot;
startDate = &quot;8/1/1997&quot;;
endDate = &quot;8/31/1997&quot;;
4.
Dans le bloc conditionnel Not IsPostBack, affectez les variables startDate et endDate &agrave; Session.
Session(&quot;startDate&quot;) = startDate
Session(&quot;endDate&quot;) = endDate
Session[&quot;startDate&quot;] = startDate;
Session[&quot;endDate&quot;] = endDate;
5.
Dans le bloc Else, apr&egrave;s l'extraction de l'instance ArrayList de Session, extrayez les variables startDate et
endDate de Session.
startDate = Session(&quot;startDate&quot;).ToString()
endDate = Session(&quot;endDate&quot;).ToString()
startDate = Session[&quot;startDate&quot;].ToString();
endDate = Session[&quot;endDate&quot;].ToString();
Cette approche permet d'atteindre la fin du bloc avec les variables de date affect&eacute;es dans les deux cas. Cette
m&eacute;thode suit la logique parall&egrave;le de l'affectation de la variable ArrayList que vous avez configur&eacute;e dans le
tutoriel pr&eacute;c&eacute;dent.
6.
Cr&eacute;ez plusieurs sauts de ligne dans le code au-dessus de la ligne qui lie le rapport au contr&ocirc;le
CrystalReportViewer.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
429
7.
Dans ces nouveaux sauts de ligne, saisissez un appel &agrave; la m&eacute;thode SetDateRangeForOrders(), puis
transmettez le rapport CustomersByCity et les variables startDate et endDate.
SetDateRangeForOrders(customersByCityReport, startDate, endDate)
SetDateRangeForOrders(customersByCityReport, startDate, endDate);
Cette proc&eacute;dure est suivie du code d'origine qui lie le rapport au contr&ocirc;le CrystalReportViewer.
8.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Modifiez ensuite la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click.
1.5.2.6.4.2.2
Pour modifier la m&eacute;thode redisplay_Click()
incluant la persistance Session
Proc&eacute;dure
1.
Dans la m&eacute;thode d'&eacute;v&eacute;nement redisplay_Click(), cr&eacute;ez plusieurs sauts de ligne dans le code apr&egrave;s la
ligne qui affecte l'instance ArrayList &agrave; Session.
2.
Dans les sauts de ligne, affectez la propri&eacute;t&eacute; Text des contr&ocirc;les TextBox orderStartDate et orderEndDate aux
variables Session.
Session(&quot;startDate&quot;) = orderStartDate.Text
Session(&quot;endDate&quot;) = orderEndDate.Text
Session[&quot;startDate&quot;] = orderStartDate.Text;
Session[&quot;endDate&quot;] = orderEndDate.Text;
3.
Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
Ces valeurs Session startDate et endDate sont &agrave; pr&eacute;sent extraites et appliqu&eacute;es lors de l'appel de la m&eacute;thode
ConfigureCrystalReports().
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour v&eacute;rifier que les valeurs TextBox red&eacute;finissent le
param&egrave;tre de plage dans le sous-rapport. w
430
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.6.5
V&eacute;rification du param&egrave;tre du sous-rapport
Vous allez &agrave; pr&eacute;sent v&eacute;rifier le param&egrave;tre du sous-rapport &agrave; partir des valeurs TextBox.
1.5.2.6.5.1
Pour v&eacute;rifier le param&egrave;tre du sous-rapport
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Dans le contr&ocirc;le ListBox, cliquez sur au moins quatre villes diff&eacute;rentes dans la liste en maintenant la touche
Ctrl enfonc&eacute;e.
5.
Dans le contr&ocirc;le TextBox startDate, saisissez &quot;1/1/1997&quot;.
6.
Dans le contr&ocirc;le TextBox endDate , saisissez &quot;31/12/1997&quot;.
7.
Cliquez sur le bouton R&eacute;afficher le rapport.
La page se recharge et affiche les enregistrements des clients qui vivent dans les villes que vous venez de
s&eacute;lectionner dans la liste, ainsi qu'un sous-rapport indiquant les commandes correspondant &agrave; la plage de
dates sp&eacute;cifi&eacute;es ci-dessus.
8.
Dans le contr&ocirc;le CrystalReportViewer, augmentez le facteur de zoom &agrave; 125 %.
La page se recharge avec un facteur de zoom de 125 %. Les valeurs s&eacute;lectionn&eacute;es &agrave; la fois pour les villes et la
plage des dates de commande sont rendues persistantes.
9.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.6.6
Addenda : Am&eacute;liorations du code des param&egrave;tres
de plage pour des sous-rapports
Vous avez r&eacute;ussi &agrave; modifier votre projet de tutoriel pour utiliser un rapport contenant un sous-rapport, ainsi qu'&agrave;
d&eacute;finir une plage de dates de commande selon le param&egrave;tre de plage cr&eacute;&eacute; dans le sous-rapport. Dans cet
addenda, vous allez apprendre &agrave; lire et &agrave; d&eacute;finir des param&egrave;tres d'un sous-rapport avec des fonctionnalit&eacute;s API
am&eacute;lior&eacute;es.
Dans les &eacute;tapes pr&eacute;c&eacute;dentes, vous avez appris &agrave; cr&eacute;er la m&eacute;thode d'assistance SetDateRangeForOrders() qui
utilise les classes ParameterFieldDefinitions et ParameterFieldDefinition.
Dans ce tutoriel, vous devez supprimer les lignes de code utilisant les classes ParameterFieldDefinitions et
ParameterFieldDefinition. Vous apprendrez ensuite &agrave; utiliser les classes ParameterFields et
ParameterField des fonctionnalit&eacute;s API am&eacute;lior&eacute;es de SAP Crystal Reports pour coder la m&eacute;thode
SetDateRangeForOrders().
Remarque
Les fonctionnalit&eacute;s API am&eacute;lior&eacute;es incluent la m&eacute;thode SetParameterValue(string
parameterFieldName, object value, string subreport) pour les sous-rapports avec des champs de
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
431
param&egrave;tre discret. La m&eacute;thode SetParameterValue() ne peut donc pas &ecirc;tre utilis&eacute;e dans ce tutoriel, car le
sous-rapport comporte un param&egrave;tre de plage.
1.5.2.6.6.1
Pour utiliser les fonctionnalit&eacute;s API am&eacute;lior&eacute;es
de SAP Crystal Reports pour les sous-rapports avec des
param&egrave;tres de plage
Pr&eacute;requis
Vous devez cr&eacute;er un projet bas&eacute; sur les instructions de la section Tutoriel : Lecture et d&eacute;finition des param&egrave;tres
avec un sous-rapport [page 418].
Proc&eacute;dure
1.
Ouvrez le projet termin&eacute; de ce tutoriel.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Dans la m&eacute;thode SetDateRangeForOrders(), supprimez les lignes de code qui utilisent les classes
ParameterFieldDefinitions ou ParameterFieldDefinition. Supprimez les lignes de code suivantes :
Dim myParameterFieldDefinitions As ParameterFieldDefinitions =
myReportDocument.DataDefinition.ParameterFields
Dim myParameterFieldDefinition As ParameterFieldDefinition =
myParameterFieldDefinitions(SUBREPORT_PARAMETER_FIELD_NAME, SUBREPORT_NAME)
myParameterFieldDefinition.CurrentValues.Clear()
myParameterFieldDefinition.CurrentValues.Add(myParameterRangeValue)
myParameterFieldDefinition.ApplyCurrentValues(myParameterFieldDefinition.CurrentV
alues)
ParameterFieldDefinitions parameterFieldDefinitions =
reportDocument.DataDefinition.ParameterFields;
ParameterFieldDefinition parameterFieldDefinition =
parameterFieldDefinitions[SUBREPORT_PARAMETER_FIELD_NAME, SUBREPORT_NAME];
parameterFieldDefinition.CurrentValues.Clear();
parameterFieldDefinition.CurrentValues.Add(parameterRangeValue);
parameterFieldDefinition.ApplyCurrentValues(parameterFieldDefinition.CurrentValue
s);
Dans l'&eacute;tape suivante, vous allez ajouter les nouvelles m&eacute;thodes API de SAP Crystal Reports &agrave; la m&eacute;thode
SetDateRangeForOrders(), apr&egrave;s le code d&eacute;finissant le type de limite de plage.
5.
Dans la m&eacute;thode SetDateRangeForOrders(), extrayez l'instance ParameterFields &agrave; partir de la propri&eacute;t&eacute;
ParameterFields de l'instance ReportDocument.
Dim myParameterFields As ParameterFields = reportDocument.ParameterFields
432
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
ParameterFields parameterFields = reportDocument.ParameterFields;
6.
Extrayez l'instance ParameterField de la classe index&eacute;e ParameterFields, bas&eacute;e sur les deux valeurs index&eacute;es
suivantes : le nom du champ de param&egrave;tre du sous-rapport et le nom du sous-rapport. Transmettez les deux
valeurs de constante que vous avez d&eacute;clar&eacute;es au d&eacute;but de la classe.
Dim myParameterField As ParameterField =
myParameterFields(SUBREPORT_PARAMETER_FIELD_NAME, SUBREPORT_NAME)
ParameterField parameterField = parameterFields[SUBREPORT_PARAMETER_FIELD_NAME,
SUBREPORT_NAME];
7.
Appelez la m&eacute;thode Clear() de la propri&eacute;t&eacute; CurrentValues de l'instance ParameterField afin de supprimer
les &eacute;ventuelles valeurs existantes de la propri&eacute;t&eacute; CurrentValues.
myParameterField.CurrentValues.Clear()
parameterField.CurrentValues.Clear();
8.
Ajoutez l'instance ParameterRangeValue que vous venez de cr&eacute;er &agrave; la propri&eacute;t&eacute; CurrentValues de l'instance
ParameterField.
myParameterField.CurrentValues.Add(myParameterRangeValue)
parameterField.CurrentValues.Add(parameterRangeValue);
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour lire et d&eacute;finir des param&egrave;tres de plage pour un
sous-rapport.
1.5.2.7
Tutoriel : Exportation dans plusieurs formats
Dans ce tutoriel, vous allez apprendre &agrave; exporter le rapport par programmation.
Introduction
Dans ce tutoriel, vous allez apprendre &agrave; exporter le rapport par programmation. SAP Crystal Reports permet
d'exporter vers un grand nombre de formats. Les options disponibles d&eacute;pendent de la version de
SAP Crystal Reports install&eacute;e.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
433
Toutes les versions de SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio prennent en charge
les options d'exportation suivantes :
●
SAP Crystal Reports (RPT)
●
SAP Crystal Reports Read-Only (RPTR)
●
PDF
●
Rich Text Format (RTF)
●
Microsoft Word (97-2003)
●
Microsoft Excel (97-2003)
●
Microsoft Excel (97-2003) Donn&eacute;es uniquement
●
Microsoft Excel (2007) Donn&eacute;es uniquement
●
HTML 4.0
SAP Crystal Reports Developer prend en charge les formats suppl&eacute;mentaires suivants :
●
Valeurs s&eacute;par&eacute;es par des virgules (CSV)
●
Microsoft Word modifiable (RTF)
●
Texte s&eacute;par&eacute; par des tabulations (TTX)
●
Texte
Vous pouvez s&eacute;lectionner n'importe lequel de ces formats ; cliquez sur le bouton Exporter du contr&ocirc;le
CrystalReportViewer, puis exportez un rapport au format s&eacute;lectionn&eacute; vers votre ordinateur local qui ex&eacute;cute
SAP Crystal Reports dans une application Web ou Windows.
Vous pouvez &eacute;galement exporter des rapports par programmation vers des r&eacute;pertoires sp&eacute;cifiques sur un
serveur Web local ou un ordinateur utilisant Windows.
Pour commencer ce tutoriel, vous allez ajouter un contr&ocirc;le DropDownList &agrave; votre Web Form ou Windows Form,
puis le remplir avec les valeurs de l'&eacute;num&eacute;ration ExportFormatType dans l'espace de noms
CrystalDecisions.Shared.
Vous allez ensuite cr&eacute;er trois m&eacute;thodes d'assistance priv&eacute;es contenant la fonctionnalit&eacute; d'exportation et
effectuant la configuration sp&eacute;cifique de chaque format d'exportation.
Enfin, vous allez cr&eacute;er une m&eacute;thode d'&eacute;v&eacute;nement de clic &agrave; partir d'un contr&ocirc;le Button sur le Web Form ou le
Windows Form et appeler les trois m&eacute;thodes d'assistance priv&eacute;es ex&eacute;cutant l'exportation.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_Export
●
Projets Windows C# : CS_Win_RDObjMod_Export
●
Site Web Visual Basic : VB_Web_RDObjMod_Export
●
Projet Windows Visual Basic : VB_Win_RDObjMod_Export
434
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.7.1
Ajout de contr&ocirc;les au Web Form ou Windows Form
Dans cette section, vous allez ajouter des contr&ocirc;les DropDownList, Button et Label au-dessus du contr&ocirc;le
CrystalReportViewer sur le Web Form ou le Windows Form.
1.5.2.7.1.1
Pour ajouter des contr&ocirc;les au Web Form ou
Windows Form
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Appuyez sur la FLECHE GAUCHE du clavier afin de faire appara&icirc;tre un curseur clignotant, puis appuyez
sur ENTREE.
Le contr&ocirc;le CrystalReportViewer descend d'une ligne.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Redimensionnez le contr&ocirc;le CrystalReportViewer pour laisser assez d'espace au-dessus afin d'ajouter un
contr&ocirc;le ComboBox.
c) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
5.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList (dans les sites Web) ou un contr&ocirc;le ComboBox
(dans les projets Windows) au-dessus du contr&ocirc;le CrystalReportViewer.
Remarque
Si une t&acirc;che guid&eacute;e appara&icirc;t dans le contr&ocirc;le DropDownList (ComboBox) lorsque vous utilisez
Visual Studio 2005 ou version ult&eacute;rieure, appuyez sur Echap pour la fermer.
6.
Cliquez sur le contr&ocirc;le DropDownList (ComboBox) pour le s&eacute;lectionner.
7.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; ID la valeur &quot;exportTypesList&quot;.
8.
Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button &agrave; droite du contr&ocirc;le DropDownList (ComboBox).
9.
Cliquez sur le contr&ocirc;le Button pour le s&eacute;lectionner.
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, proc&eacute;dez comme suit :
○
Attribuez &agrave; la propri&eacute;t&eacute; ID la valeur &quot;exportByType&quot;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
435
○
Attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Exporter au type s&eacute;lectionn&eacute;&quot;.
11. Dans la Bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label &agrave; droite du contr&ocirc;le Button.
12. Cliquez sur le contr&ocirc;le Label pour le s&eacute;lectionner.
13. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, proc&eacute;dez comme suit :
○
Attribuez &agrave; la propri&eacute;t&eacute; ID la valeur &quot;message&quot;.
○
Laissez la propri&eacute;t&eacute; Text vide.
○
Attribuez &agrave; la propri&eacute;t&eacute; Visible la valeur &quot;False&quot;.
14. Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
R&eacute;sultats
Vous devez &agrave; pr&eacute;sent remplir le contr&ocirc;le DropDownList &agrave; l'aide de l'&eacute;num&eacute;ration ExportFormatType de l'espace
de noms CrystalDecisions.Shared.
1.5.2.7.1.2
Pour remplir le contr&ocirc;le DropDownList &agrave; l'aide de
l'&eacute;num&eacute;ration ExportFormatType pour un site Web
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez un bloc conditionnel Not IsPostBack &agrave; la fin de la m&eacute;thode ConfigureCrystalReports().
If Not IsPostBack Then
End If
if (!IsPostBack)
{
}
4.
Dans le bloc conditionnel, attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le ComboBox exportTypesList les
valeurs de l'&eacute;num&eacute;ration ExportFormatType.
exportTypesList.DataSource = System.Enum.GetValues(GetType(ExportFormatType))
exportTypesList.DataSource = System.Enum.GetValues(typeof(ExportFormatType));
5.
Appelez la m&eacute;thode DataBind() du contr&ocirc;le DropDownList exportTypesList pour lier les valeurs au contr&ocirc;le.
exportTypesList.DataBind()
436
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
exportTypesList.DataBind();
1.5.2.7.1.3
Pour remplir le contr&ocirc;le DropDownList &agrave; l'aide de
l'&eacute;num&eacute;ration ExportFormatType pour un projet Windows
Proc&eacute;dure
1.
Ouvrez le Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la m&eacute;thode ConfigureCrystalReports(), attribuez &agrave; la propri&eacute;t&eacute; DataSource du contr&ocirc;le
ComboBox exportTypesList les valeurs de l'&eacute;num&eacute;ration ExportFormatType.
exportTypesList.DataSource = System.Enum.GetValues(GetType(ExportFormatType))
exportTypesList.DataSource = System.Enum.GetValues(typeof(ExportFormatType));
1.5.2.7.2
Cr&eacute;ation de m&eacute;thodes ex&eacute;cutant l'exportation
Dans cette section, vous allez cr&eacute;er les m&eacute;thodes d'assistance priv&eacute;es ex&eacute;cutant l'exportation suivantes.
●
ExportSetup()
●
ExportSelection()
●
ExportCompletion()
Ces m&eacute;thodes sont appel&eacute;es plus loin dans ce tutoriel &agrave; partir d'une m&eacute;thode d'&eacute;v&eacute;nement de clic. Vous
commencez par cr&eacute;er la m&eacute;thode d'assistance ExportSetup().
1.5.2.7.2.1
Pour cr&eacute;er la m&eacute;thode ExportSetup()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
En haut de la classe, ajoutez trois d&eacute;clarations de classe.
Private exportPath As String
Private myDiskFileDestinationOptions As DiskFileDestinationOptions
Private myExportOptions As ExportOptions
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
437
private string exportPath;
private DiskFileDestinationOptions diskFileDestinationOptions;
private ExportOptions exportOptions;
Vous instancierez ult&eacute;rieurement ces classes d'assistance dans la m&eacute;thode ExportSetup().
4.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ExportSetup(), sans valeur renvoy&eacute;e.
Public Sub ExportSetup()
End Sub
private void ExportSetup()
{
}
5.
Dans la m&eacute;thode, d&eacute;finissez pour la variable de type cha&icirc;ne exportPath le r&eacute;pertoire racine du disque dur.
exportPath = &quot;C:\Exported\&quot;
exportPath = &quot;C:\\Exported\\&quot;;
Remarque
Si vous souhaitez placer le dossier Exported dans le r&eacute;pertoire Web de votre serveur Web, ajoutez la
propri&eacute;t&eacute; Request.PhysicalApplicationPath comme pr&eacute;fixe au nom de dossier.
6.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si le r&eacute;pertoire dans la cha&icirc;ne exportPath existe d&eacute;j&agrave;.
If Not System.IO.Directory.Exists(exportPath) Then
End If
if (!System.IO.Directory.Exists(exportPath))
{
}
7.
Dans le bloc conditionnel, appelez la m&eacute;thode CreateDirectory() de System.IO.Directory pour cr&eacute;er le
r&eacute;pertoire dans la cha&icirc;ne exportPath.
System.IO.Directory.CreateDirectory(exportPath)
System.IO.Directory.CreateDirectory(exportPath);
8.
En dehors du bloc conditionnel, instanciez la classe DiskFileDesintationOptions.
myDiskFileDestinationOptions = New DiskFileDestinationOptions()
438
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
diskFileDestinationOptions = new DiskFileDestinationOptions();
9.
Remplissez l'instance ExportOptions avec la propri&eacute;t&eacute; ExportOptions de l'instance
hierarchicalGroupingReport.
myExportOptions = hierarchicalGroupingReport.ExportOptions
exportOptions = hierarchicalGroupingReport.ExportOptions;
10. Attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportDestinationType.DiskFile.
myExportOptions.ExportDestinationType = ExportDestinationType.DiskFile
exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
11. Pour un projet Windows, effacez les valeurs de la propri&eacute;t&eacute; ExportFormatOptions de l'instance ExportOptions.
(Cette ligne de code est inutile pour un site Web car la variable est automatiquement effac&eacute;e &agrave; chaque
&eacute;v&eacute;nement de clic.)
myExportOptions.ExportFormatOptions = Nothing
exportOptions.ExportFormatOptions = null;
R&eacute;sultats
Vous allez cr&eacute;er &agrave; pr&eacute;sent la m&eacute;thode d'assistance ExportSelection().
1.5.2.7.2.2
Pour cr&eacute;er la m&eacute;thode ExportSelection()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Au d&eacute;but de la classe, ajoutez une d&eacute;claration bool&eacute;enne utilis&eacute;e pour v&eacute;rifier qu'aucun format d'exportation
n'est s&eacute;lectionn&eacute;.
Private selectedNoFormat As Boolean = True
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
439
private bool selectedNoFormat = true;
4.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ExportSelection(), sans valeur
renvoy&eacute;e.
Public Sub ExportSelection()
End Sub
private void ExportSelection()
{
}
5.
Dans la m&eacute;thode, cr&eacute;ez une instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] qui
r&eacute;f&eacute;rence les membres de l'&eacute;num&eacute;ration ExportFormatType. L'&eacute;num&eacute;ration repose sur l'objet SelectedIndex
du contr&ocirc;le DropDownList exportTypesList que vous avez cr&eacute;&eacute; dans la proc&eacute;dure pr&eacute;c&eacute;dente.
Select Case exportTypesList.SelectedIndex
Case ExportFormatType.NoFormat
Case ExportFormatType.CrystalReport
Case ExportFormatType.RichText
Case ExportFormatType.WordForWindows
Case ExportFormatType.Excel
Case ExportFormatType.PortableDocFormat
Case ExportFormatType.HTML32
Case ExportFormatType.HTML40
Case Else
End Select
switch ((ExportFormatType)exportTypesList.SelectedIndex)
{
case ExportFormatType.NoFormat:
break;
case ExportFormatType.CrystalReport:
break;
case ExportFormatType.RichText:
break;
case ExportFormatType.WordForWindows:
break;
case ExportFormatType.Excel:
break;
case ExportFormatType.PortableDocFormat:
break;
case ExportFormatType.HTML32:
break;
case ExportFormatType.HTML40:
break;
default:
440
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
}
break;
R&eacute;sultats
Vous avez termin&eacute; la m&eacute;thode ExportSelection(). Vous allez cr&eacute;er &agrave; pr&eacute;sent la m&eacute;thode d'assistance
ExportCompletion().
1.5.2.7.2.3
Pour cr&eacute;er la m&eacute;thode ExportCompletion()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ExportCompletion(), sans valeur
renvoy&eacute;e.
Public Sub ExportCompletion()
End Sub
private void ExportCompletion()
{
}
4.
Dans la m&eacute;thode, cr&eacute;ez un bloc try/catch avec la classe Exception r&eacute;f&eacute;renc&eacute;e en tant que variable intitul&eacute;e
&quot;ex&quot;.
Try
Catch ex As Exception
End Try
try
{
}
catch (Exception ex)
{
}
5.
Dans le bloc d'essai, cr&eacute;ez un bloc conditionnel pour v&eacute;rifier la variable bool&eacute;enne selectedNoFormat.
If selectedNoFormat Then
Else
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
441
End If
if (selectedNoFormat)
{
}
else
{
}
6.
Dans le bloc If, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante
FORMAT_NOT_SUPPORTED de la classe MessageConstants.
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
7.
Dans le bloc Else, appelez la m&eacute;thode Export() de l'instance hierarchicalGroupingReport.
hierarchicalGroupingReport.Export()
hierarchicalGroupingReport.Export();
8.
Toujours dans le bloc Else, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante SUCCESS de
la classe MessageConstants.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
9.
Dans le bloc catch, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante FAILURE de la classe
MessagesConstants, puis ajoutez-lui la propri&eacute;t&eacute; Message du param&egrave;tre Exception.
message.Text = MessageConstants.FAILURE &amp; ex.Message
message.Text = MessageConstants.FAILURE + ex.Message;
10. En dehors du bloc try/catch, attribuez &agrave; la propri&eacute;t&eacute; Visible du contr&ocirc;le Label message la valeur &quot;True&quot;.
message.Visible = True
message.Visible = true;
442
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
R&eacute;sultats
Vous venez de cr&eacute;er les trois m&eacute;thodes d'assistance priv&eacute;es ex&eacute;cutant l'exportation.
1.5.2.7.3
Cr&eacute;ation de m&eacute;thodes configurant plusieurs
formats d'exportation
Dans cette section, vous allez cr&eacute;er les m&eacute;thodes d'assistance priv&eacute;es configurant plusieurs formats
d'exportation. Toutes ces m&eacute;thodes sont utilis&eacute;es de la m&ecirc;me fa&ccedil;on, &agrave; l'exception des m&eacute;thodes
ConfigureExportToHtml32() et ConfigureExportToHtml40() qui offrent diff&eacute;rents modes d'exportation au format
HTML.
●
ConfigureExportToRpt()
●
ConfigureExportToRtf()
●
ConfigureExportToDoc()
●
ConfigureExportToXls()
●
ConfigureExportToPdf()
●
ConfigureExportToHtml32()
●
ConfigureExportToHtml40()
1.5.2.7.3.1
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToRpt()
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToRpt(), sans valeur
renvoy&eacute;e.
Public Sub ConfigureExportToRpt()
End Sub
private void ConfigureExportToRpt()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType CrystalReport.
myExportOptions.ExportFormatType = ExportFormatType.CrystalReport
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
443
exportOptions.ExportFormatType = ExportFormatType.CrystalReport;
5.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath,
puis ajoutez-lui le nom d'un document avec une extension de fichier .rpt.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp;
&quot;Report.rpt&quot;
diskFileDestinationOptions.DiskFileName = exportPath +
&quot;Report.rpt&quot;;
6.
Enfin, attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
1.5.2.7.3.2
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToRtf
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToRtf(), sans valeur
renvoy&eacute;e.
Public Sub ConfigureExportToRtf()
End Sub
private void
ConfigureExportToRtf()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType RichText.
myExportOptions.ExportFormatType = ExportFormatType.RichText
exportOptions.ExportFormatType = ExportFormatType.RichText;
444
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath, puis
ajoutez-lui le nom d'un document avec une extension de fichier .rtf.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp; &quot;RichTextFormat.rtf&quot;
diskFileDestinationOptions.DiskFileName = exportPath + &quot;RichTextFormat.rtf&quot;;
6.
Enfin, attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
1.5.2.7.3.3
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToDoc
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToDoc(), sans valeur
renvoy&eacute;e.
Public Sub ConfigureExportToDoc()
End Sub
private void
ConfigureExportToDoc()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType WordForWindows.
myExportOptions.ExportFormatType = ExportFormatType.WordForWindows
exportOptions.ExportFormatType = ExportFormatType.WordForWindows;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
445
5.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath, puis
ajoutez-lui le nom d'un document avec une extension de fichier .doc.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp;
&quot;Word.doc&quot;
diskFileDestinationOptions.DiskFileName = exportPath + &quot;Word.doc&quot;;
6.
Enfin, attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
1.5.2.7.3.4
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToXls
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToXls(), sans valeur
renvoy&eacute;e.
Public Sub ConfigureExportToXls()
End Sub
private void
ConfigureExportToXls()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType Excel.
myExportOptions.ExportFormatType = ExportFormatType.Excel
exportOptions.ExportFormatType = ExportFormatType.Excel;
446
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
5.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath, puis
ajoutez-lui le nom d'un document avec une extension de fichier .xls.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp; &quot;Excel.xls&quot;
diskFileDestinationOptions.DiskFileName = exportPath + &quot;Excel.xls&quot;;
6.
Enfin, attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
1.5.2.7.3.5
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToPdf
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToPdf(), sans valeur
renvoy&eacute;e.
Public Sub ConfigureExportToPdf()
End Sub
private void
ConfigureExportToPdf()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType PortableDocFormat.
myExportOptions.ExportFormatType = ExportFormatType.PortableDocFormat
exportOptions.ExportFormatType = ExportFormatType.PortableDocFormat;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
447
5.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath, puis
ajoutez-lui le nom d'un document avec une extension de fichier .pdf.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp; &quot;PortableDoc.pdf&quot;
diskFileDestinationOptions.DiskFileName = exportPath + &quot;PortableDoc.pdf&quot;;
6.
Enfin, attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
1.5.2.7.3.6
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToHtml32
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToHtml32(), sans
valeur renvoy&eacute;e.
Public Sub ConfigureExportToHtml32()
End Sub
private void
ConfigureExportToHtml32()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType HTML32.
myExportOptions.ExportFormatType = ExportFormatType.HTML32
exportOptions.ExportFormatType = ExportFormatType.HTML32;
5.
D&eacute;clarez et instanciez la classe HTMLFormatOptions avec le nom de variable &quot;html32FormatOptions&quot;.
Dim html32FormatOptions As HTMLFormatOptions = New
HTMLFormatOptions()
448
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
HTMLFormatOptions html32FormatOptions = new HTMLFormatOptions();
6.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLBaseFolderName de l'instance html32FormatOptions la cha&icirc;ne exportPath et le
nom &quot;Html32Folder&quot;.
html32FormatOptions.HTMLBaseFolderName = exportPath &amp;
&quot;Html32Folder&quot;
html32FormatOptions.HTMLBaseFolderName = exportPath +
&quot;Html32Folder&quot;;
7.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLFileName de l'instance html32FormatOptions le nom &quot;html32.html&quot;.
html32FormatOptions.HTMLFileName = &quot;html32.html&quot;
html32FormatOptions.HTMLFileName = &quot;html32.html&quot;;
8.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLEnableSeparatedPages de l'instance html32FormatOptions la valeur &quot;False&quot;.
html32FormatOptions.HTMLEnableSeparatedPages = False
html32FormatOptions.HTMLEnableSeparatedPages = false;
9.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLHasPageNavigator de l'instance html32FormatOptions la valeur &quot;False&quot;.
html32FormatOptions.HTMLHasPageNavigator = False
html32FormatOptions.HTMLHasPageNavigator = false;
10. Enfin, affectez l'instance html32FormatOptions &agrave; la propri&eacute;t&eacute; FormatOptions de l'instance ExportOptions.
myExportOptions.ExportFormatOptions = html32FormatOptions
exportOptions.ExportFormatOptions = html32FormatOptions;
1.5.2.7.3.7
Pour cr&eacute;er la m&eacute;thode d'assistance
ConfigureExportToHtml40
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
449
2.
Dans le menu Affichage, cliquez sur Code.
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToHtml40(), sans
valeur renvoy&eacute;e.
Public Sub ConfigureExportToHtml40()
End Sub
private void
ConfigureExportToHtml40()
{
}
4.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType HTML40.
myExportOptions.ExportFormatType = ExportFormatType.HTML40
exportOptions.ExportFormatType = ExportFormatType.HTML40;
5.
D&eacute;clarez et instanciez la classe HTMLFormatOptions avec le nom de variable &quot;html40FormatOptions&quot;.
Dim html40FormatOptions As HTMLFormatOptions = New
HTMLFormatOptions()
HTMLFormatOptions html40FormatOptions = new HTMLFormatOptions();
6.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLBaseFolderName de l'instance html40FormatOptions la cha&icirc;ne exportPath et le
nom &quot;Html40Folder&quot;.
html40FormatOptions.HTMLBaseFolderName = exportPath &amp;
&quot;Html40Folder&quot;
html40FormatOptions.HTMLBaseFolderName = exportPath +
&quot;Html40Folder&quot;;
7.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLFileName de l'instance html40FormatOptions le nom &quot;html40.html&quot;.
html40FormatOptions.HTMLFileName = &quot;html40.html&quot;
html40FormatOptions.HTMLFileName = &quot;html40.html&quot;;
8.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLEnableSeparatedPages de l'instance html40FormatOptions la valeur &quot;True&quot;.
html40FormatOptions.HTMLEnableSeparatedPages = True
450
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
html40FormatOptions.HTMLEnableSeparatedPages = true;
9.
Attribuez &agrave; la propri&eacute;t&eacute; HTMLHasPageNavigator de l'instance html40FormatOptions la valeur &quot;True&quot;.
html40FormatOptions.HTMLHasPageNavigator = True
html40FormatOptions.HTMLHasPageNavigator = true;
10. Attribuez &agrave; la propri&eacute;t&eacute; FirstPageNumber de l'instance html40FormatOptions la valeur 1.
html40FormatOptions.FirstPageNumber = 1
html40FormatOptions.FirstPageNumber = 1;
11. Attribuez &agrave; la propri&eacute;t&eacute; LastPageNumber de l'instance html40FormatOptions la valeur 3.
html40FormatOptions.LastPageNumber = 3
html40FormatOptions.LastPageNumber = 3;
12. Enfin, affectez l'instance html40FormatOptions &agrave; la propri&eacute;t&eacute; FormatOptions de l'instance ExportOptions.
myExportOptions.FormatOptions = html40FormatOptions
exportOptions.FormatOptions = html40FormatOptions;
R&eacute;sultats
Vous avez cr&eacute;&eacute; les m&eacute;thodes d'assistance priv&eacute;es configurant plusieurs formats d'exportation.
1.5.2.7.4
Appel des m&eacute;thodes &agrave; partir de l'instruction Case
Pr&eacute;c&eacute;demment, vous avez cr&eacute;&eacute; une instruction Case dans la m&eacute;thode ExportSelection() avec plusieurs cas
de figure. Chaque cas est li&eacute; &agrave; une s&eacute;lection de l'&eacute;num&eacute;ration ExportFormatType. Vous pouvez d&eacute;sormais
appeler chaque m&eacute;thode de configuration selon les cas correspondants, ainsi que d&eacute;finir la valeur de la valeur
bool&eacute;enne selectedNoFormat.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
451
1.5.2.7.4.1
Pour appeler les m&eacute;thodes &agrave; partir de
l'instruction Case
Proc&eacute;dure
1.
2.
Localisez la m&eacute;thode ExportSelection() que vous avez cr&eacute;&eacute;e dans le cours pr&eacute;c&eacute;dent.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.NoFormat, attribuez &agrave; la variable bool&eacute;enne selectedNoFormat la valeur True.
selectedNoFormat = True
selectedNoFormat = true;
3.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.CrystalReport, appelez la m&eacute;thode ConfigureExportToRpt().
selectedNoFormat = False
ConfigureExportToRpt()
selectedNoFormat = false;
ConfigureExportToRpt();
4.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.RichText, appelez la m&eacute;thode ConfigureExportToRtf().
selectedNoFormat = False
ConfigureExportToRtf()
selectedNoFormat = false;
ConfigureExportToRtf();
5.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.WordForWindows, appelez la m&eacute;thode ConfigureExportToDoc().
selectedNoFormat = False
ConfigureExportToDoc()
selectedNoFormat = false;
ConfigureExportToDoc();
6.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.Excel, appelez la m&eacute;thode ConfigureExportToXls().
selectedNoFormat = False
ConfigureExportToXls()
452
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
selectedNoFormat = false;
ConfigureExportToXls();
7.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.PortableDocFormat, appelez la m&eacute;thode ConfigureExportToPdf().
selectedNoFormat = False
ConfigureExportToPdf()
selectedNoFormat = false;
ConfigureExportToPdf();
8.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.HTML32, appelez la m&eacute;thode ConfigureExportToHtml32().
selectedNoFormat = False
ConfigureExportToHtml32()
selectedNoFormat = false;
ConfigureExportToHtml32();
9.
Dans l'instruction Select Case [Visual Basic] ou switch [C#], dans le cas correspondant &agrave;
ExportFormatType.HTML40, appelez la m&eacute;thode ConfigureExportToHtml40().
selectedNoFormat = False
ConfigureExportToHtml40()
selectedNoFormat = false;
ConfigureExportToHtml40();
10. Dans le instructions conditionnelles Select Case [Visual Basic] ou switch [C#], dans le cas de
Switch Else [Visual Basic] ou default: [C#], attribuez &agrave; la variable bool&eacute;enne selectedNoFormat
la valeur True.
selectedNoFormat = True
selectedNoFormat = true;
R&eacute;sultats
Si vous cr&eacute;ez un projet dans Visual Studio 2005 ou une version ult&eacute;rieure, vous devez suivre les proc&eacute;dures de la
section Cr&eacute;ation de m&eacute;thodes pour les nouveaux formats d'exportation [page 455] avant de consulter la section
Appel des m&eacute;thodes pour ex&eacute;cuter l'exportation [page 454].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
453
1.5.2.7.5
Appel des m&eacute;thodes pour ex&eacute;cuter l'exportation
Vous pouvez &agrave; pr&eacute;sent cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement de clic du contr&ocirc;le Button exportByType, puis appeler les
m&eacute;thodes afin d'effectuer l'exportation &agrave; partir de cette m&eacute;thode d'&eacute;v&eacute;nement.
1.5.2.7.5.1
Pour cr&eacute;er la m&eacute;thode d'&eacute;v&eacute;nement
exportByType_Click
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button exportByType.
La m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click() est cr&eacute;&eacute;e et s'affiche en mode code.
4.
Dans la m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click(), saisissez les appels aux trois m&eacute;thodes
d'&eacute;v&eacute;nement que vous avez cr&eacute;&eacute;es pr&eacute;c&eacute;demment afin d'effectuer l'exportation.
ExportSetup()
ExportSelection()
ExportCompletion()
ExportSetup();
ExportSelection();
ExportCompletion();
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet, puis exporter votre rapport dans plusieurs formats.
1.5.2.7.5.2
Pour v&eacute;rifier le projet
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
454
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
L'application Web ou Windows compile et affiche le rapport Hierarchical Grouping. Un contr&ocirc;le DropDownList
affiche plusieurs formats d'exportation et un bouton Exporter au type s&eacute;lectionn&eacute; appara&icirc;t permettant
d'ex&eacute;cuter l'exportation.
4.
S&eacute;lectionnez un des formats d'exportation dans le contr&ocirc;le DropDownList, puis cliquez sur le bouton Exporter
au type s&eacute;lectionn&eacute;.
Un message s'affiche en regard du bouton et indique si l'exportation a r&eacute;ussi. Dans le cas contraire, un
message d'erreur appara&icirc;t.
5.
Essayez d'effectuer des exportations avec diff&eacute;rents formats.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
7.
V&eacute;rifiez le r&eacute;pertoire de fichiers Exported sur votre serveur Web ou votre ordinateur utilisant Windows pour
confirmer que les fichiers export&eacute;s ont &eacute;t&eacute; plac&eacute;s dans le r&eacute;pertoire.
1.5.2.7.6
Addenda : Am&eacute;liorations apport&eacute;es au code
d'exportation
Si vous avez install&eacute; Visual Studio 2005 ou version ult&eacute;rieure, ou SAP Crystal Reports, vous avez acc&egrave;s aux
fonctionnalit&eacute;s API am&eacute;lior&eacute;es pour l'exportation de votre rapport Crystal dans diff&eacute;rents formats.
Dans les fonctionnalit&eacute;s API am&eacute;lior&eacute;es de SAP Crystal Reports, l'&eacute;num&eacute;ration ExportFormatTypes comporte
deux nouveaux formats d'exportation : des enregistrements Microsoft Excel (fichier .xls contenant uniquement
les donn&eacute;es) et des fichiers texte.
En outre, vous disposez &agrave; pr&eacute;sent des m&eacute;thodes d'exportation am&eacute;lior&eacute;es suivantes dans la classe
ReportDocument :
●
ExportToDisk(CrystalDecisions.Shared.ExportFormatType formatType, string fileName) :
exporte un rapport vers le disque local du serveur Web ou de l'ordinateur utilisant Windows.
●
ExportToHttpResponse(CrystalDecisions.Shared.ExportFormatType formatType,
System.Web.HttpResponse response, bool asAttachment, string attachmentName) : exporte
un rapport au type de format sp&eacute;cifi&eacute; vers une fen&ecirc;tre de navigateur, ou exporte le rapport sous la forme
d'une pi&egrave;ce jointe.
●
ExportToHttpResponse(CrystalDecisions.Shared.ExportOptions options,
System.Web.HttpResponse response, bool asAttachment, string attachmentName) : exporte
un rapport au type de format sp&eacute;cifi&eacute; vers une fen&ecirc;tre de navigateur, ou exporte le rapport sous la forme
d'une pi&egrave;ce jointe.
●
ExportToStream(CrystalDecisions.Shared.ExportFormatType formatType) : exporte les
donn&eacute;es d'un rapport avec un type de format sp&eacute;cifi&eacute; vers un flux d'entr&eacute;e/sortie.
1.5.2.7.6.1
Cr&eacute;ation de m&eacute;thodes pour les nouveaux formats
d'exportation
Dans cette section, vous allez apprendre &agrave; modifier votre projet (que vous avez pr&eacute;c&eacute;demment cr&eacute;&eacute; dans ce
tutoriel) afin d'inclure les nouveaux formats d'exportation.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
455
Avant de modifier le code pour inclure les nouveaux formats d'exportation, effectuez toutes les proc&eacute;dures de la
section Tutoriel : Exportation dans plusieurs formats [page 433].
1.5.2.7.6.1.1
Pour modifier le code afin d'inclure les
nouveaux formats d'exportation
Proc&eacute;dure
1.
Ouvrez le projet termin&eacute; de ce tutoriel.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Dans l'instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] de la m&eacute;thode
ExportSelection(), ajoutez une instruction Case pour le format ExcelRecord.
Case ExportFormatType.ExcelRecord
case ExportFormatType.ExcelRecord:
break;
Cr&eacute;ez les m&eacute;thodes d'assistance priv&eacute;es configurant plusieurs formats d'exportation. Vous cr&eacute;ez d'abord la
m&eacute;thode ConfigureExportToXlsRec() afin de d&eacute;finir les options d'exportation ExcelRecord.
5.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e appel&eacute;e ConfigureExportToXlsRec(), sans
valeur renvoy&eacute;e.
Public Sub ConfigureExportToXlsRec()
End Sub
private void ConfigureExportToXlsRec()
{
}
6.
Dans la m&eacute;thode, attribuez &agrave; la propri&eacute;t&eacute; ExportFormatType de l'instance ExportOptions l'&eacute;num&eacute;ration
ExportFormatType ExcelRecord.
myExportOptions.ExportFormatType = ExportFormatType.ExcelRecord
exportOptions.ExportFormatType = ExportFormatType.ExcelRecord;
7.
Attribuez &agrave; la propri&eacute;t&eacute; DiskFileName de l'instance DiskFileDestinationOptions la cha&icirc;ne exportPath, puis
ajoutez-lui le nom d'un document avec une extension de fichier .xls.
myDiskFileDestinationOptions.DiskFileName = exportPath &amp; &quot;ExcelRecord.xls&quot;
456
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
diskFileDestinationOptions.DiskFileName = exportPath + &quot;ExcelRecord.xls&quot;;
8.
Attribuez &agrave; la propri&eacute;t&eacute; ExportDestinationOptions de l'instance ExportOptions, l'instance
DiskFileDestinationOptions que vous avez configur&eacute;e &agrave; l'&eacute;tape pr&eacute;c&eacute;dente.
myExportOptions.ExportDestinationOptions = myDiskFileDestinationOptions
exportOptions.ExportDestinationOptions = diskFileDestinationOptions;
R&eacute;sultats
Vous avez r&eacute;ussi &agrave; ajouter deux nouveaux formats d'exportation &agrave; votre projet.
Pour continuer l'exploration des fonctionnalit&eacute;s API am&eacute;lior&eacute;es, choisissez l'une des m&eacute;thodes d'exportation
am&eacute;lior&eacute;es suivantes :
●
Si vous souhaitez r&eacute;duire la quantit&eacute; de code et n'avez pas besoin de d&eacute;finir l'instance ExportOptions,
effectuez la proc&eacute;dure Utilisation de la m&eacute;thode ExportToDisk() [page 457].
●
Pour un site Web, si vous souhaitez exporter votre rapport dans une fen&ecirc;tre de navigateur ou sous forme de
pi&egrave;ce jointe dans une fen&ecirc;tre de navigateur, effectuez la proc&eacute;dure Utilisation de la m&eacute;thode
ExportToHttpResponse() [page 467].
●
Si vous souhaitez transmettre les donn&eacute;es de votre rapport vers un flux d'entr&eacute;e/sortie, effectuez la
proc&eacute;dure Utilisation de la m&eacute;thode ExportToStream() [page 473].
1.5.2.7.6.2
Utilisation de la m&eacute;thode ExportToDisk()
La m&eacute;thode ExportToDisk() fait appel &agrave; une instance d'ExportFormatType et &agrave; un param&egrave;tre de nom de fichier.
Cette m&eacute;thode simplifie l'utilisation des m&eacute;thodes de configuration d'exportation que vous avez cr&eacute;&eacute;es dans la
section Cr&eacute;ation de m&eacute;thodes configurant plusieurs formats d'exportation [page 443].
Dans cette section, vous allez apprendre &agrave; cr&eacute;er un projet, &agrave; modifier un projet existant et &agrave; ajouter un code au
projet pour utiliser la m&eacute;thode ExportToDisk().
Conditions pr&eacute;requises :
●
Vous devez cr&eacute;er un projet en suivant les instructions de la section Configuration d'un projet pour la m&eacute;thode
ExportToDisk() [page 458].
●
Ou vous devez cr&eacute;er un projet en suivant les instructions de la section Cr&eacute;ation de m&eacute;thodes pour les
nouveaux formats d'exportation [page 455].
Vous devez ensuite modifier le projet comme indiqu&eacute; dans la section Pr&eacute;paration du projet pour la m&eacute;thode
ExportToDisk() [page 460].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
457
1.5.2.7.6.2.1
Configuration d'un projet pour la m&eacute;thode
ExportToDisk()
Dans cette section, vous allez apprendre &agrave; cr&eacute;er un projet pour la m&eacute;thode ExportToDisk().
1.5.2.7.6.2.1.1
Pour configurer un nouveau projet pour la
m&eacute;thode ExportToDisk()
Proc&eacute;dure
1.
2.
Suivez les instructions de la section Ajout de contr&ocirc;les au Web Form ou Windows Form [page 435].
Cr&eacute;ez la m&eacute;thode ExportSetup() et la m&eacute;thode ExportSelection() indiqu&eacute;es dans la section Cr&eacute;ation
de m&eacute;thodes ex&eacute;cutant l'exportation [page 437].
3.
Dans l'instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] de la m&eacute;thode
ExportSelection(), ajoutez une instruction Case pour le format ExcelRecord.
Case ExportFormatType.ExcelRecord
case ExportFormatType.ExcelRecord:
break;
4.
Cr&eacute;ez un bloc conditionnel pour v&eacute;rifier la variable bool&eacute;enne selectedNoFormat.
If selectedNoFormat Then
Else
End If
if (selectedNoFormat)
{
}
else
{
}
5.
Dans le bloc If, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante
FORMAT_NOT_SUPPORTED de la classe MessageConstants.
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
458
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
6.
Dans le bloc Else, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante SUCCESS de la classe
MessageConstants.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
7.
Cr&eacute;ez un bloc try/catch avec la classe Exception r&eacute;f&eacute;renc&eacute;e en tant que variable intitul&eacute;e &quot;ex&quot;. Le bloc try
inclut l'instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] et le bloc conditionnel.
Try
Catch ex As Exception
End Try
try
{
}
catch (Exception ex)
{
}
8.
Dans le bloc catch, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante FAILURE de la classe
MessagesConstants, puis ajoutez-lui la propri&eacute;t&eacute; Message du param&egrave;tre Exception.
message.Text = MessageConstants.FAILURE &amp; ex.Message
message.Text = MessageConstants.FAILURE + ex.Message;
9.
En dehors du bloc try/catch, attribuez &agrave; la propri&eacute;t&eacute; Visible du contr&ocirc;le Label message la valeur &quot;True&quot;.
message.Visible = True
message.Visible = true;
10. Dans le menu Affichage, cliquez sur Concepteur.
11. Cliquez deux fois sur le contr&ocirc;le Button exportByType.
La m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click() est cr&eacute;&eacute;e et vous passez en mode code.
12. Dans la m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click(), saisissez les appels aux m&eacute;thodes ExportSetup()
et ExportSelection().
ExportSetup()
ExportSelection()
ExportSetup();
ExportSelection();
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
459
1.5.2.7.6.2.2
Pr&eacute;paration du projet pour la m&eacute;thode
ExportToDisk()
Dans cette section, vous allez apprendre &agrave; modifier un projet r&eacute;sultant de la proc&eacute;dure de la section Cr&eacute;ation de
m&eacute;thodes pour les nouveaux formats d'exportation [page 455].
Vous devez &agrave; pr&eacute;sent supprimer certaines lignes de code inutiles pour la m&eacute;thode ExportToDisk().
1.5.2.7.6.2.2.1
Pour modifier le projet afin d'utiliser la
m&eacute;thode ExportToDisk()
Proc&eacute;dure
1.
Ouvrez le projet.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
En haut de la classe, supprimez les d&eacute;clarations de classe suivantes :
Private myDiskFileDestinationOptions As DiskFileDestinationOptions
Private myExportOptions As ExportOptions
private DiskFileDestinationOptions diskFileDestinationOptions;
private ExportOptions exportOptions;
5.
Dans la m&eacute;thode ExportSetup(), supprimez toutes les lignes de code situ&eacute;es apr&egrave;s le bloc conditionnel. (La
derni&egrave;re ligne de code qui appelle la propri&eacute;t&eacute; ExportFormatOptions s'applique uniquement &agrave; un projet
Windows.)
myDiskFileDestinationOptions = New DiskFileDestinationOptions()
myExportOptions = hierarchicalGroupingReport.ExportOptions
myExportOptions.ExportDestinationType = ExportDestinationType.DiskFile
myExportOptions.ExportFormatOptions = Nothing
diskFileDestinationOptions = new DiskFileDestinationOptions();
exportOptions = hierarchicalGroupingReport.ExportOptions;
exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
exportOptions.ExportFormatOptions = null;
6.
460
Supprimez les m&eacute;thodes de configuration d'exportation suivantes :
○
ConfigureExportToRpt()
○
ConfigureExportToRtf()
○
ConfigureExportToDoc()
○
ConfigureExportToXls()
○
ConfigureExportToPdf()
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
○
ConfigureExportToHtml32()
○
ConfigureExportToHtml40()
○
ConfigureExportToXlsRec()
○
ConfigureExportToTxt()
Dans les instructions Case Select Case [Visual Basic] ou switch [C#] de ExportSelection(),
supprimez les appels aux m&eacute;thodes de configuration d'exportation.
8.
Dans la m&eacute;thode ExportCompletion(), supprimez l'appel &agrave; la m&eacute;thode Export().
9.
Copiez et collez la totalit&eacute; du code de la m&eacute;thode ExportCompletion() au d&eacute;but de la m&eacute;thode
ExportSelection().
10. Supprimez la m&eacute;thode ExportCompletion() et l'appel &agrave; la m&eacute;thode ExportCompletion() dans
l'&eacute;v&eacute;nement de clic exportByType.
11. Dans la m&eacute;thode ExportSelection(), coupez et collez les instructions Case Select Case [Visual
Basic] ou switch [C#] au-dessus du bloc If dans le bloc try.
Le bloc try/catch ressemble maintenant &agrave; ceci :
Try
Select Case exportTypesList.SelectedIndex
Case ExportFormatType.NoFormat
selectedNoFormat = True
Case ExportFormatType.CrystalReport
Case ExportFormatType.RichText
Case ExportFormatType.WordForWindows
Case ExportFormatType.Excel
Case ExportFormatType.PortableDocFormat
Case ExportFormatType.HTML32
Case ExportFormatType.HTML40
End Select
If selectedNoFormat Then
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
Else
message.Text = MessageConstants.SUCCESS
End If
Catch ex As Exception
message.Text = MessageConstants.FAILURE &amp; ex.Message
End Try
try
{
switch ((ExportFormatType)exportTypesList.SelectedIndex)
{
case ExportFormatType.NoFormat:
selectedNoFormat = true;
break;
case ExportFormatType.CrystalReport:
break;
case ExportFormatType.RichText:
break;
case ExportFormatType.WordForWindows:
break;
case ExportFormatType.Excel:
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
461
break;
case ExportFormatType.PortableDocFormat:
break;
case ExportFormatType.HTML32:
break;
case ExportFormatType.HTML40:
break;
case ExportFormatType.ExcelRecord:
break;
}
if (selectedNoFormat)
{
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
}
else
{
message.Text = MessageConstants.SUCCESS;
}
}
catch (Exception ex)
{
message.Text = MessageConstants.FAILURE + ex.Message;
}
1.5.2.7.6.2.3
Modification de la m&eacute;thode ExportSetup()
Dans cette section, vous allez apprendre &agrave; modifier la m&eacute;thode ExportSetup() pour cr&eacute;er des dossiers destin&eacute;s
aux formats d'exportation HTML32 et HTML40.
1.5.2.7.6.2.3.1
Pour modifier la m&eacute;thode ExportSetup()
Proc&eacute;dure
1.
Au d&eacute;but de la classe, ajoutez les d&eacute;clarations de classe suivantes :
Private exportPathHTML32 As String
Private exportPathHTML40 As String
private string exportPathHTML32;
private string exportPathHTML40;
2.
Dans la m&eacute;thode ExportSetup(), instanciez les variables de type cha&icirc;ne exportPathHTML32 et
exportPathHTML40 sur le r&eacute;pertoire racine du disque dur.
exportPathHTML32 = &quot;C:\Exported\HTML32\&quot;
exportPathHTML40 = &quot;C:\Exported\HTML40\&quot;
exportPathHTML32 = &quot;C:\\Exported\\HTML32\\&quot;;
exportPathHTML40 = &quot;C:\\Exported\\HTML40\\&quot;;
462
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Remarque
Si vous souhaitez placer les dossiers dans le r&eacute;pertoire Web de votre serveur Web, ajoutez la propri&eacute;t&eacute;
Request.PhysicalApplicationPath comme pr&eacute;fixe au nom de dossier.
3.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si le r&eacute;pertoire dans la cha&icirc;ne exportPathHTML32 existe d&eacute;j&agrave;.
If Not System.IO.Directory.Exists(exportPathHTML32) Then
End If
if (!System.IO.Directory.Exists(exportPathHTML32))
{
}
4.
Dans le bloc conditionnel, appelez la m&eacute;thode CreateDirectory() de System.IO.Directory pour cr&eacute;er le
r&eacute;pertoire dans la cha&icirc;ne exportPathHTML32.
System.IO.Directory.CreateDirectory(exportPathHTML32)
System.IO.Directory.CreateDirectory(exportPathHTML32);
5.
Cr&eacute;ez un bloc conditionnel qui v&eacute;rifie si le r&eacute;pertoire dans la cha&icirc;ne exportPathHTML40 existe d&eacute;j&agrave;.
If Not System.IO.Directory.Exists(exportPathHTML40) Then
End If
if (!System.IO.Directory.Exists(exportPathHTML40))
{
}
6.
Dans le bloc conditionnel, appelez la m&eacute;thode CreateDirectory() de System.IO.Directory pour cr&eacute;er le
r&eacute;pertoire dans la cha&icirc;ne exportPathHTML40.
System.IO.Directory.CreateDirectory(exportPathHTML40)
System.IO.Directory.CreateDirectory(exportPathHTML40);
1.5.2.7.6.2.4
Appel de la m&eacute;thode ExportToDisk()
Dans cette section, vous allez apprendre &agrave; appeler la m&eacute;thode ExportToDisk() dans chaque instruction Case
de la m&eacute;thode ExportSelection().
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
463
1.5.2.7.6.2.4.1
Pour appeler la m&eacute;thode ExportToDisk() dans
la m&eacute;thode ExportSelection()
Proc&eacute;dure
1.
Dans la m&eacute;thode ExportSelection(), d&eacute;clarez une variable de type cha&icirc;ne et instanciez la variable sur une
cha&icirc;ne vide.
Dim myFileName As String = &quot;&quot;
string fileName = &quot;&quot;;
2.
Dans l'instruction Case ExportFormatType.CrystalReport, proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .rpt.
myFileName = exportPath &amp; &quot;Report.rpt&quot;
fileName = exportPath + &quot;Report.rpt&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.CrystalReport et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.CrystalReport,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.CrystalReport,
fileName);
3.
Dans l'instruction Case ExportFormatType.RichText, proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .rtf.
myFileName = exportPath &amp; &quot;RichTextFormat.rtf&quot;
fileName = exportPath + &quot;RichTextFormat.rtf&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.RichText et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.RichText,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.RichText,
fileName);
464
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
4.
Dans l'instruction Case ExportFormatType.WordForWindows, proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .doc.
myFileName = exportPath &amp; &quot;Word.doc&quot;
fileName = exportPath + &quot;Word.doc&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.WordForWindows et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.WordForWindows,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.WordForWindows,
fileName);
5.
Dans l'instruction Case ExportFormatType.Excel, proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .xls.
myFileName = exportPath &amp; &quot;Excel.xls&quot;
fileName = exportPath + &quot;Excel.xls&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.Excel et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.Excel,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.Excel,
fileName);
6.
Dans l'instruction Case ExportFormatType.PortableDocFormat, proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .pdf.
myFileName = exportPath &amp; &quot;PortableDoc.pdf&quot;
fileName = exportPath + &quot;PortableDoc.pdf&quot;;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
465
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.PortableDocFormat et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.PortableDocFormat,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.PortableDocFormat,
fileName);
7.
Dans l'instruction Case ExportFormatType.HTML32 proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPathHTML32, puis ajoutez-lui le nom d'un
document avec une extension de fichier .html.
myFileName = exportPathHTML32 &amp; &quot;HTML32.html&quot;
fileName = exportPathHTML32 + &quot;HTML32.html&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.HTML32 et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.HTML32, myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.HTML32, fileName);
8.
Dans l'instruction Case ExportFormatType.HTML40 proc&eacute;dez comme suit :
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPathHTML40, puis ajoutez-lui le nom d'un
document avec une extension de fichier .html.
myFileName = exportPathHTML40 &amp; &quot;HTML40.html&quot;
fileName = exportPathHTML40 + &quot;HTML40.html&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.HTML40 et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.HTML40,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.HTML40,
fileName);
9.
466
Dans l'instruction Case ExportFormatType.ExcelRecord proc&eacute;dez comme suit :
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
a) Attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath, puis ajoutez-lui le nom d'un document avec
une extension de fichier .xls.
myFileName = exportPath &amp; &quot;ExcelRecord.xls&quot;
fileName = exportPath + &quot;ExcelRecord.xls&quot;;
b) Appelez la m&eacute;thode ExportToDisk() &agrave; partir de l'instance hierarchicalGroupingReport, puis
transmettez ExportFormatType.ExcelRecord et la cha&icirc;ne de nom de fichier.
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.ExcelRecord,
myFileName)
hierarchicalGroupingReport.ExportToDisk(ExportFormatType.ExcelRecord,
fileName);
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour exporter votre rapport Crystal dans diff&eacute;rents
formats.
Si vous souhaitez utiliser d'autres m&eacute;thodes API am&eacute;lior&eacute;es, cliquez sur un des liens ci-dessous pour atteindre la
section qui vous int&eacute;resse :
●
Utilisation de la m&eacute;thode ExportToHttpResponse() [page 467]
●
Utilisation de la m&eacute;thode ExportToStream() [page 473]
1.5.2.7.6.3
Utilisation de la m&eacute;thode
ExportToHttpResponse()
La m&eacute;thode ExportToHttpResponse() permet d'exporter votre rapport Crystal vers une fen&ecirc;tre de navigateur
ou sous forme de pi&egrave;ce jointe. Cette m&eacute;thode s'applique uniquement aux sites Web.
Les m&eacute;thodes surcharg&eacute;es disponibles pour la m&eacute;thode ExportToHttpResponse() sont notamment les
suivantes :
●
ExportToHttpResponse(CrystalDecisions.Shared.ExportFormatType formatType,
System.Web.HttpResponse response, bool asAttachment, string attachmentName)
●
ExportToHttpResponse(CrystalDecisions.Shared.ExportOptions options,
System.Web.HttpResponse response, bool asAttachment, string attachmentName)
La m&eacute;thode ExportToHttpResponse() ne prend pas en charge les exportations vers HTTP Response pour les
formats HTML32 et HTML40. Par cons&eacute;quent, lorsque vous essayez d'effectuer une exportation au format
HTML32 ou HTML40, un message d'erreur s'affiche.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
467
Si la variable bool&eacute;enne asAttachment a la valeur True, une bo&icirc;te de dialogue T&eacute;l&eacute;chargement de fichier appara&icirc;t.
Si la variable bool&eacute;enne asAttachment a la valeur False, le rapport export&eacute; s'ouvre dans la fen&ecirc;tre du navigateur.
Lorsque vous choisissez d'enregistrer le fichier, le nom de fichier a pour valeur la variable de type cha&icirc;ne
attachmentName. Si vous ne sp&eacute;cifiez pas la variable attachmentName, le nom de fichier par d&eacute;faut est &quot;Sans
titre&quot; avec l'extension de fichier sp&eacute;cifi&eacute;e. Le nom de fichier peut &ecirc;tre modifi&eacute; dans la bo&icirc;te de dialogue Enregistrer
sous.
1.5.2.7.6.3.1
Utilisation de la m&eacute;thode
ExportToHttpResponse() avec l'&eacute;num&eacute;ration
ExportFormatType
Pour utiliser la m&eacute;thode ExportToHttpResponse()avec le param&egrave;tre ExportFormatType, vous devez effectuer la
proc&eacute;dure Ajout de contr&ocirc;les au Web Form ou Windows Form [page 435] pour un site Web. Vous n'avez pas
besoin des m&eacute;thodes ExportSetup(), ExportSelection() et ExportCompletion(). Le code n&eacute;cessaire est plac&eacute; dans
la m&eacute;thode d'&eacute;v&eacute;nement de clic exportByType.
1.5.2.7.6.3.1.1
Pour utiliser la m&eacute;thode
ExportToHttpResponse() avec le param&egrave;tre ExportFormatType
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button exportByType.
La m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click() est cr&eacute;&eacute;e et vous passez en mode code.
4.
Au d&eacute;but de la classe, ajoutez une d&eacute;claration de classe ExportOptions.
Private myExportOptions As ExportOptions
private ExportOptions exportOptions;
5.
Dans la m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click(), instanciez l'instance ExportOptions.
myExportOptions = New ExportOptions()
exportOptions = new ExportOptions();
6.
Cr&eacute;ez un bloc try/catch avec la classe Exception r&eacute;f&eacute;renc&eacute;e en tant que variable intitul&eacute;e &quot;ex&quot;.
Try
468
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Catch ex As Exception
End Try
try
{
}
catch (Exception ex)
{
}
7.
Dans le bloc try, cr&eacute;ez un bloc conditionnel pour v&eacute;rifier si l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; &agrave; partir de l'instance
exportTypesList est &eacute;gal &agrave; l'instance ExportFormatType.NoFormat.
If (exportTypesList.SelectedIndex = ExportFormatType.NoFormat) Then
Else
End If
if ((ExportFormatType)exportTypesList.SelectedIndex == ExportFormatType.NoFormat)
{
}
else
{
}
8.
Dans le bloc If, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante
FORMAT_NOT_SUPPORTED de la classe MessageConstants.
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
9.
Dans le bloc Else, affectez l'instance ExportFormatType s&eacute;lectionn&eacute;e dans exportTypesList &agrave; la propri&eacute;t&eacute;
ExportFormatType de l'instance ExportOptions.
myExportOptions.ExportFormatType = exportTypesList.SelectedIndex
exportOptions.ExportFormatType =
(ExportFormatType)exportTypesList.SelectedIndex;
10. Dans le bloc Else, appelez la m&eacute;thode ExportToHttpResponse() de l'instance hierarchicalGroupingReport.
Transmettez l'instance ExportOptions, l'objet de r&eacute;ponse ASP.NET, une valeur bool&eacute;enne True et une cha&icirc;ne
de nom de fichier comme param&egrave;tres de la m&eacute;thode.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
469
Remarque
La cha&icirc;ne de nom de fichier de la pi&egrave;ce jointe ne n&eacute;cessite aucune extension, car celle-ci est
automatiquement ajout&eacute;e au fichier export&eacute;.
hierarchicalGroupingReport.ExportToHttpResponse(myExportOptions,
Response, True, &quot;ExportedReport&quot;)
hierarchicalGroupingReport.ExportToHttpResponse(exportOptions,
Response, True, &quot;ExportedReport&quot;);
11. Dans le bloc catch, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante FAILURE de la classe
MessagesConstants, puis ajoutez-lui la propri&eacute;t&eacute; Message du param&egrave;tre Exception.
message.Text = MessageConstants.FAILURE &amp; ex.Message
message.Text = MessageConstants.FAILURE + ex.Message;
12. En dehors du bloc try/catch, attribuez &agrave; la propri&eacute;t&eacute; Visible du contr&ocirc;le Label message la valeur &quot;True&quot;.
message.Visible = True
message.Visible = true;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour exporter votre rapport Crystal dans diff&eacute;rents
formats.
Si vous souhaitez utiliser la m&eacute;thode ExportToHttpResponse() avec la classe ExportOptions, voir Utilisation de la
m&eacute;thode ExportToHttpResponse() avec la classe ExportOptions [page 470].
Pour utiliser d'autres m&eacute;thodes API am&eacute;lior&eacute;es, cliquez sur un des liens ci-dessous pour atteindre la section qui
vous int&eacute;resse :
●
Utilisation de la m&eacute;thode ExportToDisk() [page 457]
●
Utilisation de la m&eacute;thode ExportToStream() [page 473]
1.5.2.7.6.3.2
Utilisation de la m&eacute;thode
ExportToHttpResponse() avec la classe ExportOptions
Pour utiliser la m&eacute;thode ExportToHttpResponse() avec le param&egrave;tre ExportOptions, vous devez effectuer la
proc&eacute;dure Ajout de contr&ocirc;les au Web Form ou Windows Form [page 435] pour un site Web. Vous n'avez pas
470
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
besoin des m&eacute;thodes ExportSetup(), ExportSelection() et ExportCompletion(). Le code n&eacute;cessaire est plac&eacute; dans
la m&eacute;thode d'&eacute;v&eacute;nement de clic exportByType.
1.5.2.7.6.3.2.1
Pour utiliser la m&eacute;thode
ExportToHttpResponse() avec le param&egrave;tre ExportOptions
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Cliquez deux fois sur le contr&ocirc;le Button exportByType.
La m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click() est cr&eacute;&eacute;e et vous passez en mode code.
4.
Dans la m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click(), cr&eacute;ez un bloc try/catch avec la classe Exception
r&eacute;f&eacute;renc&eacute;e en tant que variable intitul&eacute;e &quot;ex&quot;.
Try
Catch ex As Exception
End Try
try
{
}
catch (Exception ex)
{
}
5.
Dans le bloc try, cr&eacute;ez un bloc conditionnel pour v&eacute;rifier si l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; &agrave; partir de l'instance
exportTypesList est &eacute;gal &agrave; l'instance ExportFormatType.NoFormat.
If (exportTypesList.SelectedIndex = ExportFormatType.NoFormat) Then
Else
End If
if ((ExportFormatType)exportTypesList.SelectedIndex ==
ExportFormatType.NoFormat)
{
}
else
{
}
6.
Dans le bloc If, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante
FORMAT_NOT_SUPPORTED de la classe MessageConstants.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
471
Remarque
La condition If est remplie lorsque la valeur NoFormat du contr&ocirc;le DropDownList est s&eacute;lectionn&eacute;e.
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
7.
Dans le bloc Else, appelez la m&eacute;thode ExportToHttpResponse() de l'instance hierarchicalGroupingReport.
Transmettez l'instance ExportFormatType s&eacute;lectionn&eacute;e, l'objet de r&eacute;ponse ASP.NET, une valeur bool&eacute;enne
True et une cha&icirc;ne de nom de fichier comme param&egrave;tres de la m&eacute;thode.
Remarque
La cha&icirc;ne de nom de fichier de la pi&egrave;ce jointe ne n&eacute;cessite aucune extension, car celle-ci est
automatiquement ajout&eacute;e au fichier export&eacute;.
hierarchicalGroupingReport.ExportToHttpResponse(exportTypesList.SelectedIndex,
Response, True, &quot;ExportedReport&quot;)
hierarchicalGroupingReport.ExportToHttpResponse((ExportFormatType)exportTypesList
.SelectedIndex,
Response, True, &quot;ExportedReport&quot;);
8.
Dans le bloc catch, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante FAILURE de la classe
MessagesConstants, puis ajoutez-lui la propri&eacute;t&eacute; Message du param&egrave;tre Exception.
message.Text = MessageConstants.FAILURE &amp; ex.Message
message.Text = MessageConstants.FAILURE + ex.Message;
9.
En dehors du bloc try/catch, attribuez &agrave; la propri&eacute;t&eacute; Visible du contr&ocirc;le Label message la valeur &quot;True&quot;.
message.Visible = True
message.Visible = true;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour exporter votre rapport Crystal dans diff&eacute;rents
formats.
Pour utiliser d'autres m&eacute;thodes API am&eacute;lior&eacute;es, cliquez sur un des liens ci-dessous pour atteindre la section qui
vous int&eacute;resse :
472
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
●
Utilisation de la m&eacute;thode ExportToDisk() [page 457]
●
Utilisation de la m&eacute;thode ExportToStream() [page 473]
1.5.2.7.6.4
Utilisation de la m&eacute;thode ExportToStream()
Dans cette section, vous allez apprendre &agrave; utiliser la m&eacute;thode ExportToStream() pour exporter le rapport vers le
flux d'entr&eacute;e/sortie sous la forme d'une s&eacute;quence d'octets. Vous allez ensuite apprendre &agrave; &eacute;crire la s&eacute;quence
d'octets dans un fichier au format que vous avez sp&eacute;cifi&eacute;.
Lorsque vous exportez le rapport au format HTML, les images ne sont pas export&eacute;es. Il est recommand&eacute; d'utiliser
les m&eacute;thodes ExportToHttpResponse() pour exporter des rapports au format HTML.
Conditions pr&eacute;requises :
●
Vous devez cr&eacute;er un projet en suivant les instructions de la section Configuration d'un projet pour la m&eacute;thode
ExportToStream() [page 473].
●
Ou vous devez cr&eacute;er un projet en suivant les instructions de la section Cr&eacute;ation de m&eacute;thodes pour les
nouveaux formats d'exportation [page 455].
Vous devez ensuite modifier le projet comme indiqu&eacute; dans la section Pr&eacute;paration du projet pour la m&eacute;thode
ExportToStream() [page 475].
1.5.2.7.6.4.1
Configuration d'un projet pour la m&eacute;thode
ExportToStream()
Dans cette section, vous allez apprendre &agrave; cr&eacute;er un projet pour la m&eacute;thode ExportToStream().
1.5.2.7.6.4.1.1
Pour configurer un nouveau projet pour la
m&eacute;thode ExportToStream()
Proc&eacute;dure
1.
Suivez les instructions de la section Ajout de contr&ocirc;les au Web Form ou Windows Form [page 435].
2.
Cr&eacute;ez la m&eacute;thode ExportSetup() et la m&eacute;thode ExportSelection() indiqu&eacute;es dans la section Cr&eacute;ation
de m&eacute;thodes ex&eacute;cutant l'exportation [page 437].
3.
Dans l'instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] de la m&eacute;thode
ExportSelection(), ajoutez une instruction Case pour le format ExcelRecord.
Case ExportFormatType.ExcelRecord
case ExportFormatType.ExcelRecord:
break;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
473
4.
Cr&eacute;ez un bloc conditionnel pour v&eacute;rifier la variable bool&eacute;enne selectedNoFormat.
If selectedNoFormat Then
Else
End If
if (selectedNoFormat)
{
}
else
{
}
5.
Dans le bloc If, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante
FORMAT_NOT_SUPPORTED de la classe MessageConstants.
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
6.
Dans le bloc Else, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante SUCCESS de la classe
MessageConstants.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
7.
Cr&eacute;ez un bloc try/catch avec la classe Exception r&eacute;f&eacute;renc&eacute;e en tant que variable intitul&eacute;e &quot;ex&quot;. Le bloc try
inclut l'instruction &quot;Select Case&quot; [Visual Basic] ou &quot;switch&quot; [C#] et le bloc conditionnel.
Try
Catch ex As Exception
End Try
try
{
}
catch (Exception ex)
{
}
8.
Dans le bloc catch, attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante FAILURE de la classe
MessagesConstants, puis ajoutez-lui la propri&eacute;t&eacute; Message du param&egrave;tre Exception.
message.Text = MessageConstants.FAILURE &amp; ex.Message
474
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
message.Text = MessageConstants.FAILURE + ex.Message;
9.
En dehors du bloc try/catch, attribuez &agrave; la propri&eacute;t&eacute; Visible du contr&ocirc;le Label message la valeur &quot;True&quot;.
message.Visible = True
message.Visible = true;
10. Dans le menu Affichage, cliquez sur Concepteur.
11. Cliquez deux fois sur le contr&ocirc;le Button exportByType.
La m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click() est cr&eacute;&eacute;e et vous passez en mode code.
12. Dans la m&eacute;thode d'&eacute;v&eacute;nement exportByType_Click(), saisissez les appels aux m&eacute;thodes ExportSetup()
et ExportSelection().
ExportSetup()
ExportSelection()
ExportSetup();
ExportSelection();
1.5.2.7.6.4.2
Pr&eacute;paration du projet pour la m&eacute;thode
ExportToStream()
Dans cette section, vous allez apprendre &agrave; modifier un projet r&eacute;sultant de la proc&eacute;dure de la section Cr&eacute;ation de
m&eacute;thodes pour les nouveaux formats d'exportation [page 455].
Vous devez &agrave; pr&eacute;sent supprimer certaines lignes de code inutiles pour la m&eacute;thode ExportToStream().
1.5.2.7.6.4.2.1
Pour modifier le projet afin d'utiliser la
m&eacute;thode ExportToStream()
Proc&eacute;dure
1.
Ouvrez le projet.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
En haut de la classe, supprimez les d&eacute;clarations de classe suivantes :
Private myDiskFileDestinationOptions As DiskFileDestinationOptions
Private myExportOptions As ExportOptions
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
475
private DiskFileDestinationOptions diskFileDestinationOptions;
private ExportOptions exportOptions;
5.
Dans la m&eacute;thode ExportSetup(), supprimez toutes les lignes de code situ&eacute;es apr&egrave;s le bloc conditionnel. (La
derni&egrave;re ligne de code qui appelle la propri&eacute;t&eacute; ExportFormatOptions s'applique uniquement &agrave; un projet
Windows.)
myDiskFileDestinationOptions = New DiskFileDestinationOptions()
myExportOptions = hierarchicalGroupingReport.ExportOptions
myExportOptions.ExportDestinationType = ExportDestinationType.DiskFile
myExportOptions.ExportFormatOptions = Nothing
diskFileDestinationOptions = new DiskFileDestinationOptions();
exportOptions = hierarchicalGroupingReport.ExportOptions;
exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
exportOptions.ExportFormatOptions = null;
6.
7.
Supprimez les m&eacute;thodes de configuration d'exportation suivantes :
○
ConfigureExportToRpt()
○
ConfigureExportToRtf()
○
ConfigureExportToDoc()
○
ConfigureExportToXls()
○
ConfigureExportToPdf()
○
ConfigureExportToHtml32()
○
ConfigureExportToHtml40()
○
ConfigureExportToXlsRec()
Dans les instructions Case Select Case [Visual Basic] ou switch [C#] de ExportSelection(),
supprimez les appels aux m&eacute;thodes de configuration d'exportation.
8.
Dans la m&eacute;thode ExportCompletion(), supprimez l'appel &agrave; la m&eacute;thode Export().
9.
Copiez et collez la totalit&eacute; du code de la m&eacute;thode ExportCompletion() au d&eacute;but de la m&eacute;thode
ExportSelection().
10. Supprimez la m&eacute;thode ExportCompletion() et l'appel &agrave; la m&eacute;thode ExportCompletion() dans
l'&eacute;v&eacute;nement de clic exportByType.
11. Dans la m&eacute;thode ExportSelection(), coupez et collez les instructions Case Select Case [Visual
Basic] ou switch [C#] au-dessus du bloc If dans le bloc try.
Le bloc try/catch ressemble maintenant &agrave; ceci :
Try
Select Case exportTypesList.SelectedIndex
Case ExportFormatType.NoFormat
selectedNoFormat = True
Case ExportFormatType.CrystalReport
Case ExportFormatType.RichText
Case ExportFormatType.WordForWindows
Case ExportFormatType.Excel
Case ExportFormatType.PortableDocFormat
476
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Case ExportFormatType.HTML32
Case ExportFormatType.HTML40
End Select
If selectedNoFormat Then
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED
Else
message.Text = MessageConstants.SUCCESS
End If
Catch ex As Exception
message.Text = MessageConstants.FAILURE &amp; ex.Message
End Try
try
{
switch ((ExportFormatType)exportTypesList.SelectedIndex)
{
case ExportFormatType.NoFormat:
selectedNoFormat = true;
break;
case ExportFormatType.CrystalReport:
break;
case ExportFormatType.RichText:
break;
case ExportFormatType.WordForWindows:
break;
case ExportFormatType.Excel:
break;
case ExportFormatType.PortableDocFormat:
break;
case ExportFormatType.HTML32:
break;
case ExportFormatType.HTML40:
break;
case ExportFormatType.ExcelRecord:
break;
}
if (selectedNoFormat)
{
message.Text = MessageConstants.FORMAT_NOT_SUPPORTED;
}
else
{
message.Text = MessageConstants.SUCCESS;
}
}
catch (Exception ex)
{
message.Text = MessageConstants.FAILURE + ex.Message;
}
1.5.2.7.6.4.3
Modification des instructions Case dans la
m&eacute;thode ExportSelection()
Dans cette section, vous allez apprendre &agrave; d&eacute;finir une cha&icirc;ne de nom de fichier pour chaque instruction Case
ExportFormatType.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
477
1.5.2.7.6.4.3.1
Pour modifier les instructions Case dans la
m&eacute;thode ExportSelection()
Proc&eacute;dure
1.
Dans la m&eacute;thode ExportSelection(), d&eacute;clarez une variable de type cha&icirc;ne et instanciez la variable sur une
cha&icirc;ne vide.
Dim myFileName As String = &quot;&quot;
string fileName = &quot;&quot;;
2.
Dans l'instruction Case ExportFormatType.CrystalReport, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath, suivie d'un nom de document avec une extension de fichier .rpt.
myFileName = exportPath &amp; &quot;Report.rpt&quot;
myFileName = exportPath + &quot;Report.rpt&quot;;
3.
Dans l'instruction Case ExportFormatType.RichText, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath suivie d'un nom de document avec une extension de fichier .rtf.
myFileName = exportPath &amp; &quot;RichTextFormat.rtf&quot;
myFileName = exportPath + &quot;RichTextFormat.rtf&quot;;
4.
Dans l'instruction Case ExportFormatType.WordForWindows, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath suivie d'un nom de document avec une extension de fichier .doc.
myFileName = exportPath &amp; &quot;Word.doc&quot;
fileName = exportPath + &quot;Word.doc&quot;;
5.
Dans l'instruction Case ExportFormatType.Excel, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne exportPath
suivie d'un nom de document avec une extension de fichier .xls.
myFileName = exportPath &amp; &quot;Excel.xls&quot;
fileName = exportPath + &quot;Excel.xls&quot;;
6.
Dans l'instruction Case ExportFormatType.PortableDocFormat, attribuez &agrave; la cha&icirc;ne de nom de fichier la
cha&icirc;ne exportPath suivie d'un nom de document avec une extension de fichier .pdf.
myFileName = exportPath &amp; &quot;PortableDoc.pdf&quot;
478
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
fileName = exportPath + &quot;PortableDoc.pdf&quot;;
7.
Dans l'instruction Case ExportFormatType.HTML32, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath suivie d'un nom de document avec une extension de fichier .html.
myFileName = exportPath &amp; &quot;HTML32.html&quot;
fileName = exportPath + &quot;HTML32.html&quot;;
8.
Dans l'instruction Case ExportFormatType.HTML40, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath suivie d'un nom de document avec une extension de fichier .html.
myFileName = exportPath &amp; &quot;HTML40.html&quot;
fileName = exportPath + &quot;HTML40.html&quot;;
9.
Dans l'instruction Case ExportFormatType.ExcelRecord, attribuez &agrave; la cha&icirc;ne de nom de fichier la cha&icirc;ne
exportPath suivie d'un nom de document avec une extension de fichier .xls.
myFileName = exportPath &amp; &quot;ExcelRecord.xls&quot;
fileName = exportPath + &quot;ExcelRecord.xls&quot;;
1.5.2.7.6.4.4
Appel de la m&eacute;thode ExportToStream()
Dans cette section, vous allez apprendre &agrave; appeler la m&eacute;thode ExportToStream() et &agrave; &eacute;crire les donn&eacute;es du
rapport export&eacute; dans un fichier au format que vous avez sp&eacute;cifi&eacute;.
1.5.2.7.6.4.4.1
Pour appeler la m&eacute;thode ExportToStream()
dans la m&eacute;thode ExportSelection()
Proc&eacute;dure
1.
Au-dessus de la signature de classe, ajoutez une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot;
[C#] au d&eacute;but de la classe pour l'espace de noms System.IO.
Imports System.IO
using System.IO;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
479
2.
Dans le bloc Else de la m&eacute;thode ExportSelection(), appelez la m&eacute;thode ExportToStream() de l'instance
hierarchicalGroupingReport, transmettez l'instance ExportFormatType s&eacute;lectionn&eacute;e dans le contr&ocirc;le
dropdownlist exportTypesList et affectez l'instance &agrave; la classe Stream.
Stream myStream =
hierarchicalGroupingReport.ExportToStream(exportTypesList.SelectedIndex)
Stream stream =
hierarchicalGroupingReport.ExportToStream((ExportFormatType)exportTypesList.Selec
tedIndex);
3.
Cr&eacute;ez un tableau d'octets de m&ecirc;me longueur que l'instance Stream.
Dim myDataArray As byte() = New byte(myStream.Length)
byte[] dataArray = new byte[stream.Length];
4.
Envoyez les donn&eacute;es de l'instance Stream au tableau d'octets d'un d&eacute;calage de z&eacute;ro jusqu'&agrave; la longueur de
l'instance Stream.
myStream.Read(myDataArray, 0, Convert.ToInt32(myStream.Length));
stream.Read(dataArray, 0, Convert.ToInt32(stream.Length));
5.
Cr&eacute;ez une instance FileStream qui cr&eacute;e le fichier sp&eacute;cifi&eacute; par la variable cha&icirc;ne de nom de fichier.
Dim myFileStream As FileStream = New FileStream(myFileName,
System.IO.FileMode.Create)
FileStream fileStream = new FileStream(fileName, System.IO.FileMode.Create);
6.
Transf&eacute;rez les donn&eacute;es stock&eacute;es dans le tableau d'octets vers le fichier d'un d&eacute;calage de z&eacute;ro jusqu'&agrave; la
longueur du tableau d'octets.
myFileStream.Write(myDataArray, 0, myDataArray.Length)
fileStream.Write(dataArray, 0, dataArray.Length);
7.
Fermez l'instance FileStream et l'instance Stream.
myFileStream.Close()
myStream.Close()
fileStream.Close();
stream.Close();
480
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
8.
Attribuez &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label message la constante SUCCESS de la classe
MessageConstants.
message.Text = MessageConstants.SUCCESS
message.Text = MessageConstants.SUCCESS;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter le projet pour exporter votre rapport Crystal dans diff&eacute;rents
formats.
Si vous souhaitez utiliser d'autres m&eacute;thodes API am&eacute;lior&eacute;es, cliquez sur un des liens ci-dessous pour atteindre la
section qui vous int&eacute;resse :
●
Utilisation de la m&eacute;thode ExportToDisk() [page 457]
●
Utilisation de la m&eacute;thode ExportToHttpResponse() [page 467]
1.5.2.8
Tutoriel : Filtrage des donn&eacute;es &agrave; l'aide des formules
de s&eacute;lection
Dans ce tutoriel, vous allez apprendre &agrave; filtrer les donn&eacute;es dans le mod&egrave;le d'objet ReportDocument en d&eacute;finissant
la propri&eacute;t&eacute; RecordSelectionFormula de la classe DataDefinition.
Introduction
Les formules de s&eacute;lection servent &agrave; filtrer les enregistrements &agrave; afficher dans un rapport Crystal. Pour &eacute;crire des
formules de s&eacute;lection, vous pouvez utiliser la syntaxe Basic ou la syntaxe Crystal.
Dans ce tutoriel, vous allez cr&eacute;er une formule de s&eacute;lection afin de filtrer les enregistrements clients dans lesquels
le champ Ventes de l'ann&eacute;e derni&egrave;re est sup&eacute;rieur &agrave; une valeur sp&eacute;cifique et le champ Nom du client est compar&eacute;
&agrave; une autre cha&icirc;ne. Un contr&ocirc;le DropDownList (Web) ou ComboBox (Windows) s&eacute;lectionne un op&eacute;rateur de
comparaison pour le champ Nom du client. Vous pouvez choisir d'afficher les noms de client qui sont &eacute;gaux,
inf&eacute;rieurs, sup&eacute;rieurs, inf&eacute;rieurs ou &eacute;gaux, sup&eacute;rieurs ou &eacute;gaux, ou pas &eacute;gaux &agrave; la valeur de cha&icirc;ne que vous avez
sp&eacute;cifi&eacute;e.
La formule est transmise sous forme de variable cha&icirc;ne &agrave; la propri&eacute;t&eacute; SelectionFormula de la classe
CrystalReportViewer. Une fois la propri&eacute;t&eacute; d&eacute;finie, le rapport Crystal li&eacute; au contr&ocirc;le CrystalReportViewer est filtr&eacute;
avant d'&ecirc;tre affich&eacute;.
Ce tutoriel peut &eacute;galement &ecirc;tre effectu&eacute; avec des classes du mod&egrave;le d'objet CrystalReportViewer, bien qu'il soit
recommand&eacute; d'utiliser le mod&egrave;le d'objet ReportDocument.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
481
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les fichiers de
chaque version d'exemple de code sont stock&eacute;s dans les dossiers suivants :
●
Site Web C# : CS_Web_RDObjMod_SavedDataSelectionFormula
●
Projet Windows C# : CS_Win_RDObjMod_SavedDataSelectionFormula
●
Site Web Visual Basic : VB_Web_RDObjMod_SavedDataSelectionFormula
●
Projet Windows Visual Basic : VB_Win_RDObjMod_SavedDataSelectionFormula
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
Choisir le mod&egrave;le d'objet correct pour votre projet [page 32]
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.8.1
Cr&eacute;ation d'un rapport
Pour commencer, vous allez cr&eacute;er un rapport Crystal dans lequel vous allez filtrer les donn&eacute;es.
1.5.2.8.1.1
Pour cr&eacute;er un rapport Crystal
Contexte
Remarque
Cette proc&eacute;dure fonctionne uniquement avec un projet cr&eacute;&eacute; &agrave; partir de la proc&eacute;dure Configuration d'un projet
[page 15]. La section Configuration d'un projet contient une configuration de r&eacute;f&eacute;rences d'espaces de noms et
de code sp&eacute;cifique n&eacute;cessaire &agrave; cette proc&eacute;dure. Il est impossible de suivre cette proc&eacute;dure sans cette
configuration.
482
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le Rapport
Crystal.
3.
Dans le champ Nom, saisissez le nom &quot;CustomerBySalesName.rpt&quot;, puis cliquez sur Ajouter.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
8.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; l'exemple de base de donn&eacute;es
Xtreme, puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
9.
D&eacute;veloppez le nœud Tables et s&eacute;lectionnez la table Clients.
10. Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
11. Utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner Nom du client, Ventes de l'ann&eacute;e derni&egrave;re et
Ville.
12. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur le
bouton Terminer.
Le rapport CustomerBySalesName est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
13. Cliquez sur Aper&ccedil;u Rapport principal.
Un aper&ccedil;u du rapport s'affiche contenant toutes les donn&eacute;es disponibles. Vous filtrerez ensuite ces donn&eacute;es
par programmation.
14. Cliquez sur Rapport principal pour quitter le mode Aper&ccedil;u.
1.5.2.8.2
Liaison du rapport
Durant la proc&eacute;dure Configuration d'un projet [page 15], vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer dans un
Web Form ou Windows Form. Lors de l'&eacute;tape pr&eacute;c&eacute;dente, vous avez ajout&eacute; un rapport CustomerBySalesName au
projet.
Dans cette section, vous allez instancier le rapport CustomerBySalesName et le lier au contr&ocirc;le
CrystalReportViewer.
Vous pouvez instancier et lier le rapport de deux fa&ccedil;ons :
●
En tant que rapport incorpor&eacute;.
●
En tant que rapport non incorpor&eacute;.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous.
●
Si vous utilisez des rapports incorpor&eacute;s, effectuez la proc&eacute;dure suivante afin d'instancier le rapport sous
forme de rapport incorpor&eacute;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
483
●
Si vous utilisez des rapports non incorpor&eacute;s, effectuez la seconde proc&eacute;dure afin d'instancier le rapport sous
forme de rapport non incorpor&eacute;.
1.5.2.8.2.1
Pour instancier le rapport CustomerBySalesName
sous forme de rapport incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport CustomerBySalesName,
en utilisant la variable customerBySalesNameReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customerBySalesNameReport As CustomerBySalesName
private CustomerBySalesName customerBySalesNameReport;
4.
Dans la m&eacute;thode ConfigureCrystalReports(), instanciez la classe wrapper du rapport.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans Configuration d'un projet [page 15].
customerBySalesNameReport = New CustomerBySalesName()
customerBySalesNameReport = new CustomerBySalesName();
5.
Sur la ligne suivante, au-dessous de l'instanciation du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; la classe de rapport instanci&eacute;e (nom de la variable : customerBySalesNameReport).
myCrystalReportViewer.ReportSource = customerBySalesNameReport
crystalReportViewer.ReportSource = customerBySalesNameReport;
R&eacute;sultats
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Passez &agrave; la section suivante ci-dessous.
484
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.8.2.2
Pour instancier le rapport CustomerBySalesName
sous forme de rapport non incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport ReportDocument, avec la
variable customerBySalesNameReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customerBySalesNameReport As ReportDocument
private ReportDocument customerBySalesNameReport;
Remarque
La classe ReportDocument est un membre de l'espace de noms
CrystalDecisions.CrystalReports.Engine. Vous avez ajout&eacute; une d&eacute;claration &quot;Imports&quot; [Visual
Basic] ou &quot;using&quot; [C#] pour cet espace de noms dans la section Configuration d'un projet [page 15].
Lorsque vous instanciez ReportDocument et chargez un rapport dans l'espace de noms, vous acc&eacute;dez au
rapport via le SDK sans l'incorporer.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans la section Configuration d'un
projet [page 15]), instanciez la classe ReportDocument.
customerBySalesNameReport = New ReportDocument()
customerBySalesNameReport = new ReportDocument();
5.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;CustomerBySalesName.rpt&quot;)
string reportPath = Server.MapPath(&quot;CustomerBySalesName.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
485
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp;
&quot;CustomerBySalesName.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; +
&quot;CustomerBySalesName.rpt&quot;;
6.
Appelez la m&eacute;thode Load() de l'instance ReportDocument et transmettez-lui la variable cha&icirc;ne reportPath.
customerBySalesNameReport.Load(reportPath)
customerBySalesNameReport.Load(reportPath);
7.
Sur la ligne suivante, sous le chargement du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer &agrave; l'instance ReportDocument.
myCrystalReportViewer.ReportSource = customerBySalesNameReport
crystalReportViewer.ReportSource = customerBySalesNameReport;
R&eacute;sultats
Que vous ayez choisi d'instancier une classe de rapport incorpor&eacute; ou une classe de rapport non incorpor&eacute; via la
classe ReportDocument, le nom de la variable utilis&eacute;e est identique : customerBySalesNameReport. Vous pouvez
ainsi utiliser un bloc de code commun dans les proc&eacute;dures suivantes.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet.
1.5.2.8.2.3
Pour tester le chargement du rapport
CustomerBySalesName
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
486
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
Si vous utilisez un rapport non incorpor&eacute; dans un projet Windows, recherchez l'ex&eacute;cutable Windows compil&eacute;
dans le sous-r&eacute;pertoire \bin\ [Visual Basic] ou \bin\debug\ [C#], puis copiez le rapport dans ce
sous-r&eacute;pertoire.
Remarque
Pour que le rapport non incorpor&eacute; soit charg&eacute; par l'ex&eacute;cutable Windows au moment de l'ex&eacute;cution, le
rapport doit &ecirc;tre stock&eacute; dans le m&ecirc;me r&eacute;pertoire que l'ex&eacute;cutable Windows.
4.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport appara&icirc;t et affiche toutes les lignes de donn&eacute;es disponibles. Dans la section suivante, vous allez
commencer &agrave; filtrer les donn&eacute;es &agrave; l'aide de la propri&eacute;t&eacute; RecordSelectionFormula.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.8.3
Application d'un filtre aux donn&eacute;es du rapport
Dans cette section, vous allez apprendre &agrave; appliquer un filtre aux donn&eacute;es du rapport.
1.5.2.8.3.1
Pour appliquer un filtre aux donn&eacute;es du rapport
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Au d&eacute;but de la classe, ajoutez trois nouvelles d&eacute;clarations de variables de niveau classe qui repr&eacute;senteront les
valeurs selon lesquelles les donn&eacute;es seront filtr&eacute;es.
Private salesAmount As String
Private operatorValue As String
Private customerName As String
private string salesAmount;
private string operatorValue;
private string customerName;
4.
Si vous cr&eacute;ez un projet Windows, ajoutez une d&eacute;claration de variable de niveau classe suppl&eacute;mentaire, une
variable bool&eacute;enne appel&eacute;e useDefaultValues, puis affectez-lui la valeur True.
Private useDefaultValues As Boolean = True
private bool useDefaultValues = true;
5.
Dans la m&eacute;thode ConfigureCrystalReports(), cr&eacute;ez un bloc conditionnel.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
487
○
Si vous cr&eacute;ez un site Web, cr&eacute;ez un bloc conditionnel Not IsPostBack. Placez ce bloc au-dessus du code
existant dans la m&eacute;thode.
If Not IsPostBack Then
End If
if (!IsPostBack)
{
}
○
Si vous cr&eacute;ez un projet Windows, cr&eacute;ez un bloc conditionnel useDefaultValues. Placez ce bloc au-dessus
du code existant dans la m&eacute;thode.
If useDefaultValues Then
End If
if (useDefaultValues)
{
}
6.
Dans le bloc conditionnel, affectez les valeurs 4000, &lt; et K aux trois variables de niveau classe.
Ces valeurs sont affect&eacute;es dans un bloc conditionnel, car plus tard vous les remplacerez par un &eacute;v&eacute;nement de
clic.
salesAmount = &quot;4000&quot;
operatorValue = &quot;&lt;&quot;
customerName = &quot;K&quot;
salesAmount = &quot;4000&quot;;
operatorValue = &quot;&lt;&quot;;
customerName = &quot;K&quot;;
7.
Imm&eacute;diatement en dessous et en dehors du bloc conditionnel, cr&eacute;ez une cha&icirc;ne selectionFormula dans
laquelle vous ajoutez des litt&eacute;raux aux variables de niveau classe que vous venez de cr&eacute;er.
Dim selectionFormula As String = &quot;{Customer.Last Year's Sales} &gt;
&quot; _
&amp; salesAmount _
&amp; &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; _
&amp; operatorValue _
&amp; &quot;'&quot; _
&amp; customerName _
&amp; &quot;'&quot;
string selectionFormula = &quot;{Customer.Last Year's Sales} &gt; &quot;
+ salesAmount
+ &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot;
+ operatorValue
+ &quot;'&quot;
+ customerName
+ &quot;'&quot;;
488
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
8.
Dans le code de liaison de rapport que vous avez cr&eacute;&eacute; pr&eacute;c&eacute;demment, cr&eacute;ez un saut de ligne juste au-dessus
de la ligne de code dans laquelle customerBySalesName est affect&eacute; &agrave; la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportViewer.
9.
Dans ce saut de ligne, affectez la variable cha&icirc;ne selectionFormula &agrave; l'instance ReportDocument.
customerBySalesNameReport.DataDefinition.RecordSelectionFormula =
selectionFormula
customerBySalesNameReport.DataDefinition.RecordSelectionFormula =
selectionFormula;
10. Compilez et affichez votre application.
Les donn&eacute;es devraient maintenant &ecirc;tre filtr&eacute;es.
11. Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
R&eacute;sultats
Dans la section suivante, vous allez cr&eacute;er des contr&ocirc;les sur le formulaire qui permettront d'ajuster de fa&ccedil;on
dynamique la formule de s&eacute;lection.
1.5.2.8.4
Ajout de contr&ocirc;les pour le filtrage dynamique
Dans cette section, vous allez ajouter des contr&ocirc;les que vous utiliserez dans la formule de s&eacute;lection. Ces contr&ocirc;les
permettront de filtrer les donn&eacute;es de fa&ccedil;on dynamique.
1.5.2.8.4.1
s&eacute;lection
Pour ajouter des contr&ocirc;les dans la formule de
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Si vous d&eacute;veloppez un site Web, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
b) Appuyez sur la FLECHE GAUCHE du clavier afin de faire appara&icirc;tre un curseur clignotant, puis appuyez
cinq fois sur ENTREE.
Le contr&ocirc;le CrystalReportViewer descend de cinq lignes.
4.
Si vous d&eacute;veloppez un projet Windows, proc&eacute;dez comme suit :
a) Cliquez sur le contr&ocirc;le CrystalReportViewer pour le s&eacute;lectionner.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
489
b) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Dock la valeur &quot;Bottom&quot;.
c) Redimensionnez le contr&ocirc;le CrystalReportViewer afin d'afficher environ trois lignes au-dessus.
d) Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Anchor la valeur &quot;Top, Bottom, Left, Right&quot;.
5.
Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label en haut &agrave; gauche du formulaire.
6.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;Afficher les clients suivants :&quot;.
7.
Dans la bo&icirc;te &agrave; outils, faites glisser un second contr&ocirc;le Label sur le formulaire en dessous du premier.
8.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;- ventes de l'ann&eacute;e derni&egrave;re &gt; $&quot;.
9.
Dans la bo&icirc;te &agrave; outils, faites glisser un troisi&egrave;me contr&ocirc;le Label sur le formulaire en dessous du second.
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; la propri&eacute;t&eacute; Text la valeur &quot;- premi&egrave;re lettre du nom&quot;.
11. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite du second contr&ocirc;le Label.
12. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID la valeur &quot;lastYearsSales&quot;.
13. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le DropDownList (Web) ou ComboBox (Windows) &agrave; droite du
troisi&egrave;me contr&ocirc;le Label.
14. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID la valeur &quot;operatorValueList&quot;.
15. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le TextBox &agrave; droite du contr&ocirc;le DropDownList (Web) ou du
contr&ocirc;le ComboBox (Windows).
16. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID la valeur &quot;letterOfName&quot;.
17. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Button en dessous du troisi&egrave;me contr&ocirc;le Label.
18. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID la valeur &quot;redisplay&quot; et &agrave; Text la valeur &quot;R&eacute;afficher le rapport&quot;.
19. Dans la bo&icirc;te &agrave; outils, faites glisser un contr&ocirc;le Label en dessous du contr&ocirc;le Button.
20. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez &agrave; ID la valeur &quot;formula&quot; et laissez la propri&eacute;t&eacute; Text vide.
V&eacute;rifiez que le contr&ocirc;le CrystalReportViewer se trouve bien juste en dessous de ces contr&ocirc;les.
21. Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Dans la section suivante, vous allez remplir le contr&ocirc;le DropDownList (Web) ou ComboBox (Windows).
1.5.2.8.5
D&eacute;finition du contenu du contr&ocirc;le DropDownList ou
ComboBox
Le contr&ocirc;le DropDownList (Web) ou le contr&ocirc;le ComboBox (Windows) requiert une liste de valeurs d'op&eacute;rateurs
(&eacute;gal &agrave;, sup&eacute;rieur &agrave;, etc.). Le moyen le plus courant de remplir ce contr&ocirc;le consiste &agrave; fournir cette liste de valeurs
sous la forme d'un &eacute;num&eacute;rateur.
490
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.8.5.1
ComboBox
Pour remplir le contr&ocirc;le DropDownList ou
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, s&eacute;lectionnez Classe.
3.
Saisissez le nom &quot;CeComparisonOperator&quot;, puis cliquez sur OK.
4.
Dans le fichier de classe, remplacez le mot class par enum.
Remarque
Dans Visual Basic, n'oubliez pas de remplacer &agrave; la fois la signature d'ouverture et de fermeture. Dans C#,
supprimez le constructeur.
5.
Saisissez les valeurs d'&eacute;num&eacute;ration suivantes.
EqualTo
GreaterThan
GreaterThanOrEqualTo
LessThan
LessThanOrEqualTo
NotEqualTo
EqualTo,
GreaterThan,
GreaterThanOrEqualTo,
LessThan,
LessThanOrEqualTo,
NotEqualTo
6.
Ouvrez le Web Form ou le Windows Form en mode Design.
7.
Dans le menu Affichage, cliquez sur Code.
8.
Dans la m&eacute;thode ConfigureCrystalReports(), vous remplissez maintenant l'instance operatorValueList
avec des valeurs de l'&eacute;num&eacute;ration CeComparisonOperator. Ce code est plac&eacute; dans un emplacement diff&eacute;rent
selon que vous cr&eacute;ez un site Web ou un projet Windows.
○
Dans un site Web, ins&eacute;rez l'affectation et la liaison de la propri&eacute;t&eacute; DataSource au sein du bloc conditionnel
Not IsPostBack.
operatorValueList.DataSource =
System.Enum.GetValues(GetType(CeComparisonOperator))
operatorValueList.DataBind()
operatorValueList.DataSource =
System.Enum.GetValues(typeof(CeComparisonOperator));
operatorValueList.DataBind();
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
491
○
Dans un projet Windows, ins&eacute;rez uniquement l'affectation de la propri&eacute;t&eacute; DataSource au sein du bloc
conditionnel useDefaultValues.
operatorValueList.DataSource =
System.Enum.GetValues(GetType(CeComparisonOperator))
operatorValueList.DataSource =
System.Enum.GetValues(typeof(CeComparisonOperator));
Remarque
Dans un projet Windows, il est inutile d'appeler une m&eacute;thode DataBind().
9.
Au bas de la m&eacute;thode ConfigureCrystalReports(), affectez la cha&icirc;ne selectionFormula &agrave; la propri&eacute;t&eacute;
Text du contr&ocirc;le Label formula.
formula.Text = selectionFormula
formula.Text = selectionFormula;
10. Compilez et affichez l'application.
La liste d'op&eacute;rateurs et tous les autres contr&ocirc;les devraient s'afficher correctement.
11. Fermez votre navigateur.
R&eacute;sultats
Dans la section suivante, vous allez cr&eacute;er une m&eacute;thode qui extrait des s&eacute;lections &agrave; partir de ce contr&ocirc;le lorsqu'un
utilisateur clique sur le bouton R&eacute;afficher le rapport.
1.5.2.8.6
Extraction des s&eacute;lections &agrave; partir du contr&ocirc;le
Dans cette section, vous allez extraire des s&eacute;lections &agrave; partir du contr&ocirc;le DropDownList (Web) ou ComboBox
(Windows).
1.5.2.8.6.1
Pour extraire des s&eacute;lections &agrave; partir du contr&ocirc;le
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Dans le menu Affichage, cliquez sur Code.
492
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
3.
A la fin de la classe, cr&eacute;ez une m&eacute;thode d'assistance priv&eacute;e GetSelectedOperator() qui renvoie une valeur de
cha&icirc;ne.
Private Function GetSelectedOperator() As String
End Function
private string GetSelectedOperator()
{
}
4.
Dans la m&eacute;thode, d&eacute;clarez une cha&icirc;ne selectedOperator et affectez-lui une valeur de cha&icirc;ne vide.
Dim selectedOperator As String = &quot;&quot;
string selectedOperator = &quot;&quot;;
5.
Toujours dans la m&eacute;thode, cr&eacute;ez une instruction Select Case/switch case qui v&eacute;rifie l'index s&eacute;lectionn&eacute; dans
le contr&ocirc;le de liste et renvoie la valeur d'&eacute;num&eacute;ration correspondante.
Remarque
Dans C#, vous devez effectuer explicitement un cast de l'index s&eacute;lectionn&eacute; en &eacute;num&eacute;ration dans la
signature switch.
Select Case operatorValueList.SelectedIndex
Case CeComparisonOperator.EqualTo
selectedOperator = &quot;=&quot;
Case CeComparisonOperator.GreaterThan
selectedOperator = &quot;&gt;&quot;
Case CeComparisonOperator.GreaterThanOrEqualTo
selectedOperator = &quot;&gt;=&quot;
Case CeComparisonOperator.LessThan
selectedOperator = &quot;&lt;&quot;
Case CeComparisonOperator.LessThanOrEqualTo
selectedOperator = &quot;&lt;=&quot;
Case CeComparisonOperator.NotEqualTo
selectedOperator = &quot;&lt;&gt;&quot;
End Select
switch ((CeComparisonOperator)operatorValueList.SelectedIndex)
{
case CeComparisonOperator.EqualTo:
selectedOperator = &quot;=&quot;;
break;
case CeComparisonOperator.GreaterThan:
selectedOperator = &quot;&gt;&quot;;
break;
case CeComparisonOperator.GreaterThanOrEqualTo:
selectedOperator = &quot;&gt;=&quot;;
break;
case CeComparisonOperator.LessThan:
selectedOperator = &quot;&lt;&quot;;
break;
case CeComparisonOperator.LessThanOrEqualTo:
selectedOperator = &quot;&lt;=&quot;;
break;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
493
}
6.
case CeComparisonOperator.NotEqualTo:
selectedOperator = &quot;&lt;&gt;&quot;;
break;
Renvoyez la cha&icirc;ne selectedOperator &agrave; partir de la m&eacute;thode.
Return selectedOperator
return selectedOperator;
7.
Dans le menu Fichier, cliquez sur Enregistrer tout.
R&eacute;sultats
Dans la derni&egrave;re section, vous allez ajouter un &eacute;v&eacute;nement de clic pour que les nouvelles valeurs de formule de
s&eacute;lection soient appliqu&eacute;es au rapport lorsqu'un utilisateur clique sur le bouton.
1.5.2.8.7
Ajout d'un &eacute;v&eacute;nement de clic
La derni&egrave;re &eacute;tape de configuration du filtrage dynamique consiste &agrave; ajouter l'&eacute;v&eacute;nement de clic et &agrave; &eacute;crire le code
permettant d'appliquer les nouvelles valeurs de formule de s&eacute;lection au rapport.
1.5.2.8.7.1
Pour ajouter l'&eacute;v&eacute;nement de clic
Proc&eacute;dure
1.
Ouvrez le Web Form ou le Windows Form en mode Design.
2.
Cliquez deux fois sur le contr&ocirc;le Button.
3.
La classe code-behind est charg&eacute;e et un &eacute;v&eacute;nement de clic est cr&eacute;&eacute;.
4.
Dans la m&eacute;thode, attribuez &agrave; la variable de niveau classe &quot;salesAmount&quot; la propri&eacute;t&eacute; Text de l'instance du
contr&ocirc;le lastYearsSales.
salesAmount = lastYearsSales.Text
salesAmount = lastYearsSales.Text;
5.
Attribuez &agrave; la variable de niveau classe &quot;operatorValue&quot; la valeur renvoy&eacute;e par la m&eacute;thode d'assistance
GetSelectedOperator.
operatorValue = GetSelectedOperator()
494
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
operatorValue = GetSelectedOperator();
6.
Attribuez &agrave; la variable de niveau classe &quot;customerName&quot; la propri&eacute;t&eacute; Text de l'instance du contr&ocirc;le
letterOfName.
customerName = letterOfName.Text
customerName = letterOfName.Text;
7.
Si vous g&eacute;n&eacute;rez un projet Windows, attribuez &agrave; la variable de niveau classe &quot;useDefaultValues&quot; la valeur False.
Remarque
Ceci permet d'ignorer le bloc conditionnel de la m&eacute;thode ConfigureCrystalReports() qui d&eacute;finit les valeurs
par d&eacute;faut des variables de niveau classe.
useDefaultValues = False
useDefaultValues = false;
8.
Toujours dans la m&eacute;thode, appelez la m&eacute;thode ConfigureCrystalReports() pour proc&eacute;der au filtrage et &agrave;
la liaison du rapport.
ConfigureCrystalReports()
ConfigureCrystalReports();
R&eacute;sultats
Vous pouvez maintenant tester l'application.
1.5.2.8.8
Test du filtrage des donn&eacute;es
Dans la section finale, vous testez le filtrage des donn&eacute;es.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
495
1.5.2.8.8.1
Pour tester le filtrage des donn&eacute;es
Proc&eacute;dure
1.
Compilez et affichez votre application.
2.
V&eacute;rifiez que le rapport s'affiche avec les valeurs de filtrage par d&eacute;faut.
3.
Saisissez &quot;200000&quot; dans Ventes de l'ann&eacute;e derni&egrave;re.
4.
S&eacute;lectionnez GreaterThan dans le contr&ocirc;le DropDownList (Web) ou ComboBox (Windows).
5.
Saisissez &quot;M&quot; dans le contr&ocirc;le TextBox, puis cliquez sur R&eacute;afficher le rapport.
Les donn&eacute;es du rapport qui s'affiche sont filtr&eacute;es de la mani&egrave;re sp&eacute;cifi&eacute;e ci-dessus.
6.
Fermez votre navigateur.
1.5.2.8.9
Addenda : Am&eacute;liorations apport&eacute;es au code des
formules de s&eacute;lection
Si vous avez install&eacute; SAP Crystal Reports 2008, vous avez acc&egrave;s aux fonctionnalit&eacute;s API am&eacute;lior&eacute;es qui filtrent les
donn&eacute;es dans le mod&egrave;le d'objet ReportDocument en d&eacute;finissant la formule SavedDataSelection de la classe
DataDefinition.
Dans les proc&eacute;dures pr&eacute;c&eacute;dentes, vous avez appris &agrave; utiliser la formule RecordSelection pour filtrer les
donn&eacute;es apr&egrave;s un &eacute;v&eacute;nement de clic.
Dans ce tutoriel, vous allez modifier la m&eacute;thode redisplay_Click afin d'utiliser la formule SavedDataSelection
pour filtrer les donn&eacute;es apr&egrave;s un &eacute;v&eacute;nement de clic. La formule SavedDataSelection permet de d'appliquer le
filtrage sur les donn&eacute;es enregistr&eacute;es sans qu'il soit n&eacute;cessaire d'acc&eacute;der une nouvelle fois &agrave; la base de donn&eacute;es.
1.5.2.8.9.1
Modification du projet pour la formule
SavedDataSelection
Si vous avez effectu&eacute; toutes les proc&eacute;dures de la section Tutoriel : Filtrage des donn&eacute;es &agrave; l'aide des formules de
s&eacute;lection [page 481], vous devez d'abord supprimer certaines lignes de code indiqu&eacute;es dans la proc&eacute;dure
suivante.
496
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.8.9.1.1
Pour modifier le projet afin d'utiliser la formule
SavedDataSelection
Proc&eacute;dure
1.
Ouvrez le projet termin&eacute; de ce tutoriel.
2.
Ouvrez le Web Form ou Windows Form.
3.
Dans le menu Affichage, cliquez sur Code.
4.
Si vous d&eacute;veloppez un projet Windows, supprimez la variable de niveau classe nomm&eacute;e
&quot;useDefaultValues&quot;.
5.
Si vous d&eacute;veloppez un projet Web, dans la m&eacute;thode ConfigureCrystalReports(), supprimez le bloc
conditionnel sans supprimer le code qu'il contient.
La m&eacute;thode ConfigureCrystalReports() modifi&eacute;e doit ressembler &agrave; ceci :
Private Sub ConfigureCrystalReports()
salesAmount = &quot;4000&quot;
operatorValue = &quot;&lt;&quot;
customerName = &quot;K&quot;
Dim selectionFormula As String = &quot;{Customer.Last Year's Sales} &gt; &quot; &amp;
salesAmount _
&amp; &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; &amp; operatorValue &amp; &quot;'&quot; &amp;
customerName &amp; &quot;'&quot;
operatorValueList.DataSource =
System.Enum.GetValues(GetType(CeComparisonOperator))
operatorValueList.DataBind()
customerBySalesNameReport = New ReportDocument()
Dim reportPath As String = Server.MapPath(&quot;CustomerSalesByReport.rpt&quot;)
customerBySalesNameReport.Load(reportPath)
customerBySalesNameReport.DataDefinition.RecordSelectionFormula =
selectionFormula
myCrystalReportViewer.ReportSource = customerBySalesNameReport
formula.Text = selectionFormula
End Sub
private void ConfigureCrystalReports()
{
salesAmount = &quot;4000&quot;;
operatorValue = &quot;&lt;&quot;;
customerName = &quot;K&quot;;
string selectionFormula = &quot;{Customer.Last Year's Sales} &gt; &quot; + salesAmount
+ &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; + operatorValue + &quot;'&quot; +
customerName + &quot;'&quot;;
operatorValueList.DataSource =
System.Enum.GetValues(typeof(CeComparisonOperator));
operatorValueList.DataBind();
customerBySalesNameReport = new ReportDocument();
string reportPath = Server.MapPath(&quot;CustomerBySalesName.rpt&quot;);
customerBySalesNameReport.Load(reportPath);
customerBySalesNameReport.DataDefinition.RecordSelectionFormula =
selectionFormula;
crystalReportViewer.ReportSource = customerBySalesNameReport;
formula.Text = selectionFormula;
}
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
497
1.5.2.8.9.2
Ajout d'un &eacute;v&eacute;nement qui applique la formule
SavedDataSelection
Dans cette section, vous allez modifier la m&eacute;thode redisplay_Click en appliquant la formule
SavedDataSelection aux valeurs selectionFormula du rapport.
1.5.2.8.9.2.1
Pour ajouter l'&eacute;v&eacute;nement de clic
Proc&eacute;dure
1.
Ouvrez le Web Form ou Windows Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Dans la m&eacute;thode redisplay_Click, supprimez la ligne qui appelle la m&eacute;thode
ConfigureCrystalReports().
4.
Cr&eacute;ez une cha&icirc;ne selectionFormula dans laquelle vous ajoutez des litt&eacute;raux aux variables de niveau classe.
Dim selectionFormula As String = &quot;{Customer.Last Year's Sales} &gt; &quot; _
&amp; salesAmount _
&amp; &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot; _
&amp; operatorValue _
&amp; &quot;'&quot; _
&amp; customerName _
&amp; &quot;'&quot;
string selectionFormula = &quot;{Customer.Last Year's Sales} &gt; &quot;
+ salesAmount
+ &quot; AND Mid({Customer.Customer Name}, 1, 1) &quot;
+ operatorValue
+ &quot;'&quot;
+ customerName
+ &quot;'&quot;;
5.
Affectez la variable cha&icirc;ne selectionFormula &agrave; l'instance ReportDocument.
customerBySalesNameReport.DataDefinition.SavedDataSelectionFormula =
selectionFormula
customerBySalesNameReport.DataDefinition.SavedDataSelectionFormula =
selectionFormula;
6.
Sur la ligne suivante, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le CrystalReportViewer &agrave; l'instance
ReportDocument.
myCrystalReportViewer.ReportSource = customerBySalesNameReport
crystalReportViewer.ReportSource = customerBySalesNameReport;
7.
Au bas de la m&eacute;thode , affectez la cha&icirc;ne selectionFormula &agrave; la propri&eacute;t&eacute; Text du contr&ocirc;le Label de la
formule.
formula.Text = selectionFormula
498
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
formula.Text = selectionFormula;
R&eacute;sultats
Vous pouvez maintenant tester l'application.
1.5.2.8.9.3
Test du filtrage des donn&eacute;es
Dans cette section, vous testez le filtrage des donn&eacute;es.
1.5.2.8.9.3.1
Pour tester le filtrage des donn&eacute;es
Proc&eacute;dure
1.
Compilez et affichez votre application.
2.
V&eacute;rifiez que le rapport s'affiche avec les valeurs de filtrage par d&eacute;faut.
3.
Saisissez &quot;30000&quot; dans Ventes de l'ann&eacute;e derni&egrave;re.
4.
S&eacute;lectionnez GreaterThan dans le contr&ocirc;le DropDownList (Web) ou ComboBox (Windows).
5.
Saisissez &quot;H&quot; dans le contr&ocirc;le TextBox, puis cliquez sur R&eacute;afficher le rapport.
Le rapport est r&eacute;affich&eacute;, avec tous les clients dont le nom commence par les lettres H &agrave; K et dont les ventes
sont sup&eacute;rieures &agrave; 30 000 $.
6.
Remplacez &quot;H&quot; par &quot;S&quot; dans le contr&ocirc;le TextBox, puis cliquez sur R&eacute;afficher le rapport.
Le rapport est r&eacute;affich&eacute; sans aucune donn&eacute;e. Cela est d&ucirc; au fait que la lettre &quot;S&quot; est en dehors des
param&egrave;tres initiaux d&eacute;finis dans la m&eacute;thode ConfigureCrystalReports().
7.
Fermez votre navigateur.
1.5.2.9
Tutoriel : Affichage de parties de rapport &agrave; l'aide du
contr&ocirc;le CrystalReportPartsViewer
Dans ce tutoriel, vous allez apprendre &agrave; diviser le rapport en plusieurs parties et &agrave; afficher chaque partie en
cliquant sur une s&eacute;rie de liens hypertexte successifs.
Introduction
Dans ce tutoriel, vous allez apprendre &agrave; diviser le rapport en plusieurs parties et &agrave; afficher chaque partie en
cliquant sur une s&eacute;rie de liens hypertexte successifs. Les liens hypertexte vont du groupe de r&eacute;sum&eacute; de rapport
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
499
de base aux informations les plus d&eacute;taill&eacute;es sur le rapport. Vous allez d&eacute;finir le point de d&eacute;part, puis chaque lien
hypertexte successif du rapport. Pour afficher le rapport en plusieurs parties, vous allez affecter le rapport &agrave; un
autre contr&ocirc;le appel&eacute; CrystalReportPartsViewer.
Remarque
Les parties de rapport sont utilis&eacute;es uniquement dans les sites Web ; elles ne sont pas disponibles pour les
projets Windows.
Il existe deux principaux moyens de visualiser un rapport :
●
Vous pouvez visualiser la totalit&eacute; du rapport.
●
Vous pouvez visualiser le rapport sous forme de s&eacute;rie de parties de rapport li&eacute;es.
Visualisation de la totalit&eacute; du rapport
Les rapports s'affichent g&eacute;n&eacute;ralement sous la forme d'un document unique (compos&eacute; d'une ou de plusieurs
pages) dans lequel des informations d&eacute;taill&eacute;es sont regroup&eacute;es par cat&eacute;gories, sous-cat&eacute;gories et lignes de
d&eacute;tails individuelles.
Par exemple, la base de donn&eacute;es Xtreme Access fournie avec SAP Crystal Reports contient des donn&eacute;es client
sur les magasins de bicyclettes dans de nombreux endroits du monde. L'un des moyens classiques de visualiser
les donn&eacute;es dans un rapport consiste &agrave; regrouper les magasins de bicyclettes en fonction des r&eacute;gions, puis des
villes et &agrave; faire appara&icirc;tre des lignes d'informations sur chaque magasin au niveau des d&eacute;tails.
Le contr&ocirc;le CrystalReportViewer permet d'afficher la totalit&eacute; d'un rapport.
Visualisation d'un rapport sous la forme d'une s&eacute;rie de parties li&eacute;es
Avec l'av&egrave;nement des portails Web et de la navigation Web sur les t&eacute;l&eacute;phones cellulaires, lesquels offrent tous
deux une surface de visualisation tr&egrave;s limit&eacute;e pour consulter les informations, une nouvelle m&eacute;thode d'affichage
des rapports a &eacute;t&eacute; mise au point.
Pour ce faire, le rapport complet qui se compose de cat&eacute;gories de groupes, de sous-cat&eacute;gories et de lignes de
d&eacute;tails est red&eacute;fini sous la forme d'une s&eacute;rie de parties de rapport. Ces parties s'affichent ensuite &agrave; travers une
s&eacute;rie de pages li&eacute;es. Dans ce sc&eacute;nario, le groupe d'informations de la cat&eacute;gorie la plus &eacute;lev&eacute;e s'affiche en premier.
Lorsqu'un &eacute;l&eacute;ment de ce groupe de niveau sup&eacute;rieur est s&eacute;lectionn&eacute;, le groupe d'informations d'une souscat&eacute;gorie s'affiche. Cette exploration continue jusqu'&agrave; ce que les lignes de d&eacute;tails individuelles d'une souscat&eacute;gorie donn&eacute;e soient atteintes.
Par exemple, les donn&eacute;es client sur les magasins de bicyclettes de la base de donn&eacute;es Xtreme s'affichent au
d&eacute;part sous la forme d'une liste de r&eacute;gions. Lorsque vous s&eacute;lectionnez une r&eacute;gion, les villes de cette r&eacute;gion
apparaissent. Lorsque vous s&eacute;lectionnez une ville, les lignes de d&eacute;tails sur les magasins de bicyclettes de la ville
en question apparaissent.
Cette division en plusieurs parties d'un rapport permet d'acc&eacute;der facilement &agrave; un rapport long et complexe sur
une surface de visualisation tr&egrave;s limit&eacute;e.
500
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Le contr&ocirc;le CrystalReportPartsViewer permet d'afficher des rapports sous la forme d'une s&eacute;rie de parties
li&eacute;es.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_RDObjMod_ReportParts
●
Site Web Visual Basic : VB_Web_RDObjMod_ReportParts
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.2.9.1
Cr&eacute;ation d'un rapport
Commencez par cr&eacute;er un rapport &agrave; partir des informations de la base de donn&eacute;es Xtreme.
1.5.2.9.1.1
Pour cr&eacute;er un rapport avec des param&egrave;tres
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet affich&eacute; en gras,
pointez sur Ajouter, puis cliquez sur Nouvel &eacute;l&eacute;ment.
2.
Dans la bo&icirc;te de dialogue Ajouter un nouvel &eacute;l&eacute;ment, dans la vue Mod&egrave;les, s&eacute;lectionnez le mod&egrave;le &quot;Rapport
Crystal&quot;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
501
3.
Dans le champ Nom, saisissez le nom &quot;Customers.rpt&quot;, puis cliquez sur Ajouter.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre Assistant de cr&eacute;ation de rapports standard,
d&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
7.
Dans le sous-dossier qui s'ouvre, d&eacute;veloppez le dossier ODBC (RDO).
8.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; la base de donn&eacute;es Xtreme,
puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
9.
D&eacute;veloppez le nœud Tables et s&eacute;lectionnez la table Clients.
10. Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
11. Utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner Pays, Nom du client, Ventes de l'ann&eacute;e
derni&egrave;re, R&eacute;gion et Ville.
12. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur le
bouton Suivant.
13. Dans le panneau Champs disponibles, sous Champs du rapport, suivez les instructions suivantes :
a) S&eacute;lectionnez Pays et cliquez sur le bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par.
b) S&eacute;lectionnez R&eacute;gion et cliquez sur le bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par.
c) Cliquez sur Suivant.
Des champs r&eacute;sum&eacute;s sont cr&eacute;&eacute;s pour le champ Ventes de l'ann&eacute;e derni&egrave;re dans les groupes Pays et
R&eacute;gion.
14. Cliquez sur Terminer.
Le rapport Customers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
15. En bas de la fen&ecirc;tre, cliquez sur Aper&ccedil;u Rapport principal.
Le rapport s'affiche selon des niveaux hi&eacute;rarchiques tri&eacute;s d'abord par pays, puis par r&eacute;gion. Si vous changez
l'affichage du rapport pour afficher des parties de rapport, chaque niveau s'affiche s&eacute;par&eacute;ment.
R&eacute;sultats
Vous pouvez maintenant convertir le rapport pour afficher des parties de rapport.
1.5.2.9.2
rapport
Conversion du rapport afin d'afficher des parties de
Dans cette section, vous allez apprendre &agrave; d&eacute;finir des liens hypertexte dans le rapport pour lier les informations
g&eacute;n&eacute;rales aux informations plus d&eacute;taill&eacute;es.
502
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.2.9.2.1
Pour convertir le rapport afin d'afficher des
parties de rapport
Proc&eacute;dure
1.
En bas de la fen&ecirc;tre, cliquez sur Rapport principal.
Remarque
Le groupe de plus haut niveau, Nom du groupe n&deg; 1, s'affiche en deux endroits, au d&eacute;but et en bas du
rapport.
Au bas du rapport dans la section Pied de page de groupe n&deg; 1, Nom du groupe n&deg; 1 est une &eacute;tiquette suivie
d'un champ r&eacute;sum&eacute; de Clients.Ventes de l'ann&eacute;e derni&egrave;re. Cette &eacute;tiquette est &agrave; utiliser de pr&eacute;f&eacute;rence
comme point d'entr&eacute;e des parties de rapport.
2.
Cliquez avec le bouton droit de la souris sur Nom du groupe n&deg; 1 situ&eacute; dans la section Pied de page de groupe n
&deg; 1, puis cliquez sur Copier.
3.
Cliquez avec le bouton droit de la souris sur une zone vide du rapport, pointez sur Rapport, puis cliquez sur
Options du rapport.
4.
Dans la bo&icirc;te de dialogue Options du rapport, cliquez sur Coller le lien.
L'ID de l'&eacute;tiquette du groupe 1 &quot;GroupNamePays2&quot; est coll&eacute;e dans le champ Nom de l'objet.
Le champ Contexte des donn&eacute;es accepte une valeur de cha&icirc;ne qui filtre les donn&eacute;es du rapport. Pour le
moment, ce champ doit rester vide.
5.
Cliquez sur OK.
6.
Cliquez avec le bouton droit de la souris sur Nom du groupe n&deg; 1 qui se trouve dans la section Pied de page de
groupe n&deg; 1, puis cliquez sur Mettre en forme l'objet.
7.
Dans l'Editeur de mise en forme, cliquez sur l'onglet Lien hypertexte, puis s&eacute;lectionnez Exploration des parties
du rapport.
8.
Dans le panneau Champs disponibles, d&eacute;veloppez Pied de page de groupe n&deg; 2, cliquez deux fois sur
GroupNameR&eacute;gion2, puis cliquez sur OK.
Vous avez configur&eacute; Groupe n&deg; 1 pour le lier &agrave; Groupe n&deg; 2 lorsqu'un utilisateur clique sur Groupe n&deg; 1 au
moment de l'ex&eacute;cution.
9.
Cliquez avec le bouton droit de la souris sur Nom du groupe n&deg; 2 qui se trouve dans la section Pied de page de
groupe n&deg; 2, puis cliquez sur Mettre en forme l'objet.
10. Dans l'Editeur de mise en forme, cliquez sur l'onglet Lien hypertexte, puis s&eacute;lectionnez Exploration des parties
du rapport.
11. Dans le panneau Champs disponibles, proc&eacute;dez de la mani&egrave;re suivante :
a) D&eacute;veloppez D&eacute;tails.
b) Utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner Nomduclient1, Ventesdelann&eacute;ederni&egrave;re1
et Ville1.
c) Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher.
d) Cliquez sur OK.
Vous avez d&eacute;fini Groupe n&deg; 2 pour le lier aux informations d&eacute;taill&eacute;es sur le client lorsqu'un utilisateur
clique sur Groupe n&deg; 2 au moment de l'ex&eacute;cution.
12. Dans le menu Fichier, s&eacute;lectionnez Enregistrer tout.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
503
1.5.2.9.3
Liaison du rapport
Lorsque vous avez suivi les instructions de la proc&eacute;dure Configuration d'un projet [page 15] en pr&eacute;paration de ce
tutoriel, vous avez plac&eacute; un contr&ocirc;le CrystalReportViewer sur le Web Form. Or, pour afficher des parties de
rapport, vous devez utiliser le contr&ocirc;le CrystalReportPartsViewer.
Dans cette section, vous allez instancier le rapport Customers et le lier au contr&ocirc;le
CrystalReportPartsViewer. Vous v&eacute;rifierez ensuite si le rapport affiche les parties de rapport que vous avez
cr&eacute;&eacute;es dans les proc&eacute;dures pr&eacute;c&eacute;dentes.
Vous pouvez instancier et lier le rapport de deux fa&ccedil;ons :
●
En tant que rapport incorpor&eacute;.
●
En tant que rapport non incorpor&eacute;.
Choisissez l'une des deux (mais pas les deux) proc&eacute;dures ci-dessous.
●
Si vous utilisez des rapports incorpor&eacute;s, effectuez la proc&eacute;dure suivante afin d'instancier le rapport sous
forme de rapport incorpor&eacute;.
●
Si vous utilisez des rapports non incorpor&eacute;s, effectuez la seconde proc&eacute;dure afin d'instancier le rapport sous
forme de rapport non incorpor&eacute;.
Effectuez maintenant la proc&eacute;dure Filtrage des donn&eacute;es du rapport [page 507].
1.5.2.9.3.1
Pour instancier le rapport Customers sous forme
de rapport incorpor&eacute; et le lier au contr&ocirc;le
CrystalPartsReportViewer
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
Supprimez le contr&ocirc;le CrystalReportViewer.
4.
Dans la bo&icirc;te &agrave; outils, ouvrez le nœud Crystal Reports afin de localiser le contr&ocirc;le CrystalReportPartsViewer.
5.
Faites glisser le contr&ocirc;le CrystalReportPartsViewer sur le Web Form.
6.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, d&eacute;finissez la propri&eacute;t&eacute; ID de la mani&egrave;re suivante :
○
Pour les sites Web Visual Basic, attribuez &agrave; la propri&eacute;t&eacute; ID la valeur &quot;myCrystalReportPartsViewer&quot;.
○
Pour les sites Web C#, attribuez &agrave; la propri&eacute;t&eacute; ID la valeur &quot;crystalReportPartsViewer&quot;.
7.
Dans le menu Affichage, cliquez sur Code pour afficher la classe code-behind de ce Web Form.
8.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport Customers, avec la
variable customerReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customersReport As Customers
private Customers customersReport;
504
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
9.
Dans la m&eacute;thode ConfigureCrystalReports(), instanciez la classe wrapper du rapport.
Remarque
Vous avez cr&eacute;&eacute; la m&eacute;thode ConfigureCrystalReports() dans Configuration d'un projet [page 15].
customersReport = New Customers()
customersReport = new Customers();
10. Sur la ligne suivante, au-dessous de l'instanciation du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportPartsViewer &agrave; la classe de rapport instanci&eacute;e (nom de la variable : customersReport).
myCrystalReportPartsViewer.ReportSource = customersReport
crystalReportPartsViewer.ReportSource = customersReport;
Remarque
L'instance du contr&ocirc;le CrystalReportPartsViewer est accessible dans le code, car vous avez ajout&eacute; le
contr&ocirc;le &agrave; votre Web Form ou Windows Form. Si IntelliSense ne reconna&icirc;t pas l'instance du contr&ocirc;le
CrystalReportPartsViewer, v&eacute;rifiez que le contr&ocirc;le CrystalReportPartsViewer a &eacute;t&eacute; ajout&eacute; sous la forme
d'une d&eacute;claration de niveau classe &agrave; cette classe code-behind.
1.5.2.9.3.2
Pour instancier le rapport Customers sous forme
de rapport non incorpor&eacute; et le lier au contr&ocirc;le
CrystalReportPartsViewer
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet.
Proc&eacute;dure
1.
Ouvrez le Web Form.
2.
Dans le menu Affichage, cliquez sur Code.
3.
Ajoutez une nouvelle d&eacute;claration de niveau classe pour la classe wrapper du rapport ReportDocument, avec la
variable customersReport. D&eacute;finissez le modificateur d'acc&egrave;s &agrave; private.
Private customersReport As ReportDocument
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
505
private ReportDocument customersReport;
Remarque
La classe ReportDocument est un membre de l'espace de noms CrystalDecisions.CrystalReports.Engine.
Vous avez ajout&eacute; une d&eacute;claration &quot;Imports&quot; [Visual Basic] ou &quot;using&quot; [C#] pour cet espace de
noms dans la section Configuration d'un projet [page 15]. Lorsque vous instanciez ReportDocument et
chargez un rapport dans l'espace de noms, vous acc&eacute;dez au rapport via le SDK sans l'incorporer.
4.
Dans la m&eacute;thode ConfigureCrystalReports() (que vous avez cr&eacute;&eacute;e dans l'une des proc&eacute;dures de la
section Configuration d'un projet [page 15]), instanciez la classe ReportDocument.
customersReport = New ReportDocument()
customersReport = new ReportDocument();
5.
D&eacute;clarez une variable cha&icirc;ne, nommez-la reportPath et affectez-lui un chemin d'acc&egrave;s au rapport local au
moment de l'ex&eacute;cution. Ce chemin est d&eacute;termin&eacute; diff&eacute;remment selon qu'il s'agit d'un site Web ou d'un projet
Windows :
○
Pour un site Web, transmettez le nom du fichier de rapport local sous forme de param&egrave;tre de type cha&icirc;ne
dans la m&eacute;thode Server.MapPath(). Ceci permet d'associer le rapport local au chemin d'acc&egrave;s du
r&eacute;pertoire de fichiers du disque dur au moment de l'ex&eacute;cution.
Dim reportPath As String = Server.MapPath(&quot;Customers.rpt&quot;)
string reportPath = Server.MapPath(&quot;Customers.rpt&quot;);
○
Pour un projet Windows, concat&eacute;nez la propri&eacute;t&eacute; Application.StartupPath avec une barre oblique
inverse et le nom du fichier de rapport local. Ceci permet d'associer le rapport au m&ecirc;me r&eacute;pertoire que
celui du fichier ex&eacute;cutable Windows.
Remarque
Au moment de la compilation, vous copierez le rapport dans le r&eacute;pertoire contenant le fichier
ex&eacute;cutable.
Dim reportPath As String = Application.StartupPath &amp; &quot;\&quot; &amp; &quot;Customers.rpt&quot;
string reportPath = Application.StartupPath + &quot;\\&quot; + &quot;Customers.rpt&quot;;
6.
Appelez la m&eacute;thode Load() de l'instance ReportDocument et transmettez-lui la variable cha&icirc;ne reportPath.
customersReport.Load(reportPath)
customersReport.Load(reportPath);
506
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
7.
Sur la ligne suivante, sous le chargement du rapport, liez la propri&eacute;t&eacute; ReportSource du contr&ocirc;le
CrystalReportPartsViewer &agrave; l'instance ReportDocument.
myCrystalReportPartsViewer.ReportSource = customersReport
crystalReportPartsViewer.ReportSource = customersReport;
1.5.2.9.3.3
Pour tester le chargement du rapport Customers
Contexte
Que vous ayez choisi d'instancier une classe de rapport incorpor&eacute; ou une classe de rapport non incorpor&eacute; via la
classe ReportDocument, le nom de la variable utilis&eacute;e est identique : customersReport. Vous pouvez ainsi utiliser
un bloc de code commun dans les proc&eacute;dures suivantes.
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet. Le chargement du rapport doit &eacute;chouer, car le code
permettant de d&eacute;finir une valeur pour le champ de param&egrave;tre Ville n'a pas encore &eacute;t&eacute; &eacute;crit. Vous ajouterez une
valeur au param&egrave;tre Ville plus loin dans ce tutoriel.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport Customers s'affiche dans le navigateur Web.
4.
Cliquez sur un pays pour afficher une liste des r&eacute;gions.
5.
Cliquez sur une r&eacute;gion pour afficher les champs Nom du client, Ventes de l'ann&eacute;e derni&egrave;re et Ville.
6.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.2.9.4
Filtrage des donn&eacute;es du rapport
Dans cette section, vous allez apprendre &agrave; d&eacute;finir le champ Contexte des donn&eacute;es pour filtrer les donn&eacute;es qui
s'affichent dans le rapport. Pour en savoir plus sur les param&egrave;tres de Contexte des donn&eacute;es, voir Impl&eacute;mentation
de l'exploration de parties de rapport [page 747].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
507
1.5.2.9.4.1
Pour filtrer les donn&eacute;es du rapport
Proc&eacute;dure
1.
Ouvrez le rapport Crystal.
2.
Cliquez avec le bouton droit de la souris sur une zone vide du rapport. S&eacute;lectionnez Rapport, puis cliquez sur
Options du rapport.
3.
Dans le champ Contexte des donn&eacute;es, saisissez &quot;/Pays[Etats-Unis]&quot;.
4.
Cliquez sur OK pour fermer la bo&icirc;te de dialogue Options du rapport.
5.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
6.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
7.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
Le rapport affiche uniquement les enregistrements des Etats-Unis.
8.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.3
Tutoriels de programmation all&eacute;g&eacute;e dans Visual Studio
Cette section pr&eacute;sente divers tutoriels consacr&eacute;s au mod&egrave;le de d&eacute;veloppement de programmation all&eacute;g&eacute;e.
Remarque
Pour les tutoriels qui font appel au mod&egrave;le de programmation classique, voir Tutoriels du mod&egrave;le d'objet
ReportDocument [page 340].
1.5.3.1
Tutoriel : Configuration par programmation all&eacute;g&eacute;e
d'un site Web avec SAP Crystal Reports &agrave; l'aide du panneau
des t&acirc;ches guid&eacute;es
Dans ce tutoriel, vous allez apprendre &agrave; utiliser le nouveau mod&egrave;le de d&eacute;veloppement d'applications avec balises
dans Visual Studio. Vous allez suivre un mod&egrave;le de d&eacute;veloppement par programmation all&eacute;g&eacute;e pour configurer un
site Web avec SAP Crystal Reports, &agrave; l'aide des t&acirc;ches guid&eacute;es.
Introduction
Dans ce tutoriel, vous allez cr&eacute;er un site Web ASP.NET dans Visual Studio. Vous allez ensuite ajouter un contr&ocirc;le
CrystalReportViewer au Web Form, afin de lancer le nouveau panneau des t&acirc;ches guid&eacute;es. Dans le panneau
des t&acirc;ches guid&eacute;es, vous allez cr&eacute;er un contr&ocirc;le CrystalReportSource, puis cr&eacute;er un rapport Crystal. Le
rapport est r&eacute;f&eacute;renc&eacute; dans le contr&ocirc;le CrystalReportSource.
508
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Ce tutoriel permet d'afficher un aper&ccedil;u du rapport de trois fa&ccedil;ons :
●
Dans le concepteur SAP Crystal Reports incorpor&eacute;, &agrave; l'aide du nouveau bouton Aper&ccedil;u de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
●
Dans le Web Form, &agrave; l'aide de donn&eacute;es factices.
Remarque
C'est gr&acirc;ce &agrave; une nouvelle fonctionnalit&eacute; nomm&eacute;e Aper&ccedil;u au moment de la conception qu'il est d&eacute;sormais
possible d'obtenir un aper&ccedil;u du Web Form.
●
Au moment de l'ex&eacute;cution, lorsque vous cr&eacute;ez et compilez l'application.
A la fin de ce tutoriel, vous allez passer en mode HTML (mode Source) et d&eacute;couvrir la relation entre le contr&ocirc;le
CrystalReportViewer et le contr&ocirc;le CrystalReportSource dans le nouveau mod&egrave;le de d&eacute;veloppement
d'applications avec balises de Visual Studio 2005 ou version ult&eacute;rieure.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_ReducedCode_WebSiteSetup
●
Site Web Visual Basic : VB_Web_ReducedCode_WebSiteSetup
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
Affichage d'un rapport au moment de la conception [page 224]
R&eacute;pertoire d'exemples de rapports [page 15]
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
509
1.5.3.1.1
Cr&eacute;ation d'un site Web avec un contr&ocirc;le
CrystalReportViewer
Pr&eacute;requis
Avant de cr&eacute;er un site Web, v&eacute;rifiez que SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio a
&eacute;t&eacute; install&eacute; sur votre syst&egrave;me.
Proc&eacute;dure
1.
D&eacute;marrez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau, puis cliquez sur Site Web.
3.
Dans la bo&icirc;te de dialogue Nouveau site Web, cliquez sur Site Web ASP.NET.
4.
Dans la liste d&eacute;roulante Emplacement, s&eacute;lectionnez Syst&egrave;me de fichiers.
5.
Dans la liste d&eacute;roulante Langage, s&eacute;lectionnez le langage de programmation que vous souhaitez utiliser.
6.
Dans le champ de texte Emplacement, saisissez le chemin d'acc&egrave;s du r&eacute;pertoire C:\WebSites\, suivi du nom
de votre projet.
7.
Cliquez sur OK.
Votre projet s'affiche dans l'Explorateur de solutions et contient une page Default.aspx.
8.
Ouvrez la page Default.aspx (le Web Form).
9.
Dans le menu Affichage, cliquez sur Concepteur.
Remarque
Vous pouvez &eacute;galement basculer en mode Design en cliquant sur le bouton Design en bas du formulaire.
10. Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
11. Faites glisser le contr&ocirc;le CrystalReportViewer sur le Web Form.
Le panneau des t&acirc;ches guid&eacute;es &quot;T&acirc;ches CrystalReportViewer&quot; s'affiche.
Informations associ&eacute;es
El&eacute;ments &agrave; installer [page 10]
510
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.3.1.2
Configuration du contr&ocirc;le CrystalReportSource
dans les t&acirc;ches guid&eacute;es
Visual Studio 2005 et version ult&eacute;rieure disposent d'une nouvelle fonctionnalit&eacute; d'interface utilisateur graphique
destin&eacute;e aux contr&ocirc;les .NET, appel&eacute;e t&acirc;ches guid&eacute;es. Pour le contr&ocirc;le CrystalReportViewer dans des sites Web, le
panneau des t&acirc;ches guid&eacute;es s'intitule &quot;T&acirc;ches CrystalReportViewer&quot;.
Ce panneau &quot;T&acirc;ches CrystalReportViewer&quot; permet de configurer plusieurs fonctionnalit&eacute;s du contr&ocirc;le
CrystalReportViewer, sans avoir &agrave; &eacute;crire de code. Les s&eacute;lections que vous effectuez &agrave; l'aide des t&acirc;ches guid&eacute;es
sont appliqu&eacute;es sous forme de param&egrave;tres avec balises dans la page ASPX.
Dans cette section, vous allez apprendre &agrave; configurer l'option CrystalReportSource disponible dans le panneau
des t&acirc;ches guid&eacute;es &quot;T&acirc;ches CrystalReportViewer&quot;.
Plus loin dans ces tutoriels de programmation all&eacute;g&eacute;e, vous examinerez d'autres fonctionnalit&eacute;s du panneau
&quot;T&acirc;ches CrystalReportViewer&quot;.
1.5.3.1.2.1
Pour configurer le contr&ocirc;le CrystalReportSource
&agrave; l'aide des t&acirc;ches guid&eacute;es
Proc&eacute;dure
1.
Si le panneau des t&acirc;ches guid&eacute;es est ouvert, cliquez sur le Web Form pour le fermer.
2.
Dans l'angle sup&eacute;rieur droit du contr&ocirc;le CrystalReportViewer, cliquez sur le petit bouton triangulaire.
Le panneau des t&acirc;ches guid&eacute;es intitul&eacute; &quot;T&acirc;ches CrystalReportViewer&quot; s'affiche de nouveau. Dans la liste
S&eacute;lectionner la source du rapport, la valeur &lt;Aucune&gt; s'affiche.
3.
Cliquez sur la liste S&eacute;lectionner la source du rapport, puis s&eacute;lectionnez &lt;Source du nouveau rapport…&gt;.
La bo&icirc;te de dialogue Cr&eacute;er la source du rapport s'ouvre.
4.
Dans la zone Indiquer le nom du contr&ocirc;le CrystalReportSource, laissez l'entr&eacute;e par d&eacute;faut
CrystalReportSource1.
5.
Cliquez sur la liste Sp&eacute;cifier un rapport Crystal pour le contr&ocirc;le CrystalReportSource, puis s&eacute;lectionnez
&lt;Nouveau rapport&gt;.
L'autre s&eacute;lection possible est &lt;Parcourir…&gt;. Cette option permet de s&eacute;lectionner un rapport Crystal existant
dans le r&eacute;pertoire de fichiers. Cependant, dans ce tutoriel, vous allez cr&eacute;er un rapport.
6.
Dans la bo&icirc;te de dialogue Cr&eacute;er un rapport Crystal, saisissez le nom &quot;XtremeCustomers.rpt&quot;, puis cliquez sur
OK.
7.
Cliquez &agrave; nouveau sur OK pour fermer la bo&icirc;te de dialogue Cr&eacute;er la source du rapport.
1.5.3.1.3
Configuration du rapport pour le contr&ocirc;le
CrystalReportSource
Dans cette section, vous utilisez l'Assistant de cr&eacute;ation de rapports pour configurer le rapport et l'ajouter au
contr&ocirc;le CrystalReportSource. Vous cr&eacute;ez une connexion &agrave; une base de donn&eacute;es, configurez les champs du
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
511
rapport, puis ajoutez le rapport au contr&ocirc;le. Lorsque vous avez termin&eacute; ces op&eacute;rations, vous testez le site Web
que vous avez cr&eacute;&eacute; par programmation all&eacute;g&eacute;e.
1.5.3.1.3.1
Pour configurer le rapport pour le contr&ocirc;le
CrystalReportSource
Proc&eacute;dure
1.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
2.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
3.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre de l'Assistant de cr&eacute;ation de rapports
standard, proc&eacute;dez comme suit :
a) D&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
b) D&eacute;veloppez le dossier ODBC (RDO).
4.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; la base de donn&eacute;es Xtreme,
puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
5.
D&eacute;veloppez le nœud Tables et s&eacute;lectionnez la table Clients.
6.
Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
7.
D&eacute;veloppez la table Clients, puis utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner les champs
Nom du client, Titre, Adresse 1, Nom du contact et Ville.
8.
Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
9.
Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Clients.Ville, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport XtremeCustomers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
10. En bas de la fen&ecirc;tre, cliquez sur Aper&ccedil;u Rapport principal.
Remarque
Le bouton Aper&ccedil;u est pour la premi&egrave;re fois disponible dans le concepteur SAP Crystal Reports incorpor&eacute;,
fourni avec SAP Crystal Reports pour Visual Studio 2005.
Le rapport s'affiche en mode Aper&ccedil;u et pr&eacute;sente les donn&eacute;es provenant de la base de donn&eacute;es Xtreme.
11. En bas de la fen&ecirc;tre, cliquez sur Rapport principal pour quitter le mode Aper&ccedil;u.
12. Ouvrez le Web Form.
13. Dans le menu Affichage, cliquez sur Concepteur.
Le rapport s'affiche alors sous forme graphique dans le Web Form, en mode Aper&ccedil;u au moment de la
conception.
14. Dans le menu Fichier, cliquez sur Enregistrer tout.
512
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.3.1.3.2
all&eacute;g&eacute;e
Pour v&eacute;rifier le site Web cr&eacute;&eacute; par programmation
Contexte
Votre rapport est cr&eacute;&eacute; et constitue le rapport d&eacute;sign&eacute; pour le contr&ocirc;le CrystalReportSource. Vous &ecirc;tes
maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Le rapport XtremeCustomers s'affiche dans le navigateur Web.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.3.1.4
Exploration du contr&ocirc;le CrystalReportSource en
mode Source
Contexte
Dans cette section, vous allez d&eacute;couvrir le mod&egrave;le de d&eacute;veloppement d'applications avec balises utilis&eacute; dans
ASP.NET version 2.0. Ce mod&egrave;le permet de configurer un site Web avec SAP Crystal Reports, version
d&eacute;veloppeur pour Microsoft Visual Studio, sans avoir &agrave; &eacute;crire de code. Vous allez &eacute;galement d&eacute;couvrir la structure
du contr&ocirc;le DataSource et le contr&ocirc;le CrystalReportSource qui font partie d'ASP.NET 2.0.
Proc&eacute;dure
1.
Ouvrez la page Default.aspx.
2.
Dans le menu Affichage, cliquez sur Concepteur.
3.
En bas du Web Form, cliquez sur le bouton Source.
Le code HTML de la page Default.aspx s'affiche. Il contient deux balises apparent&eacute;es pour SAP Crystal
Reports :
○
La balise CrystalReportSource, qui imbrique la balise Report. La balise Report r&eacute;f&eacute;rence le rapport dans
sa propri&eacute;t&eacute; FileName.
&lt;CR:CrystalReportSource ID=&quot;CrystalReportSource1&quot; Runat=&quot;server&quot;
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
513
EnableCaching=&quot;False&quot; GroupPath=&quot;&quot;&gt;
&lt;Report FileName=&quot;XtremeCustomers.rpt&quot;&gt;&lt;/Report&gt;
&lt;/CR:CrystalReportSource&gt;
○
La balise CrystalReportViewer, qui r&eacute;f&eacute;rence le contr&ocirc;le CrystalReportSource par ID.
&lt;CR:CrystalReportViewer ID=&quot;CrystalReportViewer1&quot; Runat=&quot;server&quot;
AutoDataBind=&quot;True&quot;
Height=&quot;1158px&quot; CssFilename=&quot;CssFilename&quot;
ReportSourceID=&quot;CrystalReportSource1&quot; Width=&quot;1059px&quot; /&gt;
R&eacute;sultats
Le code pr&eacute;sente le nouveau mod&egrave;le de d&eacute;veloppement d'applications avec balises qui fait partie d'ASP.NET 2.0.
Comme dans ASP.NET version 1.0, le contr&ocirc;le CrystalReportViewer est repr&eacute;sent&eacute; par une balise XML.
Cependant, les propri&eacute;t&eacute;s disponibles pour ce contr&ocirc;le sont plus nombreuses dans ASP.NET 2.0 afin de prendre
en charge le mod&egrave;le de d&eacute;veloppement d'applications avec balises.
Dans ASP.NET 2.0, la connectivit&eacute; des donn&eacute;es a &eacute;t&eacute; encapsul&eacute;e dans le contr&ocirc;le DataSource. Le contr&ocirc;le
CrystalReportSource s'adapte &agrave; la structure du contr&ocirc;le DataSource, &agrave; la diff&eacute;rence qu'il encapsule la
connectivit&eacute; du rapport plut&ocirc;t que la connectivit&eacute; des donn&eacute;es. Cette structure est g&eacute;r&eacute;e par la propri&eacute;t&eacute;
ReportSourceID dans le contr&ocirc;le visuel principal.
Pour en savoir plus sur les autres propri&eacute;t&eacute;s du contr&ocirc;le CrystalReportSource, voir Contr&ocirc;le
CrystalReportSource [page 52]. Les propri&eacute;t&eacute;s sont &eacute;galement pr&eacute;sent&eacute;es dans les autres tutoriels de
programmation all&eacute;g&eacute;e de cette section.
1.5.3.2
Tutoriel : Configuration par programmation all&eacute;g&eacute;e
d'un projet Windows avec SAP Crystal Reports &agrave; l'aide des
t&acirc;ches guid&eacute;es
Introduction
Dans ce tutoriel, vous allez apprendre &agrave; cr&eacute;er un projet Windows dans SAP Crystal Reports, version d&eacute;veloppeur
pour Microsoft Visual Studio. Vous allez ensuite ajouter un contr&ocirc;le CrystalReportViewer au Windows Form. Dans
le panneau des t&acirc;ches guid&eacute;es, vous allez ouvrir le concepteur SAP Crystal Reports incorpor&eacute; et cr&eacute;er un rapport.
La fonctionnalit&eacute; des t&acirc;ches guid&eacute;es g&eacute;n&egrave;re le code qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Ce tutoriel permet d'afficher un aper&ccedil;u du rapport de trois fa&ccedil;ons :
●
Dans le concepteur SAP Crystal Reports incorpor&eacute;, &agrave; l'aide du nouveau bouton Aper&ccedil;u de
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
●
Dans le Windows Form, &agrave; l'aide de donn&eacute;es factices.
●
Au moment de l'ex&eacute;cution, lorsque vous cr&eacute;ez et compilez l'application.
A la fin de ce tutoriel, vous allez passer en mode code pour observer comment le mod&egrave;le de d&eacute;veloppement par
programmation all&eacute;g&eacute;e fonctionne dans SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
514
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Projet Windows C# : CS_Win_ReducedCode_ProjectSetup.
●
Projet Windows Visual Basic : VB_Win_ReducedCode_ProjectSetup.
Base de donn&eacute;es Xtreme
Ce tutoriel utilise un exemple de base de donn&eacute;es appel&eacute;e Xtreme. Le fichier de base de donn&eacute;es xtreme.mdb est
fourni dans le package d'exemples de code du SDK de SAP Crystal Reports .NET. Pour utiliser la base de donn&eacute;es
Xtreme, vous devez cr&eacute;er manuellement une connexion ODBC &agrave; cette base de donn&eacute;es.
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.3.2.1
Cr&eacute;ation d'un projet Windows avec un contr&ocirc;le
CrystalReportViewer
Pr&eacute;requis
Avant de cr&eacute;er un projet Windows, v&eacute;rifiez que SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft
Visual Studio a &eacute;t&eacute; install&eacute; sur votre syst&egrave;me.
Proc&eacute;dure
1.
Lancez Visual Studio.
2.
Dans le menu Fichier, s&eacute;lectionnez Nouveau, puis cliquez sur Projet.
3.
Dans la bo&icirc;te de dialogue Nouveau projet, dans la liste Types de projets, s&eacute;lectionnez un dossier de langage
pour C# ou Visual Basic.
4.
Dans la liste Mod&egrave;les, cliquez sur Application Windows.
5.
Dans le champ Nom, remplacez le nom de projet par d&eacute;faut par le nom de votre projet.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
515
6.
Cliquez sur OK.
Votre projet s'affiche dans l'Explorateur de solutions et contient une classe Form1.
7.
Ouvrez la classe Form1.
8.
Dans la Bo&icirc;te &agrave; outils, ouvrez le nœud Reporting afin de localiser le contr&ocirc;le CrystalReportViewer.
9.
Faites glisser le contr&ocirc;le CrystalReportViewer sur le Windows Form.
10. Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, d&eacute;finissez la propri&eacute;t&eacute; Name de la mani&egrave;re suivante :
○
Pour les projets Visual Basic, attribuez la valeur &quot;myCrystalReportViewer&quot;.
○
Pour les projets C#, attribuez la valeur &quot;crystalReportViewer&quot;.
11. Dans le menu Fichier, cliquez sur Enregistrer tout.
Informations associ&eacute;es
El&eacute;ments &agrave; installer [page 10]
1.5.3.2.2
Configuration du rapport dans le panneau des
t&acirc;ches guid&eacute;es
Pour le contr&ocirc;le CrystalReportViewer dans des projets Windows, le panneau des t&acirc;ches guid&eacute;es s'intitule T&acirc;ches
CrystalReportViewer.
Les s&eacute;lections que vous effectuez dans les t&acirc;ches guid&eacute;es sont g&eacute;n&eacute;r&eacute;es sous forme de code dans une classe
partielle Form1. Dans cette section, vous allez configurer un nouveau rapport &agrave; l'aide du panneau des t&acirc;ches
guid&eacute;es T&acirc;ches CrystalReportViewer et du concepteur SAP Crystal Reports incorpor&eacute;. Plus loin dans ces tutoriels
de programmation all&eacute;g&eacute;e, vous examinerez d'autres fonctionnalit&eacute;s des t&acirc;ches guid&eacute;es.
1.5.3.2.2.1
guid&eacute;es
Configuration du rapport &agrave; l'aide des t&acirc;ches
Proc&eacute;dure
1.
Dans l'angle sup&eacute;rieur droit du contr&ocirc;le CrystalReportViewer, cliquez sur le petit bouton triangulaire.
Le panneau des t&acirc;ches guid&eacute;es T&acirc;ches CrystalReportViewer s'affiche.
2.
Cliquez sur le lien Cr&eacute;er un rapport Crystal.
3.
Dans la bo&icirc;te de dialogue Cr&eacute;er un rapport Crystal, saisissez le nom XtremeCustomers.rpt, puis cliquez sur
OK.
La bo&icirc;te de dialogue Galerie de rapports Crystal s'affiche.
4.
Dans le panneau Cr&eacute;er un document de rapport Crystal de la bo&icirc;te de dialogue Galerie de rapports Crystal,
s&eacute;lectionnez en utilisant l' Assistant de cr&eacute;ation de rapports.
5.
Dans le panneau Choisir un expert, s&eacute;lectionnez Standard, puis cliquez sur OK.
516
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
6.
Dans le panneau Sources de donn&eacute;es disponibles de la fen&ecirc;tre de l'Assistant de cr&eacute;ation de rapports
standard, proc&eacute;dez comme suit :
a) D&eacute;veloppez le dossier Cr&eacute;er une nouvelle connexion.
b) D&eacute;veloppez le dossier ODBC (RDO).
7.
Dans la fen&ecirc;tre ODBC (RDO), s&eacute;lectionnez l'entr&eacute;e DSN ODBC correspondant &agrave; l'exemple de base de donn&eacute;es
Xtreme, puis cliquez sur Terminer.
Le dossier ODBC (RDO) se d&eacute;veloppe pour afficher la base de donn&eacute;es Xtreme.
8.
D&eacute;veloppez le nœud Tables, puis s&eacute;lectionnez la table Clients.
9.
Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables s&eacute;lectionn&eacute;es, puis cliquez sur Suivant.
10. Utilisez la combinaison de touches CTRL-clic pour s&eacute;lectionner les champs Nom du client, Titre, Adresse 1 et
Ville.
11. Cliquez sur le bouton &gt; pour d&eacute;placer ces champs dans le panneau Champs &agrave; afficher, puis cliquez sur
Suivant.
12. Dans le panneau Champs disponibles, sous Champs du rapport, s&eacute;lectionnez Clients.Ville, cliquez sur le
bouton &gt; pour d&eacute;placer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.
Le rapport XtremeCustomers est cr&eacute;&eacute; et charg&eacute; dans la fen&ecirc;tre principale de Visual Studio.
13. En bas de la fen&ecirc;tre, cliquez sur Aper&ccedil;u Rapport principal.
Remarque
Le bouton Aper&ccedil;u est une nouvelle fonctionnalit&eacute; du concepteur SAP Crystal Reports incorpor&eacute; fourni avec
SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio.
14. En bas de la fen&ecirc;tre, cliquez sur Rapport principal pour quitter le mode Aper&ccedil;u.
15. Revenez &agrave; la classe Form1.
Le rapport s'affiche sous forme graphique dans le Web Form, en mode Aper&ccedil;u au moment de la conception.
Sous la classe Form1, le rapport XtremeCustomers s'affiche dans la barre d'&eacute;tat des composants.
16. Dans le menu Fichier, cliquez sur Enregistrer tout.
1.5.3.2.2.2
Pour renommer la variable du rapport
Contexte
Votre rapport est cr&eacute;&eacute; et constitue le rapport d&eacute;sign&eacute; pour le contr&ocirc;le CrystalReportViewer. A ce stade, vous
pouvez renommer la variable de rapport.
Proc&eacute;dure
1.
Cliquez sur XtremeCustomers1 dans la barre d'&eacute;tat des composants pour le s&eacute;lectionner.
2.
Dans la fen&ecirc;tre Propri&eacute;t&eacute;s, attribuez au champ Name la valeur &quot;xtremeCustomersReport&quot;.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
517
1.5.3.2.2.3
Pour v&eacute;rifier le projet Windows cr&eacute;&eacute; par
programmation all&eacute;g&eacute;e
Contexte
Vous &ecirc;tes maintenant pr&ecirc;t &agrave; g&eacute;n&eacute;rer et ex&eacute;cuter votre projet.
Proc&eacute;dure
1.
Dans le menu G&eacute;n&eacute;rer, s&eacute;lectionnez G&eacute;n&eacute;rer la solution.
2.
Si vous rencontrez des erreurs lors de la g&eacute;n&eacute;ration, corrigez-les.
3.
Dans le menu D&eacute;boguer, cliquez sur D&eacute;marrer.
4.
Le rapport XtremeCustomers s'affiche dans une nouvelle application Windows.
5.
Revenez dans Visual Studio, puis cliquez sur Arr&ecirc;ter pour quitter le mode d&eacute;bogage.
1.5.3.2.3
Exploration du code g&eacute;n&eacute;r&eacute; par des t&acirc;ches guid&eacute;es
Dans cette section, vous allez explorer le code g&eacute;n&eacute;r&eacute; par les t&acirc;ches guid&eacute;es, qui a permis de configurer un projet
Windows avec SAP Crystal Reports sans avoir &agrave; &eacute;crire de code.
1.5.3.2.3.1
guid&eacute;es
Pour explorer le code g&eacute;n&eacute;r&eacute; par les t&acirc;ches
Proc&eacute;dure
1.
Ouvrez la classe Form1.
2.
Dans le menu Affichage, cliquez sur Code.
La classe Form1 s'ouvre en mode code et affiche une classe vide.
Remarque
Dans C#, la classe vide affiche le constructeur de classe.
public Form1()
{
InitializeComponent();
}
518
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
1.5.3.2.3.2
Pour afficher la classe Form1 partielle masqu&eacute;e
Contexte
Notez que le code suivant est absent :
●
la d&eacute;claration de l'instance du contr&ocirc;le CrystalReportViewer ;
●
l'instance du rapport XtremeCustomers ;
●
le code qui lie le rapport au contr&ocirc;le CrystalReportViewer.
Le code absent a &eacute;t&eacute; masqu&eacute; dans une classe partielle. Elles permettent &agrave; une classe d'accepter un addenda
provenant d'un autre fichier de classe, en attribuant &agrave; ce fichier le m&ecirc;me nom de classe avec le pr&eacute;fixe &quot;partial&quot;.
Les classes partielles contiennent g&eacute;n&eacute;ralement du code g&eacute;n&eacute;r&eacute; automatiquement.
Pour visualiser le code g&eacute;n&eacute;r&eacute; automatiquement qui n'appara&icirc;t pas dans la classe Form1, vous allez explorer les
instances CrystalReportViewer et les instances du rapport dans la classe partielle masqu&eacute;e Form1.
Proc&eacute;dure
1.
Dans l'Explorateur de solutions, cliquez sur l'ic&ocirc;ne de barre d'outils Afficher tous les fichiers.
2.
D&eacute;veloppez Form1.cs ou Form1.vb.
La classe Form1.Designer.cs ou .vb s'affiche.
3.
Cliquez avec le bouton droit de la souris sur la classe Form1.Designer.cs ou .vb, puis s&eacute;lectionnez Afficher le
code.
La classe partielle Form1 s'ouvre et affiche le code g&eacute;n&eacute;r&eacute; de fa&ccedil;on automatique pour cette classe. Cela inclut
la d&eacute;claration de l'instance du contr&ocirc;le CrystalReportViewer, l'instance du rapport XtremeCustomers et le
code qui lie le rapport &agrave; l'instance du contr&ocirc;le CrystalReportViewer.
Remarque
Si vous pr&eacute;f&eacute;rez &eacute;crire le code et le placer dans la classe code-behind, voir Configuration d'un projet [page
15].
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
519
1.5.3.3
Tutoriel : Connexion &agrave; une base de donn&eacute;es s&eacute;curis&eacute;e
&agrave; programmation all&eacute;g&eacute;e dans un site Web
Dans ce tutoriel de cr&eacute;ation de site Web par programmation all&eacute;g&eacute;e, vous allez apprendre &agrave; afficher un rapport
contenant des informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e.
Introduction
Dans ce tutoriel de cr&eacute;ation de site Web par programmation all&eacute;g&eacute;e, vous allez apprendre &agrave; afficher un rapport
contenant des informations provenant d'une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e. Pour cr&eacute;er une connexion &agrave;
une base de donn&eacute;es s&eacute;curis&eacute;e, vous affectez la propri&eacute;t&eacute; DataSources du rapport au contr&ocirc;le SQLDataSource
faisant partie de la nouvelle structure du contr&ocirc;le DataSource dans .NET 2.0.
Dans ce tutoriel, pour afficher un rapport contenant des informations provenant d'une base de donn&eacute;es SQL
Server s&eacute;curis&eacute;e, vous allez utiliser le nouveau mod&egrave;le de d&eacute;veloppement d'applications avec balises pour
connecter les composants cl&eacute;s :
●
Connecter un contr&ocirc;le CrystalReportViewer &agrave; un contr&ocirc;le CrystalReportSource.
●
Connecter le contr&ocirc;le CrystalReportSource &agrave; un rapport.
●
Connecter la propri&eacute;t&eacute; DataSources du rapport &agrave; un contr&ocirc;le SqlDataSource.
Remarque
La propri&eacute;t&eacute; DataSources s'affiche sous forme de propri&eacute;t&eacute; de rapport dans la fen&ecirc;tre Propri&eacute;t&eacute;s, ou sous
forme de balise en mode HTML (mode Source).
Toutes ces op&eacute;rations sont r&eacute;alis&eacute;es sans &eacute;crire de code.
Remarque
Un mod&egrave;le de d&eacute;veloppement de codage de ce tutoriel est &eacute;galement disponible. Voir Tutoriel : Connexion &agrave;
une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e &agrave; l'aide de l'authentification SQL [page 353] ou Tutoriel : Connexion
&agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e &agrave; l'aide de la s&eacute;curit&eacute; int&eacute;gr&eacute;e [page 370].
Pour commencer, vous allez ajouter un contr&ocirc;le CrystalReportViewer au Web Form. Dans le panneau des t&acirc;ches
guid&eacute;es, vous allez cr&eacute;er un contr&ocirc;le CrystalReportSource, puis un rapport Crystal &agrave; l'aide du concepteur
SAP Crystal Reports incorpor&eacute;. Ce rapport se connecte &agrave; une base de donn&eacute;es SQL Server s&eacute;curis&eacute;e. Le rapport
est r&eacute;f&eacute;renc&eacute; dans le contr&ocirc;le CrystalReportSource.
Vous allez ensuite apprendre &agrave; configurer la connexion &agrave; la base de donn&eacute;es SQL Server s&eacute;curis&eacute;e afin de
renvoyer les tables requises utilis&eacute;es par le rapport Crystal. Pour commencer, vous allez s&eacute;lectionner l'option
&quot;Activer l'invite de connexion &agrave; la base de donn&eacute;es&quot; dans le panneau des t&acirc;ches guid&eacute;es. Lorsque cette option est
s&eacute;lectionn&eacute;e, l'exception renvoy&eacute;e lorsque la connexion &agrave; la base de donn&eacute;es &eacute;choue est remplac&eacute;e par une invite
demandant &agrave; l'utilisateur de se connecter manuellement.
Pour configurer une connexion coh&eacute;rente &agrave; la base de donn&eacute;es requise, vous ajoutez un contr&ocirc;le SqlDataSource,
puis le configurez de mani&egrave;re &agrave; ce qu'il d&eacute;signe la base de donn&eacute;es SQL Server s&eacute;curis&eacute;e et renvoie les tables
requises.
Enfin, vous affectez la propri&eacute;t&eacute; DataSource du rapport au contr&ocirc;le SqlDataSource que vous avez cr&eacute;&eacute;.
520
&copy; 2014 SAP AG ou soci&eacute;t&eacute; affili&eacute;e SAP. Tous droits r&eacute;serv&eacute;s.
SAP Crystal Report pour le Guide du d&eacute;veloppeur de SAP SDK Visual Studio .NET
Guide du d&eacute;veloppeur du SAP SDK Crystal Reports .NET
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version termin&eacute;e du projet. Suivez les
instructions de ce tutoriel pour cr&eacute;er un projet ou ouvrez le projet d'exemple de code pour travailler &agrave; partir d'une
version termin&eacute;e.
Les exemples de code sont stock&eacute;s dans des dossiers class&eacute;s par langue et par type de projet. Les noms des
dossiers de chaque version d'exemple de code sont les suivants :
●
Site Web C# : CS_Web_ReducedCode_DBLogon
●
Site Web Visual Basic : VB_Web_ReducedCode_DBLogon
Informations associ&eacute;es
R&eacute;pertoire d'exemples de rapports [page 15]
1.5.3.3.1
Cr&eacute;ation d'un site Web avec un contr&ocirc;le
CrystalReportViewer
Avant de cr&eacute;er un site Web, v&eacute;rifiez que SAP Crystal Reports, version d&eacute;veloppeur pour Microsoft Visual Studio, a
&eacute;t&eacute; install&eacute; sur votre syst&egrave;me.
Une configuration pr&eacute;alable de la base de donn&eacute;es est requise avant de commencer ce tutoriel.
1.5.3.3.1.1
donn&eacute;es
●
Configuration pr&eacute;alable requise de la base de
Conf">
こんにちは！私はAIチャットボットで、SAP version développeur pour Microsoft Visual Studio Developer Guideに関するサポートをするために特別にトレーニングされています。すでにドキュメントを徹底的に確認しており、必要な情報を正確に見つけたり、内容をわかりやすく説明したりできます。特定の機能に関するガイダンス、トラブルシューティングの手順、または一般的な使い方について知りたい場合でも、遠慮なく質問してください。問題やニーズについて詳細を教えていただければ、より正確かつ効果的にお手伝いできます！