Création du rapport avec des paramètres

Créez tout d'abord un rapport à partir de l'exemple de base de données Microsoft Access livré avec Crystal Reports.

Remarque

Xtreme.mdb est l'exemple de base de données livré avec Crystal Reports. Pour localiser la base de données Xtreme.mdb correspondant à votre version de Crystal Reports sur votre disque dur, voir Emplacement de l'exemple de base de données Xtreme. Vous devez vous connecter à la base de données via son entrée DSN ODBC. Pour connaître le nom correspondant à votre version de Crystal Reports pour cette entrée, voir Entrée DSN ODBC pour l'exemple de base de données Xtreme.

Pour créer le rapport avec des paramètres

1. Si la boîte de dialogue Assistant d'enregistrement apparaît, vous devez enregistrer votre copie de Crystal Reports. Vous avez deux possibilités :

   • Cliquez sur Suivant pour procéder à l'enregistrement.
   • Cliquez sur Plus tard pour vous enregistrer plus tard.

Après avoir fait votre choix, passez à l'étape suivante.

2. Dans le panneau Créer un document de rapport Crystal de la boîte de dialogue Galerie de rapports Crystal, sélectionnez en utilisant l'Assistant de création de rapports.

3. Dans le panneau Choisir un expert, sélectionnez Standard, puis cliquez sur OK.

   La fenêtre Assistant de création de rapports standard s'affiche.

4. Dans le panneau Sources de données disponibles de la fenêtre Assistant de création de rapports standard, développez le dossier Créer une nouvelle connexion.

5. Dans le sous-dossier qui s'ouvre, développez le dossier ODBC (RDO).

6. Dans la boîte de dialogue ODBC (RDO), sélectionnez l'entrée DSN ODBC correspondant à votre version de Crystal Reports comme décrit dans la section Entrée DSN ODBC pour l'exemple de base de données Xtreme, puis cliquez sur Suivant.

7. Laissez les champs ID utilisateur et Mot de passe vides, puis cliquez sur Terminer.

Le dossier ODBC (RDO) se développe pour afficher l'exemple de base de données Xtreme.

8. Développez le nœud Tables et sélectionnez la table Clients.

9. Cliquez deux fois sur la table Clients pour l'ajouter au panneau Tables sélectionnées, puis cliquez sur Suivant.

10. Développez la table Clients, puis utilisez la combinaison de touches CTRL-clic pour sélectionner les champs Nom du client, Titre, Adresse 1, Nom du contact et Ville.

11. Cliquez sur le bouton > pour déplacer ces champs dans le panneau Champs à afficher, puis cliquez sur Suivant.

12. Dans le panneau Champs disponibles, sous Champs du rapport, sélectionnez Clients.Ville, cliquez sur le bouton > pour déplacer le champ dans le panneau Regrouper par, puis cliquez sur Terminer.

Le rapport CustomersByCity est créé et chargé dans la fenêtre principale de Visual Studio.

Vous êtes maintenant prêt à ajouter un paramètre appelé Ville et à le remplir avec des valeurs par défaut.

Pour ajouter un paramètre Ville

L'Explorateur de champs doit être visible, car il permet d'accéder à plusieurs fonctions du rapport, notamment aux paramètres.

1. Si l'Explorateur de champs n'est pas visible, cliquez sur Activer/Désactiver l'affichage du champ dans la barre d'outils Crystal Reports.

   Remarque
   Vous pouvez é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ètre et sélectionnez Nouveau.

3. Dans la boîte de dialogue Créer un champ de paramètre :

1.  Attribuez à Nom la valeur "Ville".
2.  Attribuez à Texte de l'invite la valeur "Sélectionnez une ou plusieurs villes".
3.  Attribuez à Type de valeur la valeur Chaîne.
4.  Sélectionnez Autoriser plusieurs valeurs.
5.  Sélectionnez Valeurs discrètes.
6.  Cliquez sur Valeurs par défaut....

4. Dans la boîte de dialogue Définir les valeurs par défaut :

1.  Attribuez à Parcourir la table la valeur "Clients".
2.  Attribuez à Parcourir le champ la valeur "Ville".
3.  Cliquez sur \>\> (flèche droite double) pour déplacer l'ensemble de la liste des villes dans la liste Valeurs par défaut.

5. Cliquez sur OK pour fermer la boîte de dialogue Définir les valeurs par défaut.

6. Cliquez sur OK pour fermer la boîte de dialogue Créer un champ de paramètre.

Pour connecter le paramètre Ville à la colonne Ville de la base de données

Vous devez maintenant utiliser l'Expert Sélection pour définir une formule permettant de connecter la colonne Ville de la base de données au champ de paramètre Ville que vous venez de créer.

1. Dans la barre d'outils Crystal Reports, cliquez sur Expert Sélection.

2. Dans la boîte de dialogue Choisir un champ, sous Champs du rapport, sélectionnez Clients.Ville, puis cliquez sur OK.

3. Dans la boîte de dialogue Expert Sélection, dans l'onglet Clients.Ville, choisissez est égal à dans la liste.

4. Dans la nouvelle liste qui s'affiche à droite, sélectionnez le premier élément de la liste, {?Ville}, puis cliquez sur OK.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\f0c12ze9.alert_note(fr-fr,VS.90).gif" alt="Note" class="note" />Remarque </th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Cette sélection, {?Ville}, correspond au paramètre Ville que vous avez créé précédemment.</p></td>
</tr>
</tbody>
</table>

5. Dans le menu Fichier, sélectionnez Enregistrer tout.

6. En bas de la fenêtre, cliquez sur Aperçu Rapport principal.

   Remarque
   Le bouton Aperçu est une fonctionnalité du Crystal Reports Designer incorporé fourni avec Crystal Reports pour Visual Studio 2005 ou version ultérieure.

7. Dans la boîte de dialogue Saisir des valeurs de paramètre, sélectionnez au moins une ville dans la liste Valeurs discrètes, cliquez sur Ajouter, puis sur OK.

Le rapport s'affiche en mode Aperçu, avec la valeur de paramètre de ville que vous avez sélectionnée.

8. En bas de la fenêtre, cliquez sur Rapport principal pour quitter le mode Aperçu.

9. Ouvrez le Web Form.

10. Dans le menu Affichage, cliquez sur Concepteur.

Le rapport s'affiche alors sous forme graphique dans le Web Form, en mode Aperçu au moment de la conception.

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

Pour vérifier le site Web créé par programmation allégée

Votre rapport est créé et constitue à présent le rapport désigné pour le contrôle CrystalReportSource. Vous êtes maintenant prêt à générer et exécuter votre projet.

1. Dans le menu Générer, sélectionnez Générer la solution.

2. Si vous rencontrez des erreurs lors de la génération, corrigez-les.

3. Dans le menu Déboguer, cliquez sur Démarrer.

Une page d'invite de saisie de paramètre s'affiche et vous demande de sélectionner une invite dans un contrôle DropDownList. Ce résultat est logique pour deux raisons :

  - Vous n'avez pas encore configuré la balise Parameters dans le rapport.
  - Dans le panneau des tâches guidées du contrôle CrystalReportViewer, la case à cocher Activer l'invite de saisie de paramètre est activée par défaut.

4. Sélectionnez un paramètre, puis cliquez sur Soumettre.

5. Le rapport CustomersByCity s'affiche dans le navigateur Web et indique la ville que vous avez sélectionnée.

6. Revenez dans Visual Studio, puis cliquez sur Arrêter pour quitter le mode débogage.