Utilisation de paramètres pour contrôler les données des rapports

Les paramètres de rapport sont automatiquement créés lors de la définition des paramètres de requête. Dans le Générateur de rapports, les paramètres de rapport sont automatiquement créés lorsque vous définissez une invite sur une clause de filtre.

Lorsque vous définissez un dataset, vous spécifiez un type de source de données spécifique ; par exemple, MicrosoftSQL Server. Le Concepteur de rapports ouvre un concepteur de requêtes conçu pour fonctionner avec ce type de source de données. Lorsque vous définissez la requête pour chaque dataset, le concepteur de requêtes identifie des variables dans le texte de la commande de la requête, puis il crée un paramètre de requête pour chaque variable. Toutes les associations de source de données et de fournisseur de données ne prennent pas en charge les requêtes avec des variables. Pour plus d'informations sur la syntaxe de la requête attendue par la source de données, consultez Utilisation de paramètres de requête avec des sources de données spécifiques (Reporting Services).

Pour une source de données SQL Server, les requêtes incluent généralement des variables dans la clause WHERE d'une instruction Transact-SQL pour limiter l'étendue des données retournées lors de l'exécution d'une requête. De même, une requête d'une source de données Analysis Services inclut en principe des variables MDX utilisées dans une clause FILTER. Les requêtes peuvent également inclure des variables transmises en tant qu'entrées aux procédures stockées ou aux fonctions définies par l'utilisateur.

Chaque fois que vous modifiez la requête d'un dataset, la requête est retraitée. Si vous modifiez une requête en supprimant ou en renommant une variable, les paramètres de la requête reflèteront ces modifications.

Vous pouvez créer des paramètres de dataset supplémentaires sur la page Paramètres de la boîte de dialogue Propriétés du dataset. Les paramètres que vous créez ne sont pas modifiés lorsque la requête change.

La valeur par défaut de chaque paramètre de requête est définie à une expression qui correspond au paramètre de rapport associé. Pour modifier la valeur par défaut, utilisez la page Paramètres de la boîte de dialogue Propriétés du dataset. Par exemple, pour une source de données SQL Server, si le paramètre de requête est @MyParameter, le paramètre de rapport est MyParameter et la valeur de @MyParameter est l'expression [@MyParameter]. Pour plus d'informations, consultez Boîte de dialogue Propriétés du dataset, Paramètres. Vous pouvez modifier manuellement les paramètres de requête et définir leurs valeurs par défaut. Pour plus d'informations, consultez Procédure : associer un paramètre de requête à un paramètre de rapport.

Les paramètres de rapport qui sont automatiquement créés utilisent les valeurs par défaut suivantes :

• Valeur unique

• Type de données Text

• Invite dont la valeur est le nom du paramètre

• Aucune valeur par défaut

• Aucune valeur disponible

Vous devrez peut-être modifier ces propriétés en fonction du type de données que représente le paramètre de requête. Pour plus d'informations, consultez Création de paramètres de rapport et définition des propriétés des paramètres de rapport.

Lorsque vous créez une requête qui utilise plusieurs paramètres de requête, vous pouvez créer un ensemble de paramètres en cascade. Les paramètres en cascade permettent de filtrer un très grand nombre de valeurs de paramètres afin d'obtenir un nombre de valeurs facile à gérer. Supposons, par exemple, qu'une requête inclue les paramètres @Category, @Subcategory et @Product, où la liste de sous-catégories dépend de @Category et la liste de produits dépend de @Subcategory. Lorsqu'un utilisateur choisit une valeur pour le paramètre de rapport Category, les valeurs pour Subcategory sont limitées aux valeurs valides pour la catégorie choisie. Une fois que l'utilisateur sélectionne une valeur pour Subcategory, les choix pour Product sont déjà filtrés par le choix pour la catégorie et la sous-catégorie. Cette technique vous permet de réduire les choix valides pour un paramètre à un nombre raisonnable de valeurs.

Pour concevoir des paramètres en cascade, vous devez inclure les éléments suivants dans votre rapport :

• La requête de dataset principale, qui a plusieurs paramètres de requête liés.

• Une liste triée de paramètres de rapport, chacun étant lié à un paramètre de requête. En général, ces paramètres sont automatiquement créés à partir de la requête principale. Chaque paramètre dépendant doit suivre le paramètre dont il dépend. L'ordre des paramètres peut être modifié dans le volet Données du rapport, dans lequel vous pouvez déplacer les paramètres vers le haut ou vers le bas dans la collection. Pour plus d'informations, consultez Procédure : modifier l'ordre d'un paramètre de rapport (Reporting Services).

• Un dataset distinct pour chaque paramètre de rapport qui fournit ses valeurs disponibles. Il est important d'utiliser la même orthographe avec respect de la casse pour chaque paramètre de requête afin que les paramètres de requête et les paramètres de rapport soient correctement liés. La requête correspondant à chaque ensemble de valeurs disponibles pour chaque paramètre de rapport doit fournir uniquement des valeurs qui sont opportunes dans le contexte de la requête principale.

Dans l'exemple, le paramètre de rapport Product dépend de Subcategory, qui lui-même dépend de Category. Category doit figurer en premier, suivi par Subcategory, puis par Product. La requête du dataset qui fournit les valeurs disponibles pour Category doit afficher toutes les catégories qui sont valides pour la requête principale. La requête qui fournit les valeurs disponibles pour Subcategory une fois que vous avez choisi une catégorie doit fournir des valeurs qui sont valides pour la catégorie (Category) donnée, plus toutes les contraintes qui existent dans la requête principale.

Pour plus d'informations, consultez Procédure : ajouter des paramètres en cascade à un rapport (Reporting Services).