Filtrage des données dans le concepteur de rapports Web intégré Telerik

Pour qu’un rapport soit vraiment utile, vous n’avez pas besoin de toutes les données, vous avez besoin des bonnes données. Dans le concepteur de rapport Web intégré, voici comment filtrer les premières données affichées dans un rapport, puis comment filtrer les données pendant que vous consultez le rapport.

Le Progrès Telerik Concepteur de rapports Web vous permet de créer le rapport dont vous avez besoin. Lorsque le concepteur est également intégré à votre application, vous pouvez créer le rapport dont vous avez besoin dans l’application où vous en avez besoin (et le rapport vous attendra pour le visualiser lorsque vous reviendrez dans votre application). Cela doit être la définition du rapport idéal : les données dont vous avez besoin, avec les informations dont vous avez besoin, livrées là où vous en avez besoin.

Après avoir commencé à créer un rapport et y ajouter des données, vous souhaiterez contrôler les données incluses dans votre rapport. Avec Web Report Designer, vous pouvez contrôler les données qui apparaîtront dans votre rapport dans le cadre de la création du rapport.

Mais la réalité est que vous n’avez pas toujours besoin des mêmes données. Dans le monde réel, selon ce que vous faites avec l’application dans laquelle votre rapport est intégré, vous souhaiterez peut-être sélectionner les données à afficher dans votre rapport pendant que vous visualisez le rapport. Le Web Report Designer vous permet également de le faire.

Sélection des données à afficher

Dans tous les cas, pour contrôler les données affichées dans votre rapport, vous devez ajouter un filtre :

1. Dans le panneau à gauche du concepteur, passez à l’onglet Explorateur et sélectionnez la ligne du haut (ce sera le nom de votre rapport).

2. Basculez maintenant vers le panneau à droite du concepteur et développez la section Données pour afficher la propriété Filtres.

3. Cliquez sur le signe plus à droite de la propriété Filtres pour afficher la boîte de dialogue Ajouter un nouvel élément.

4. Cliquez sur les trois points à droite de la zone de texte Expression pour afficher la boîte de dialogue Modifier l’expression.

5. Dans la boîte de dialogue Modifier l’expression, dans la liste en bas à gauche, cliquez sur l’élément Champs pour afficher une liste de champs que vous pouvez utiliser pour contrôler les données qui seront affichées dans votre rapport. Double-cliquez sur le champ que vous souhaitez utiliser pour filtrer vos données (dans l’exemple, les données seront filtrées par UnitPrice).

6. Cliquez sur le bouton Enregistrer pour revenir à la boîte de dialogue Ajouter un nouvel élément. La zone de texte Expression sera remplie avec la sélection que vous avez faite dans la boîte de dialogue Modifier l’expression.

7. Sélectionnez un opérateur dans la liste déroulante Opérateur (cet exemple utilise GreaterThan).

8. Dans la zone de texte Valeur, définissez la valeur qui contrôlera les données affichées. Si vous souhaitez effectuer une comparaison avec un autre champ, vous pouvez utiliser les trois points à droite de la zone de texte Valeur pour obtenir une liste des champs que vous pouvez utiliser (cet exemple est plus simple : il limite simplement le rapport aux produits avec un prix unitaire supérieur à 5,00 $). .

Cliquez sur le bouton Enregistrer pour revenir à votre rapport. Désormais, lorsque vous affichez votre rapport, seules les lignes autorisées par votre filtre seront affichées.

Sélection interactive des données à afficher

Si vous souhaitez contrôler de manière interactive les données affichées lorsque vous affichez votre rapport, vous pouvez ajouter un paramètre de rapport à votre rapport et utiliser ce paramètre de rapport dans votre filtre. Lorsque vous consultez votre rapport, vous pouvez modifier de manière interactive la valeur de ce paramètre de rapport pour contrôler les données affichées.

Indice: Vous pouvez créer votre filtre et paramètre dans n’importe quel ordre qui vous convient. Cependant, créer d’abord le filtre vous permet de vérifier que les bonnes données sont affichées pour la valeur que vous avez définie dans le filtre. Ensuite, une fois que vous savez que votre filtre fonctionne comme vous le souhaitez, vous pouvez convertir le filtre pour utiliser un paramètre de rapport.

Pour ajouter un paramètre de rapport :

1. Passez à l’onglet Explorateur dans le panneau à gauche du concepteur et, en haut du panneau, sélectionnez la ligne du haut dans l’Explorateur (le nom de votre rapport).

2. Basculez maintenant vers le panneau à droite du concepteur et développez la section Données pour afficher la propriété Paramètres du rapport.

3. Cliquez sur le signe plus à droite de la propriété Paramètres du rapport pour afficher la boîte de dialogue Ajouter un nouvel élément.

4. Dans la boîte de dialogue Ajouter un nouvel élément, définissez la propriété Text sur une étiquette qui identifiera votre paramètre lors de l’affichage de votre rapport.

5. Sous la propriété Text, dans la liste déroulante Type, sélectionnez le type de données que vous saisirez lors du filtrage de vos données (pour UnitPrice, par exemple, vous pouvez sélectionner Integer car UnitPrice est un nombre).

6. Ensuite, dans le champ Valeur, définissez une valeur initiale à utiliser pour contrôler les données affichées lors de la première ouverture du rapport.

7. Enfin, au bas de la boîte de dialogue, cochez la case Visible pour que votre paramètre de rapport s’affiche à l’ouverture de votre rapport, ce qui vous permettra de modifier la valeur du paramètre de rapport.

