Leçon 5 : ajout de paramètres à passer à un rapport d'extraction

Les rapports d'extraction constituent un type de rapport auquel vous accédez en cliquant sur un lien du rapport en cours. Quand vous cliquez sur une zone de texte qui comprend une action d'extraction, vous ouvrez le rapport d'extraction. Si ce rapport possède des paramètres, vous devez passer les valeurs de paramètre à chaque paramètre du rapport.

Dans cette leçon, vous allez concevoir un nouveau rapport pour afficher les données de détail d'une commande client spécifiée avec un paramètre. Vous allez ouvrir un rapport existant et créer une action d'extraction pour le numéro de commande client. Lorsque vous exécuterez le rapport et cliquerez sur le numéro de commande client, le nouveau rapport s'ouvrira et affichera les détails de la commande client en question.

Pour ajouter un nouveau rapport à un projet Report Server déjà ouvert

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Rapports, pointez sur Ajouter, puis cliquez sur Nouvel élément.

  2. Dans la section Modèles de la boîte de dialogue Ajouter un nouvel élément, cliquez sur l'option Rapport.

  3. Dans la zone Nom, tapez Sales Order Detail.rdl, puis cliquez sur Ajouter.

    Le Concepteur de rapports s'ouvre et affiche la nouvelle définition de rapport en mode Conception.

Pour créer une référence renvoyant à une source de données partagée

  1. Dans le volet Données du rapport, cliquez sur Nouveau, puis sur Source de données.

    [!REMARQUE]

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

  2. Dans le champ Nom, tapez AdventureWorks_Ref.

  3. Sélectionnez l'option Utiliser une référence de source de données partagée.

  4. Dans la zone de liste déroulante, sélectionnez AdventureWorks.

  5. Cliquez sur OK.

Pour créer un nouveau dataset

  1. Dans le volet Données du rapport, cliquez avec le bouton droit sur le nom de la source de données, à savoir sur AdventureWorks_Ref, puis cliquez sur Ajouter un dataset.

  2. Dans la zone Nom, tapez SalesDetails.

  3. Collez le texte de requête ci-après dans la zone de texte Requête :

    SELECT P.Name AS Product, SD.OrderQty AS Quantity, SD.LineTotal 
    FROM Sales.SalesOrderDetail AS SD 
       INNER JOIN Production.Product AS P 
       ON SD.ProductID = P.ProductID 
       INNER JOIN Sales.SalesOrderHeader AS SOH 
       ON SD.SalesOrderID = SOH.SalesOrderID
    WHERE (SOH.SalesOrderNumber = (@SalesOrder) )
    ORDER BY SD.SalesOrderDetailID
    

    Notez que pour créer la collection de champs du dataset, vous n'avez pas besoin d'exécuter la requête dans le Concepteur de requêtes avec une valeur de paramètre de requête.

  4. (Facultatif) Ouvrez le Concepteur de requêtes et cliquez sur Exécuter (!) dans la barre d'outils. Entrez la valeur suivante pour @SalesOrder : Le volet Résultats affiche 12 produits. Cliquez sur OK.

  5. Cliquez sur OK.

  6. Dans le volet Données du rapport, développez Paramètres et vérifiez que le paramètre SalesOrder apparaît.

Pour ajouter une table avec des champs de dataset

  1. À partir de la boîte à outils, faites glisser une table dans l'aire de conception.

  2. À partir du volet Données du rapport, faites glisser les champs suivants vers les cellules de la ligne Data : Product, Quantity, LineTotal.

  3. Affichez l'aperçu du rapport.

    Avant d'exécuter le rapport, vous devez entrer un numéro de commande client valide.

  4. Dans la barre d'outils de la visionneuse de rapports, dans la zone Sales Order, tapez SO43659.

    Le rapport affiche des totaux de ligne pour la commande client spécifiée.

Pour mettre en forme la table

  1. Passez en mode Conception.

  2. Cliquez avec le bouton droit dans la cellule qui contient [LineTotal], puis cliquez sur Propriétés de la zone de texte.

  3. Cliquez sur Nombre.

  4. Dans Catégorie, cliquez sur Monétaire.

  5. Cliquez sur OK. 

  6. Dans la table, cliquez sur le handle de ligne de la première ligne qui contient les en-têtes de colonne. Toutes les cellules de la ligne sont sélectionnées.

  7. Dans le menu Format, pointez sur Police, puis cliquez sur Gras.

    Lorsque vous affichez le rapport, la valeur pour LineTotal s'affiche comme une valeur monétaire et les en-têtes de colonne s'affichent en gras.

Ensuite, ajoutez l'action d'extraction pour spécifier ce rapport.

Pour ajouter une action d'extraction de rapport à votre rapport

  1. Dans l'Explorateur de solutions, double-cliquez sur Sales Orders.rdl. Le rapport s'ouvre en mode Conception.

  2. Dans la colonne Order, cliquez avec le bouton droit dans la zone de texte qui contient [Order], puis cliquez sur Propriétés de la zone de texte.

  3. Cliquez sur Action.

  4. Dans Activer en tant que lien hypertexte, sélectionnez Atteindre le rapport.

    Une autre section apparaît dans la boîte de dialogue.

  5. Dans la liste déroulante Sélectionnez un rapport dans la liste, sélectionnez Sales Order Detail.

  6. Dans Utilisez ces paramètres pour exécuter le rapport, cliquez sur Ajouter.

    Une nouvelle ligne est ajoutée à la grille.

  7. Dans la zone Nom, dans la liste déroulante qui contient la liste des paramètres définis pour le rapport, sélectionnez SalesOrder.

  8. Dans la zone Valeur, dans la liste déroulante, sélectionnez [Order].

    Ainsi, la valeur du rapport principal est liée au paramètre attendu par le rapport cible.

    Ensuite, modifiez la couleur et le style de texte du lien d'extraction.

  9. Cliquez sur Police.

  10. Dans la zone Effets, sélectionnez Souligné dans la liste déroulante.

  11. En regard de Couleur, cliquez sur (fx) pour ouvrir la boîte de dialogue Expression.

  12. Remplacez la couleur de texte Noir par défaut par une couleur différente, par exemple Bleu.

    [!REMARQUE]

    Pour obtenir des valeurs valides pour la couleur de police, cliquez sur Couleurs supplémentaires dans le volet Valeurs. La boîte de dialogue Sélectionner une couleur s'ouvre. Dans cette boîte de dialogue, vous pouvez parcourir les couleurs valides et sélectionner celle que vous souhaitez utiliser. Cliquez sur OK.

  13. Cliquez deux fois sur OK.

La zone de texte que vous venez d'ajouter possède un texte souligné qui s'affiche dans la couleur que vous avez choisie. Ces indications visuelles aident les lecteurs du rapport à comprendre qu'il existe un lien actif vers un autre rapport.

Pour prévisualiser le rapport

  1. Cliquez sur Aperçu. Le rapport Sales Orders affiche les commandes regroupées par date. La colonne Order affiche des numéros de commande qui sont des liens d'extraction.

  2. Cliquez sur un numéro de commande client avec un lien d'extraction.

    Le rapport spécifié par le lien d'extraction s'exécute et affiche les détails de la commande pour le numéro de commande sélectionné.

    [!REMARQUE]

    Pour revenir au rapport principal, utilisez la flèche noire de la barre d'outils de la visionneuse de rapports.

Étapes suivantes

Vous avez terminé le didacticiel d'ajout de paramètres à un rapport. Pour en savoir plus sur les techniques de création de rapports, consultez Didacticiels (Reporting Services).