SAP Crystal Report pour le Guide du développeur de SAP SDK

SAP Crystal Reports, version dveloppeur pour Microsoft Visual StudioVersion du document : Support Package 10 - 2014-06-23

SAP Crystal Report pour le Guide du dveloppeur de SAP SDK Visual Studio .NET

Table des matires1 Guide du dveloppeur du SAP SDK Crystal Reports .NET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1 Dmarrage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1.1 Prsentation de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1.2 Migration de l'application SAP Crystal Reports .Net. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.2 Configuration de l'environnement de dveloppement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.2.1 Configuration du systme. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

1.2.2 Configuration d'un projet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

1.3 Principes fondamentaux du SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

1.3.1 Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

1.3.2 Contrle CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

1.3.3 Quelle mthode de persistance utiliser avec SAP Crystal Reports ?. . . . . . . . . . . . . . . . . . . . 53

1.3.4 Evolutivit de l'application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

1.3.5 Utilisation de SAP Crystal Reports dans une batterie de serveurs Web ou un jardin Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

1.3.6 Utilisation de Crystal Reports en tant que service Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

1.3.7 Considrations de scurit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

1.4 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 donnes avec des paramtres ou des formules. . . . . . . . . . . . . . . . . . . . . . . . . .136

1.4.4 Dfinition de la source de donnes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

1.4.5 Visualisation d'un rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

1.4.6 Personnalisation du contrle CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

1.4.7 Utilisation des rapports SAP Crystal Reports Read-Only (RPTR). . . . . . . . . . . . . . . . . . . . . 243

1.5 Tutoriels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

1.5.1 Tutoriels du modle d'objet CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

1.5.2 Tutoriels du modle d'objet ReportDocument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

1.5.3 Tutoriels de programmation allge dans Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . 508

1.5.4 Tutoriels sur la connectivit des donnes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549

1.5.5 Tutoriels supplmentaires. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

1.6 Dploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618

1.6.1 Composants de dploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .618

1.6.2 Dploiement pour Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

1.7 Cration des rapports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

1.7.1 Utilisation du SAP Crystal Reports Designer incorpor. . . . . . . . . . . . . . . . . . . . . . . . . . . . 647

1.7.2 Formules - Rfrence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .786

1.7.3 Interface utilisateur - Rfrence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856

2 2014 SAP AG ou socit affilie SAP. Tous droits rservs.SAP Crystal Report pour le Guide du dveloppeur de SAP SDK Visual Studio .NET

Table des matires

1.8 Glossaire. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1009

SAP Crystal Report pour le Guide du dveloppeur de SAP SDK Visual Studio .NETTable des matires 2014 SAP AG ou socit affilie SAP. Tous droits rservs. 3

1 Guide du dveloppeur du SAP SDK Crystal Reports .NET

1.1 Dmarrage

Cette aide en ligne est conue pour vous aider dvelopper vos propres applications Web ou Windows l'aide du SDK SAP Crystal Reports .NET. Elle comprend des tutoriels et des rfrences de programmation qui vous aideront implmenter le SDK SAP Crystal Reports .NET.

1.1.1 Prsentation de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio permet de crer des rapports complexes de qualit professionnelle dans un programme bas sur une interface utilisateur graphique. Vous pouvez alors connecter votre rapport pratiquement n'importe quelle source de base de donnes ou des donnes proxy, comme un ensemble de rsultats (par exemple, un objet DataSet ADO.NET). A l'aide des assistants du concepteur d'interface utilisateur, vous pouvez dfinir la mise en forme, le regroupement, les diagrammes et d'autres critres.

Vous pouvez hberger votre rapport dans une application Web ou Windows avec l'un des contrles visualiseur de rapports de SAP Crystal Reports. La prsentation des rapports dans les clients Windows et HTML 4.0 est hautement interactive et offre des fonctionnalits telles que l'exploration de diagrammes, la navigation dans les rapports et la recherche de texte.

SAP Crystal Reports, version dveloppeur 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'excution, grce l'emploi de l'un des quatre modles d'objet suivants :

CrystalReportViewer, le modle d'objet le plus simple. ReportDocument, le modle d'objet le plus complet. ReportClientDocument, le modle d'objet le plus complet. Ce modle d'objet est disponible avec un serveur

RAS. InfoObject, un modle d'objet puissant conu pour la planification et la configuration de rapports dans la

structure SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.

RemarqueLes modles d'objet CrystalReportViewer et ReportDocument sont disponibles avec toutes les versions de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio. Les modles d'objet ReportClientDocument et InfoObject ncessitent une licence mise niveau. Voir Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65].

Vous pouvez associer des rapports un projet Visual Studio de nombreuses faons :

Incorporez les rapports directement dans le projet. Accdez aux rapports partir d'un rpertoire de fichiers.


Guide du dveloppeur du SAP SDK Crystal Reports .NET

Accdez aux rapports en tant que service Web de rapports partir d'un serveur distant. Connectez vos rapports en tant que services Crystal. Avec une mise niveau vers SAP Crystal Reports Server, accdez aux rapports via le serveur RAS. Avec une mise niveau vers la plateforme SAP BusinessObjects Business Intelligence, accdez aux rapports

via le Page Server ou le serveur RAS prsent dans la structure de la plateforme SAP BusinessObjects Business Intelligence.

1.1.1.1 Fonctionnalits disponibles dans SAP Crystal Report Designer

SAP Crystal Reports Designer propose plusieurs fonctionnalits qui ne sont pas disponibles avec SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio :

Fonction Description

Membres calculs dans des diagrammes de tableau crois Vous pouvez ajouter des lignes ou des colonnes un diagramme de Tableau crois en insrant un membre calcul. Ces lignes ou colonnes peuvent contenir des calculs personnaliss (par exemple, la diffrence de ventes entre deux rgions) ou peuvent tre entirement utilises des fins de mise en forme (par exemple, en insrant une ligne vide toutes les trois lignes pour amliorer la clart). Vous disposez d'une entire souplesse dans la conception de vos propres formules de calcul et pouvez choisir si elles apparaissent seulement une fois ou se rptent rgulirement dans le Tableau crois.

Objets Flash incorpors Vous pouvez incorporer un objet Flash ou crer un lien vers un objet Flash dans une section quelconque de rapport SAP Crystal Reports.

Rsums incorpors dans des tableaux croiss Vous pouvez ajouter un calcul supplmentaire votre diagramme de Tableau crois en insrant un rsum incorpor. Les rsums incorpors n'ajoutent pas de lignes ou de colonnes votre Tableau crois. Ils entranent plutt l'apparition de calculs supplmentaires dans chacune des cellules du Tableau crois. Par exemple, dans un rapport affichant les ventes rgionales, vous pouvez insrer un calcul pour chaque rgion, qui affiche le pourcentage des ventes totales du pays.

Aperu modifiable Avec SAP Crystal Reports Designer, vous pouvez visualiser un rapport dans l'onglet de conception ou l'onglet d'aperu. Vous disposez des mmes possibilits de mise en forme dans l'onglet Aperu que dans l'onglet Conception. Nanmoins, dans l'onglet Aperu, vous travaillez avec les

SAP Crystal Report pour le Guide du dveloppeur de SAP SDK Visual Studio .NETGuide du dveloppeur du SAP SDK Crystal Reports .NET 2014 SAP AG ou socit affilie SAP. Tous droits rservs. 5

Fonction Description

donnes relles. Au lieu d'un cadre de champ de donnes reprsentant plusieurs valeurs de champ de donnes, les valeurs relles apparaissent dans le rapport.

Code-barres mis en forme SAP Crystal Reports Designer comprend les formules et polices ncessaires 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 tre lu par un scanneur.

Pour afficher le code-barres dans une autre couleur.

Champs de tri interactifs 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 donnes. Pour ce faire, ajoutez un Contrle de tri votre rapport.

Un Contrle de tri est particulirement utile pour plusieurs raisons :

Il permet aux utilisateurs de trier les donnes du rapport pour une analyse plus approfondie sans quitter la zone de dessin du rapport.

Il limine la demande de traitement sur la base de donnes.

Il rduit le temps d'attente des utilisateurs pendant le tri des donnes.

Il permet aux utilisateurs de trier les champs du rapport, mme s'ils ne disposent pas d'une connexion ou des droits d'accs la base de donnes au moment de l'affichage.

Workbench Sur le Workbench, vous pouvez crer 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 rorganiser les fichiers dans un dossier ou des dossiers en les faisant glisser et en les dposant o vous souhaitez qu'ils apparaissent. Vous pouvez galement faire glisser des fichiers de rapport de l'Explorateur Windows et les dposer dans le dossier de votre choix sur le Workbench.



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 dveloppeur pour Microsoft Visual Studio.

RemarqueSAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio est dot d'un ensemble complet de fonctionnalits et est disponible en tlchargement gratuit s'intgrant Visual Studio 2010 ou version ultrieure. SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio n'est pas fourni avec l'application SAP Crystal Reports Designer.


Options de migration dans les diffrentes versions de SAP Crystal Reports

Ce diagramme reprsente les diffrents chemins de migration entre les versions de SAP Crystal Reports.



Migration vers SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio met automatiquement niveau vos anciens projets vers la version actuelle. Si un projet contient des rfrences d'anciens composants, l'utilisateur est invit effectuer une mise niveau.

Si vous cliquez sur le bouton Oui, les projets et les fichiers associs sont mis niveau vers la version actuelle de SAP Crystal Reports. Si vous cliquez sur le bouton Non, le projet est adapt de manire utiliser les rfrences d'origine. Certaines fonctionnalits rcentes sont dsactives si elles ne sont pas prises en charge par les composants plus anciens.

RemarqueSi le fichier de projet (tout fichier ASPX possdant des composants SAP Crystal Reports ou le fichier web.config) est verrouill, la mise niveau ou l'adaptation choue.

Informations associes

Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65]

1.1.2.1 Problmes de migration

Un rapport bas sur une source de donnes ADO.NET ne fonctionnera pas si le projet vise .NET 4.x Framework

Les rapports bass sur une source de donnes ADO.NET ne fonctionneront pas si le projet vise .NET 4.x Framework. L'erreur suivante se produit : "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 complmentaires : la liaison d'assembly en mode mixte a t cre avec la version v2.0.50727 du programme d'excution et ne peut pas tre charge dans le programme d'excution 4.0 sans informations de configuration supplmentaires)".

Pour rsoudre ce problme, vous pouvez mettre jour le fichier .config de votre projet. Ajoutez les lignes de code suivantes dans la section du fichier :


1.1.2.2 Limites en 64 bits

L'architecture 64 bits est prise en charge dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio x 64 (AMD64). Toutefois, l'architecture IA64 (Itanium) n'est pas prise en charge ce jour.

Fonctionnalits actuellement non prises en charge dans les scnarios 64 bits :

Exportation de rapports au format HTML. Composants de cration de cartes gographiques. Composants de police de codes barres Azalea.

1.2 Configuration de l'environnement de dveloppement

Cette section fournit des instructions dtailles sur l'installation et la configuration de votre environnement de dveloppement, ainsi que sur la cration d'un site Web ou d'un projet Windows dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio.

1.2.1 Configuration du systme

Cette section indique comment configurer votre environnement de dveloppement pour tester et dvelopper des applications Windows ou des sites Web utilisant le SDK de SAP Crystal Reports .NET.

1.2.1.1 Elments installer

Vous devez installer SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio avant de pouvoir crer 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 dveloppeur pour Microsoft Visual Studio, vrifiez que la version de Visual Studio que vous avez installe prend en charge SAP Crystal Reports.

Les ditions Visual Studio Ultimate, Premium et Professional sont prises en charge pour Visual Studio 2010 et ultrieure. Les ditions Visual Studio Express ne sont pas prises en charge par SAP Crystal Reports.


Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65]



1.2.1.1.2 Versions SAP Crystal Reports

Plusieurs versions de SAP Crystal Reports sont disponibles. De nombreuses procdures dcrites dans ce document s'appliquent une version spcifique. Pour utiliser au mieux ce document, dterminez d'abord quelle version de SAP Crystal Reports est installe sur votre systme.

1.2.1.1.2.1 Pour dterminer la version de SAP Crystal Reports que vous utilisez

Procdure

1. Accdez au cache GAC (Global Assembly Cache) l'emplacement C:\WINNT\Assembly ou C:\Windows\Assembly.

2. Recherchez le fichier CrystalDecisions.CrystalReports.Engine.

RemarqueSi vous avez install diffrentes versions de SAP Crystal Reports, plusieurs versions de ces fichiers se trouvent dans le Global Assembly Cache. Le fichier CrystalDecisions.CrystalReports.Engine est slectionn car il est inclus dans chaque version de SAP Crystal Reports.

3. Recherchez la colonne Version affiche dans la fentre.

Il s'agit de la "version de l'assembly".4. Recherchez le numro d'assembly le plus lev.5. Comparez la version de l'assembly avec le numro de version indiqu 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 dveloppeur 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


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 mme numro de version d'assembly. Si SAP Crystal Reports 2008 SP1 est install, la version du fichier doit commencer par 12.1 et non par 12.0.

1.2.1.1.3 Installation du service de mise jour de SAP Crystal Reports

Contexte

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio fournit dsormais en option un service de mise jour de SAP Crystal Reports qui recherche les mises jour et les correctifs de SAP Crystal Reports.

Le service de mise jour de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio n'est pas fourni en tant que composant du programme d'installation. Vous devez le tlcharger et l'installer sparment.

Procdure

1. Aprs avoir install SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio, dmarrez Visual Studio et crez 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 en gras, puis cliquez sur Ajouter Nouvel lment .

3. Dans la bote de dialogue Ajouter un nouvel lment, slectionnez Rapport Crystal.4. Dans le champ Nom, saisissez Test.rpt, puis cliquez sur Ajouter.

RemarqueSi vous utilisez le SAP Crystal Report Designer incorpor pour la premire fois, un message vous invite accepter les termes du Contrat de licence utilisateur. Ensuite, la bote de dialogue Service de mise jour s'ouvre. Si vous avez dj utilis le SAP Crystal Report Designer incorpor auparavant, vous devrez ouvrir la bote de dialogue Service de mise jour manuellement.

Le SAP Crystal Reports Designer incorpor s'ouvre et affiche le nouveau rapport.5. Si la bote de dialogue Service de mise jour n'apparat pas, cliquez sur Rechercher les mises jour dans le

menu Crystal Reports.

Si le service de mise jour de SAP Crystal Reports n'est pas install, un message vous invite le faire.6. Dans la bote de dialogue Service de mise jour, cliquez sur Oui.

Le site Web du service de mise jour de SAP Crystal Reports s'affiche avec un lien permettant de tlcharger ce service.



7. Tlchargez et installez le service de mise jour de SAP Crystal Reports.8. Dmarrez nouveau Visual Studio.9. Ouvrez Test.rpt.

Le SAP Crystal Report Designer incorpor dmarre et affiche le rapport.10. Dans le menu Crystal Reports, cliquez sur Rechercher les mises jour.

Le service de mise jour dmarre et recherche les mises jour. Vous pouvez accepter ou refuser toutes les mises jour disponibles.

1.2.1.1.4 Code cl de produit SAP Crystal Reports

Le code cl consiste en une chane alphanumrique comportant 19 chiffres ou caractres. Dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio, lorsque vous crez des projets de dploiement utilisant le programme Windows Installer, il peut tre ncessaire d'indiquer un code cl de produit pour valider les informations de licence des applications Web ou Windows.

1.2.1.2 Elments vrifier

Pour dvelopper un site Web ou une application Windows qui utilise le SDK de SAP Crystal Reports .NET, vous devez vrifier que les composants de Crystal Reports Developer ont t correctement installs et intgrs Visual Studio. Pour dvelopper un site Web, vous devez galement vrifier que le rpertoire virtuel des visualiseurs a t correctement install sur les serveurs Web de dveloppement et de dploiement.

Cette section dtaille les paramtres vrifier avant la cration d'une application SAP Crystal Reports .NET.


Versions de Visual Studio prises en charge [page 10]

1.2.1.2.1 Vrification de l'installation de SAP Crystal Reports

Contexte

Pour vrifier que le composant SAP Crystal Reports de Visual Studio est install, assurez-vous que son nom est affich dans la bote de dialogue Ajouter un nouvel lment de l'application Visual Studio.


Procdure

1. Lancez Visual Studio.2. Crez 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 lment.

RemarqueLes nouveaux fichiers de rapport doivent tre ajouts directement un projet. Vous ne pouvez pas crer un rapport Crystal dans Visual Studio via le menu Fichier.

4. Dans la bote de dialogue Ajouter un nouvel lment, faites dfiler la liste des lments disponibles pour vrifier que Crystal Reports y figure bien.

1.2.1.2.2 Rpertoire des visualiseurs

SAP Crystal Reports utilise un rpertoire virtuel pour accder aux visualiseurs afficher. Le nom du rpertoire virtuel et le chemin d'accs aux fichiers associs diffrent dans chaque version de SAP Crystal Reports. Cela vite les risques de conflit si vous installez plusieurs versions de SAP Crystal Reports sur le mme ordinateur.

