Leçon 6 : Ajout d'un paramètre à passer à un rapport d'extraction

Mis à jour : 12 décembre 2006

Les rapports d'extraction constituent un type de rapport auquel vous accédez en cliquant sur un lien du rapport en cours. Quand vous cliquez sur une zone de texte avec une action d'extraction, vous ouvrez le rapport d'extraction. Si ce rapport possède des paramètres, vous devez passer les valeurs de paramètre à chaque paramètre de rapport.

Dans cette leçon, vous allez importer l'exemple de rapport AdventureWorks Sales Order Detail dans votre projet de serveur de rapports et créer une action d'extraction dans la zone de texte du rapport Sales Order qui contient le numéro des commandes. Vous définirez le paramètre de rapport d'extraction en tant que numéro de commande, comme prévu par le rapport d'extraction. Vous créerez aussi un paramètre interne qui définit la couleur de lien à utiliser pour le texte du lien hypertexte dans la zone de texte.

Pour importer un rapport existant dans votre projet de serveur de rapports

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier Rapports. Cliquez sur Ajouter, puis sur Élément existant. La boîte de dialogue Ajouter un élément existant s'ouvre.

2. Recherchez le dossier dans lequel les exemples de rapports AdventureWorks ont été installés. Le répertoire par défaut est <installdir>:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Report Samples\AdventureWorks Sample Reports. Sélectionnez Sales Order Details.rdl. Le rapport s'ajoute à votre projet de rapport.

   Vous devez maintenant lier les sources de données des datasets à votre base de données AdventureWorks.

3. Dans l'Explorateur de solutions, double-cliquez sur Sales Order Details.rdl.

4. Cliquez sur l'onglet Données. L'erreur « Impossible d'établir une connexion à la base de données. » s'affiche.

   Vous devez modifier la source de données des deux datasets de ce rapport pour pointer vers la source de données AdventureWorks de votre système.

5. Dans la liste déroulante Dataset, sélectionnez SalesOrder.

6. Cliquez sur le bouton Modifier le dataset (...). La boîte de dialogue Dataset s'affiche.

7. À côté de la liste déroulante des sources de données, cliquez sur le bouton Modifier la source de données (…). La boîte de dialogue Source de données s'affiche.

8. Vérifiez que Type a bien la valeur Microsoft SQL Server.

9. À côté du volet Chaîne de connexion, cliquez sur Modifier. La boîte de dialogue Propriétés de connexion s'ouvre.

10. Entrez le nom du serveur et l'authentification de votre système. Les systèmes autonomes utilisent généralement le nom de serveur « localhost » et l'authentification Windows.

11. Dans la section Se connecter à une base de données, tapez AdventureWorks.

12. Cliquez sur Tester la connexion. Si la connexion n'aboutit pas, contactez votre administrateur de base de données.

13. Cliquez sur OK.

14. Répétez les étapes 5 à 13 pour le dataset SalesOrderDetail.

Ajouter une action d'extraction de rapport à votre rapport

1. Dans l'Explorateur de solutions, double-cliquez sur Sales Order.rdl.

2. Cliquez sur l'onglet Mise en page pour passer en mode Mise en page.

3. Dans la colonne Sales Order, cliquez dans la zone de texte de la ligne de détail. La valeur dans la zone de texte doit être =Fields!SalesOrderNumber.Value.

4. Cliquez avec le bouton droit sur la zone de texte, puis sélectionnez Propriétés. La boîte de dialogue Propriétés de la zone de texte s'ouvre.

5. Cliquez sur l'onglet Navigation.

6. Dans la section Lien hypertexte, sélectionnez Aller au rapport.

7. Dans la liste déroulante de la zone de texte, sélectionnez Sales Order Detail.

8. Cliquez sur le bouton Paramètres. La boîte de dialogue Paramètres s'affiche.

9. Dans la liste déroulante Nom du paramètre qui affiche la liste des paramètres définis pour le rapport d'extraction, choisissez SalesOrderNumber.

10. Cliquez dans la zone de texte Valeur du paramètre. Dans la liste déroulante, sélectionnez =Fields!SalesOrderNumber.Value.

11. Cliquez sur OK.

    Ensuite, modifiez la couleur et le style de texte du lien d'extraction.

12. Cliquez sur l'onglet Police.

13. Dans la liste déroulante Ornement, choisissez Souligné.

14. Cliquez sur OK.

15. Dans la fenêtre Propriétés de cette zone de texte, cliquez dans la zone de texte de la propriété Couleur. Dans la liste déroulante, choisissez Expression. L'Éditeur d'expressions s'ouvre.

16. Remplacez le texte par défaut Black par l'expression suivante :

    =Parameters!MyFontColor.Value

    La zone de texte que vous venez d'ajouter possède un texte souligné et s'affiche dans la couleur définie par le paramètre MyFontColor. Ces indications visuelles aident les lecteurs du rapport à comprendre qu'il existe un lien actif vers un autre rapport.

    Avant d'afficher l'aperçu du rapport, vous devez, dans la prochaine étape, définir le paramètre MyFontColor.

Pour créer un paramètre de rapport interne à utiliser pour la couleur de police

1. En mode Mise en page, dans le menu Rapport, sélectionnez Paramètres du rapport. La boîte de dialogue Paramètres du rapport s'ouvre.

2. Cliquez sur Ajouter. Un paramètre est créé avec les valeurs par défaut des propriétés définies automatiquement.

3. Dans la section Propriétés, dans la propriété Nom, tapez MyFontColor.

4. Vérifiez que le Type de données est String.

5. Activez la case à cocher Masquée. La propriété Demander est désactivée.

6. Vérifiez que Valeurs disponibles est égal à Sans requête.

7. Dans Valeurs par défaut, sélectionnez Sans requête et tapez la valeur MediumBlue ou autre couleur de police valide.

   Remarque :
   Pour afficher les valeurs de couleur de police valides, cliquez sur le bouton Couleur de premier plan de la barre d'outils Format de rapport.

8. Affichez l'aperçu du rapport. Vérifiez que les numéros de commandes apparaissent soulignés et avec une couleur de police différente.

9. Cliquez sur un numéro de commande. Le rapport Sales Order Detail correspondant à ce numéro de commande s'ouvre.

Remarque :

Si vous avez apporté des modifications au rapport détaillé mais qu'une erreur continue de s'afficher lorsque vous cliquez sur le lien d'extraction dans le rapport principal, il est peut être nécessaire d'actualiser les données mises en cache pour le rapport. Le Concepteur de rapports met en cache les résultats de requête sur le client dans un fichier Rdl.data pour améliorer les performances. Pour actualiser le cache local, modifiez la requête dans le Concepteur de rapports en ajoutant un espace et cliquez sur Aperçu.

Étapes suivantes

Dans cette leçon, vous avez importé avec succès un rapport existant et relié ses sources de données. Vous avez ajouté dans le rapport principal un lien d'extraction paramétré vers le rapport importé et créé un paramètre interne pour définir la couleur du lien d'extraction. Ainsi s'achève le didacticiel Ajout de paramètres à un rapport tabulaire de base. Pour obtenir la liste des autres didacticiels qui utilisent ces paramètres, consultez Didacticiel : Fonctionnalités avancées utilisant les paramètres.

Voir aussi

Autres ressources

Utilisation de paramètres dans Reporting Services
Utilisation de paramètres pour établir des liaisons à d'autres rapports

Aide et Informations

Assistance sur SQL Server 2005