Partager via

  • Article

Leçon 1 : création de datasets partagés et configuration de paramètres de rapport (SSRS)

Dans cette leçon, vous allez créer des datasets partagés et configurer des paramètres de rapport basés sur les paramètres de requête de dataset pour le rapport Employee_Sales_Summary_2008R2.

Contenu du didacticiel

Dans ce didacticiel, vous apprendrez à effectuer les tâches suivantes :

  • Créer une copie du rapport de base avec lequel commencer.

  • Ajouter plusieurs datasets partagés au projet et au rapport.

  • Configurer les paramètres de rapport qui sont créés automatiquement pour chaque paramètre de requête de dataset.

  • Ajoutez une description du scénario qui explique l'objectif du rapport à l'utilisateur du rapport.

  • Ajouter du texte masqué sous condition pour afficher les informations sur la source de données et sur la requête de dataset.

  • Ajouter du texte masqué sous condition pour afficher les valeurs de paramètres qui ont été choisies par l'utilisateur du rapport.

  • Ajouter du texte masqué sous condition pour afficher la description du rapport.

  • Ajouter un titre de rapport.

  • Afficher un aperçu du rapport et le vérifier.

  • Déployer le rapport.

Durée estimée pour effectuer ce didacticiel : 15 minutes.

Conditions requises

Pour plus d'informations sur les conditions requises, consultez Composants requis pour les exemples de rapports AdventureWorks 2008R2 (SSRS).

Cette leçon part du principe que vous avez terminé Création du projet Report Server et du rapport AdventureWorks2008R2_Base (SSRS).

Conseils

Pour obtenir une liste de conseils d'ordre général, consultez Conseils pour la conception de rapports (Générateur de rapports version 3.0 et SSRS).

Pour ouvrir le projet et effectuer une copie d'un rapport

  1. Dans Business Intelligence Development Studio, ouvrez les exemples de rapports AdventureWorks 2008R2 du projet Report Server.

  2. Dans l'Explorateur de solutions, procédez comme suit :

    1. Cliquez avec le bouton droit sur le rapport AdventureWorks2008R2_Base.rdl, puis cliquez sur Copier.

    2. Cliquez avec le bouton droit sur le nœud du projet, puis cliquez sur Coller.

    3. Renommez le rapport copié en Employee_Sales_Summary_2008R2.rdl.

Créer des datasets partagés

Ce projet de rapport utilise quatre datasets partagés basés sur la source de données partagée AdventureWorks2008R2.

Créer EmployeeSalesYearOverYear2008R2

Pour ajouter un dataset partagé pour les ventes d'une année sur l'autre

  1. Dans l'Explorateur de solutions, ajoutez un dataset partagé nommé EmployeeSalesYearOverYear2008R2.

    Les données aident à répondre à la question : Quelle est la différence entre mes ventes saisonnières d'une année sur l'autre ?

    Dans le rapport, le graphique en courbes et le graphique sparkline afficheront ces données.

  2. Pointez sur la source de données partagée AdventureWorks2008R2 et ajoutez la requête suivante :

    SELECT   P.FirstName + ' ' + P.LastName AS Employee, 
   DATEPART(Year, SOH.OrderDate) AS [Year], 
   DATEPART(Month, SOH.OrderDate) AS MonthNumber, 
   DATENAME(Month, SOH.OrderDate) AS [Month], 
   SUM(DET.LineTotal) AS Sales
FROM [Sales].[SalesPerson] SP 
   INNER JOIN [Sales].[SalesOrderHeader] SOH ON SP.[BusinessEntityID] = SOH.[SalesPersonID]
   INNER JOIN Sales.SalesOrderDetail DET ON SOH.SalesOrderID = DET.SalesOrderID
   INNER JOIN [Sales].[SalesTerritory] ST ON SP.[TerritoryID] = ST.[TerritoryID] 
   INNER JOIN [HumanResources].[Employee] E ON SOH.[SalesPersonID] = E.[BusinessEntityID] 
   INNER JOIN [Person].[Person] P ON P.[BusinessEntityID] = SP.[BusinessEntityID]
WHERE (DATEPART(Year, SOH.OrderDate) <= @ReportYear - 1 OR
   DATEPART(Year, SOH.OrderDate) = @ReportYear AND DATEPART(Month, SOH.OrderDate) <= @ReportMonth) AND 
   (SOH.SalesPersonID = (@EmployeeID))