1.2.1.2.2.1 Emplacement par dfaut du rpertoire virtuel des visualiseurs

Si vous avez install SAP Crystal Reports avec les paramtres et chemins d'accs par dfaut, les visualiseurs se trouvent dans le rpertoire virtuel indiqu ci-dessous.

Version Structure Chemin d'accs

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio

4.x Framework Chemin d'accs au fichier lors de l'utilisation du serveur de dveloppement ASP.NET :

\Windows\Microsoft.NET\Framework\v4.0.30319\ASP.NETClientFiles\crystalreportviewers13

Chemin d'accs au fichier lors de l'utilisation d'IIS :

\inetpub\wwwroot\aspnet_client\system_web\4_0_30319\crystalreportviewers13

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio

2.0 Framework Chemin d'accs au fichier lors de l'utilisation du serveur de dveloppement ASP.NET :



Version Structure Chemin d'accs

\Windows\Microsoft.NET\Framework\v2.0.50727\ASP.NETClientFiles\crystalreportviewers13

Chemin d'accs 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 rpertoire des visualiseurs

Procdure

1. Dans le Panneau de configuration, cliquez deux fois sur Outils d'administration, puis sur Internet Information Services.

2. Dans la bote de dialogue Internet Information Services, dveloppez le nud Site Web, puis le nud Site Web par dfaut.

3. Localisez tous les dossiers contenant un dossier crystalreportsviewers13.4. Cliquez avec le bouton droit de la souris sur chaque dossier crystalreportsviewers13, puis slectionnez

Proprits.5. Dans la bote de dialogue Proprits, vrifiez que le chemin d'accs local est correctement configur pour

votre version de SAP Crystal Reports ou de Visual Studio.

1.2.1.2.3 Rpertoire d'exemples de rapports

Certains exemples de fonctionnalits, scnarios de liaison de rapports et tutoriels reposent sur des exemples de rapports fournis avec SAP Crystal Reports.

Vous pouvez tlcharger les exemples de rapports partir de l'adresse suivante : http://

www.sdn.sap.com/irj/boc/downloads

1.2.2 Configuration d'un projet

Cette section prsente des informations essentielles pour les dveloppeurs ayant un niveau avanc ou intermdiaire. Elle indique les meilleures pratiques suivre pour crer et configurer un projet Windows ou un projet/site Web l'aide de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio.

En outre, le projet que vous allez crer sera utilis dans les tutoriels prsents dans cette aide en ligne.


http://help.sap.com/disclaimer?site=http://www.sdn.sap.com/irj/boc/downloadshttp://help.sap.com/disclaimer?site=http://www.sdn.sap.com/irj/boc/downloads

1.2.2.1 Configuration d'un site Web dans Visual Studio

Cette section dcrit la configuration d'un site Web dans Visual Studio. Le site Web que vous allez ainsi crer servira de prrequis aux tutoriels de programmation classique fournis dans cette aide en ligne.

1.2.2.1.1 Cration d'un site Web dans Visual Studio

Procdure

1. Lancez Visual Studio.2. Dans le menu Fichier, slectionnez Nouveau Site Web.3. Dans la bote de dialogue Nouveau site Web, cliquez sur Site Web ASP.NET.4. Dans la liste droulante Emplacement, slectionnez Systme de fichiers.5. Dans la liste droulante Langage, slectionnez le langage de programmation que vous souhaitez utiliser.6. Dans le champ de texte Emplacement, saisissez le chemin d'accs du rpertoire C:\WebSites\, suivi du nom

de votre projet.

C:\WebSites\NomMonProjet

7. Cliquez sur OK.

1.2.2.1.2 Prparation du Web Form

1.2.2.1.2.1 Pour crer le Web Form

Contexte

Dans cette section, vous allez configurer la classe code-behind pour le Web Form.

RemarqueLes termes "Web Form", "page ASPX" et "Default.aspx" sont utiliss de manire interchangeable.

Procdure

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.



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.

RemarqueSi votre page Default.aspx a t cre avec un code incorpor, son code n'a pas t plac dans un fichier spar. Dans ce cas, supprimez la page ASPX et recrez-la. Lorsque vous crez la page ASPX, activez la case cocher "Placer le code dans un fichier distinct".

3. Si vous crivez cette classe en langage Visual Basic, tapez "Option Strict On" au dbut de la classe.

RemarqueIl est recommand de dfinir Option Strict sur On au dbut de chaque classe Visual Basic de votre site Web. Ainsi, vous serez tenu de respecter les conventions d'criture du code, savoir l'emploi de dclarations de variables fortement types et la dfinition d'un cast valide, deux conventions qui sont vrifies au moment de la compilation du code. Cette prcaution aide rduire les exceptions gnres l'excution du code.

1.2.2.1.2.2 Pour ajouter des instructions Imports et Using aux espaces de noms de rfrence

