Leçon 1 : Ajout de paramètres pour filtrer les rapports par date (SSRS)

1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft SQL Server 2008 R2 et cliquez sur Business Intelligence Development Studio.

2. Dans le menu Fichier, pointez sur Ouvrir et cliquez sur Projet/Solution.

3. Cliquez sur Didacticiel, puis choisissez Tutorial.sln. Il s'agit du didacticiel qui a été créé dans le Didacticiel : création d'un rapport de tableau de base.

4. Cliquez sur OK pour ouvrir le projet. Le projet Tutorial, qui contient un rapport intitulé Sales Orders.rdl, s'affiche dans l'Explorateur de solutions.

   Remarque   Si la fenêtre Explorateur de solutions n'est pas visible, cliquez sur Explorateur de solutions dans le menu Affichage.

1. Dans le volet Données du rapport, cliquez avec le bouton droit sur la source de données AdventureWorks et sélectionnez Convertir en source de données partagée. Une source de données appelée AdventureWorks.rds est ajoutée dans l'Explorateur de solutions.

2. Dans le volet Données du rapport, cliquez avec le bouton droit sur la source de données AdventureWorks et sélectionnez Propriétés de la source de données.

3. Dans le champ Nom, tapez AdventureWorks_Ref.

4. Cliquez sur OK.

1. Dans le volet Données du rapport, cliquez avec le bouton droit sur le dataset AdventureWorksDataset, puis cliquez sur Propriétés du dataset.

   Notes

   Si le volet Données du rapport n'est pas visible, cliquez sur Données du rapport dans le menu Affichage.

2. Dans la liste Source de données, vérifiez que AdventureWorks_Ref est sélectionné.

3. Dans Type de requête, vérifiez que Texte est sélectionné.

4. Cliquez sur le bouton Concepteur de requêtes pour ouvrir le concepteur de requêtes.

5. Remplacez le texte par la requête suivante dans la zone de texte.

   SELECT 
      soh.OrderDate AS [Date], 
      soh.SalesOrderNumber AS [Order], 
      pps.Name AS Subcat, pp.Name as Product,  
      SUM(sd.OrderQty) AS Qty,
      SUM(sd.LineTotal) AS LineTotal
   FROM Sales.SalesPerson sp 
      INNER JOIN Sales.SalesOrderHeader AS soh 
         ON sp.BusinessEntityID = soh.SalesPersonID
      INNER JOIN Sales.SalesOrderDetail AS sd 
         ON sd.SalesOrderID = soh.SalesOrderID
      INNER JOIN Production.Product AS pp 
         ON sd.ProductID = pp.ProductID
      INNER JOIN Production.ProductSubcategory AS pps 
         ON pp.ProductSubcategoryID = pps.ProductSubcategoryID
      INNER JOIN Production.ProductCategory AS ppc 
         ON ppc.ProductCategoryID = pps.ProductCategoryID
   GROUP BY ppc.Name, soh.OrderDate, soh.SalesOrderNumber, 
      pps.Name, pp.Name,    soh.SalesPersonID
   HAVING (ppc.Name = 'Clothing' 
      AND (soh.OrderDate BETWEEN (@StartDate) AND (@EndDate)))
   

   Il s'agit de la même requête que précédemment, à la différence près qu'une condition avec deux paramètres de limitation a été ajoutée :

   AND (soh.OrderDate BETWEEN (@StartDate) AND (@EndDate))

6. Cliquez sur le bouton Exécuter (!) de la barre d'outils. Vous êtes invité à définir les valeurs des paramètres dans la boîte de dialogue Définir les paramètres de la requête qui s'ouvre.

7. Indiquez deux valeurs pour afficher un jeu de résultats filtré :

   1. Dans la colonne Valeur du paramètre, entrez une valeur pour @StartDate, (1/31/2001, par exemple).

   2. Dans la colonne Valeur du paramètre, entrez une valeur pour @EndDate (1/31/2003, par exemple).

8. Cliquez sur OK. 

9. Le jeu de résultats affiche un dataset filtré pour les commandes des années 2001 et 2002.

10. Cliquez deux fois sur OK. Le volet Données du rapport est rempli avec les champs du dataset. Notez également que les deux paramètres de rapport StartDate et EndDate se créent automatiquement et s'affichent sous le nœud Paramètres.

