Didacticiel : ajout d'un paramètre à un rapport (Générateur de rapports version 3.0)

1. Cliquez sur Démarrer, pointez sur Programmes, sur Générateur de rapports Microsoft SQL Server 2008 R2, puis cliquez sur Générateur de rapports version 3.0.

   La boîte de dialogue Mise en route s'affiche.

   Notes

   Si la boîte de dialogue Mise en route ne s'affiche pas, à partir du bouton Générateur de rapports, cliquez sur Nouveau.

2. Dans le volet gauche, assurez-vous que Rapport est sélectionné.

3. Dans le volet droit, cliquez sur Assistant Tableau ou matrice.

4. Cliquez sur Créer.

5. Dans la page Choisir un dataset, cliquez sur Créer un dataset.

6. Cliquez sur Suivant.

7. Dans la page Choisir une connexion à une source de données, sélectionnez une source de données de type SQL Server. Sélectionnez une source de données dans la liste ou naviguez jusqu'au serveur de rapports pour en sélectionner une.

8. Cliquez sur Suivant.

9. Dans la page Créer une requête, cliquez sur Modifier en tant que texte.

10. Collez la requête suivante dans le volet de requête :

    ;WITH CTE (StoreID, Subcategory, Quantity) 
    AS (
    SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity
    UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity
    UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity
    UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity
    UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity
    UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity
    UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity
    UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity
    UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity
    UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity
    UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)
    SELECT StoreID, Subcategory, Quantity
    FROM CTE
    

    Cette requête combine les résultats de plusieurs instructions SELECT Transact-SQL dans une expression de table commune pour spécifier des valeurs basées sur des données simplifiées de l'exemple de base de données Contoso. Les données de ventes de Constoso représentent les données de ventes internationales relatives aux biens de consommation. Ce didacticiel utilise les données de ventes spécifiques aux appareils photo. Les sous-catégories représentent les appareils photo numériques, les appareils photo numériques reflex à lentille unique (SLR), les caméscopes et les accessoires.

    La requête spécifie des noms de colonnes comprenant un identificateur de magasin, une sous-catégorie d'éléments de ventes et le volume commandé pour les commandes client de trois magasins. Dans cette requête, le nom du magasin ne fait pas partie du jeu de résultats. Ultérieurement, dans ce didacticiel, vous rechercherez le nom du magasin qui correspond à l'identificateur de magasin d'un dataset distinct.

    Cette requête ne contient pas de paramètres de requête. Vous ajouterez ultérieurement des paramètres de requête dans ce didacticiel.

11. Dans la barre d'outils du concepteur de requêtes, cliquez sur Exécuter (!). Le jeu de résultats affiche 11 lignes de données qui montrent le volume d'articles vendus pour chaque sous-catégorie dans quatre magasins et inclut les colonnes suivantes : StoreID, Subcategory, Quantity.

12. Cliquez sur Suivant.

1. Dans la page Organiser les champs, faites glisser Subcategory vers Groupes de lignes.

2. Faites glisser StoreID vers Groupes de colonnes.

3. Faites glisser Quantity vers Valeurs.

   Vous avez organisé les valeurs des quantités vendues dans des lignes regroupées par sous-catégorie. Il y a une colonne pour chaque magasin.

4. Cliquez sur Suivant.

5. Dans la page Choisir la disposition, sous Options, assurez-vous que Afficher les sous-totaux et les totaux généraux est sélectionné.

   Lorsque vous exécuterez le rapport, la dernière colonne affichera la quantité totale de chaque sous-catégorie pour tous les magasins, et la dernière ligne affichera la quantité totale pour toutes les sous-catégories pour chaque magasin.

6. Cliquez sur Suivant.

7. Dans la page Choisir un style, dans le volet Styles, sélectionnez un style.

8. Cliquez sur Terminer.

   La matrice est ajoutée à l'aire de conception. La matrice affiche trois colonnes et trois lignes. Les cellules de la première ligne contiennent Subcategory, [StoreID] et Total. Les cellules de la deuxième ligne contiennent des expressions qui représentent la sous-catégorie, la quantité d'articles vendus pour chaque magasin, ainsi que la quantité totale de chaque sous-catégorie pour tous les magasins. Les cellules de la dernière ligne affichent le total global pour chaque magasin.

9. Cliquez dans la matrice, pointez sur le bord de la première colonne, saisissez la poignée, puis augmentez la largeur de la colonne.

10. Cliquez sur Exécuter pour afficher un aperçu du rapport.