Procdure

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 dclaration "Imports" [Visual Basic] ou "using" [C#] au

dbut de la classe contenant les espaces de noms SAP Crystal Reports suivants.

Imports CrystalDecisions.CrystalReports.EngineImports CrystalDecisions.Shared

using CrystalDecisions.CrystalReports.Engine;using CrystalDecisions.Shared;

RemarqueLes classes de ces deux assemblies sont couramment utilises dans tous les tutoriels. En ce qui concerne les assemblies supplmentaires dont vous pourriez avoir besoin dans des tutoriels spcifiques, vous trouverez des instructions pour les ajouter tout au long de ce tutoriel.


1.2.2.1.2.3 Pour ajouter une mthode d'assistance prive pour le code de configuration de SAP Crystal Reports

Procdure

Dans la classe, ajoutez une nouvelle mthode d'assistance prive nomme ConfigureCrystalReports(), sans valeur renvoye.

Private Sub ConfigureCrystalReports()

End Sub

private void ConfigureCrystalReports(){}

La mthode ConfigureCrystalReports() permet aux utilisateurs d'interagir avec le rapport au moment de l'excution. De plus, elle contrle l'interaction par programme avec le rapport.

tapes suivantes

Ensuite, vous allez ajouter un gestionnaire d'vnements Page_Init partir duquel appeler la mthode ConfigureCrystalReports(). Le fait d'appeler la mthode ConfigureCrystalReports() partir de ce gestionnaire d'vnements garantit que le code de configuration du rapport Crystal s'excutera durant l'vnement d'initialisation de la page.

1.2.2.1.2.4 Pour ajouter un gestionnaire d'vnements Page_Init la classe code-behind

Contexte

Gnralement, le gestionnaire d'vnements Page_Load permet de saisir le code de configuration du Web Form dans une application Web ASP.NET de manire ce que ce programme soit appel pendant l'vnement Page.Load. Mais le code de configuration du rapport Crystal doit tre appel plus tt, pendant l'vnement Page.Init.

Procdure

1. Ajoutez l'vnement Page_Init votre code.



Si vous codez dans Visual Basic, slectionnez Page Events dans la liste droulante suprieure gauche et l'vnement Init dans la liste droulante suprieure droite. Le gestionnaire d'vnements Page_Init sera ajout 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'vnements Page_Init l'aide de la syntaxe exacte indique.

private void Page_Init(object sender, EventArgs e){

}

RemarqueDans un Web Form C# de Visual Studio 2005 ou version suivante, les gestionnaires d'vnements Page_Init, Page_Load ou Page_PreRender de la classe code-behind sont connects automatiquement l'vnement Init, Load ou PreRender. La signature de gestionnaire d'vnements doit correspondre exactement pour pouvoir tre appele.

Cette fonctionnalit est disponible lorsque le paramtre AutoEventWireup de la directive Page, qui se trouve au dbut de la page ASPX en mode HTML, est dfini sur True.

Les versions prcdentes de Visual Studio .NET dfinissaient 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 dfinie sur True par dfaut.

2. dans le gestionnaire d'vnements Page_Init de Visual Basic ou C#, ajoutez un appel la mthode d'assistance ConfigureCrystalReports().

ConfigureCrystalReports()

ConfigureCrystalReports();

3. Dans le menu Fichier, cliquez sur Enregistrer tout.

1.2.2.1.3 Pour ajouter un contrle CrystalReportViewer un site Web

Procdure

1. Ouvrez la page Default.aspx.2. Cliquez sur le bouton Design au bas du formulaire.


3. Dans la Bote outils, ouvrez le nud Reporting afin de localiser le contrle CrystalReportViewer.

RemarqueDans les versions prcdentes de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio, le contrle CrystalReportViewer apparaissait dans le nud Crystal Reports.

4. Faites glisser le contrle CrystalReportViewer sur le Web Form.5. Dans le menu Fichier, cliquez sur Enregistrer tout.

Rsultats

Si vous ajoutez un contrle CrystalReportViewer votre application, les rfrences aux assemblies SAP Crystal Reports seront automatiquement ajoutes votre rapport.

1.2.2.1.4 Configuration du fichier Web.Config

Un fichier Web.Config dans une application Web ASP.NET stocke les paramtres globaux, tels que les informations de connexion la base de donnes, les rfrences d'assembly et la gestion des erreurs. Ce fichier est crit en langage XML et son lment racine doit toujours tre . Il s'agit d'une configuration avance qui est facultative.

Les lments suivants sont spcifiques SAP Crystal Reports et peuvent tre ajouts votre fichier Web.Config.

RemarqueLes numros de version peuvent changer en fonction du produit dont vous disposez.

RemarqueDans .NET 2.0 et versions ultrieures, la balise section du fichier Web.Config doit utiliser la syntaxe suivante :

CrystalImageCleaner

Le processus CrystalImageCleaner supprime automatiquement les images gnres dynamiquement rendues par le contrle CrystalReportViewer. Ce paramtre vous permet de dfinir l'intervalle entre les analyses



du rpertoire d'images et l'ge minimal des fichiers avant suppression. Cet lment est automatiquement ajout au fichier Web.Config lorsque vous ajoutez le contrle CrystalReportViewer votre site Web. Il correspond la classe CrystalImageCleaner.

CrystalImageCleaner-Sleep initialise la dure en millisecondes pendant laquelle le nettoyeur d'image reste en veille avant d'analyser et de nettoyer les fichiers image dans le rpertoire des images dynamiques.

CrystalImageCleaner-Age initialise l'ge minimal d'un fichier, en millisecondes, avant sa suppression. CrystalImageCleaner-AutoStart contrle le processus CrystalImageCleaner. Le nettoyeur d'image

nettoie les images temporaires qui sont cres lors de la visualisation d'un rapport.

RemarqueUn seul nettoyeur d'image peut tre dmarr dans un processus de traitement ASP.NET unique.

CrystalImageHandler

L'lment CrystalImageHandler affiche toutes les images dynamiques dans le contrle CrystalReportViewer. Ce paramtre configure le processus de traitement ASP.NET pour rediriger les requtes adresses CrystalImageHandler.aspx vers une classe de traitement d'image interne uniquement. Si le paramtre CrystalImageHandler ne figure pas dans votre fichier Web.Config, les images de votre site Web ne s'afficheront pas. Cet lment est automatiquement ajout au fichier Web.Config lorsque vous ajoutez le contrle CrystalReportViewer votre site Web.

documentView

L'lment documentView contrle l'apparence du rapport dans la trame du rapport. Deux paramtres sont fournis :

Si la valeur est dfinie sur printlayout, une bordure grise s'affiche autour du rapport et une ombre porte s'affiche dans la trame. Il s'agit de la valeur par dfaut.


Si la valeur est dfinie sur weblayout le rapport remplit la trame.

EnableTextClipping

L'lment EnableTextClipping contrle si le texte du champ est tronqu. Une fois dfini sur true, le texte contenu dans un champ ne chevauchera pas le texte dans le champ situ en regard..

globalResourcePath

L'lment globalResourcePath est la rfrence au chemin du rpertoire de fichiers pour les ressources globales. Ce rpertoire de fichiers contient vos ressources de langue personnalises dans un emplacement central et peut tre partag par plusieurs applications Web. Ce paramtre vous permet d'accder aux ressources globales d'un site Web spcifique. Dans SAP CrystalReports.NET, les fichiers de ressources par dfaut ne sont pas fournis lors de l'installation du produit, mais peuvent tre tlchargs partir du site Web de support technique de SAP BusinessObjects : http://help.sap.com. Cet lment doit tre manuellement ajout au fichier Web.Config de votre site Web.



http://help.sap.com

maxNumberListOfValues

L'lment maxNumberListOfValues contrle le nombre d'lments LOV qui seront envoys au client. Contrle le nombre de valeurs affiches dans le panneau des paramtres. Si cette valeur est dfinie, seules les n premires valeurs apparaissent dans la liste de valeurs. La bote de dialogue Paramtres avancs permet de paginer plusieurs ensembles de valeurs en fonction de la taille de la liste et de la valeur de l'lment maxNumberListOfValues. Si vous disposez, par exemple, de 180 valeurs et que vous dfinissez l'lment maxNumberListOfValues sur 50, vous pourrez afficher les 50 premires valeurs du panneau des paramtres. Vous pourrez paginer les 180 valeurs dans la bote de dialogue Paramtres avancs et afficher ainsi trois groupes de 50 valeurs et un groupe de 30 valeurs.

Il est recommand de dfinir systmatiquement une valeur suprieure 0. La valeur par dfaut est 200.

printControl

L'lment printControl vous permet d'imprimer le rapport directement sur votre imprimante locale. Le rpertoire d'installation par dfaut est C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Common\Crystal Reports 2011\crystalreportviewers.

Ce paramtre rend le fichier .cab visible par votre site Web .NET SAP Crystal Reports. Cet lment doit tre manuellement ajout au fichier Web.Config de votre site Web.


processingIndicatorDelay

L'lment processingIndicatorDelay contrle le dlai pralable l'apparition de l'indicateur de traitement de rapport. La valeur est spcifie en millisecondes. Le fait de dfinir cette valeur sur 0 dsactive l'indicateur de traitement de rapport. La valeur par dfaut est de 200 ms.

processingIndicatorText

L'lment processingIndicatorText contrle le texte affich dans l'indicateur de traitement de rapport. Le texte par dfaut est : Veuillez patienter pendant le traitement du document.



reportMappings

L'lment reportMappings met jour les sites Web crs dans Visual Studio 2003 qui utilisent des rapports incorpors et les convertit en sites Web non incorpors lorsqu'ils sont ouverts dans Visual Studio 2005 ou version suivante. Ce paramtre convertit le fichier .dll cr dans Visual Studio 2003 en fichier disque. Visual Studio 2005 et 2008 ne prennent pas en charge les sites Web incorpors 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 lment doit tre manuellement ajout au fichier Web.Config de votre site Web. Le paramtre reportMappings ncessite un chemin absolu.

RemarqueCet lment est valide pour Visual Studio 2005 et Visual Studio 2008 uniquement.

resourceURI

L'lment resourceURI dfinit l'emplacement du rpertoire crystalreportviewers dans l'application Web. Le rpertoire crystalreportviewers contient tous les fichiers requis par le visualiseur.


serverFileReportManager

L'lment serverFileReportManager est un service Web qui numre les fichiers serveur situs sur le serveur. Ce paramtre vous permet d'obtenir une liste d'objets (dossiers et rapports) depuis un ordinateur distant. Il a pour valeur la racine du rpertoire de fichiers du serveur. Dans cet exemple, la racine dfinie est c:\inetpub\wwroot. Cet lment doit tre manuellement ajout au fichier Web.Config de votre site Web.

RemarqueIl correspond la classe serverFileReportManager.

UseAsynchronousRequests

Les requtes asynchrones sont autorises par dfaut dans le visualiseur DHTML. Pour activer le bouton Retour dans le navigateur afin d'utiliser le visualiseur DHTML, vous devez dsactiver les requtes asynchrones en dfinissant ce paramtre sur false.

RemarqueIl est recommand de ne pas dfinir l'lment UseAsynchronousRequests sur false. Cette action dsactive en effet la bote de dialogue Paramtres avancs dans le panneau des paramtres ainsi que certaines amliorations au niveau de la performance du visualiseur et certaines fonctionnalits qui permettent d'amliorer l'apparence.

crystal_use_asynchronous_requests false

UseBrowserLocale

L'lment UseBrowserLocale extrait les paramtres de langue de votre navigateur pour le contrle CrystalReportViewer. Lorsqu'il est dfini sur true, ce paramtre configure le contrle CrystalReportViewer pour observer les paramtres rgionaux du navigateur. Lorsqu'il est dfini sur false, il limite les paramtres rgionaux



qui sont affichs page par page. Cet lment doit tre manuellement ajout au fichier Web.Config de votre site Web.

ExempleExemple de fichier Web.Config


Impression


http://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms225384(VS.80).aspx

Web : configuration de la localisation base sur le navigateur

Web : configuration des ressources personnalises globales ou locales

Comment ajouter ou supprimer des rfrences dans Visual Studio

Versions SAP Crystal Reports

1.2.2.2 Configuration d'un projet Windows dans Visual Studio

Cette section prsente des informations essentielles pour les dveloppeurs ayant un niveau avanc ou intermdiaire. Elle indique les mthodes suivre pour crer et configurer un projet Windows l'aide de SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio.

La configuration d'un projet Windows prsente dans cette section fait appel un modle de programmation classique. Au cours de cette procdure, vous serez amen accder la classe Form1 et entrer du code. Ce projet Windows que vous allez ainsi crer servira de condition prrequise aux tutoriels de programmation classique fournis dans cette aide en ligne.

1.2.2.2.1 Cration d'un projet Windows dans Visual Studio

Procdure

1. Lancez Visual Studio.2. Dans le menu Fichier, slectionnez Nouveau, puis cliquez sur Projet.3. Dans la bote de dialogue Nouveau projet, dans la liste Types de projets, slectionnez un dossier de langage

pour C# ou Visual Basic.4. Dans la liste Modles, cliquez sur Application Windows Forms.5. Dans le champ Nom, remplacez le nom de projet par dfaut par le nom de votre projet.

Respectez la convention d'affectation de noms Pascal selon laquelle la premire lettre du nom du projet doit tre une majuscule car le nom du projet sera galement utilis comme nom de l'espace de noms de l'assembly gnr partir du projet.

6. Cliquez sur OK.



http://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms227611(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms227574(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/wkze6zky(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms225607(VS.80).aspx

1.2.2.2.2 Application des paramtres de projet Visual Basic standard (facultatif)

Contexte

Pour configurer un projet Visual Basic de manire pouvoir l'utiliser avec les tutoriels fournis dans cette documentation, vous devez apporter une modification mineure ses paramtres.

Procdure

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nom du projet en gras affich sous le nom de la solution, puis slectionnez Proprits.

2. Dans la vue Proprits, cliquez sur l'onglet Compiler.3. Dans la liste Option Strict, cliquez sur On.4. Fermez la vue Proprits.5. Dans le menu Fichier, cliquez sur Enregistrer tout.

RemarqueIl est recommand d'activer OptionStrict ds le dbut de la cration d'un projet Visual Basic. Ainsi, vous serez tenu de respecter les conventions d'criture du code, savoir l'emploi de dclarations de variables fortement types et la dfinition d'un cast valide, deux conventions qui sont vrifies au moment de la compilation du code. Cette prcaution aide rduire les exceptions gnres l'excution du code.

1.2.2.2.3 Prparation du Windows Form dans Visual

1.2.2.2.3.1 Pour crer le Windows Form

Contexte

Dans les applications Visual Basic 6 pour Windows, un formulaire par dfaut est gnralement toujours dfini par le nom Form1. Sur ce modle, vous crez un projet Windows en lui attribuant le mme nom de formulaire par dfaut, Form1, et l'extension .cs ou .vb selon le langage utilis.

Procdure

1. Si le formulaire Form1 n'est pas affich dans la fentre principale, cliquez deux fois sur Form1 dans l'Explorateur de solutions.


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 crite en langage Visual Basic ou C#.

En langage C#, la classe Form1 affiche les lments suivants :

La signature de classe. Un constructeur (Form1).

En langage Visual Basic, la classe Form1 affiche les lments suivants :

La signature de classe (classe Form1).

RemarqueDes mthodes et variables supplmentaires de la classe Form1 sont contenues dans une classe "partielle" spare. (Ceci vaut pour C# et Visual Basic.) Les classes partielles sont expliques ultrieurement dans Configuration d'un projet Windows.

1.2.2.2.3.2 Pour ajouter une mthode d'assistance prive pour le code de configuration de SAP Crystal Reports

Procdure

1. Ajoutez cette classe Form1 une nouvelle mthode d'assistance prive nomme ConfigureCrystalReports(), sans valeur renvoye.

Private Sub ConfigureCrystalReports()

End Sub

private void ConfigureCrystalReports(){}

Ajoutez ensuite un gestionnaire d'vnements Form_Load, puis insrez un appel de la mthode ConfigureCrystalReports() dans le gestionnaire d'vnements Form_Load. La mthode ConfigureCrystalReports() s'excutera 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 deux fois sur Form1, un gestionnaire d'vnements Form1_Load est automatiquement gnr dans la classe Form1.

4. Dans le gestionnaire d'vnements Form1_Load, saisissez un appel la mthode ConfigureCrystalReports().

ConfigureCrystalReports()



ConfigureCrystalReports();

5. Dans le menu Fichier, cliquez sur Enregistrer tout.

1.2.2.2.4 Ajout d'un contrle CrystalReportViewer

1.2.2.2.4.1 Pour ajouter un contrle CrystalReportViewer une application Windows

Procdure

1. Ouvrez un Windows Form dans l'onglet Conception.2. Dans la Bote outils, ouvrez le nud Reporting afin de localiser le contrle CrystalReportViewer.

RemarqueDans les versions prcdentes de Visual Studio, le contrle CrystalReportViewer apparaissait dans le nud Crystal Reports.

3. Faites glisser le contrle CrystalReportViewer sur le formulaire.4. Dans le menu Fichier, cliquez sur Enregistrer tout.

Rsultats

Si vous ajoutez un contrle CrystalReportViewer votre application, les rfrences aux assemblies SAP Crystal Reports seront automatiquement ajoutes votre rapport.

1.2.2.2.4.2 Pour ajouter des instructions Imports et Using aux espaces de noms de rfrence

Procdure

1. Si le dossier Rfrences n'est pas affich 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, dveloppez le dossier Rfrences.3. Vrifiez que les assemblies SAP Crystal Reports suivantes ont t ajoutes :

CrystalDecisions.CrystalReports.Engine CrystalDecisions.Shared


4. Slectionnez Form1, puis dans le menu Affichage, cliquez sur Code.5. Au-dessus de la signature de classe, ajoutez une dclaration "Imports" [Visual Basic] ou "using" [C#] au

dbut de la classe contenant les espaces de noms SAP Crystal Reports suivants.

Imports CrystalDecisions.CrystalReports.EngineImports CrystalDecisions.Shared

using CrystalDecisions.CrystalReports.Engine;using CrystalDecisions.Shared;

1.3 Principes fondamentaux du SDK

1.3.1 Architecture

1.3.1.1 Choisir le modle d'objet correct pour votre projet

Pour choisir le modle d'objet appropri votre projet, vous devez comprendre les conventions relatives l'utilisation du contrle CrystalReportViewer, ainsi que la manire dont ce contrle interagit avec les autres modles d'objet.

RemarqueDans cette documentation, un modle d'objet fait rfrence une classe principale et aux classes qui lui sont associes, le tout formant un modle de programmation. Dans SAP Crystal Reports, ces modles d'objet sont axs sur une classe principale qui encapsule un fichier de dfinition de rapport. Cette classe principale et le modle d'objet associ permettent d'interagir avec le rapport en le programmant.

Conventions relatives l'utilisation du contrle CrystalReportViewer

Une application Web efficace tablit une sparation nette entre sa couche prsentation et sa couche logique mtier sous-jacente.

La structure du contrle ASP.NET va naturellement dans le sens de ce modle de conception. Il encapsule les informations de prsentation dans le contrle, puis lie ce contrle un objet ou un modle d'objet sous-jacent qui cre la logique mtier.

CrystalReportViewer est un contrle .NET conforme cette architecture. Il fonctionne comme un objet d'affichage dans le Web Form ou le Windows Form (couche prsentation) et peut tre li n'importe lequel des modles d'objet suivants :

Modle d'objet ReportDocument Modle d'objet ReportClientDocument (Report Application Server)



Modle d'objet InfoObject (fourni avec SAP Crystal Reports Server ou la plateforme SAP BusinessObjects Business Intelligence)

Dans un scnario qui respecte les conventions, le contrle CrystalReportViewer se lie l'un des modles d'objet qui crent la logique mtier, gnralement pour la manipulation des rapports.

Dans ce scnario, l'interaction par programmation du contrle CrystalReportViewer se limite modifier les paramtres d'affichage (masquer ou afficher la barre d'outils du visualiseur ou l'un des boutons qui la composent par exemple).

Modle d'objet CrystalReportViewer

Le contrle CrystalReportViewer contient des proprits et des mthodes qui permettent d'interagir sur la manire dont ce dernier affiche les rapports. Il comporte galement un petit nombre de proprits et de mthodes qui permettent d'interagir avec les rapports auxquels il est li. Ces proprits et mthodes constituent un modle d'objet limit.

Certains scnarios de liaison de rapports font appel au modle d'objet CrystalReportViewer. Dans ces scnarios, le contrle CrystalReportViewer est directement li un rapport (en indiquant le chemin d'accs au rapport dans un rpertoire de fichiers par exemple) sans avoir pralablement encapsul ce rapport dans un modle d'objet. Dans ce cas, tant donn que le contrle CrystalReportViewer encapsule directement le rapport, vous devez utiliser son modle d'objet limit pour interagir avec le rapport.

Toutefois, dans la plupart des scnarios de liaison de rapports, l'utilisation de CrystalReportViewer en tant que modle d'objet est dconseille. Il est prfrable de faire appel au modle d'objet ReportDocument pour les raisons suivantes :

Le modle d'objet CrystalReportViewer peut engendrer des conflits entre modles d'objet. Ne mlangez pas le modle d'objet CrystalReportViewer avec d'autres modles d'objet.

Le modle d'objet CrystalReportViewer ne permet qu'une interaction limite avec les rapports. Il ne contient que quelques-uns unes des fonctionnalits disponibles dans le modle d'objet ReportDocument.

Dans le modle d'objet CrystalReportViewer, la sparation entre la couche prsentation et la logique mtier sous-jacente n'est pas clairement tablie.

Modle d'objet ReportDocument

ReportDocument est un modle d'objet plus puissant et plus complet que CrystalReportViewer. Il fait partie du SDK de Crystal Reports .NET et permet une manipulation tendue du code des rapports.

Quel modle d'objet utiliser ?

Si vous n'envisagez pas de mise niveau vers SAP Crystal Reports Server ou vers la plateforme SAP BusinessObjects Business Intelligence, il est recommand d'utiliser le modle d'objet ReportDocument pour vos tches de dveloppement avec le SDK de SAP Crystal Reports.


RemarqueDans SAP Crystal Reports 10 ou versions ultrieures et dans SAP Crystal Reports pour Visual Studio 2005 et versions ultrieures, le modle d'objet ReportDocument a t associ au modle d'objet ReportClientDocument pour faciliter la mise niveau vers une solution de reporting gre.

1.3.1.2 Eviter de mlanger les modles d'objet

Ne mlangez pas le modle d'objet CrystalReportViewer avec d'autres modles d'objet.

Utilis en tant que modle d'objet limit, CrystalReportViewer fonctionne correctement, condition qu'il soit directement li au rapport par le biais du chemin d'accs ce dernier.

En revanche, si vous encapsulez le rapport dans un autre modle d'objet (tel que ReportDocument ou ReportClientDocument), puis si vous liez le contrle ce modle d'objet, n'utilisez plus le modle d'objet CrystalReportViewer. Le modle d'objet fourni par le contrle CrystalReportViewer devient alors redondant par rapport au modle d'objet plus puissant auquel il est li. Par ailleurs, les paramtres appliqus au modle d'objet CrystalReportViewer sont visibles par l'autre modle d'objet, ce qui peut engendrer des comportements inattendus et des exceptions.

Supposons que vous utilisiez le modle d'objet ReportDocument pour exporter ou imprimer un rapport mensuel partir du serveur. Si vous avez dfini un paramtre de mois dans ce rapport l'aide du modle d'objet CrystalReportViewer, il se peut que vous rencontriez des problmes. Le modle d'objet ReportDocument ne peut pas voir les paramtres appliqus dans le modle d'objet CrystalReportViewer. Il tente d'exporter ou d'imprimer le rapport sans avoir connaissance du paramtre de mois dfini, et affiche ensuite le mauvais mois ou gnre une exception.

La meilleure solution consiste donc limiter l'utilisation du contrle CrystalReportViewer aux paramtres d'affichage du rapport uniquement lorsque ce contrle a t li l'un des modles d'objet sous-jacents.

1.3.1.3 SAP Crystal Reports Designer incorpor

Le SAP Crystal Reports Designer incorpor permet de crer ou de modifier des rapports. Il se compose d'une interface utilisateur graphique pour la conception de rapports en WYSIWYG et d'une srie d'experts conus pour simplifier la connectivit entre les donnes, leur tri, leur regroupement et d'autres oprations complexes de conception de rapports. SAP Crystal Reports Developer contient une version amliore du concepteur incorpor qui permet de crer des rapports et des applications de reporting performants. Le concepteur incorpor inclus dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio contient plusieurs fonctionnalits prsentes dans SAP Crystal Reports Designer.

Rle du SAP Crystal Reports Designer incorpor dans l'architecture

Le SAP Crystal Reports Designer incorpor est inclus dans la description de l'architecture, car il joue un rle primordial dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio : il permet en effet de



crer les fichiers de rapport afficher. Toutefois, le SAP Crystal Reports Designer incorpor n'intervient qu'au moment de la conception. L'interaction avec les rapports et leur affichage, qui interviennent au moment de l'excution, sont assurs par le SDK de SAP Crystal Reports. Par consquent, si le concepteur incorpor permet de crer des rapports qui sont utiliss dans l'architecture, il ne fait pas partie de l'architecture elle-mme.


Utilisation du SAP Crystal Reports Designer incorpor [page 647]

1.3.1.4 Contrles du visualiseur de rapports

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio inclut des contrles de format standard pour l'affichage des rapports. Chaque contrle encapsule des informations complexes lies la prsentation des rapports dans un objet GUI, dans la bote outils.

Deux contrles sont fournis :

Le contrle CrystalReportViewer. Ce contrle affiche le rapport en utilisant une prsentation de type page, avec la possibilit de naviguer entres les pages.

Le contrle CrystalReportPartsViewer.

Ce contrle affiche les informations de rsum sur le rapport dans une petite fentre de type portail, avec la possibilit d'explorer le rapport en profondeur par le biais d'une srie de parties lies.

Pour afficher un rapport, il suffit de faire glisser le contrle de la bote outils vers le Web Form ou le Windows Form, puis d'affecter la proprit ReportSource de ce contrle un rapport.


Comment utiliser les contrles visualiseur de rapports ? [page 43]

1.3.1.5 Modles d'objet

SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio, inclut un SDK qui contient deux modles d'objets. Avec un supplment de licence, le SDK peut tre tendu quatre modles d'objet.

Les contrles du visualiseur de rapports fournissent le point d'entre dans le SDK. Cela est d au fait que le visualiseur de rapports affiche les rapports en les liant un objet de rapport. Tous les modles d'objet contenus dans le SDK exposent et manipulent des objets de rapport.

Chaque modle d'objet offre un degr de puissance et de complexit croissant :

Le modle d'objet le plus simple est CrystalReportViewer.


Le contrle CrystalReportViewer d'un Web Form ou d'un Windows Form possde par dfinition une classe sous-jacente du mme nom. Cette classe CrystalReportViewer expose les proprits et les mthodes qui permettent de modifier la fonctionnalit d'affichage du contrle et d'interagir avec les classes qui grent les connexions la base de donnes, les paramtres et les formules de slection. Cet ensemble de classes constitue le modle d'objet le plus simple. La classe CrystalReportViewer se prsente sous deux formes diffrentes : l'une dans un espace de noms Windows et l'autre dans un espace de noms Web. De nombreux lments de ce modle d'objet se retrouvent par consquent en double dans les deux espaces de noms, avec certaines diffrences propres aux plates-formes Windows et Web.Les classes de ce modle d'objet sont contenues dans l'espace de noms CrystalDecisions.Web pour la version Web Form de ce contrle, et dans l'espace de noms CrystalDecisions.Windows pour la version Windows Form du contrle.

ReportDocument est un modle 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 fonctionnalits plus puissantes de personnalisation et d'interaction avec le rapport.Les classes de ce modle d'objet sont contenues dans l'espace de noms CrystalDecisions.CrystalReports.Engine.

Les modles d'objet suivants sont disponibles par le biais d'une mise niveau :

ReportClientDocument, modle d'objet offrant des fonctionnalits de modification de rapport plus avances.Cette classe sert de passerelle vers un modle d'objet plus volumineux constitu de nombreuses classes contenues dans plusieurs espaces de noms. Elle expose la structure du rapport dans son intgralit via le SDK, ce qui permet de crer ou de modifier par programmation chaque aspect du rapport au moment de l'excution.Les classes de ce modle d'objet sont contenues dans le groupe d'espaces de noms CrystalDecisions.ReportAppServer.Le modle d'objet ReportClientDocument est fourni avec un RAS (Report Application Server) qui ncessite l'acquisition d'une licence supplmentaire. Un Report Application Server est fourni avec SAP Crystal Reports Server et la plateforme SAP BusinessObjects Business Intelligence.

InfoObject, un modle 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 galement disponible. Ce modle est fourni avec la licence SAP Crystal Reports Server ou de plateforme SAP BusinessObjects Business Intelligence.Cette classe sert de passerelle vers le modle d'objet de plateforme complet de SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence.Les classes de ce modle d'objet sont contenues dans le groupe d'espaces de noms CrystalDecisions.Enterprise.

RemarqueLe modle d'objet InfoObject est fourni uniquement avec SAP Crystal Reports Server et la plateforme SAP BusinessObjects Business Intelligence, qui ncessitent l'acquisition d'une licence supplmentaire.


Choisir le modle d'objet correct pour votre projet [page 32]



Comparaison des solutions de reporting de SAP BusinessObjects Business Intelligence [page 66]

1.3.1.5.1 Modle d'objet CrystalReportViewer

La classe CrystalReportViewer a deux rles :

Dans un Web Form ou un Windows Form, la classe CrystalReportViewer est expose comme un contrle .NET et peut tre ajoute au formulaire pour afficher un rapport. Pour avoir des informations spcifiques sur le rle de cette classe en tant que contrle .NET, voir Contrles du visualiseur de rapports [page 35].

Dans le code sous-jacent du Web Form ou du Windows Form, la classe CrystalReportViewer fournit le modle d'objet le plus simple du SDK. Ce modle d'objet sera examin plus loin dans cette section.

La manire la plus simple d'insrer un rapport dans un Web Form ou Windows Form consiste ajouter le contrle CrystalReportViewer au formulaire, puis, dans la classe code-behind, affecter la proprit ReportSource de la classe CrystalReportViewer le chemin d'accs au rapport sous forme de chane.

En affectant le chemin du rapport directement au contrle (plutt que de placer le rapport dans un modle d'objet plus complexe tel que ReportDocument ou ReportClientDocument), vous limitez l'interface au modle d'objet le plus simple : CrystalReportViewer.

Comparaison de modles d'objet CrystalReportViewer

CrystalReportViewer possde deux diagrammes de modle d'objet, car le mme nom de classe et de contrle (et par consquent son modle d'objet sous-jacent) est utilis pour les applications Windows et Web. Ainsi, le modle d'objet CrystalReportViewer se rpte-t-il ( quelques diffrences prs) dans deux espaces de noms diffrents.

La version Windows du modle d'objet CrystalReportViewer comporte les principales classes et les principaux vnements partags par les versions Windows et Web du modle d'objet.

La version Web du modle d'objet CrystalReportViewer contient les mmes classes et vnements que la version Windows, auxquels s'ajoutent les vnements suivants relatifs au mode de chargement des pages ASPX.


Contrles du visualiseur de rapports [page 35]Liaison de rapports l'aide du modle d'objet CrystalReportViewer [page 172]

1.3.1.5.2 Modle d'objet ReportDocument

La classe ReportDocument fournit un modle d'objet plus complet pour le SDK que le modle d'objet CrystalReportViewer.


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.

Modle d'objet ReportDocument

Dans la section prcdente, vous avez appris utiliser le modle d'objet de base CrystalReportViewer en affectant directement au contrle CrystalReportViewer le chemin d'accs un rapport.

Au niveau suivant, vous allez utiliser le modle d'objet ReportDocument pour encapsuler le rapport dans une instance de ReportDocument avant de l'affecter au contrle. Vous accdez ainsi au modle d'objet plus complexe et puissant fourni par ReportDocument.

RemarqueEtant donn que les modles d'objet CrystalReportViewer et ReportDocument sont tous deux impliqus dans ce processus (le premier pour charger et afficher le rapport, le second pour encapsuler et manipuler le rapport), il est frquent de confondre leur rle respectif. Une fois le rapport encapsul l'aide du modle d'objet ReportDocument, toutes les manipulations portant sur le rapport doivent tre limites ce modle. Si vous essayez d'utiliser les proprits et les mthodes de CrystalReportViewer pour manipuler le rapport, les deux modles d'objet entrent en conflit et se comportent de manire imprvisible.

Une fois que vous avez ajout un modle d'objet, limitez l'utilisation du code de CrystalReportViewer la dfinition des proprits d'affichage.

ReportDocument et ReportClientDocument (RAS)

Dans SAP Crystal Reports 9, ces deux modles taient compltement spars. Dans SAP Crystal Reports 10 et versions ultrieures, cette sparation essentielle entre les deux modles d'objet a t supprime. Le modle d'objet ReportDocument fonctionne dsormais comme un proxy vers un sous-ensemble de fonctionnalits partir du modle d'objet ReportClientDocument.

SAP Crystal Reports 2008 permet d'accder une version limite du modle d'objet ReportClientDocument via la proprit ReportDocument.ReportClientDocument.


Tutoriels du modle d'objet ReportDocument [page 340]Cette section prsente divers tutoriels bass sur le modle d'objet ReportDocument.

Liaison de rapports l'aide du modle d'objet ReportDocument [page 200]Modle d'objet CrystalReportViewer [page 37]Choisir le modle d'objet correct pour votre projet [page 32]



1.3.1.5.3 Modle d'objet ReportClientDocument (RAS)

ReportClientDocument est le modle d'objet le plus puissant et le plus complet pour manipuler les rapports. Ce modle d'objet n'est fourni qu'avec un RAS (Report Application Server), disponible sous la forme d'un RAS BusinessObjects Enterprise gr ou non gr.

Le modle d'objet ReportClientDocument est constitu de nombreuses classes contenues dans divers espaces de noms. Chaque espace de noms a pour prfixe CrystalDecisions.ReportAppServer. Ce modle d'objet expose la structure du rapport dans son intgralit dans le SDK. Ainsi, vous pouvez crer et modifier par programmation chaque aspect du rapport au moment de l'excution, ainsi qu'en enregistrer les modifications.

Une instance de ReportClientDocument comprend un rapport qui peut tre modifi par programmation en fonction de ses proprits de classe. Ces proprits sont lies une srie d'autres bibliothques dans le SDK qui contiennent des contrleurs, des modles de dfinition de donnes et des modles de dfinition de rapport :

ReportDefinition correspond la prsentation du rapport, tel qu'indiqu dans le SAP Crystal Reports Designer.

DataDefinition correspond l'Explorateur de champs dans le SAP Crystal Reports Designer. RowsetController correspond aux valeurs de donnes traites de chaque ligne de dtails, lors de la

visualisation du rapport au moment de l'excution.

Les instances de ReportClientDocument peuvent tre des instanciations :

d'un fichier .rpt existant charg partir d'un rpertoire, puis modifi avec les classes de dfinition de rapport et de dfinition de donnes du SDK ReportClientDocument ;

d'un nouveau rapport entirement vide cr avec les classes de dfinition de rapport et de dfinition de donnes du SDK ReportClientDocument.

Cette instance de classe ReportClientDocument peut tre charge uniquement durant le temps ncessaire pour transmettre l'instance au visualiseur pour affichage, avant qu'elle ne soit mise hors de porte. Toutefois, vous pouvez galement modifier l'instance de classe, puis l'enregistrer en tant que rapport (.rpt) dans un rpertoire avec l'une des classes du contrleur.

Pour obtenir des informations dtailles sur le modle 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 gr et les assemblys RAS .NET, il tait ncessaire de programmer le modle d'objet ReportClientDocument. Les dveloppeurs pouvaient ainsi crer des projets .NET qui exploitaient le modle d'objet ReportClientDocument.

Toutefois, cela impliquait galement que les projets initialement crs avec le modle d'objet ReportDocument fourni avec SAP Crystal Reports devaient tre intgralement reprogramms pour tre utiliss avec le modle d'objet ReportClientDocument inclus dans le RAS. Cela tenait au fait que les deux modles d'objet taient compltement spars.


ReportClientDocument dans SAP Crystal Reports 10 et versions ultrieures

Dans SAP Crystal Reports 10, cette sparation essentielle entre les deux modles d'objet a t supprime. Pour ce faire, le modle d'objet ReportDocument a t rcrit de faon ce qu'il fonctionne comme un proxy vers un sous-ensemble de fonctionnalits partir du modle d'objet ReportClientDocument. Les classes du modle d'objet ReportDocument exposent les mmes signatures de proprit et de mthode qu'avant, mais la fonctionnalit sous-jacente a t modifie de manire rediriger chaque proprit et chaque mthode vers les proprits et les mthodes du modle d'objet ReportClientDocument plus puissant.

Cela ne signifie pas pour autant qu'une version de base de SAP Crystal Reports Developer offre un accs intgral un serveur RAS non gr ou au modle d'objet ReportClientDocument. La version de base de SAP Crystal Reports permet toujours de n'accder qu'au modle d'objet ReportDocument (mme si le modle d'objet ReportDocument fonctionne comme un proxy vers un sous-ensemble du modle d'objet ReportClientDocument). Le moteur de cration de rapports d'origine fourni dans les prcdentes versions de SAP Crystal Reports a t remplac par une version limite et incorpore du moteur de cration de rapports RAS.

Vous ne pouvez installer le modle d'objet ReportClientDocument et y accder directement qu'en acqurant une licence mise niveau du serveur RAS non gr. A ce stade, tout le code correspondant au modle d'objet ReportDocument peut tre facilement redirig vers le serveur RAS distinct en dfinissant deux proprits de n'importe quelle instance de rapport donne, et le modle d'objet ReportClientDocument sous-jacent est dsormais accessible directement, lorsque vous l'extrayez de la proprit de la classe ReportDocument.

1.3.1.5.4 Modle d'objet InfoObject (BOE)

Le modle d'objet InfoObject est fourni avec les mises niveau de SAP Crystal Reports Server et de la plateforme SAP BusinessObjects Business Intelligence.

RemarquePour en savoir plus, voir Solutions de reporting de SAP BusinessObjects Business Intelligence [page 65].

InfoObject offre un modle d'objet de niveau plateforme pour le SDK. InfoObject fonctionne comme une classe de base dans laquelle de nombreux objets Enterprise sont encapsuls dans des classes drives. La classe drive qui reprsente 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 utilise dans le SDK pour reprsenter un large ventail d'entits d'informations. Cela inclut la fois des entits physiques, telles que des fichiers de rapport ou des fichiers PDF, et des entits du rseau, telles que les utilisateurs, les serveurs ou les connexions FTP.



La classe InfoObject est une classe de base pour de nombreuses classes tendues correspondant ces entits d'informations de faon plus dtaille. Les classes tendues qui hritent d'InfoObject sont les suivantes : Report, User, Server, Folder, Program, Ftp, Smtp, Word, Excel et Pdf.

La manipulation des instances de classes tendues et de classes InfoObject vous permet de crer 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 contrleur, ou passerelle, vers le rfrentiel CMS (Central Management Server) (qui est une base de donnes), o sont stockes toutes les instances d'InfoObject. La classe InfoStore est utilise pour instancier, extraire et valider toutes les instances de classe InfoObject stockes dans le rfrentiel CMS.

La classe indexe InfoObjects

La classe indexe InfoObjects contient plusieurs instances d'InfoObject. Elle est utilise par InfoStore pour dplacer les instances InfoObject vers et depuis le rfrentiel CMS.

La classe Infostore ne peut pas grer directement les instances InfoObject. Elles doivent tre d'abord encapsules dans la classe indexe InfoObjects. Par le biais de cette classe indexe, chaque instance d'InfoObject peut tre ajoute, extraite, mise jour ou planifie.

RemarquePour en savoir plus sur le SDK de SAP Crystal Reports Server ou de la plateforme SAP BusinessObjects Business Intelligence, consultez la documentation correspondante.


Choisir le modle 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 dveloppeur pour Microsoft Visual Studio SAP Crystal Reports Developer Report Application Server non gr (RAS) SAP Crystal Reports Server ou plateforme SAP BusinessObjects Business Intelligence

Une diffrence d'architecture fondamentale entre chaque solution de reporting repose sur la faon dont le moteur de rapport est plac et implment.


Dfinition du moteur de rapport

Le moteur de rapport est une composante essentielle de chaque solution de reporting. Il traite toutes les demandes utilisateur et gnre en sortie les informations concernant les rapports.

La capacit maximale de traitement simultan des demandes utilisateur varie d'une solution l'autre. Dans certaines solutions, elle est conditionne par la conception de l'architecture ou par les licences.

Les autres pices matresses de chaque solution de reporting sont les suivantes :

le fichier de dfinition de rapport (.rpt) ; la source de donnes ; 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 pices matresses

Le moteur de rapport utilise le fichier de dfinition de rapport (.rpt) comme modle. Il extrait ensuite les donnes de la source de donnes et utilise la dfinition de rapport pour fournir le rendu du rapport demand, puis le transmet au visualiseur de rapports. Les informations reues du visualiseur ou codes l'aide du SDK d'interface dclenchent des traitements supplmentaires de la part du moteur de rapport qui excute d'autres oprations sur le rapport.

Diffrences de configuration du moteur de rapport entre les solutions de reporting SAP Business Intelligence

Le moteur de rapport est incorpor.Dans SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio, le moteur de rapport est incorpor dans l'application.La capacit maximale de traitement simultan de ce moteur de rapport incorpor est limite trois demandes utilisateur. Cela n'est pas d une limite de licence arbitraire, mais une restriction lie l'architecture du moteur de rapport incorpor.

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 gr, le moteur de rapport est extrait dans un processus serveur distinct. Ce processus serveur peut s'excuter sur le mme ordinateur ou tre plac sur un ordinateur distinct de manire augmenter les performances en dchargeant le traitement de votre serveur d'applications. Le serveur RAS non gr n'est plus disponible en tant qu'option de mise niveau. Il est recommand d'effectuer la place une mise 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 dans une architecture de plateforme complte.Dans la solution SAP Crystal Reports Server ou de plateforme SAP BusinessObjects Business Intelligence, une architecture de plateforme complte, qui encapsule le processus serveur de rapports distinct (RAS), a t ajoute. Le Report Application Server (RAS) gr devient alors un simple serveur, parmi les nombreux



autres serveurs qui constituent l'architecture de plateforme. Ce type d'architecture offre une large palette de fonctionnalits supplmentaires, telles que la planification, l'quilibrage des charges, le basculement et une volutivit la fois verticale et horizontale.

1.3.2 Contrle CrystalReportViewer

Pour afficher un rapport Crystal, vous devez ajouter un contrle CrystalReportViewer votre application. Le contrle CrystalReportViewer permet de lier et d'afficher des rapports dans le .NET Framework. Le contrle CrystalReportViewer par dfaut inclut des lments d'interface utilisateur pour vous aider afficher, enregistrer et parcourir un rapport.

Les deux contrle CrystalReportViewer les plus frquemment utiliss sont le contrle CrystalReportViewer pour les applications Windows, auquel on accde via la classe CrystalDecisions.Windows.Forms.CrystalReportViewer, et le contrle CrystalReportViewer pour les sites Web, auquel on accde via la classe CrystalDecisions.Web.CrystalReportViewer. Pour en savoir plus, voir la Rfrence de l'API .NET SAP Crystal Reports.

RemarqueUn contrle CrystalReportViewer n'est ncessaire que si vous avez l'intention d'afficher des rapports Crystal.

Personnalisation du contrle CrystalReportViewer

En fonction de votre application, vous pouvez modifier certains lments du contrle par dfaut. SAP Crystal Reports vous permet de personnaliser l'aspect et la convivialit du visualiseur dans votre application de diffrentes manires, notamment :

La barre d'outils CrystalReportViewer peut tre supprime du visualiseur. Les boutons de la barre d'outils CrystalReportViewer peuvent tre ajouts ou supprims par programmation. Le contrle CrystalReportViewer prend en charge la personnalisation via la CSS ou Thmes.


Personnalisation du contrle CrystalReportViewer [page 225]Visualisation d'un rapport [page 165]

1.3.2.1 Comment utiliser les contrles visualiseur de rapports ?

Les contrles visualiseur de rapports sont des contrles .NET qui peuvent tre ajouts un formulaire dans une application Web ou Windows pour afficher des rapports dans ce formulaire.


Lorsque vous envisagez de gnrer une application l'aide du SDK de SAP Crystal Reports, l'un des points les plus importants dterminer concerne l'utilisation des contrles visualiseur de rapports. Connatre les principes fondamentaux du SDK qui influencent ces contrles vous aidera choisir la structure la mieux adapte votre projet SAP Crystal Reports, version dveloppeur pour Microsoft Visual Studio.

Dfinition des contrles .NET

Les contrles Microsoft .NET forment une classe particulire de contrles qui s'affichent dans la bote outils Visual Studio. Ils sont ajouts un Web Form ou un Windows Form en tant qu'objets GUI et hritent des caractristiques d'une classe de contrles de base commune. Les contrles .NET classiques sont notamment Button, DropDownList, CheckBox, TextBox ou DataGrid.

Les contrles Microsoft .NET respectent la convention selon laquelle la couche prsentation doit tre spare de la couche logique mtier. Les informations d'affichage sont encapsules dans le contrle lui-mme dans le Web Form ou le Windows Form. Dans la classe code-behind, le contrle .NET est instanci en tant qu'instance de niveau classe. Cette variable d'instance permet d'accder aux proprits, mthodes et vnements du contrle.

Les contrles Microsoft .NET sont identiques d'un point de vue fonctionnel pour les Windows Forms comme pour les Web Forms. Le .NET Framework permet de visua

Documents

SAP Crystal Report pour le Guide du développeur de SAP SDK