Référence API des cartes

Cette page documente chaque classe, interface et enum publique dans la bibliothèque de graphiques PowerPortalsPro.

Composants

Les composants Blazor qui affichent les graphiques.

FluentUIChart

Un enveloppement thématique autour du composant de base Chart . Lit les couleurs des jetons de design actifs de Fluent UI, remplit automatiquement les couleurs des jeux de données à partir d’une palette dérivée de Fluent, et re-thématise le graphique lorsque l’utilisateur bascule entre le mode clair et sombre.

DataverseChart

Un composant de commodité qui enveloppe FluentUIChart et gère le cycle de vie du chargement des données. Accepte un DataverseChartDataSource, gère l’état de chargement, l’affichage des erreurs et fournit un bouton de rafraîchissement optionnel.

Types de cartes & Enums

Énumérations pour la sélection des types de cartes et le segment de dates.

ChartType

L’ensemble des types de cartes supportés par la bibliothèque Chart.js sous-jacente : Bar, Line, Pie, Doughnut, PolarArea, Radar, Bubble et Scatter.

ChartDateGrouping

Intervalles de bucketing de dates pour regrouper les colonnes de dates et heures dans les requêtes agrégées. Inclut des valeurs simples (Jour, Mois, Année) et des valeurs combinées (MoisAndAnnée, TrimestreAndAnnée, etc.) qui produisent des labels formatés comme "Jan 2024".

Modèle de données

Les classes et interfaces qui représentent les données graphiques, les points de données, le thème et les charges utiles des événements de clics.

ChartData

Regroupe les données entièrement formées nécessaires pour afficher un graphique : une liste d’étiquettes de catégories (axe X) et un ou plusieurs ensembles de données. Retourné par les méthodes sources LoadAsync de données.

ChartDataset

Représente un seul ensemble de données (série) dans un graphique. Contient des points de données, une étiquette de légende et des options de remplacement de couleur pour l’arrière-plan et la bordure.

DataPoint

Implémentation par défaut de IDataPoint. Sous-classe pour attacher le contexte défini par l’appelant (identifiant d’enregistrement, région, etc.) qui sera disponible pour les gestionnaires de clics.

DataverseDataPoint

Une implémentation qui conserve le Dataverse TableRecord sous-jacent dont IDataPoint elle a été projetée. Les gestionnaires de clics peuvent faire une correspondance de motifs sur ce type pour accéder à l’identifiant de la ligne, au nom de la table et aux valeurs de colonne.

ChartTheme

Les contours de thème et de mise en forme s’appliquaient à une instance de graphique — couleur de texte, couleur de la ligne de grille, formatage des valeurs de l’axe Y (préfixe/suffixe), titre du graphique, mode empilé et position de la légende.

ChartClickEventArgs

Charge utile décrivant un clic sur un élément de graphique unique (barre, tranche, point, etc.). Contient l’index du jeu de données, l’index des données, l’étiquette, la valeur, l’étiquette du jeu de données et l’instance originale IDataPoint pour la correspondance des motifs.

Sources de données

Des classes de source de données qui chargent les données des graphiques de Dataverse via des requêtes FetchXML.

DataverseChartDataSource

Classe source de données de base qui accepte le FetchXML brut et les correspondances de colonnes. Exécute la requête via IPowerPortalsProService, gère RelatedRecordValue le dépliage pour obtenir des résultats agrégés, et façonne les lignes en séries simples ou multiples ChartData.

AggregateDataverseChartDataSource

Une sous-classe qui construit une requête FetchXML agrégée à partir de propriétés simples (NomTable, GroupByColumn, AggregateColumn, Aggregate) au lieu de nécessiter du FetchXML brut. Prend en charge le bucketing de dates, la multi-série, le filtrage basé sur la vue, les fragments de filtre en ligne et les jointures d’entités liées.

ViewDataverseChartDataSource

Une sous-classe qui résout son FetchXML depuis une vue sauvegardée Dataverse (requête sauvegardée). L’appelant continue de définir LabelColumn et ValueColumn d’indiquer quelles colonnes correspondent aux étiquettes et aux valeurs.

ChartLinkedEntity

Décrit une entité liée (jointure) utilisée par AggregateDataverseChartDataSource pour placer un attribut groupby ou série sur une table apparentée. Prend en compte un nœud illimité via la LinkedEntity propriété pour les jointures multi-sauts (par exemple, opportunité → compte → unité métier).

Partage d’une source de données entre une grille et un graphique

A ViewDataSource peut piloter un MainGrid et un (ou plusieurs) DataverseChart composants en parfaite synchronisation. Un aller-retour serveur renvoie la page de ligne et l’agrégation du graphique de façon atomique, donc il n’y a pas de course où le graphique affiche les chiffres d’un ancien filtre alors que la grille est sur un nouveau. La recherche, le tri, la page et la vue des changements sur les deux consommateurs passent par la même source de données.

Construisons la source de données dans OnInitialized (de sorte que l’injecté IGridService soit disponible) et la transmets aux deux vues via DataSource. La grille affiche la page de ligne ; le graphique rend AggregationResults[AggregationIndex]. Plusieurs agrégations sont prises en charge — chaque entrée alimente un graphique distinct pointant vers la même source de données.

Cliquer sur une tranche de graphique définit la , de Highlightla source de données, ce qui atténue les lignes non correspondantes dans la grille appariée (et les tranches non correspondantes dans le graphique) sans re-récupérer. Cliquez à nouveau sur la même tranche pour nettoyer. Pour une navigation à travers les exercices ou un filtre rigide, réglez CrossFilterMode="ChartCrossFilterMode.None" et gérez-vous OnElementClick .