Références à des collections de variables de rapport et de groupe (Générateur de rapports et SSRS)

  • Article

Lorsqu'un calcul complexe est utilisé plusieurs fois dans les expressions d'un rapport, vous pouvez créer une variable. Vous pouvez créer une variable de rapport ou une variable de groupe. Les noms de variable doivent être uniques dans un rapport.

[!REMARQUE]

Vous pouvez créer et modifier des définitions de rapport (.rdl) 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. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports (SSRS) sur le site Web Microsoft.

Variables de rapport

Utilisez une variable de rapport pour contenir une valeur dans le cadre de calculs qui dépendent du temps, tels que les taux de change ou horodatages, ou pour un calcul complexe référencé plusieurs fois. Par défaut, une variable de rapport est calculée une fois et peut être utilisée dans les expressions de l'ensemble d'un rapport. Les variables de rapport sont en lecture seule par défaut. Vous pouvez modifier la valeur par défaut pour permettre à une variable de rapport d'être en lecture-écriture. La valeur d'une variable de rapport est conservée tout au long d'une session, jusqu'à ce que le rapport soit traité une nouvelle fois.

Pour ajouter une variable de rapport, ouvrez la boîte de dialogue Propriétés du rapport, cliquez sur Variables, puis indiquez un nom et une valeur. Les noms sont des chaînes sensibles à la casse qui commencent par une lettre et qui ne contiennent aucun espace. Un nom peut inclure des lettres, des nombres et des traits de soulignement (_).

Pour faire référence à la variable dans une expression, utilisez la syntaxe de collection globale, par exemple, =Variables!CustomTimeStamp.Value. Sur l'aire de conception, la valeur s'affiche dans une zone de texte sous la forme <<Expr>>.

Vous pouvez utiliser les variables de rapport des manières suivantes :

  • Utilisation en lecture seule   Définissez une valeur une fois pour créer une constante pour la session de rapport, par exemple pour créer un horodatage.

    Dans la mesure où les expressions dans les zones de texte sont évaluées à la demande lorsqu'un utilisateur navigue parmi les pages d'un rapport, les valeurs dynamiques (par exemple, une expression qui inclut la fonction Now(), qui retourne l'heure du jour) peuvent retourner des valeurs différentes si vous passez à la page suivante et précédente à l'aide du bouton Précédent. En définissant la valeur d'une variable de rapport avec l'expression =Now(), puis en ajoutant la variable à votre expression, vous garantissez que la même valeur est utilisée dans l'intégralité du traitement des rapports.

  • Utilisation en lecture-écriture   Définissez une valeur une fois et sérialisez-la dans une session de rapport. L'option en lecture-écriture pour les variables fournit une meilleure alternative que l'utilisation d'une variable statique dans le bloc de code dans la définition de rapport.

    Lorsque vous effacez l'option Lecture seule pour une variable, la propriété Writable pour la variable a la valeur true. Pour mettre à jour la valeur à partir d'une expression, utilisez la méthode SetValue, par exemple =Variables!MyVariable.SetValue("123").

    [!REMARQUE]

    Vous ne pouvez pas contrôler le moment où le processeur de rapports initialise une variable ou évalue une expression qui met à jour une variable. L'ordre d'exécution pour l'initialisation d'une variable est non défini.

Pour plus d'informations sur les sessions, consultez Aperçu des rapports dans le Générateur de rapports.

Variables de groupe

Utilisez une variable de groupe pour calculer une expression complexe dans l'étendue d'un groupe. Une variable de groupe est valide uniquement dans l'étendue du groupe et ses groupes enfants.

Par exemple, supposez qu'une région de données affiche des données d'inventaire pour des éléments qui sont dans différentes catégories d'impôts et que vous souhaitez appliquer différents taux de taxe pour chaque catégorie. Vous regroupez les données en fonction de Category et définissez une variable Tax sur le groupe parent. Vous définissez une variable de groupe pour ItemTax pour chaque catégorie d'impôts et affectez chacun des différents sous-groupes Category à la variable de groupe correcte. Par exemple :

  • Pour le groupe parent basé sur [Category], affectez à la variable Tax la valeur [Tax]. Supposez que les valeurs des catégories sont Food et Clothing.

  • Pour le groupe enfant basé sur [Subcategory], affectez à la variable ItemsTax la valeur =Variables!Tax.Value * Sum(Fields!Price.Value). Supposez que les valeurs des sous-catégories pour la catégorie Food sont Beverages et Bread. Supposez que les valeurs des sous-catégories pour Clothing sont Shirts et Hats.

  • Pour une zone de texte d'une ligne située dans le groupe enfant, ajoutez l'expression =Variables!ItemsTax.Value.

    La zone de texte affiche l'impôt total pour Beverages et Bread à l'aide de l'impôt de la catégorie Food, et pour Shirts et Hats à l'aide de l'impôt de la catégorie Clothing.

Pour ajouter une variable de groupe, ouvrez la boîte de dialogue Propriétés du groupe de tableaux matriciels, cliquez sur Variables, puis indiquez un nom et une valeur. La variable de groupe est calculée une fois par valeur de groupe unique.

Pour faire référence à la variable dans une expression, utilisez la syntaxe de collection globale, par exemple =Variables!GroupDescription.Value. Sur l'aire de conception, la valeur s'affiche dans une zone de texte sous la forme <<Expr>>.

Voir aussi

Référence

Collections intégrées dans les expressions (Générateur de rapports et SSRS)

Exemples d'expressions (Générateur de rapports et SSRS)

Concepts

Filtrer, regrouper et trier des données (Générateur de rapports et SSRS)