Une fois les paramètres de requête du rapport défini, vous devez modifier le type de données des paramètres de rapport pour qu'il corresponde au type de données des données sources. La valeur par défaut est Texte et elle est mappée au type de données String dans la plupart des sources de données. Si des données sources sont numériques, booléennes ou de type date/heure, vous devez modifier le type de données de paramètre de rapport.

1. Dans le volet Données du rapport, développez Paramètres et double-cliquez sur StartDate. La boîte de dialogue Propriétés du paramètre de rapport s'ouvre.

2. Vérifiez que le nom du paramètre est StartDate et que l'invite est Start Date.

3. Dans Type de données, sélectionnez Date/Heure.

4. Cliquez sur OK.

5. Dans le volet Données du rapport, double-cliquez sur EndDate. Vérifiez les valeurs du nom et de l'invite.

6. Dans Type de données, sélectionnez Date/Heure.

7. Cliquez sur OK. 

8. Cliquez sur Aperçu. Les paramètres StartDate et EndDate apparaissent chacun dans la barre d'outils du rapport avec un contrôle calendrier. Les contrôles calendrier s'affichent automatiquement lorsque le type de données du paramètre est Date/Time et que vous n'avez pas défini de liste de valeurs disponibles. Si vous avez défini une liste de valeurs disponibles, une liste déroulante de valeurs s'affiche à la place.

9. Indiquez deux valeurs de paramètre pour exécuter le rapport :

   1. Dans la zone de texte du paramètre StartDate, entrez la date 1/31/2001.

   2. Dans la zone de texte du paramètre EndDate, entrez la date 1/31/2003.

10. Cliquez sur Afficher le rapport. Le rapport n'affiche que les données qui sont comprises dans l'intervalle des valeurs des paramètres de rapport.

Une fois les paramètres de requête du rapport créés, vous pouvez ajouter les valeurs par défaut de ces paramètres. Les paramètres par défaut permettent au rapport de s'exécuter automatiquement ; sinon, l'utilisateur doit entrer les valeurs des paramètres pour que le rapport s'exécute.

1. En mode Conception, dans le volet Données du rapport, développez Paramètres et double-cliquez sur StartDate. La boîte de dialogue Propriétés du paramètre de rapport s'ouvre.

2. Cliquez sur Valeurs par défaut.

3. Sélectionnez l'option Spécifier les valeurs. Le bouton Ajouter et une grille Valeur vide apparaissent.

4. Cliquez sur Ajouter. Une ligne vide est ajoutée à la grille.

5. Cliquez dans la zone de texte Valeur et supprimez le texte par défaut (Null).

6. Tapez 1/31/2001. Cliquez sur OK. 

7. Dans le volet Conception de rapport, double-cliquez sur EndDate.

8. Cliquez sur Valeurs par défaut.

9. Sélectionnez l'option Spécifier les valeurs.

10. Cliquez sur Ajouter.

11. Tapez 1/31/2003. Cliquez sur OK.

12. Cliquez sur Aperçu. Le rapport s'exécute immédiatement car des valeurs par défaut ont été définies pour tous les paramètres.

1. Passez en mode Conception.

2. Cliquez avec le bouton droit sur le dataset AdventureWorksDataset et sélectionnez Propriétés du dataset. Ouvrez le concepteur de requêtes et remplacez la requête par la requête suivante :

   SELECT 
      soh.OrderDate AS [Date], DATENAME(weekday, soh.OrderDate) as Weekday,
      soh.SalesOrderNumber AS [Order], 
      pps.Name AS Subcat, pp.Name as Product,  
      SUM(sd.OrderQty) AS Qty,
      SUM(sd.LineTotal) AS LineTotal
   FROM Sales.SalesPerson sp 
      INNER JOIN Sales.SalesOrderHeader AS soh 
         ON sp.BusinessEntityID = soh.SalesPersonID
      INNER JOIN Sales.SalesOrderDetail AS sd 
         ON sd.SalesOrderID = soh.SalesOrderID
      INNER JOIN Production.Product AS pp 
         ON sd.ProductID = pp.ProductID
      INNER JOIN Production.ProductSubcategory AS pps 
         ON pp.ProductSubcategoryID = pps.ProductSubcategoryID
      INNER JOIN Production.ProductCategory AS ppc 
         ON ppc.ProductCategoryID = pps.ProductCategoryID
   GROUP BY ppc.Name, soh.OrderDate, soh.SalesOrderNumber, 
      pps.Name, pp.Name,    soh.SalesPersonID
   HAVING (ppc.Name = 'Clothing' AND (soh.OrderDate BETWEEN (@StartDate) AND (@EndDate)))
   

   Dans la requête, vous pouvez définir une colonne calculée supplémentaire pour le jour de la semaine où une vente intervient en ajoutant la commande suivante à l'instruction SELECT :

   DATENAME(weekday, soh.OrderDate) as Weekday.