GROUP BY P.FirstName + ' ' + P.LastName, SOH.SalesPersonID, 
   DATEPART(Year, SOH.OrderDate), DATEPART(Month, SOH.OrderDate), 
   DATENAME(Month, SOH.OrderDate)

    Le dataset partagé s'affiche dans l'Explorateur de solutions.

  3. Dans le volet Données du rapport, créez un dataset nommé EmployeeSalesYearOverYear2008R2.

  4. Dans la boîte de dialogue Propriétés du dataset, sélectionnez Utiliser un dataset partagé, puis cliquez sur le dataset que vous venez de créer dans l'Explorateur de solutions.

    La requête de dataset inclut les variables de requête @ReportMonth, @ReportYear et @EmployeeID.

  5. Dans Propriétés du dataset, vérifiez qu'un paramètre de dataset est créé pour chaque variable de requête.

  6. Dans le volet Données du rapport, vérifiez qu'un paramètre de rapport est créé pour chaque paramètre de dataset.

Le dataset dans le volet Données du rapport est une référence au dataset partagé dans l'Explorateur de solutions. Une fois le rapport publié, la référence pointe vers le dataset partagé sur le serveur de rapports ou le site SharePoint.

Créer EmployeeSalesDetail2008R2

Pour ajouter un dataset partagé qui inclut des données pour chaque commande client

  1. Dans l'Explorateur de solutions, ajoutez un dataset partagé nommé EmployeeSalesDetail2008R2.

    Ces données aident à répondre à la question : Est-ce que j'atteins mes quotas de ventes pour le mois entier et pour chaque catégorie ?

    Dans le rapport, la matrice et les indicateurs incorporés afficheront ces données.

  2. Utilisez la source de données partagée AdventureWorks2008R2 et la requête suivante :

    SELECT PER.FirstName + ' ' + PER.LastName AS Employee,
   PS.Name AS Subcategory, SUM(DET.LineTotal) AS Sales, 
   SOH.SalesOrderID,  SOH.SalesOrderNumber, 
   P.Name AS Product, 
   SUM(DET.OrderQty) AS OrderQty, DET.UnitPrice, 
   PC.Name AS Category
FROM Sales.SalesOrderHeader SOH 
   INNER JOIN [Sales].[SalesPerson] SP ON SP.[BusinessEntityID] = SOH.[SalesPersonID]
   INNER JOIN Sales.SalesOrderDetail DET ON SOH.SalesOrderID = DET.SalesOrderID
   INNER JOIN [HumanResources].[Employee] E ON SOH.[SalesPersonID] = E.[BusinessEntityID] 
   INNER JOIN [Person].[Person] PER ON PER.[BusinessEntityID] = SP.[BusinessEntityID]
   INNER JOIN Production.Product P ON DET.ProductID = P.ProductID 
   INNER JOIN Production.ProductSubcategory PS ON P.ProductSubcategoryID = PS.ProductSubcategoryID 
   INNER JOIN Production.ProductCategory PC ON PS.ProductCategoryID = PC.ProductCategoryID
WHERE (DATEPART(Year, SOH.OrderDate) = @ReportYear) AND 
   (DATEPART(Month, SOH.OrderDate) = @ReportMonth) AND 
    (SOH.SalesPersonID = @EmployeeID)
GROUP BY PER.FirstName + ' ' + PER.LastName, 
   DATEPART(Month, SOH.OrderDate), SOH.SalesOrderID, SOH.SalesOrderNumber, 
   P.Name, PS.Name, DET.UnitPrice, PC.Name

    Le dataset partagé s'affiche dans l'Explorateur de solutions.

  3. Dans le volet Données du rapport, créez un dataset nommé EmployeeSalesDetail2008R2.

  4. Dans la boîte de dialogue Propriétés du dataset, sélectionnez Utiliser un dataset partagé, puis cliquez sur le dataset que vous venez de créer dans l'Explorateur de solutions.

Créer EmpSalesMonth2008R2

Pour ajouter un dataset partagé pour les ventes d'un mois sur l'autre

  1. Dans l'Explorateur de solutions, ajoutez un dataset partagé nommé EmpSalesMonth2008R2.

    Ces données aident à répondre à la question : Quelle est la différence entre les ventes de catégorie pour ce mois et les ventes pour le même mois dans les années précédentes ?

    Dans le rapport, l'histogramme et un graphique de barre de données afficheront ces données.

  2. Utilisez la source de données partagée AdventureWorks2008R2 et la requête suivante :

    SELECT PER.FirstName + ' ' + PER.LastName AS Employee, 
   DATEPART(Year, SOH.OrderDate) AS [Year], 
   DATEPART(Month, SOH.OrderDate) AS [MonthNumber], 
   DATENAME(Month, SOH.OrderDate) AS [Month], 
   PC.Name AS Category, SUM(DET.LineTotal) AS Sales
