Leçon 2 : modifier les propriétés d’une source de données de rapport

Dans cette leçon du tutoriel sur Reporting Services, vous utilisez le portail web pour sélectionner un rapport à envoyer aux destinataires. L’abonnement piloté par les données que vous allez définir distribue le rapport Sales Order créé dans le tutoriel Créer un rapport de tableau de base (tutoriel SSRS). Au cours des étapes qui suivent, vous allez modifier les informations de connexion à la source de données utilisée par le rapport pour extraire les données. Seuls les rapports qui utilisent des informations d’identification stockées pour accéder à une source de données de rapport peuvent être distribués par le biais d’un abonnement piloté par les données. Les informations d'identification stockées sont nécessaires pour traiter les rapports de façon autonome.

Vous allez également modifier le dataset et le rapport pour qu'ils utilisent un paramètre permettant de filtrer le rapport sur [Order] de sorte que l'abonnement puisse générer plusieurs instances différentes du rapport pour des commandes et des formats de rendu spécifiques.

Modifier la source de données pour utiliser les informations d'identification stockées

  1. Accédez au portail web Reporting Services avec des privilèges d’administrateur ; cliquez, par exemple, avec le bouton droit sur l’icône d’Internet Explorer et sélectionnez Exécuter en tant qu’administrateur.

  2. Accédez à l’URL du portail web. Par exemple :
    https://<server name>/reports.
    https://localhost/reportsRemarque : L’URL du portail web est « Reports », et non « Reportserver », l’URL du serveur de rapports.

  3. Accédez au dossier contenant le rapport Sales Orders et, dans le menu local du rapport, sélectionnez Gérer.

    Screenshot of the context menu of Sales Orders.

  4. Sélectionnez Sources de données dans le volet gauche.

  5. Vérifiez que le Type de connexion est Microsoft SQL Server.

  6. Vérifiez que la chaîne de connexion est la suivante et qu’elle suppose que l’exemple de base de données se trouve sur un serveur de base de données local :

    Data source=localhost; initial catalog=AdventureWorks2022  
    
  7. Sélectionnez Utilisez les informations d’identification suivantes.

  8. Dans la zone Type d’informations d’identification, sélectionnez Nom d’utilisateur et mot de passe Windows

  9. Tapez votre nom d’utilisateur (utilisez le format domaine\utilisateur) et votre mot de passe. Si vous n'avez pas l'autorisation d'accéder à la base de données AdventureWorks2022, indiquez une connexion qui l'autorise.

  10. Sélectionnez Tester la connexion pour vous assurer que vous pouvez vous connecter à la source de données.

  11. Sélectionnez Enregistrer.

  12. Sélectionnez Annuler.

  13. Affichez le rapport pour vérifier qu'il s'exécute avec les informations d'identification que vous avez spécifiées.

Modifier AdventureWorksDataset

Dans les étapes suivantes, vous modifiez le dataset pour utiliser un paramètre permettant de filtrer le jeu de données en fonction d’un numéro de commande.

  1. Ouvrez le rapport Sales Orders dans SQL Server Data Tools.

  2. Cliquez avec le bouton droit sur le jeu de données AdventureWorksDataset et sélectionnez Propriétés du jeu de données.

    Screenshot of the context menu for AdventureWorksDataset highlighting the Dataset Properties option.

  3. Ajoutez l'instruction WHERE (UPPER(SalesOrderNumber) =UPPER(@OrderNumber) or @OrderNumber IS NULL) avant l'instruction Group By . L’exemple suivant présente la syntaxe complète de la requête :

    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 AS 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  
    
    WHERE (UPPER(SalesOrderNumber) =UPPER(@OrderNumber) or  @OrderNumber IS NULL)  
    
    GROUP BY ppc.Name, soh.OrderDate, soh.SalesOrderNumber, pps.Name, pp.Name, soh.SalesPersonID  
    HAVING (ppc.Name = 'Clothing')  
    
  4. Sélectionnez OK.
    Dans les étapes suivantes, vous ajoutez un paramètre au rapport. Le paramètre de rapport alimente le paramètre de dataset.

Pour ajouter un paramètre de rapport et republier le rapport

  1. Dans le volet des données de rapport , développez le dossier de paramètres et double-cliquez sur le paramètre Ordernumber. Il a été créé automatiquement dans les étapes précédentes quand vous avez ajouté le paramètre au dataset. Sélectionnez Nouveau , puis choisissez Paramètre...

    Screenshot of the Report Data pane highlighting the Ordernumber parameter.

  2. Vérifiez que le Nom est OrderNumber.

  3. Vérifiez que l’Invite est OrderNumber.

  4. Sélectionnez Autoriser une valeur vide ("") .

  5. Sélectionnez Autoriser les valeurs de type Null.

  6. Cliquez sur OK.

  7. Sélectionnez l’onglet Aperçu pour exécuter le rapport. Notez que la zone d’entrée de paramètres apparaît en haut du rapport. Vous pouvez :

    • Cliquez sur Afficher le rapport pour afficher le rapport dans son intégralité sans utiliser de paramètre.

    • Désélectionnez l’option Null et tapez un numéro de commande, par exemple, so71949, puis cliquez sur Afficher le rapport pour afficher uniquement cette commande dans le rapport.

    Screenshot of the preview tab and the View Report button highlighted.

Redéployez le rapport

  1. Redéployez le rapport afin que la configuration de l'abonnement dans la leçon suivante puisse utiliser les modifications que vous avez apportées dans cette leçon. Pour plus d’informations sur les propriétés de projet utilisées dans le tutoriel de table, consultez la section « Pour publier le rapport sur le serveur de rapports (facultatif) » de la Leçon 6 : ajout d’un regroupement et de totaux (Reporting Services).

  2. Dans la barre d'outils, cliquez sur Générer , puis choisissez Déployer le tutoriel.

Étape suivante

  • Vous avez correctement configuré le rapport pour extraire les données au moyen des informations d’identification stockées et les données peuvent être filtrées avec un paramètre.
  • Dans la leçon suivante, vous configurez l’abonnement à l’aide des pages Abonnement piloté par les données du portail web. Consultez Leçon 3 : définition d’un abonnement piloté par les données.