Le rapport s'exécute sur le serveur de rapports en présentant son titre et l'heure à laquelle il a été traité.

Dans ce scénario, les en-têtes de colonnes affichent l'identificateur du magasin mais pas le nom du magasin. Ultérieurement, vous ajouterez une expression pour rechercher le nom de magasin dans un dataset qui contient des paires nom d'identificateur/nom de magasin.

1. Basculez en mode Conception.

2. Dans le volet Données du rapport, développez le dossier Datasets, cliquez avec le bouton droit sur DataSet1, puis sur Requête.

3. Ajoutez la clause Transact-SQLWHERE suivante comme dernière ligne de la requête :

   WHERE StoreID = (@StoreID)
   

   La clause WHERE limite les données récupérées à l'identificateur de magasin spécifié par le paramètre de requête @StoreID.

4. Dans la barre d'outils du Concepteur de requêtes, cliquez sur Exécuter (!). La boîte de dialogue Définir les paramètres de la requête s'ouvre et vous êtes invité à définir une valeur pour le paramètre de requête @StoreID.

5. Dans Valeur du paramètre, tapez 200.

6. Cliquez sur OK.

   Le jeu de résultats affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l'identificateur de magasin 200.

7. Cliquez sur OK.

8. Dans le volet Données du rapport, développez le dossier Paramètres.

Notez qu'il y a maintenant un paramètre de rapport nommé @StoreID. Par défaut, le paramètre a le type de données Texte. Dans la mesure où l'identificateur de magasin est un entier, vous devez remplacer le type de données par le type Entier dans la procédure suivante.

1. Dans le volet Données du rapport sous le nœud Paramètres, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.

2. Dans Invite, tapez Identificateur du magasin ?. Ce texte s'affiche sur la barre d'outils de la visionneuse de rapports lorsque vous exécutez le rapport.

3. Dans Type de données, dans la liste déroulante, sélectionnez Entier.

4. Acceptez les valeurs par défaut restantes dans la boîte de dialogue.

5. Cliquez sur OK.

6. Affichez l'aperçu du rapport. La visionneuse de rapports affiche l'invite pour @StoreID.

7. Dans la barre d'outils de la visionneuse de rapports, en regard de StoreID, tapez 200, puis cliquez sur Afficher le rapport.

1. Basculez en mode Conception.

2. Dans le volet Données du rapport, cliquez avec le bouton droit sur le dossier Datasets, puis cliquez sur Ajouter un dataset.

3. Dans le champ Nom, tapez Stores (Magasins).

4. Sélectionnez l'option Utiliser un dataset incorporé dans mon rapport.

5. Dans Source de données, dans la liste déroulante, choisissez la source de données que vous avez créée au cours de la première procédure.

6. Dans Type de requête, assurez-vous que Texte est sélectionné.

7. Dans Requête, collez le texte suivant :

   SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName
   UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName
   UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName
   UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName
   

8. Cliquez sur OK.

   Le volet Données du rapport affiche les champs StoreID et StoreName sous le nœud du dataset Stores.

1. Dans le volet Données du rapport, cliquez avec le bouton droit sur le paramètre @StoreID, puis cliquez sur Propriétés du paramètre.

2. Cliquez sur Valeurs disponibles, puis sur Obtenir les valeurs à partir d'une requête.

3. Dans la liste déroulante Dataset, cliquez sur Stores.

4. Dans la liste déroulante Champ de valeur, cliquez sur StoreID.

5. Dans la liste déroulante Champ d'étiquette, cliquez sur StoreName. Le champ d'étiquette spécifie le nom d'affichage de la valeur.

6. Cliquez sur Général.

7. Dans le champ Invite, tapez Nom du magasin ?.

   L'utilisateur sélectionnera désormais un nom dans une liste de noms de magasins au lieu d'identificateurs de magasin. Notez que le type de données du paramètre reste Entier, car le paramètre est basé sur l'identificateur de magasin au lieu du nom de magasin.

8. Cliquez sur OK.

9. Affichez l'aperçu du rapport.

   Dans la barre d'outils de la visionneuse de rapports, la zone de texte de paramètre est maintenant une liste déroulante affichant <Sélectionner une valeur>.

10. Dans la liste déroulante, sélectionnez « Contoso Catalog Store », puis cliquez sur Afficher le rapport.

Le rapport affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l'identificateur de magasin 200.

1. Basculez en mode Conception.

2. Dans le volet Données du rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.

3. Cliquez sur Valeurs par défaut, puis sur Obtenir les valeurs à partir d'une requête.

4. Dans la liste déroulante Dataset, cliquez sur Stores.