FROM Sales.SalesOrderHeader SOH 
   INNER JOIN [Sales].[SalesPerson] SP ON SP.[BusinessEntityID] = SOH.[SalesPersonID]
   INNER JOIN Sales.SalesOrderDetail DET ON SOH.SalesOrderID = DET.SalesOrderID
   INNER JOIN [HumanResources].[Employee] E ON SOH.[SalesPersonID] = E.[BusinessEntityID] 
   INNER JOIN [Person].[Person] PER ON PER.[BusinessEntityID] = SP.[BusinessEntityID]
   INNER JOIN Production.Product P ON DET.ProductID = P.ProductID 
   INNER JOIN Production.ProductSubcategory PS ON P.ProductSubcategoryID = PS.ProductSubcategoryID 
   INNER JOIN Production.ProductCategory PC ON PS.ProductCategoryID = PC.ProductCategoryID
WHERE
   (DATEPART(Year, SOH.OrderDate) <= @ReportYear) 
   AND (DATEPART(Month, SOH.OrderDate) = @ReportMonth)  
   AND (SOH.SalesPersonID = @EmployeeID)
GROUP BY PER.FirstName + ' ' + PER.LastName, 
   DATEPART(Year, SOH.OrderDate), DATEPART(Month, SOH.OrderDate), 
   DATENAME(Month, SOH.OrderDate), PC.Name

    Le dataset partagé s'affiche dans l'Explorateur de solutions.

  3. Dans le volet Données du rapport, créez un dataset nommé EmpSalesMonth2008R2.

  4. Dans la boîte de dialogue Propriétés du dataset, sélectionnez Utiliser un dataset partagé, puis cliquez sur le dataset que vous venez de créer dans l'Explorateur de solutions.

Créer SalesEmployees2008R2

Pour créer le dataset pour une liste de valeurs disponible pour les employés

  1. Dans l'Explorateur de solutions, ajoutez un dataset partagé nommé SalesEmployees2008R2.

    Ces données fournissent des valeurs valides pour le paramètre @EmployeeID.

  2. Utilisez la source de données partagée AdventureWorks2008R2 et la requête suivante :

    SELECT s.[BusinessEntityID], p.[FirstName] + N' ' + p.LastName AS Employee, e.[JobTitle]
FROM [Sales].[SalesPerson] s
   INNER JOIN [HumanResources].[Employee] e ON e.[BusinessEntityID] = s.[BusinessEntityID]
   INNER JOIN [Person].[Person] p ON p.[BusinessEntityID] = s.[BusinessEntityID]

    Le dataset partagé s'affiche dans l'Explorateur de solutions.

  3. Dans le volet Données du rapport, créez un dataset nommé SalesEmployees2008R2.

  4. Dans la boîte de dialogue Propriétés du dataset, sélectionnez Utiliser un dataset partagé, puis cliquez sur le dataset que vous venez de créer dans l'Explorateur de solutions.

Configurer des paramètres de rapport

Les datasets partagés contiennent des requêtes de dataset avec les variables de requête pour ReportYear, ReportMonth et EmployeeID. Les paramètres de rapport correspondant sont créés automatiquement pour chaque variable de requête. Par défaut, les propriétés de chaque paramètre de rapport sont définies pour le type de données String, une valeur unique et aucune valeur par défaut ou liste de valeurs valides. Vous devez configurer manuellement chaque paramètre, si nécessaire.

Modifier l'ordre des paramètres

Pour modifier l'ordre des paramètres sur la barre d'outils de la visionneuse de rapports

  1. Dans le volet Données du rapport, cliquez sur ShowAll.

  2. Sur la barre d'outils du volet Données du rapport, cliquez sur Descendre jusqu'à ce que le paramètre soit en dernière position dans la liste.

  3. Cliquez sur ReportMonth.

  4. Cliquez sur Monter jusqu'à ce que le paramètre soit en première position dans la liste.

Configurer ReportMonth

Configurez @ReportMonth pour accepter uniquement les valeurs provenant d'un ensemble de valeurs que vous spécifiez individuellement. La valeur par défaut doit être l'une de ces valeurs, sans quoi le rapport ne s'exécutera pas automatiquement.