Cet exemple définit le texte sur « Prix unitaire supérieur à » pour indiquer que ce paramètre de rapport sera utilisé avec le filtre UnitPrice décrit précédemment. Étant donné que UnitPrice est un champ numérique, la liste déroulante Type est définie sur Integer. La propriété Value est définie sur 5 afin que, initialement, seuls les produits dont le prix unitaire est supérieur à 5,00 $ lorsque le rapport est affiché.

Cliquez sur le bouton Enregistrer pour revenir à votre rapport.

Une fois votre paramètre de rapport créé, vous pouvez l’utiliser dans un filtre pour contrôler les données affichées à l’ouverture de votre rapport. Dans cet exemple, cela signifie modifier le filtre qui a été créé précédemment et qui a filtré les données en fonction du champ UnitPrice.

L’étape suivante consiste à modifier un filtre pour utiliser le paramètre de rapport :

1. Encore une fois, sélectionnez la ligne du haut dans l’onglet Explorateur du panneau de gauche.

2. Dans le panneau de droite, développez la section Données pour afficher la propriété Filtres.

3. Développez la propriété Filtres pour rechercher les filtres que vous avez créés.

4. Double-cliquez sur le filtre où vous souhaitez utiliser votre paramètre—la boîte de dialogue Modifier l’élément s’affiche.

5. Dans la zone de texte Valeur, cliquez sur les trois points à droite pour ouvrir la boîte de dialogue Modifier l’expression.

6. Effacer tout ce qui se trouve actuellement dans la zone de texte en haut de la boîte de dialogue

7. Dans la zone en bas à droite, cliquez sur la liste Paramètres de rapport pour rechercher le paramètre de rapport que vous avez créé. Chaque paramètre aura une valeur et une entrée d’étiquette affichées dans la liste au milieu (vous allez vouloir utiliser l’entrée de valeur).

8. Double-cliquez sur l’entrée Valeur du paramètre de rapport pour faire de votre paramètre la nouvelle valeur utilisée dans votre filtre.

Cliquez sur les boutons Enregistrer pour revenir à votre rapport.

Maintenant, lorsque vous cliquez sur le bouton Aperçu, votre rapport aura un nouveau panneau sur la droite montrant votre paramètre de rapport avec sa valeur initiale. Lorsque vous modifiez la valeur du paramètre et que vous cliquez sur le bouton Aperçu du rapport, le rapport se met à jour pour n’afficher que les données qui correspondent à la combinaison de votre filtre et de la valeur que vous avez définie dans votre paramètre de rapport.

Indice: Vraiment, devoir cliquer sur le bouton Aperçu après avoir modifié un paramètre dans le volet de filtre du rapport est une étape supplémentaire inutile. Heureusement, vous pouvez éliminer complètement le bouton Aperçu dans le panneau de filtre : lors de la définition de votre paramètre de rapport, cochez simplement la case Actualiser automatiquement dans la boîte de dialogue Modifier l’élément du paramètre. Maintenant, après avoir modifié la valeur dans le panneau de filtre du rapport, vous pouvez simplement appuyer sur la touche Tab pour que votre rapport s’affiche à nouveau en affichant les données filtrées.

Prochaines étapes

Vous pouvez, bien sûr, avoir autant de filtres et de paramètres de rapport que vous le souhaitez dans un rapport. Vous pouvez également créer les paramètres de rapport et les filtres dans l’ordre qui vous convient.

Vous pouvez également faciliter la définition des valeurs dans votre paramètre. Par exemple, il vaut la peine de regarder la propriété Valeurs disponibles dans la boîte de dialogue Ajouter de nouveaux éléments lors de la création de votre paramètre. Les valeurs disponibles vous permettent de configurer une liste déroulante de valeurs acceptables parmi lesquelles choisir lors de la définition de la valeur de votre paramètre de rapport.

Mais, peu importe ce que vous faites avec vos filtres, vous avez maintenant un rapport qui vous donne les données qui vous intéressent dans l’application où vous en avez besoin. Vous pouvez même sélectionner les données pendant que vous visualisez le rapport. C’est la définition du rapport idéal.

Prêt à tirer parti des rapports intégrés ?

Progrès Rapports Telerik fournit tous les outils dont vous avez besoin pour intégrer les rapports riches et interactifs dont vos utilisateurs ont besoin pour analyser et comprendre leurs données directement dans les applications de vos utilisateurs (y compris la possibilité pour vos utilisateurs d’exporter les résultats dans plus de 15 formats, soit pour les distribuer, soit pour les intégrer à autres outils d’analyse). Telerik Reporting vous permet ensuite d’aller plus loin et de donner à vos utilisateurs un concepteur de rapports Web entièrement fonctionnel pour créer les rapports qu’ils souhaitent sans jamais quitter les applications où ils utiliseront leurs rapports.

Vous pouvez tirer parti de ces outils faciles à utiliser à la fois dans n’importe quel environnement d’application Web côté client (HTML5/JS, Angular, React, Vue ou Blazor) et dans n’importe quelle application .NET (Web ou bureau : ASP.NET Core, ASP.NET MVC, ASP.NET AJAX, WinForms et UWP).

Si vous ne l’avez toujours pas essayé, vous pouvez commencer un essai gratuit pour regarder de plus près. Un service d’assistance renommé et une panoplie de ressources vous aideront tout au long du chemin.

Ensuite : Ajout d’en-têtes de groupe et de sous-totaux avec le concepteur de rapport Web intégré