3. Cliquez sur Exécuter (!). La boîte de dialogue Définir les paramètres de la requête s'affiche.

4. Dans la colonne Valeur du paramètre, entrez une valeur pour @StartDate, (1/31/2001, par exemple).

5. Dans la colonne Valeur du paramètre, entrez une valeur pour @EndDate (1/31/2003, par exemple).

6. Cliquez sur OK. Une nouvelle colonne doit s'afficher dans le jeu de résultats portant l'étiquette Weekday.

7. Cliquez deux fois sur OK. Dans le volet des données de rapport, vérifiez que Weekday est un champ.

1. Cliquez sur l'onglet Conception.

2. Cliquez avec le bouton droit sur la cellule qui contient l'expression de champ [Date] et cliquez sur Propriétés de la zone de texte.

3. Cliquez sur Nombre puis, dans le champ Catégorie, sélectionnez Date.

4. Dans la zone Type, sélectionnez Monday, January 31, 2000.

5. Cliquez sur OK.

1. En mode Conception, dans le volet Données du rapport, cliquez sur Nouveau, puis cliquez sur Paramètre. La boîte de dialogue Propriétés du paramètre de rapport s'ouvre.

2. Dans Nom, tapez DayoftheWeek.

3. Dans Invite, tapez Filter on the day of the week:.

4. Vérifiez que le type de données est Text.

5. Cliquez sur Valeurs par défaut.

6. Sélectionnez l'option Spécifier les valeurs. Le bouton Ajouter et une grille Valeur vide apparaissent.

7. Cliquez sur Ajouter.

8. Tapez Friday.

9. Cliquez sur OK.  

1. En mode Conception, cliquez avec le bouton droit sur un descripteur de ligne ou de colonne de la table et sélectionnez Propriétés du tableau matriciel.

   Notes

   La région de données de table est un modèle qui repose sur une région de données de tableau matriciel.

2. Cliquez sur Filtres. Une grille de filtre vide apparaît.

3. Cliquez sur Ajouter. Une ligne vide est ajoutée à la grille.

4. Dans Expression, sélectionnez [Weekday] dans la liste déroulante.

5. Vérifiez que le signe égal (=) est affiché dans Opérateur.

6. Cliquez sur le bouton d'expression (fx) situé à côté de la zone de texte Valeur. La boîte de dialogue Expression s'affiche.

7. Dans Catégorie, cliquez sur Paramètres. La liste des paramètres actuels s'affiche dans le volet Valeurs. Double-cliquez sur DayoftheWeek. L'expression de paramètre est ajoutée à la zone de texte de l'expression. L'expression suivante apparaît maintenant dans la zone de texte de l'expression : =Parameters!DayoftheWeek.Value.

8. Cliquez sur OK. Cliquez sur OK pour quitter la boîte de dialogue Propriétés du tableau matriciel.

   Le filtre de la table est maintenant défini pour comparer la valeur du champ Weekday à la valeur de paramètre de DayoftheWeek. Par exemple, lorsque vous entrez la valeur Friday dans la barre d'outils du rapport pour DayoftheWeek, le processeur de rapports ne traite que les lignes de la table où le champ Weekday a pour valeur Friday.

   Cliquez sur Aperçu. Comme tous les paramètres possèdent des valeurs par défaut, le rapport s'exécute automatiquement. La table n'affiche que les valeurs qui sont comprises dans la plage de dates définie par StartDate et EndDate et qui tombent un vendredi (Friday).