Pour configurer le paramètre de rapport @ReportMonth

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

  2. Ouvrez Propriétés du paramètre pour @ReportMonth.

  3. Dans la page Général, remplacez Type de données par Entier.

  4. Dans la page Valeurs disponibles, sélectionnez Spécifier les valeurs.

  5. Ajoutez une entrée pour chacun des 12 mois. Affectez à Étiquette le nom du mois et à Valeur la valeur ordinale du mois. Par exemple, la première entrée est janvier et 1. La dernière entrée est décembre et 12. Remplissez l'ensemble des 12 valeurs.

  6. Dans la page Valeurs par défaut, sélectionnez Spécifier les valeurs. Dans la zone Valeurs, tapez 7.

Juillet est ainsi défini comme valeur par défaut. Lorsque chaque paramètre de rapport a une valeur par défaut, le rapport s'exécute automatiquement au premier affichage.

Configurer ReportYear

Pour configurer le paramètre de rapport @ReportYear

  1. Ouvrez Propriétés du paramètre pour @ReportYear.

  2. Dans la page Général, remplacez Type de données par Entier.

  3. Dans la page Valeurs par défaut, sélectionnez Spécifier les valeurs.

  4. Ajoutez une valeur. Dans Valeurs, tapez 2007.

Configurer EmployeeID

Pour configurer le paramètre de rapport @EmployeeID

  1. Ouvrez Propriétés du paramètre pour @EmployeeID.

  2. Dans la page Général, remplacez Demander par Employé.

  3. Remplacez Type de données par Entier.

  4. Dans la page Valeurs disponibles, sélectionnez Obtenir les valeurs à partir d'une requête.

  5. Dans Dataset, sélectionnez SalesEmployees2008R2.

  6. Dans Valeur, sélectionnez BusinessEntityID.

  7. Dans Étiquette, sélectionnez Employee.

  8. Dans la page Valeurs par défaut, sélectionnez Spécifier les valeurs. Dans Valeurs, tapez 283. Cette valeur est l'ID employé pour David Campbell.

Ajouter la description du scénario

Pour ajouter la description du scénario

  • Dans la zone de texte de description du scénario, remplacez le texte existant par le texte suivant :

    En tant que vendeur pour AdventureWorks, je souhaite connaître la différence entre mes ventes et les ventes saisonnières des années précédentes.

    Les graphiques en courbes et sparkline affichent les ventes d'une année sur l'autre pour toutes les catégories.

    La matrice avec des indicateurs indique les ventes actuelles comparées aux quotas. Modifiez les valeurs des quotas dans la barre d'outils de la visionneuse de rapports.

    Les histogrammes et graphiques de barres de données affichent les ventes dans chaque catégorie.

Au cours d'autres leçons, vous allez lier des mots du texte aux régions des données associées.

Afficher les valeurs de source de données source, de dataset et de paramètre

Vous pouvez afficher le texte de la commande de requête de dataset et les valeurs choisies par l'utilisateur pour chaque paramètre de rapport. Pour clarifier le rapport, placez ces informations dans des zones de texte dans un conteneur rectangle masqué de façon conditionnelle dans la dernière page.

Pour ajouter un rectangle

  1. Ajoutez un rectangle en bas du rapport, au-dessus du pied de page.

  2. Dans les propriétés du Rectangle, procédez comme suit :

    1. Dans la page Général, sélectionnez Insérer un saut de page avant.

    2. Dans la page Visibilité, sélectionnez Afficher ou masquer en fonction d'une expression, puis tapez : =NOT Parameters!ShowAll.Value

Au cours des étapes suivantes, ajoutez chaque zone de texte au rectangle dès que vous en avez terminé une. Étendez le rectangle, si nécessaire. En utilisant le rectangle comme conteneur, vous pouvez facilement déplacer toutes les zones de texte comme une unité.

Pour ajouter une zone de texte qui affiche des valeurs de paramètres

  1. Ajoutez, au corps du rapport, une zone de texte contenant le texte suivant sur des lignes distinctes :

    1. Mois de rapport : [@ReportMonth] [@ReportMonth.Label]

    2. Année de rapport : [@ReportYear]

    3. ID employé :@EmployeeID\] [@EmployeeID.Label]

  2. Faites glisser la zone de texte jusqu'au rectangle et ajustez des tailles, si nécessaire.