5. Dans la liste déroulante Champ de valeur, cliquez sur StoreID.

6. Cliquez sur OK.

7. Affichez l'aperçu du rapport.

Pour @StoreID, la visionneuse de rapports affiche la valeur « Contoso North America Online Store ». Il s'agit de la première valeur du jeu de résultats pour le dataset Stores. Le rapport affiche la quantité vendue des articles « Digital Cameras » pour l'identificateur de magasin 199.

1. Basculez en mode Conception.

2. Dans le volet Données du rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.

3. Cliquez sur Valeurs par défaut, sur Spécifier les valeurs, puis sur Ajouter. Une nouvelle ligne de valeurs est ajoutée.

4. Dans la zone Valeur, tapez 200.

5. Cliquez sur OK.

6. Affichez l'aperçu du rapport.

Pour @StoreID, la visionneuse de rapports affiche la valeur « Contoso Catalog Store ». Il s'agit du nom d'affichage pour l'identificateur de magasin 200. Le rapport affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l'identificateur de magasin 200.

1. Basculez en mode Conception.

2. Dans l'aire de conception, dans la matrice, dans le premier en-tête de ligne ou de colonne, cliquez avec le bouton droit sur [StoreID], puis cliquez sur Expression.

3. Dans le volet Expression, supprimez tout le texte sauf le signe equals (=) de début.

4. Dans Catégorie, développez Fonctions communes, puis cliquez sur Divers. Le volet Élément affiche un ensemble de fonctions.

