Création de datasets de rapport à partir d'une base de données relationnelle SQL Server (Générateur de rapports version 2.0)

Dans le Concepteur de requêtes textuel, vous pouvez taper des commandes Transact-SQL pour définir les données d'un dataset. Par exemple, la requête Transact-SQL suivante sélectionne les noms de tous les employés qui occupent la fonction d'assistants marketing.

SELECT
  HumanResources.Employee.BusinessEntityID
  ,HumanResources.Employee.JobTitle
  ,Person.Person.FirstName
  ,Person.Person.LastName
FROM
  Person.Person
  INNER JOIN HumanResources.Employee
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant' 

Cliquez sur le bouton Exécuter (!) de la barre d'outils pour exécuter la requête et afficher un jeu de résultats.

Pour paramétrer cette requête, ajoutez un paramètre de requête. Par exemple, modifiez la clause WHERE comme suit :

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Lorsque vous exécutez la requête, les paramètres de rapport qui correspondent aux paramètres de requête sont créés automatiquement. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.

Vous pouvez spécifier une procédure stockée pour une requête de dataset en procédant de l'une des manières suivantes :

• Dans la boîte de dialogue Propriétés du dataset, définissez l'option Procédure stockée. Effectuez un choix dans la zone de liste déroulante de procédures stockées et de fonctions table.

• Dans le Concepteur de requêtes relationnelles, dans le volet Base de données, sélectionnez une procédure stockée ou une fonction table.

• Dans le Concepteur de requêtes textuel, sélectionnez StoredProcedure dans la barre d'outils.

Après avoir sélectionné une procédure stockée ou une fonction table, vous pouvez exécuter la requête. Vous serez invité à fournir les valeurs des paramètres d'entrée. Lorsque vous exécutez la requête, les paramètres de rapport qui correspondent aux paramètres d'entrée sont créés automatiquement. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.

Seul le premier jeu de résultats extrait pour une procédure stockée est pris en charge. Si une procédure stockée retourne plusieurs jeux de résultats, seul le premier est utilisé.

Si une procédure stockée possède un paramètre doté d'une valeur par défaut, vous pouvez accéder à cette dernière en utilisant le mot clé DEFAULT comme valeur pour le paramètre. Si le paramètre de requête est lié à un paramètre de rapport, l'utilisateur peut taper ou sélectionner le mot DEFAULT dans la zone d'entrée pour le paramètre de rapport.

Pour plus d'informations sur les procédures stockées, consultez « Procédures stockées (Moteur de base de données) » dans la documentation en ligne de SQL Server.

Pour le texte de requête qui contient des paramètres ou pour les procédures stockées dotées de paramètres d'entrée, les paramètres de rapport correspondants sont créés automatiquement. Lors de l'exécution du rapport, les valeurs des paramètres de rapport sont passées aux paramètres de requête. Par exemple, la requête SQL suivante crée un paramètre de rapport nommé EmpID :

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN
       Person.Contact C ON  E.ContactID=C.ContactID 
WHERE EmployeeID = @EmpID

Vous pouvez gérer la relation entre les paramètres de rapport et les paramètres de requête à l'aide de la Boîte de dialogue Propriétés du dataset, Paramètres (Générateur de rapports version 2.0). Les requêtes comportant des paramètres liés à des paramètres de rapport ne nécessitent pas l'instruction DECLARE.

Bien que les paramètres de rapport soient automatiquement créés à partir des paramètres de requête, ils sont gérés séparément dans le volet Données du rapport.