TechNet
Exporter (0) Imprimer
Développer tout

Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)

 

S'applique à: SQL Server 2016

Dans Reporting Services des rapports paginés, les expressions sont utilisées dans la définition de rapport pour spécifier ou calculer les valeurs des paramètres, requêtes, filtres, propriétés d’élément de rapport, les définitions de groupe et de tri, propriétés-zone de texte, signets, explorateurs de documents, en-tête de page dynamique et contenu de pied de page, les images et définitions de source de données dynamiques. Cette rubrique fournit des exemples des nombreux emplacements où vous pouvez utiliser des expressions pour varier le contenu ou l'apparence d'un rapport. Cette liste n'est pas exhaustive. Vous pouvez définir une expression de n’importe quelle propriété dans une boîte de dialogue qui affiche l’expression (fx) bouton ou dans une liste déroulante qui affiche < Expression... >.

Les expressions peuvent être simples ou complexes. Les expressions simples contiennent une référence à un champ de dataset unique, paramètre ou champ prédéfini. Les expressions complexes peuvent contenir plusieurs références intégrées, opérateurs et appels de fonction. Par exemple, une expression complexe peut inclure la fonction Sum appliquée au champ Sales.

Les expressions sont écrites en Microsoft Visual Basic. Une expression commence par un signe égal (=) suivi d'une combinaison de références à des collections intégrées, telles que des paramètres et champs de dataset, constantes, fonctions et opérateurs.

System_CAPS_ICON_note.jpg Remarque


Vous pouvez créer et modifier des fichiers de définition de rapport (.rdl) paginés dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes.

Les expressions simples apparaissent entre crochets sur l'aire de conception et dans les boîtes de dialogue ; par exemple, un champ de dataset apparaît comme [ProductID]. Elles sont créées automatiquement lorsque vous faites glisser un champ d'un dataset vers une zone de texte. Un espace réservé est créé et l'expression définit la valeur sous-jacente. Vous pouvez également taper les expressions directement dans une cellule de région de données ou zone de texte sur l'aire de conception ou dans une boîte de dialogue (par exemple, [ProductID]).

Le tableau suivant répertorie des exemples d'utilisations des expressions simples. Le tableau décrit la fonctionnalité, la propriété à définir, la boîte de dialogue utilisée en général pour la définir et la valeur de la propriété. Vous pouvez taper l'expression simple directement sur l'aire de conception, dans une boîte de dialogue ou dans le volet Propriétés, ou vous pouvez la modifier dans la boîte de dialogue Expression, comme vous le feriez avec toute expression.

FonctionnalitéPropriété, contexte et boîte de dialogueValeur de propriété
Spécifier un champ de dataset à afficher dans une zone de texte.Valeur de propriété d’un espace réservé à l’intérieur d’une zone de texte. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.[Sales]
Agréger des valeurs pour un groupe.Valeur de propriété d’un espace réservé à l’intérieur d’une ligne associée à un groupe de tableau matriciel. Utilisez la boîte de dialogue Propriétés de la zone de texte.[Sum(Sales)]
Inclure un numéro de page.Valeur de propriété d’un espace réservé à l’intérieur d’une zone de texte placée dans un en-tête de page. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.[&PageNumber]
Afficher une valeur de paramètre sélectionnée.Valeur de propriété d’un espace réservé dans la zone de texte sur l’aire de conception. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.[@SalesThreshold]
Spécifier une définition de groupe pour une région de données.Expression de groupe sur le groupe de tableaux matriciels. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Général.[Category]
Exclure une valeur de champ spécifique d'une table.Équation de filtre sur le tableau matriciel. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Pour le type de données, sélectionnez Entier.

 [Quantity]

 >

 100
Inclure uniquement une valeur spécifique pour un filtre de groupe.Équation de filtre sur le groupe de tableaux matriciels. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Filtres.[Category]

 =

 Clothing
Exclure des valeurs spécifiques pour plusieurs champs d'un dataset.Équation de filtre pour un groupe dans un tableau matriciel. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.=[Color]

 <>

 Red

 =[Color]

 <>

 Blue
Spécifier l'ordre de tri selon un champ existant dans une table.Expression de tri sur le tableau matriciel. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Tri.[SizeSortOrder]
Lier un paramètre de requête à un paramètre de rapport.Collection de paramètres sur le dataset. Utilisez la boîte de dialogue Propriétés du dataset, Paramètres.[@Category]

 [@Category]
Transmettre un paramètre d'un rapport principal à un sous-rapport.Collection de paramètres sur le sous-rapport. Utilisez la boîte de dialogue Propriétés du sous-rapport, Paramètres.[@Category]

 [@Category]

