Leçon 1 : ajout de paramètres pour filtrer les rapports par date (Générateur de rapports version 2.0)

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

À partir du bouton Générateur de rapports, cliquez sur Ouvrir.

Accédez à Sales Order (Commande client). Il s'agit du rapport qui a été créé dans le cadre du Didacticiel : création d'un rapport de tableau de base (Générateur de rapports version 2.0).

Cliquez sur Ouvrir. La définition de rapport s'ouvre en mode Conception.

Vous allez à présent remplacer la requête de dataset par une requête qui contient un paramètre de requête.

Dans le volet Données du rapport, cliquez avec le bouton droit sur le dataset DataSet1, puis cliquez sur Requête. Le concepteur de requêtes s'ouvre.

Dans le volet de requête, remplacez le texte par la requête suivante :

SELECT
  SH.OrderDate
  ,SH.SalesOrderNumber
  ,SD.OrderQty
  ,SD.LineTotal
  ,P.Name AS [Product]
  ,PS.Name AS [Subcategory]
FROM
  Sales.SalesOrderHeader AS SH
  INNER JOIN Sales.SalesOrderDetail AS SD
    ON SH.SalesOrderID = SD.SalesOrderID
  INNER JOIN Production.Product AS P
   ON SD.ProductID = P.ProductID
  INNER JOIN Production.ProductSubcategory AS PS
   ON PS.ProductSubcategoryID = P.ProductSubcategoryID
  INNER JOIN Production.ProductCategory AS PC
   ON PC.ProductCategoryID = PS.ProductCategoryID
WHERE PC.Name = 'Clothing' AND SH.OnlineOrderFlag = 0
   AND (SH.OrderDate BETWEEN (@StartDate) AND (@EndDate))

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

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

Cliquez sur le bouton Exécuter (!) de la barre d'outils. 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 chaque paramètre.

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

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

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

Cliquez sur OK. 

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

Cliquez sur OK. 

Dans le volet Données du rapport, développez le nœud Paramètres pour consulter les deux paramètres de rapport StartDate et EndDate, qui sont automatiquement créés à partir des paramètres de requête.

Après avoir défini les paramètres de requête qui représentent une date ou une heure, vous devez modifier le type de données des paramètres de rapport pour qu'il corresponde.

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

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

Dans Type de données, sélectionnez Date/Heure. Le type de données du paramètre de rapport enregistré dans la définition de rapport est alors défini.

Cliquez sur OK.

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

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

Cliquez sur OK. 

Cliquez sur Exécuter pour afficher un aperçu du rapport. 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.

Indiquez les valeurs des deux paramètres pour exécuter le rapport. Vous pouvez utiliser le contrôle calendrier ou simplement taper les dates suivantes :

1. Dans la zone de texte du paramètre StartDate, tapez 2001-01-01.

2. Dans la zone de texte du paramètre EndDate, tapez 2003-01-01.

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.

Passez 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.

Cliquez sur Valeurs par défaut.

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

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

Dans la zone de texte Valeur, remplacez le texte par défaut (Null) en tapant 2001-01-01.

Cliquez sur OK. 

Dans le volet Données du rapport, double-cliquez sur EndDate.

Cliquez sur Valeurs par défaut.

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

Cliquez sur Ajouter.

Tapez 2003-01-01.

Cliquez sur OK.

Cliquez sur Aperçu. Le rapport s'exécute immédiatement car chaque paramètre a une valeur par défaut.

Passez en mode Conception.

Cliquez avec le bouton droit sur le dataset Dataset1 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
  SH.OrderDate
  ,DATENAME(weekday, SH.OrderDate) as Weekday
  ,SH.SalesOrderNumber
  ,SD.OrderQty
  ,SD.LineTotal
  ,P.Name AS [Product]
  ,PS.Name AS [Subcategory]
FROM
  Sales.SalesOrderHeader AS SH
  INNER JOIN Sales.SalesOrderDetail AS SD
    ON SH.SalesOrderID = SD.SalesOrderID
  INNER JOIN Production.Product AS P
   ON SD.ProductID = P.ProductID
  INNER JOIN Production.ProductSubcategory AS PS
   ON PS.ProductSubcategoryID = P.ProductSubcategoryID
  INNER JOIN Production.ProductCategory AS PC
   ON PC.ProductCategoryID = PS.ProductCategoryID
WHERE PC.Name = 'Clothing' AND SH.OnlineOrderFlag = 0
   AND (SH.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.

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

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

Dans la colonne Valeur du paramètre, entrez une valeur pour @EndDate (20030101, par exemple).

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

Cliquez deux fois sur OK. Dans le volet Données du rapport, vérifiez que Weekday est un champ.

Maintenant que la table contient des données qui identifient le jour de la semaine, vous pouvez ajouter un filtre de telle sorte que seules les ventes d'un jour précis de la semaine soient prises en compte dans le rapport. Pour vous en assurer, vous pouvez afficher le jour de la semaine avec la date de la commande client.

Passez en mode Conception.

Cliquez sur la cellule contenant l'expression de champ OrderDate. Sous l'onglet Accueil, dans le groupe Nombre, cliquez sur le lanceur de boîte de dialogue.

Dans Catégorie, vérifiez que Date est sélectionné.

Dans la zone Type, sélectionnez un type de date qui affiche le jour de la semaine. Par exemple, pour le paramètre régional Anglais (États-Unis), vous pouvez sélectionner Monday, January 31, 2000.

Cliquez sur OK.

Cliquez sur Exécuter pour afficher un aperçu du rapport. La date figurant dans la première colonne de la table indique le jour de la semaine ainsi que la date de calendrier.

Vous allez à présent ajouter un paramètre pour permettre à l'utilisateur de procéder à un filtrage en fonction du jour de la semaine.

Passez en mode Conception.

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

Dans Nom, tapez DayoftheWeek.

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

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

Cliquez sur Valeurs par défaut.

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

Cliquez sur Ajouter.

Tapez Friday (vendredi).

Cliquez sur OK. 

Ensuite, vous allez ajouter un filtre pour n'afficher que la valeur que vous avez choisie pour le paramètre DayoftheWeek. Vous pouvez ajouter un filtre à la table ou au dataset. Ce rapport contient une table et un graphique qui présentent les mêmes données. Ajoutez le filtre à la table si vous souhaitez afficher les données filtrées dans la table uniquement. Ajoutez le filtre au dataset si vous souhaitez que la table et le graphique affichent tous deux les données filtrées. Dans la procédure suivante, vous allez définir le filtre sur le dataset.

En mode Conception, dans le volet Données du rapport, cliquez avec le bouton droit sur DataSet1, puis cliquez sur Propriétés du dataset.

Cliquez sur Filtres.

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

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

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

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

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.

Cliquez sur OK. 

Valeur présente l'expression simple pour le paramètre DayoftheWeek : [@DayoftheWeek].

Cliquez sur OK. 

Le filtre du dataset 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 Vendredi 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 Vendredi.

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

• 1er février 2002

• 1er mars 2002

• 1er novembre 2002