Pour ajouter une zone de texte qui affiche des informations sur la source de données et le dataset

  1. Ajoutez, au corps du rapport, une zone de texte nommée DataSourceandDatasets avec le texte suivant :

    1. Source de données AdventureWorks2008R2 :

    2. Créer un espace réservé nommé AdventureWorks2008R2 avec la valeur suivante : =DataSources!AdventureWorks2008R2.DataSourceReference

    3. Dataset EmployeeSalesYearOverYear2008R2 :

    4. Créer un espace réservé nommé EmployeeSalesYearOverYear2008R2 avec la valeur suivante : =DataSets!EmployeeSalesYearOverYear2008R2.CommandText.

    5. Dataset EmployeeSalesDetail2008R2 :

    6. Créer un espace réservé nommé EmployeeSalesDetail2008R2 avec la valeur suivante : =DataSets! EmployeeSalesDetail2008R2.CommandText.

    7. Dataset EmpSalesMonth2008R2.

    8. Créer un espace réservé nommé EmpSalesMonth2008R2 avec la valeur suivante : =DataSets! EmpSalesMonth2008R2.CommandText.

  3. Mettez en forme le texte autant que nécessaire. Par exemple, soulignez le nom du dataset.

  4. Faites glisser la zone de texte jusqu'au rectangle et ajustez des tailles, si nécessaire.

Ajouter la description

Pour ajouter la description

  1. Dans le pied de page, remplacez le texte figurant dans la zone de texte de description par le texte suivant :

    Objectif : rapport de résumé. Affiche les ventes d'une année sur l'autre pour toutes les catégories, les catégories individuelles et les quotas. Inclut des graphiques (en courbes, sparkline, histogramme avec lignes de changement d'échelle, barre de données), un tableau matriciel (lignes bascule, groupe de lignes, indicateurs au niveau de la table et du groupe), des variables de rapport et de groupe, des conteneurs rectangles, des datasets partagés, une source de données partagée, du code personnalisé pour la couleur de ligne du graphique, des signets, une action d'extraction, des paramètres à valeurs multiples et des paramètres pour contrôler la visibilité conditionnelle des zones de texte et lignes bascule.

  2. Cliquez sur l'arrière-plan de rapport pour afficher Propriétés du rapport dans le volet de propriétés.

  3. Dans Description, collez le texte de description.

Ajouter le titre du rapport

Pour ajouter le titre du rapport

  1. Dans l'en-tête de page, ajoutez une zone de texte avec le texte suivant sur deux lignes :

    Sales Report for [@EmployeeID.Label]

    [@ReportMonth.Label], [@ReportYear]

  2. Mettez en forme le texte autant que nécessaire.

Afficher un aperçu du rapport

Pour afficher un aperçu du rapport et le vérifier

  1. Affichez l'aperçu du rapport.

  2. Vérifiez que le rapport s'exécute automatiquement.

  3. Dans la barre d'outils de la visionneuse de rapports, vérifiez les éléments suivants :

    1. Mois de rapport a une liste déroulante de tous les mois. Par défaut, la valeur est Juillet.

    2. Année de rapport a la valeur par défaut 2007.

    3. Employé a une liste déroulante des noms de tous les employés. Par défaut, la valeur est David Campbell.

  4. Dans l'en-tête de page, le logo, le nom du rapport et le titre du rapport s'affichent.

  5. Lorsque vous cliquez sur la bascule, le texte de scénario s'affiche.

  6. Lorsque vous affectez à ShowAll la valeur True, et que vous exécutez le rapport, les valeurs de paramètres, les informations sur la source de données et le dataset, ainsi que la description s'affichent dans la dernière page du rapport.

Déployer le rapport

Pour déployer le rapport

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis cliquez sur Déployer. Recherchez des erreurs sur la ligne d'état de BI Development Studio ou dans le volet de sortie.

    Notes

    Étant donné que le rapport dépend de datasets partagés, vous devez déployer la totalité du projet la première fois que vous déployez le rapport.

  2. Dans un navigateur, naviguez jusqu'au serveur de rapports ou site SharePoint et vérifiez que les sources de données partagées, datasets partagés et rapports s'affichent dans les dossiers corrects, et que vous pouvez consulter les rapports.

Étapes suivantes

Vous avez terminé la création d'un projet de rapport et d'un rapport de base. Vous pouvez à présent créer un exemple de rapport. Pour plus d'informations, consultez Didacticiels : Création d'exemples de rapports AdventureWorks 2008R2 (SSRS).