5. Dans Élément, double-cliquez sur Recherche. Le volet Expression affiche =Lookup(. Le volet d'exemple affiche un exemple de syntaxe de recherche.

6. Tapez l'expression suivante : =Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")

   La fonction de recherche prend la valeur de StoreID, la recherche dans le dataset « Stores », puis retourne la valeur StoreName.

7. Cliquez sur OK.

   L'en-tête de colonne de magasin contient le texte affiché pour une expression complexe : <<Expr>>.

8. Affichez l'aperçu du rapport.

La zone de texte en haut de chaque page affiche le nom de magasin au lieu de l'identificateur de magasin.

1. Basculez en mode Conception.

2. Cliquez avec le bouton droit sur le pied de page, pointez sur Insérer, puis cliquez sur Zone de texte. Faites glisser la zone de texte en regard de la zone de texte comportant l'horodatage. Saisissez la poignée latérale de la zone de texte et augmentez la largeur de cette dernière.

3. Dans le volet Données du rapport, faites glisser le paramètre @StoreID vers la zone de texte. La zone de texte affiche [@StoreID].

4. Pour afficher l'étiquette de paramètre, cliquez dans la zone de texte jusqu'à ce que le curseur d'insertion s'affiche après l'expression existante, tapez un espace, puis faites glisser une autre copie du paramètre du volet Données du rapport vers la zone de texte. La zone de texte affiche [@StoreID] [@StoreID].

5. Cliquez avec le bouton droit sur la première expression, puis cliquez sur Expression. La boîte de dialogue Expression s'affiche. Remplacez le texte Value par Label.

6. Cliquez sur OK.

   Le texte affiche : [@StoreID.Label] [@StoreID].

7. Affichez l'aperçu du rapport.

1. Basculez en mode Conception.

2. Cliquez avec le bouton droit sur une ligne ou un descripteur d'en-tête de colonne dans la matrice, puis cliquez sur Propriétés du tableau matriciel.

3. Cliquez sur Filtres, puis sur Ajouter. Une nouvelle ligne de filtres apparaît.

4. Dans la liste déroulante Expression, sélectionnez le champ de dataset StoreID. Le type de données affiche Entier. Lorsque la valeur d'expression est un champ de dataset, le type de données est défini automatiquement.

5. Dans Opérateur, vérifiez que equals (=) est sélectionné.

6. Dans Valeur, tapez [@StoreID]. [@StoreID] est la syntaxe d'expression simple qui représente =Parameters!StoreID.Value.

7. Cliquez sur OK.

8. Affichez l'aperçu du rapport.

   La matrice affiche des données uniquement pour « Contoso Catalog Store ».

9. Dans la barre d'outils de la visionneuse de rapports, pour Nom du magasin ?, sélectionnez Contoso Asia Online Store, puis cliquez sur Afficher le rapport.

La matrice affiche les données qui correspondent au magasin que vous avez sélectionné.

1. Basculez en mode Conception.

2. Dans le volet Données du rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.

3. Sélectionnez Autoriser les valeurs multiples.

4. Cliquez sur OK.

5. Dans le volet Données du rapport, développez le dossier Datasets, cliquez avec le bouton droit sur DataSet1, puis sur Requête.

6. Remplacez le signe equals (=) par IN dans la clause Transact-SQLWHERE de la dernière ligne de la requête :

   WHERE StoreID IN (@StoreID)
   

   L'opérateur IN teste l'inclusion d'une valeur dans un ensemble de valeurs.

7. Cliquez sur OK.

8. Cliquez avec le bouton droit sur une ligne ou un descripteur d'en-tête de colonne dans la matrice, puis cliquez sur Propriétés du tableau matriciel.

9. Cliquez sur Filtres.

10. Dans Opérateur, sélectionnez In.

11. Cliquez sur OK.

12. Dans la zone de texte qui affiche le paramètre au sein du pied de page, supprimez l'ensemble du texte.

13. Cliquez avec le bouton droit sur la zone de texte, puis cliquez sur Expression. Tapez l'expression suivante : =Join(Parameters!StoreID.Label, ", ")

    Cette expression concatène tous les noms de magasins que l'utilisateur a sélectionnés.

14. Cliquez sur OK.

15. Cliquez dans la zone de texte devant l'expression que vous venez de créer, puis tapez ce qui suit : Valeurs de paramètres sélectionnées :.

16. Affichez l'aperçu du rapport.

17. Cliquez sur la liste déroulante en regard de Nom du magasin ?

    Chaque valeur valide s'affiche en regard d'une case à cocher.

18. Cliquez sur Sélectionner tout, puis sur Afficher le rapport.

    Le rapport affiche les quantités vendues pour toutes les sous-catégories de tous les magasins.

19. Dans la liste déroulante, cliquez sur Sélectionner tout afin d'effacer la liste, cliquez sur « Contoso Catalog Store » et sur « Contoso Asia Online Store », puis cliquez sur Afficher le rapport.

1. Dans l'aire de conception, dans le volet Données du rapport, cliquez avec le bouton droit sur Paramètres, puis cliquez sur Ajouter un paramètre.

2. Dans la zone Nom, tapez ShowSelections.

3. Dans Invite, tapez Afficher les sélections ?

4. Dans Type de données, dans la liste déroulante, cliquez sur Booléen.

5. Cliquez sur Valeurs par défaut.

6. Cliquez sur Spécifier les valeurs, puis sur Ajouter.

7. Dans la zone Valeur, tapez False.

8. Cliquez sur OK.

1. Dans l'aire de conception, cliquez avec le bouton droit sur la zone de texte du pied de page qui affiche les valeurs de paramètres, puis cliquez sur Propriétés de la zone de texte.

2. Cliquez sur Visibilité.

3. Sélectionnez l'option Afficher ou masquer en fonction d'une expression, puis cliquez sur le bouton Expression Fx.

4. Tapez l'expression suivante : =Not Parameters!ShowSelections.Value

   L'option de visibilité de la zone de texte est contrôlée par la propriété Hidden. Appliquez l'opérateur Not afin que lorsque le paramètre est sélectionné, la valeur False soit affectée à la propriété Hidden et que la zone de texte soit affichée.

5. Cliquez sur OK.

6. Cliquez sur OK.

7. Affichez l'aperçu du rapport.

   La zone de texte qui affiche les choix de paramètre ne s'affiche pas.

8. Dans la barre d'outils de la visionneuse de rapports, en regard de Afficher les sélections, cliquez sur True.

9. Affichez l'aperçu du rapport.

La zone de texte située dans le pied de page affiche tous les noms de magasins que vous avez sélectionnés.

1. Dans l'aire de conception, cliquez sur Cliquez pour ajouter un titre.

2. Tapez Ventes de produits paramétrables, puis cliquez en dehors de la zone de texte.

1. À partir du bouton Générateur de rapports, cliquez sur Enregistrer sous.

2. Cliquez sur Sites et serveurs récents.

3. Sélectionnez ou tapez le nom du serveur de rapports sur lequel vous êtes autorisé à enregistrer des rapports.

   Le message Connexion au serveur de rapports s'affiche. Une fois la connexion établie, le contenu du dossier de rapports spécifié par l'administrateur du serveur de rapports s'affiche comme emplacement par défaut des rapports.

4. Dans la zone Nom, remplacez le nom par défaut par État des ventes paramétrable.

5. Cliquez sur Enregistrer.

Le rapport est enregistré sur le serveur de rapports. Le serveur de rapports auquel vous êtes connecté est indiqué dans la barre d'état située au bas de la fenêtre.