Les expressions complexes peuvent contenir plusieurs références intégrées, opérateurs et appels de fonction, et apparaissent sur l'aire de conception comme <<Expr>>. Pour voir ou modifier le texte de l'expression, vous devez ouvrir la boîte de dialogue Expression ou taper directement dans le volet Propriétés. Le tableau suivant répertorie les utilisations classiques d'une expression complexe pour afficher ou organiser des données, ou modifier l'apparence du rapport, y compris la propriété à définir, la boîte de dialogue utilisée en général pour la définir et la valeur de la propriété. Vous pouvez taper une expression directement dans une boîte de dialogue, sur l'aire de conception ou dans le volet Propriétés.

FonctionnalitéPropriété, contexte et boîte de dialogueValeur de propriété
Calculer les valeurs d'agrégat pour un dataset.Valeur de propriété d’un espace réservé à l’intérieur d’une zone de texte. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.=First(Fields!Sales.Value,"DataSet1")
Concaténer du texte et des expressions dans la même zone de texte.Valeur d’un espace réservé à l’intérieur d’une zone de texte placée dans un en-tête ou un pied de page. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.="This report began processing at " & Globals!ExecutionTime
Calculer une valeur d'agrégat pour un dataset dans une étendue différente.Valeur d’un espace réservé à l’intérieur d’une zone de texte est placé dans un groupe de tableau matriciel. Utilisez la boîte de dialogue Propriétés de l'espace réservé, Général.=Max(Fields!Total.Value,"DataSet2)
Mettre en forme des données dans une zone de texte selon la valeur.Couleur d’un espace réservé à l’intérieur d’une zone de texte dans la ligne de détails d’un tableau matriciel. Utilisez la boîte de dialogue Propriétés de la zone de texte, Police.=IIF(Fields!TotalDue.Value < 10000,"Red","Black")
Calculer une valeur une fois pour s'y reporter dans tout le rapport.Valeur d’une variable d’état. Utilisez la boîte de dialogue Propriétés du rapport, Variables.=Variables!MyCalculation.Value
Inclure des valeurs spécifiques pour plusieurs champs d'un dataset.Équation de filtre pour un groupe dans un tableau matriciel. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.Pour le type de données, sélectionnez Booléen.

 =IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE)

 =

 TRUE
Masquer une zone de texte sur l'aire de conception, qui peut être activée ou désactivée par l'utilisateur à l'aide d'un paramètre booléen nommé Show.Hiddenproperty sur une zone de texte. Utilisez la boîte de dialogue Propriétés de la zone de texte, Visibilité.=Not Parameters! Afficher < paramètre booléen> .Value
Spécifier un contenu dynamique de l'en-tête de page ou du pied de page.Valeur d’un espace réservé à l’intérieur d’une zone de texte est placé dans l’en-tête ou le pied de page.="Page " & Globals!PageNumber & " of " & Globals!TotalPages
Spécifier une source de données de façon dynamique à l'aide d'un paramètre.Chaîne de connexion sur la source de données. Utilisez la boîte de dialogue Propriétés de la source de données, Général.="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks2012"
Identifier toutes les valeurs pour un paramètre à valeurs multiples choisi par l'utilisateur.Valeur d’un espace réservé à l’intérieur d’une zone de texte. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Filtres.=Join(Parameters!MyMultivalueParameter.Value,", ")
Spécifier des sauts de page toutes les 20 lignes dans un tableau matriciel sans aucun autre groupe.Expression de groupe pour un groupe dans un tableau matriciel. Utilisez la boîte de dialogue Propriétés du groupe de tableaux matriciels, Sauts de page. Sélectionnez l'option Entre chaque instance d'un groupe.=Ceiling(RowNumber(Nothing)/20)
Spécifier une visibilité conditionnelle basée sur un paramètre.Propriété Hidden pour un tableau matriciel. Utilisez la boîte de dialogue Propriétés du tableau matriciel, Visibilité.=Not Parameters!< paramètre booléen >.Value
Spécifier une date mise en forme pour une culture spécifique.Valeur d’un espace réservé à l’intérieur d’une zone de texte dans une région de données. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.=Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE"))
Concaténer une chaîne et un nombre mis en forme comme un pourcentage à deux décimales.Valeur d’un espace réservé à l’intérieur d’une zone de texte dans une région de données. Utilisez la boîte de dialogue Propriétés de la zone de texte, Général.="Growth Percent: " & Format(Fields!Growth.Value,"p2")

Expressions & #40 ; Le Générateur de rapports et SSRS & #41 ;
Exemples d’expression & #40 ; Le Générateur de rapports et SSRS & #41 ;
Paramètres de rapport & #40 ; Le Générateur de rapports et le Concepteur de rapports & #41 ;
Exemples d’équations de filtre & #40 ; Le Générateur de rapports et SSRS & #41 ;
Filtre, groupe et trier des données & #40 ; Le Générateur de rapports et SSRS & #41 ;
En-têtes et pieds de page & #40 ; Le Générateur de rapports et SSRS & #41 ;
Mise en forme du texte et des espaces réservés & #40 ; Le Générateur de rapports et SSRS & #41 ;
Masquer un élément & #40 ; Le Générateur de rapports et SSRS & #41 ;

Ajouts de la communauté

Afficher:
© 2016 Microsoft