Chart-API-Referenz

Diese Seite dokumentiert jede öffentliche Klasse, Schnittstelle und jedes Enum in der PowerPortalsPro-Charting-Bibliothek.

Komponenten

Die Blazor-Komponenten, die Diagramme rendern.

FluentUIChart

Ein thematisches Wrapper um die Basiskomponente Chart . Liest Farben aus den aktiven Fluent-UI-Designtokens, füllt die Farben des Datensatzes automatisch aus einer von Fluent abgeleiteten Palette aus und gestaltet das Diagramm neu, wenn der Benutzer zwischen Hell- und Dunkelmodus wechselt.

Reagieren Blazor

FluentUIChart Baureihe

Parameter

Name
Typ
Default
Beschreibung
DatasetsList<ChartDataset>
Erhält oder setzt die Datensätze zum Plotten. Jeder Datensatz, der verlässt ChartDataset.BackgroundColor oder ChartDataset.BorderColor null wird automatisch aus der aktiven Fluent-Palette gefüllt.
EnableAnimationbool
True
Ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig.
Heightstring?
400px
Erhält oder setzt die optionale CSS-Höhe, die auf den Chart-Container angewendet wird. Standardmäßig steht 400px.
LabelsList<string>
Erhält oder setzt die Kategorielabels, die entlang der Hauptachse des Diagramms gerendert werden.
LegendPositionChartLegendPosition?
Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, ist Chart.js Standard (ChartLegendPosition.Top) wird verwendet.
OrientationChartOrientation?
Diagrammorientierung. Wenn ChartOrientation.Horizontal, erscheinen Kategorien auf der Y-Achse und Werte auf der X-Achse. Funnel-Diagramme sind standardmäßig horizontal für einen Top-Down-Funnel. Wenn null, wird der Standard für den Diagrammtyp verwendet.
ShowBorderbool
True
Ob man das Diagramm in einen thematischen Rand mit abgerundeten Ecken wickelt. Standardmäßig steht richtig.
Stackedbool
False
Ob man Datensätze übereinander stapeln sollte und nicht nebeneinander. Gilt für Balken- und Liniendiagramme.
Titlestring?
Der Charttitel wird über dem Diagramm angezeigt. Wenn null, wird kein Titel angezeigt.
TypeChartType
Bar
Erhält oder setzt den Diagrammtyp so, dass er rendert (zum Beispiel ChartType.Bar, ChartType.Line, ChartType.Pie, ChartType.Doughnut).
Widthstring?
Erhält oder setzt die optionale CSS-Breite, die auf den Chartcontainer angewendet wird.
XAxisPrefixstring?
Optionale Zeichenkette, die jedem X-Achsen-Tick-Label vorangestellt wird.
XAxisSuffixstring?
Optionale Zeichenkette, die jedem X-Achsen-Tick-Label hinzugefügt wird.
YAxisPrefixstring?
Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert vorangebracht wird (zum Beispiel '$' für Währung).
YAxisSuffixstring?
Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert angehängt wird (zum Beispiel '%' für Prozentsätze).
Name: Datasets
Typ: List<ChartDataset>
Beschreibung: Erhält oder setzt die Datensätze zum Plotten. Jeder Datensatz, der verlässt ChartDataset.BackgroundColor oder ChartDataset.BorderColor null wird automatisch aus der aktiven Fluent-Palette gefüllt.
Name: EnableAnimation
Typ: bool
Default: True
Beschreibung: Ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig.
Name: Height
Typ: string?
Default: 400px
Beschreibung: Erhält oder setzt die optionale CSS-Höhe, die auf den Chart-Container angewendet wird. Standardmäßig steht 400px.
Name: Labels
Typ: List<string>
Beschreibung: Erhält oder setzt die Kategorielabels, die entlang der Hauptachse des Diagramms gerendert werden.
Name: LegendPosition
Typ: ChartLegendPosition?
Beschreibung: Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, ist Chart.js Standard (ChartLegendPosition.Top) wird verwendet.
Name: Orientation
Typ: ChartOrientation?
Beschreibung: Diagrammorientierung. Wenn ChartOrientation.Horizontal, erscheinen Kategorien auf der Y-Achse und Werte auf der X-Achse. Funnel-Diagramme sind standardmäßig horizontal für einen Top-Down-Funnel. Wenn null, wird der Standard für den Diagrammtyp verwendet.
Name: ShowBorder
Typ: bool
Default: True
Beschreibung: Ob man das Diagramm in einen thematischen Rand mit abgerundeten Ecken wickelt. Standardmäßig steht richtig.
Name: Stacked
Typ: bool
Default: False
Beschreibung: Ob man Datensätze übereinander stapeln sollte und nicht nebeneinander. Gilt für Balken- und Liniendiagramme.
Name: Title
Typ: string?
Beschreibung: Der Charttitel wird über dem Diagramm angezeigt. Wenn null, wird kein Titel angezeigt.
Name: Type
Typ: ChartType
Default: Bar
Beschreibung: Erhält oder setzt den Diagrammtyp so, dass er rendert (zum Beispiel ChartType.Bar, ChartType.Line, ChartType.Pie, ChartType.Doughnut).
Name: Width
Typ: string?
Beschreibung: Erhält oder setzt die optionale CSS-Breite, die auf den Chartcontainer angewendet wird.
Name: XAxisPrefix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem X-Achsen-Tick-Label vorangestellt wird.
Name: XAxisSuffix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem X-Achsen-Tick-Label hinzugefügt wird.
Name: YAxisPrefix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert vorangebracht wird (zum Beispiel '$' für Währung).
Name: YAxisSuffix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert angehängt wird (zum Beispiel '%' für Prozentsätze).

Veranstaltungen

Name
Typ
Beschreibung
OnElementClickEventCallback<ChartClickEventArgs>
Erhöht, wenn der Benutzer auf ein gerendertes Diagrammelement klickt (eine Leiste, einen Schnitt, einen Punkt usw.). Weitergeleitet auf das zugrundeliegende Components.ChartKonto; Klicks auf den Diagrammhintergrund werden ignoriert.
Name: OnElementClick
Typ: EventCallback<ChartClickEventArgs>
Beschreibung: Erhöht, wenn der Benutzer auf ein gerendertes Diagrammelement klickt (eine Leiste, einen Schnitt, einen Punkt usw.). Weitergeleitet auf das zugrundeliegende Components.ChartKonto; Klicks auf den Diagrammhintergrund werden ignoriert.

Methoden

Name
Parameter
Typ
Beschreibung
ExportAsImageAsyncTask<string>
Exportiert das aktuelle Diagramm als PNG-Bild und gibt die Daten als Base64-codierte Daten zurück data-URI (z. B. 'data:image/png; base64,...').Gibt null zurück, wenn das Diagramm wurde noch nicht gerendert.
Name: ExportAsImageAsync
Typ: Task<string>
Beschreibung: Exportiert das aktuelle Diagramm als PNG-Bild und gibt die Daten als Base64-codierte Daten zurück data-URI (z. B. 'data:image/png; base64,...').Gibt null zurück, wenn das Diagramm wurde noch nicht gerendert.

DataverseChart

Eine Convenience-Komponente, die den Datenladezyklus umwickelt FluentUIChart und besitzt. Akzeptiert einen DataverseChartDataSource, verwaltet den Ladezustand und die Fehleranzeige und bietet optional eine Aktualisierungstaste.

Reagieren Blazor

DataverseChart Baureihe

Parameter

Name
Typ
Default
Beschreibung
AggregationIndexint
0
Welcher Eintrag in ViewDataSource.AggregationResults zum Rendern. Standardmäßig steht 0. Lässt eine Datenquelle konfiguriert werden mit mehreren Aggregationen treiben mehrere Diagramme an (eine pro metrisch). Ignoriert wird, wenn DataverseChart.Source es stattdessen verwendet wird.
CrossFilterModeChartCrossFilterMode
Highlight
Slice-Click-Verhalten, wenn ein DataverseChart.DataSource bereitgestellt wird. Standardmäßig steht auf ChartCrossFilterMode.Highlight — weich Kreuzfilter, der den abgestimmten Schnitt betont und das Geschwister dimmt Nicht übereinstimmende Zeilen ohne erneutes Abrufen. Die vom Verbraucher bereitgestellten DataverseChart.OnElementClick feuert weiterhin nebeneinander, für geschichtet Telemetrie / Drill-Through-Verhalten. Ignoriert, wenn DataverseChart.Source wird verwendet.
DataSourceViewDataSource?
Geteilte Instanz Data.ViewDataSource (typischerweise auch fuhr ein gepaartes <MainGrid>). Gegenseitig ausschließend mit DataverseChart.Source. Das Diagramm liest seine Daten reaktiv aus aus und ViewDataSource.AggregationResults Sendet den Zustand Cross-Filter auf Slice Clicks per DataverseChart.CrossFilterMode. Dann ein Server-Roundtrip behält die Zeilenseite des Rasters und die Aggregation der Grafik atomar Konsistent.
DefaultViewIdGuid?
Optionale Standard-Ansichts-ID zum Vorauswählen im Ansichts-Dropdown. Wenn nicht gesetzt, der erste Ansicht in DataverseChart.ViewIds (oder die Standardansicht der Tabelle) ausgewählt ist.
EnableAnimationbool
True
Ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig.
Heightstring?
400px
Optionale CSS-Höhe wurde auf die gesamte Komponente angewendet (einschließlich des View-Selectors) Dropdown und thematisch Rand, wenn gezeigt). Das interne Horoskop füllt den beliebigen Raum bleibt nach der Symbolleiste und dem Selektor. Standardmäßig steht 400px.
LegendPositionChartLegendPosition?
Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, ist Chart.js Standard (ChartLegendPosition.Top) wird verwendet.
OrientationChartOrientation?
Diagrammorientierung. Funnel-Diagramme werden standardmäßig auf ChartOrientation.Horizontal für einen Top-Down-Trichter. Wenn null, wird der Standard für den Diagrammtyp verwendet.
ShowBorderbool
True
Ob man das Diagramm in einen thematischen Rand mit abgerundeten Ecken wickelt. Standardmäßig steht richtig.
ShowExportButtonbool
True
Ob ein Download-Button angezeigt werden soll, der das Diagramm als PNG-Bild exportiert. Standardmäßig steht richtig.
ShowRefreshButtonbool
True
Ob ein Aktualisierungsbutton oben rechts in der Grafik angezeigt werden soll. Standardmäßig steht richtig.
SourceDataverseChartDataSource?
Eigenständige, kursbasierte Datenquelle. Gegenseitig ausschließend mit DataverseChart.DataSource — genau eines von beiden muss geliefert. Mit DataverseChart.Source, besitzt diese Komponente die Laden + aktualisieren Lebenszyklus und Dispatches durch Services.IChartService direkt. Verwenden, wenn ein Horoskop seine Eigenschaft besitzt Own Fetch (kein gepaartes Raster).
Stackedbool
False
Ob man Datensätze übereinander stapeln sollte und nicht nebeneinander.
Titlestring?
Der Charttitel wird über dem Diagramm angezeigt. Wenn null, wird kein Titel angezeigt.
TypeChartType
Bar
Der Diagrammtyp zum Rendern.
ViewIdsList<Guid>?
Optionale Liste von Dataverse-Ansichts-IDs, die in einem Dropdown-Menü über der Grafik angezeigt werden. Wenn die Der Benutzer wählt eine Ansicht aus, deren Filterbedingungen in die Datenquelle und das Diagramm integriert werden lädt nach. Arbeitet mit Components.AggregateDataverseChartDataSource und Components.ViewDataverseChartDataSource.
Widthstring?
Optionale CSS-Breite wird auf den Chart-Container angewendet.
XAxisPrefixstring?
Optionale Zeichenkette, die jedem X-Achsen-Tick-Label vorangestellt wird.
XAxisSuffixstring?
Optionale Zeichenkette, die jedem X-Achsen-Tick-Label hinzugefügt wird.
YAxisPrefixstring?
Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert (z. B. '$') vorangestellt wird.
YAxisSuffixstring?
Optionaler String, der an jedes Y-Achsen-Tick-Label und jeden Tooltip-Wert angehängt wird (z. B. '%').
Name: AggregationIndex
Typ: int
Default: 0
Beschreibung: Welcher Eintrag in ViewDataSource.AggregationResults zum Rendern. Standardmäßig steht 0. Lässt eine Datenquelle konfiguriert werden mit mehreren Aggregationen treiben mehrere Diagramme an (eine pro metrisch). Ignoriert wird, wenn DataverseChart.Source es stattdessen verwendet wird.
Name: CrossFilterMode
Typ: ChartCrossFilterMode
Default: Highlight
Beschreibung: Slice-Click-Verhalten, wenn ein DataverseChart.DataSource bereitgestellt wird. Standardmäßig steht auf ChartCrossFilterMode.Highlight — weich Kreuzfilter, der den abgestimmten Schnitt betont und das Geschwister dimmt Nicht übereinstimmende Zeilen ohne erneutes Abrufen. Die vom Verbraucher bereitgestellten DataverseChart.OnElementClick feuert weiterhin nebeneinander, für geschichtet Telemetrie / Drill-Through-Verhalten. Ignoriert, wenn DataverseChart.Source wird verwendet.
Name: DataSource
Typ: ViewDataSource?
Beschreibung: Geteilte Instanz Data.ViewDataSource (typischerweise auch fuhr ein gepaartes <MainGrid>). Gegenseitig ausschließend mit DataverseChart.Source. Das Diagramm liest seine Daten reaktiv aus aus und ViewDataSource.AggregationResults Sendet den Zustand Cross-Filter auf Slice Clicks per DataverseChart.CrossFilterMode. Dann ein Server-Roundtrip behält die Zeilenseite des Rasters und die Aggregation der Grafik atomar Konsistent.
Name: DefaultViewId
Typ: Guid?
Beschreibung: Optionale Standard-Ansichts-ID zum Vorauswählen im Ansichts-Dropdown. Wenn nicht gesetzt, der erste Ansicht in DataverseChart.ViewIds (oder die Standardansicht der Tabelle) ausgewählt ist.
Name: EnableAnimation
Typ: bool
Default: True
Beschreibung: Ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig.
Name: Height
Typ: string?
Default: 400px
Beschreibung: Optionale CSS-Höhe wurde auf die gesamte Komponente angewendet (einschließlich des View-Selectors) Dropdown und thematisch Rand, wenn gezeigt). Das interne Horoskop füllt den beliebigen Raum bleibt nach der Symbolleiste und dem Selektor. Standardmäßig steht 400px.
Name: LegendPosition
Typ: ChartLegendPosition?
Beschreibung: Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, ist Chart.js Standard (ChartLegendPosition.Top) wird verwendet.
Name: Orientation
Typ: ChartOrientation?
Beschreibung: Diagrammorientierung. Funnel-Diagramme werden standardmäßig auf ChartOrientation.Horizontal für einen Top-Down-Trichter. Wenn null, wird der Standard für den Diagrammtyp verwendet.
Name: ShowBorder
Typ: bool
Default: True
Beschreibung: Ob man das Diagramm in einen thematischen Rand mit abgerundeten Ecken wickelt. Standardmäßig steht richtig.
Name: ShowExportButton
Typ: bool
Default: True
Beschreibung: Ob ein Download-Button angezeigt werden soll, der das Diagramm als PNG-Bild exportiert. Standardmäßig steht richtig.
Name: ShowRefreshButton
Typ: bool
Default: True
Beschreibung: Ob ein Aktualisierungsbutton oben rechts in der Grafik angezeigt werden soll. Standardmäßig steht richtig.
Name: Source
Typ: DataverseChartDataSource?
Beschreibung: Eigenständige, kursbasierte Datenquelle. Gegenseitig ausschließend mit DataverseChart.DataSource — genau eines von beiden muss geliefert. Mit DataverseChart.Source, besitzt diese Komponente die Laden + aktualisieren Lebenszyklus und Dispatches durch Services.IChartService direkt. Verwenden, wenn ein Horoskop seine Eigenschaft besitzt Own Fetch (kein gepaartes Raster).
Name: Stacked
Typ: bool
Default: False
Beschreibung: Ob man Datensätze übereinander stapeln sollte und nicht nebeneinander.
Name: Title
Typ: string?
Beschreibung: Der Charttitel wird über dem Diagramm angezeigt. Wenn null, wird kein Titel angezeigt.
Name: Type
Typ: ChartType
Default: Bar
Beschreibung: Der Diagrammtyp zum Rendern.
Name: ViewIds
Typ: List<Guid>?
Beschreibung: Optionale Liste von Dataverse-Ansichts-IDs, die in einem Dropdown-Menü über der Grafik angezeigt werden. Wenn die Der Benutzer wählt eine Ansicht aus, deren Filterbedingungen in die Datenquelle und das Diagramm integriert werden lädt nach. Arbeitet mit Components.AggregateDataverseChartDataSource und Components.ViewDataverseChartDataSource.
Name: Width
Typ: string?
Beschreibung: Optionale CSS-Breite wird auf den Chart-Container angewendet.
Name: XAxisPrefix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem X-Achsen-Tick-Label vorangestellt wird.
Name: XAxisSuffix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem X-Achsen-Tick-Label hinzugefügt wird.
Name: YAxisPrefix
Typ: string?
Beschreibung: Optionale Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert (z. B. '$') vorangestellt wird.
Name: YAxisSuffix
Typ: string?
Beschreibung: Optionaler String, der an jedes Y-Achsen-Tick-Label und jeden Tooltip-Wert angehängt wird (z. B. '%').

Veranstaltungen

Name
Typ
Beschreibung
OnElementClickEventCallback<ChartClickEventArgs>
Erhöht, wenn der Nutzer auf ein gerendertes Diagrammelement klickt.
Name: OnElementClick
Typ: EventCallback<ChartClickEventArgs>
Beschreibung: Erhöht, wenn der Nutzer auf ein gerendertes Diagrammelement klickt.

Kartentypen & Enums

Aufzählungen für die Auswahl des Diagrammtyps und die Datumsverteilung.

ChartType

Die Menge der Diagrammtypen, die von der zugrundeliegenden Chart.js Bibliothek unterstützt werden: Bar, Line, Pie, Donut, PolarArea, Radar, Bubble und Scatter.

Reagieren Blazor

ChartType Enum

Values

Name
Value
Beschreibung
Bar0
Vertikales Balkendiagramm (Chart.js 'Balken').
Line1
Liniendiagramm (Chart.js 'Linie').
Pie2
Tortendiagramm (Chart.js 'Kuchen').
Doughnut3
Donut-Diagramm (Chart.js 'Donut').
PolarArea4
Polarflächendiagramm (Chart.js 'polarArea').
Radar5
Radarkarte (Chart.js 'Radar').
Bubble6
Blasendiagramm (Chart.js 'Blase').
Scatter7
Streudiagramm (Chart.js 'Streuung').
Funnel8
Funnel-Diagramm (über chartjs-chart-funnel-Plugin, tippen Sie 'funnel').
Name: Bar
Value: 0
Beschreibung: Vertikales Balkendiagramm (Chart.js 'Balken').
Name: Line
Value: 1
Beschreibung: Liniendiagramm (Chart.js 'Linie').
Name: Pie
Value: 2
Beschreibung: Tortendiagramm (Chart.js 'Kuchen').
Name: Doughnut
Value: 3
Beschreibung: Donut-Diagramm (Chart.js 'Donut').
Name: PolarArea
Value: 4
Beschreibung: Polarflächendiagramm (Chart.js 'polarArea').
Name: Radar
Value: 5
Beschreibung: Radarkarte (Chart.js 'Radar').
Name: Bubble
Value: 6
Beschreibung: Blasendiagramm (Chart.js 'Blase').
Name: Scatter
Value: 7
Beschreibung: Streudiagramm (Chart.js 'Streuung').
Name: Funnel
Value: 8
Beschreibung: Funnel-Diagramm (über chartjs-chart-funnel-Plugin, tippen Sie 'funnel').

ChartDateGrouping

Datums-Bucket-Intervalle zur Gruppierung von Datumszeit-Spalten in aggregierten Abfragen. Enthält einfache Werte (Tag, Monat, Jahr) und kombinierte Werte (MonthAndYear, QuarterAndYear usw.), die formatierte Labels wie "Jan 2024". erzeugen.

Reagieren Blazor

ChartDateGrouping Enum

Values

Name
Value
Beschreibung
None0
Keine Datumsgruppierung – die Spalte ist nach ihrem Rohwert gruppiert.
Day1
Gruppieren nach Tag (Dategrouping='Tag'). Etikett: Tagesnummer.
Week2
Gruppieren nach ISO-Woche (Dategrouping='Woche'). Etikett: Wochennummer.
Month3
Gruppieren nach Kalendermonat (Dategrouping='Monat'). Etikett: abgekürzter Monatsname (Jan, Feb, ...) in der heutigen Kultur.
Quarter4
Gruppieren nach Kalenderquartal (Datumsgruppierung='Quartal'). Etikett: Viertelnummer.
Year5
Gruppieren nach Kalenderjahr (Datumsgruppierung='Jahr'). Etikett: Jahr.
MonthAndYear6
Gruppieren nach Monat + Jahr. Etikett: 'Jan 2024'.
DayAndMonth7
Gruppe nach Tag + Monat. Etikett: '15. Jan'.
DayAndMonthAndYear8
Gruppieren nach Tag + Monat + Jahr. Etikett: '15. Jan 2024'.
WeekAndYear9
Gruppiert nach ISO Woche + Jahr. Label: 'W15 2024'.
QuarterAndYear10
Gruppe nach Quartal + Jahr. Etikett: 'Q1 2024'.
Name: None
Value: 0
Beschreibung: Keine Datumsgruppierung – die Spalte ist nach ihrem Rohwert gruppiert.
Name: Day
Value: 1
Beschreibung: Gruppieren nach Tag (Dategrouping='Tag'). Etikett: Tagesnummer.
Name: Week
Value: 2
Beschreibung: Gruppieren nach ISO-Woche (Dategrouping='Woche'). Etikett: Wochennummer.
Name: Month
Value: 3
Beschreibung: Gruppieren nach Kalendermonat (Dategrouping='Monat'). Etikett: abgekürzter Monatsname (Jan, Feb, ...) in der heutigen Kultur.
Name: Quarter
Value: 4
Beschreibung: Gruppieren nach Kalenderquartal (Datumsgruppierung='Quartal'). Etikett: Viertelnummer.
Name: Year
Value: 5
Beschreibung: Gruppieren nach Kalenderjahr (Datumsgruppierung='Jahr'). Etikett: Jahr.
Name: MonthAndYear
Value: 6
Beschreibung: Gruppieren nach Monat + Jahr. Etikett: 'Jan 2024'.
Name: DayAndMonth
Value: 7
Beschreibung: Gruppe nach Tag + Monat. Etikett: '15. Jan'.
Name: DayAndMonthAndYear
Value: 8
Beschreibung: Gruppieren nach Tag + Monat + Jahr. Etikett: '15. Jan 2024'.
Name: WeekAndYear
Value: 9
Beschreibung: Gruppiert nach ISO Woche + Jahr. Label: 'W15 2024'.
Name: QuarterAndYear
Value: 10
Beschreibung: Gruppe nach Quartal + Jahr. Etikett: 'Q1 2024'.

Datenmodell

Die Klassen und Schnittstellen, die Diagrammdaten, Datenpunkte, Theming und Klick-Event-Payloads darstellen.

ChartData

Bündelt die vollständig geformten Daten, die zur Darstellung eines Diagramms benötigt werden: eine Liste von Kategorielabels (X-Achse) und ein oder mehrere Datensätze. Zurückgegeben von Datenquellenmethoden LoadAsync .

ChartData Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
DatasetsList<ChartDataset>
Datensätze zum Plotten. Jedes Datensatz ChartDataset.Data Die Länge sollte übereinstimmen ChartData.Labels; fehlende Eimer sind vom Server nullgefüllt, sodass die Positionsausrichtung erhalten bleibt über verschiedene Serien hinweg.
LabelsList<string>
Kategorienlabels entlang der Hauptachse gerendert.
Name: Datasets
Typ: List<ChartDataset>
Beschreibung: Datensätze zum Plotten. Jedes Datensatz ChartDataset.Data Die Länge sollte übereinstimmen ChartData.Labels; fehlende Eimer sind vom Server nullgefüllt, sodass die Positionsausrichtung erhalten bleibt über verschiedene Serien hinweg.
Name: Labels
Typ: List<string>
Beschreibung: Kategorienlabels entlang der Hauptachse gerendert.

ChartDataset

Repräsentiert einen einzelnen Datensatz (Serie) in einem Diagramm. Enthält Datenpunkte, ein Legendenlabel und optionale Farbüberschreibungen für Hintergrund und Rand.

ChartDataset Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
BackgroundColorstring?
Standard-Hintergrundfarbe für jedes Element in diesem Datensatz für Kartesische Horoskoptypen. Für Radialkartentypen pro Punkt DataPoint.BackgroundColor Overrides gewinnen. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem aktiven Fließende Farbpalette.
BorderColorstring?
Standard-Randfarbe. Gleiche Präzedenzsemantik wie ChartDataset.BackgroundColor.
BorderWidthdouble
1
Elementränderbreite in Pixeln. Fraktionelle Werte werden unterstützt (z. B. 0,5 für Haargrenze bei hoch-DPI-Displays). Standardmäßig geht es auf 1.
DataList<DataPoint>
Datenpunkte in diesem Datensatz. Die Elemente sind Models.DataPoint oder eine Unterklasse (Models.DataverseDataPoint wenn die Datenquelle wird von Dataverse unterstützt). Der polymorphe '$type'-Diskriminator ist erhalten durch JSON.
Labelstring
Legendenbezeichnung für diesen Datensatz (z. B. 'Sales' oder 'Won').
Name: BackgroundColor
Typ: string?
Beschreibung: Standard-Hintergrundfarbe für jedes Element in diesem Datensatz für Kartesische Horoskoptypen. Für Radialkartentypen pro Punkt DataPoint.BackgroundColor Overrides gewinnen. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem aktiven Fließende Farbpalette.
Name: BorderColor
Typ: string?
Beschreibung: Standard-Randfarbe. Gleiche Präzedenzsemantik wie ChartDataset.BackgroundColor.
Name: BorderWidth
Typ: double
Default: 1
Beschreibung: Elementränderbreite in Pixeln. Fraktionelle Werte werden unterstützt (z. B. 0,5 für Haargrenze bei hoch-DPI-Displays). Standardmäßig geht es auf 1.
Name: Data
Typ: List<DataPoint>
Beschreibung: Datenpunkte in diesem Datensatz. Die Elemente sind Models.DataPoint oder eine Unterklasse (Models.DataverseDataPoint wenn die Datenquelle wird von Dataverse unterstützt). Der polymorphe '$type'-Diskriminator ist erhalten durch JSON.
Name: Label
Typ: string
Beschreibung: Legendenbezeichnung für diesen Datensatz (z. B. 'Sales' oder 'Won').

DataPoint

Standardimplementierung von IDataPoint. Unterklasse, um aufruferdefinierten Kontext (Datensatz-ID, Region usw.) anzuhängen, der für Klick-Handler verfügbar sein wird.

DataPoint Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
BackgroundColorstring?
Punkt-Hintergrundfarbe. Verwendet von radialen Diagrammtypen (Pie, Donut, polarArea), um einzelne Segmente deutlich zu färben. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem Aktive Palette.
BorderColorstring?
Randfarbe pro Punkt. Gleiche Semantik wie DataPoint.BackgroundColor.
Valuedouble
0
Der numerische Wert, der von Chart.js dargestellt wird.
Name: BackgroundColor
Typ: string?
Beschreibung: Punkt-Hintergrundfarbe. Verwendet von radialen Diagrammtypen (Pie, Donut, polarArea), um einzelne Segmente deutlich zu färben. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem Aktive Palette.
Name: BorderColor
Typ: string?
Beschreibung: Randfarbe pro Punkt. Gleiche Semantik wie DataPoint.BackgroundColor.
Name: Value
Typ: double
Default: 0
Beschreibung: Der numerische Wert, der von Chart.js dargestellt wird.

DataverseDataPoint

Eine Implementierung, die das zugrundeliegende Dataverse TableRecord beibehält, von dem IDataPoint sie projiziert wurde. Klickhandler können bei diesem Typ ein Muster abgleichen, um auf die ID, den Tabellennamen und die Spaltenwerte der Zeile zuzugreifen.

DataverseDataPoint Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
BackgroundColorstring?
Punkt-Hintergrundfarbe. Verwendet von radialen Diagrammtypen (Pie, Donut, polarArea), um einzelne Segmente deutlich zu färben. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem Aktive Palette.
BorderColorstring?
Randfarbe pro Punkt. Gleiche Semantik wie DataPoint.BackgroundColor.
RecordTableRecord?
Die Dataverse-Zeile, aus der dieser Datenpunkt projiziert wurde. Nullierbar Weil Null-gefüllte Eimer in einem Mehrserien-Pivot kein Ursprüngliche Aufnahme.
Valuedouble
0
Der numerische Wert, der von Chart.js dargestellt wird.
Name: BackgroundColor
Typ: string?
Beschreibung: Punkt-Hintergrundfarbe. Verwendet von radialen Diagrammtypen (Pie, Donut, polarArea), um einzelne Segmente deutlich zu färben. Wenn null, füllt sich der FluentUIChart-Wrapper automatisch aus dem Aktive Palette.
Name: BorderColor
Typ: string?
Beschreibung: Randfarbe pro Punkt. Gleiche Semantik wie DataPoint.BackgroundColor.
Name: Record
Typ: TableRecord?
Beschreibung: Die Dataverse-Zeile, aus der dieser Datenpunkt projiziert wurde. Nullierbar Weil Null-gefüllte Eimer in einem Mehrserien-Pivot kein Ursprüngliche Aufnahme.
Name: Value
Typ: double
Default: 0
Beschreibung: Der numerische Wert, der von Chart.js dargestellt wird.

ChartTheme

Themen- und Formatierungsüberschreibungen, die auf eine Karteninstanz angewendet werden – Textfarbe, Gitterlinienfarbe, Y-Achsen-Wertformatierung (Präfix/Suffix), Diagrammtitel, gestapelter Modus und Legendenposition.

Reagieren Blazor

ChartTheme Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
EnableAnimationbool
True
Bekommt oder bestimmt, ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig. Auf falsch setzen, um alle Eingabe- und Aktualisierungsanimationen zu deaktivieren.
GridColorstring?
Erhält oder setzt die Farbe, die für Achsengitterlinien und Ränder verwendet wird.
IndexAxisChartIndexAxis?
Die Chart.js Kategorie-Achse-Richtung. Gesetzt von der Komponentenschicht aus dem Aufrufer Components.ChartOrientation via Components.ChartOrientation); Konsumenten sollten die Orientierung auf die Komponente setzen statt auf diese Eigenschaft direkt. Wenn null, wendet die JS-Schicht eine charttypspezifische Standardeinstellung an. Das Enum Der Wert wird zur Zeit der JSON-Serialisierung in die Kleinbuchstaben Chart.js String umgewandelt (siehe Components.ChartIndexAxis).
LegendPositionChartLegendPosition?
Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, wird Chart.js's Standard verwendet. Der Enumwert ist zur Zeit der JSON-Serialisierung in den kleinen Chart.js-String umgewandelt (siehe Components.ChartLegendPosition).
Stackedbool
False
Bekommt oder bestimmt, ob die X- und Y-Achse gestapelt sind. Wenn zutreffend, werden Datensätze darauf gestapelt voneinander, statt nebeneinander dargestellt zu werden. Gilt für Balken- und Liniendiagramme.
TextColorstring?
Erhält oder setzt die Farbe, die für Standardtext, Legendenbeschriftungen, Achsenkreuze und Titel verwendet wird.
Titlestring?
Erhält oder setzt den Diagrammtitel, der über dem Diagramm angezeigt wird. Wenn null, wird kein Titel angezeigt.
XAxisPrefixstring?
Erhält oder setzt eine Zeichenkette, die jedem X-Achsen-Tick-Label zugeordnet wird (zum Beispiel 'Q' für Vierteldollar). Wenn null, wird kein Präfix verwendet.
XAxisSuffixstring?
Erhält oder setzt eine Zeichenkette, die jedem X-Achsen-Tick-Label angehängt wird. Wenn null, wird kein Suffix verwendet.
YAxisPrefixstring?
Erhält oder setzt eine Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert zugeordnet ist (zum Beispiel '$' für Währung). Wenn null, wird kein Präfix verwendet.
YAxisSuffixstring?
Erhält oder setzt eine Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert angehängt wird. (zum Beispiel '%' für Prozentsätze). Wenn null, wird kein Suffix verwendet.
Name: EnableAnimation
Typ: bool
Default: True
Beschreibung: Bekommt oder bestimmt, ob Diagrammanimationen aktiviert sind. Standardmäßig steht richtig. Auf falsch setzen, um alle Eingabe- und Aktualisierungsanimationen zu deaktivieren.
Name: GridColor
Typ: string?
Beschreibung: Erhält oder setzt die Farbe, die für Achsengitterlinien und Ränder verwendet wird.
Name: IndexAxis
Typ: ChartIndexAxis?
Beschreibung: Die Chart.js Kategorie-Achse-Richtung. Gesetzt von der Komponentenschicht aus dem Aufrufer Components.ChartOrientation via Components.ChartOrientation); Konsumenten sollten die Orientierung auf die Komponente setzen statt auf diese Eigenschaft direkt. Wenn null, wendet die JS-Schicht eine charttypspezifische Standardeinstellung an. Das Enum Der Wert wird zur Zeit der JSON-Serialisierung in die Kleinbuchstaben Chart.js String umgewandelt (siehe Components.ChartIndexAxis).
Name: LegendPosition
Typ: ChartLegendPosition?
Beschreibung: Legendenplatzierung relativ zum Kartenbereich, oder ChartLegendPosition.Hidden um es ganz zu verbergen. Wenn null, wird Chart.js's Standard verwendet. Der Enumwert ist zur Zeit der JSON-Serialisierung in den kleinen Chart.js-String umgewandelt (siehe Components.ChartLegendPosition).
Name: Stacked
Typ: bool
Default: False
Beschreibung: Bekommt oder bestimmt, ob die X- und Y-Achse gestapelt sind. Wenn zutreffend, werden Datensätze darauf gestapelt voneinander, statt nebeneinander dargestellt zu werden. Gilt für Balken- und Liniendiagramme.
Name: TextColor
Typ: string?
Beschreibung: Erhält oder setzt die Farbe, die für Standardtext, Legendenbeschriftungen, Achsenkreuze und Titel verwendet wird.
Name: Title
Typ: string?
Beschreibung: Erhält oder setzt den Diagrammtitel, der über dem Diagramm angezeigt wird. Wenn null, wird kein Titel angezeigt.
Name: XAxisPrefix
Typ: string?
Beschreibung: Erhält oder setzt eine Zeichenkette, die jedem X-Achsen-Tick-Label zugeordnet wird (zum Beispiel 'Q' für Vierteldollar). Wenn null, wird kein Präfix verwendet.
Name: XAxisSuffix
Typ: string?
Beschreibung: Erhält oder setzt eine Zeichenkette, die jedem X-Achsen-Tick-Label angehängt wird. Wenn null, wird kein Suffix verwendet.
Name: YAxisPrefix
Typ: string?
Beschreibung: Erhält oder setzt eine Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert zugeordnet ist (zum Beispiel '$' für Währung). Wenn null, wird kein Präfix verwendet.
Name: YAxisSuffix
Typ: string?
Beschreibung: Erhält oder setzt eine Zeichenkette, die jedem Y-Achsen-Tick-Label und Tooltip-Wert angehängt wird. (zum Beispiel '%' für Prozentsätze). Wenn null, wird kein Suffix verwendet.

ChartClickEventArgs

Nutzlast, die einen Klick auf ein einzelnes Diagrammelement (Balken, Slice, Punkt usw.) beschreibt. Enthält den Dataset-Index, Datenindex, Label, Wert, Datensatz-Label und die ursprüngliche IDataPoint Instanz zur Mustererkennung.

Reagieren Blazor

ChartClickEventArgs Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
DataIndexint
0
Der nullbasierte Index des Datenpunkts innerhalb seines Datensatzes.
DataPointDataPoint?
Die tatsächliche Models.DataPoint Instanz, die das geklickte Element unterstützt. Musterabgleich mit deiner benutzerdefinierten Unterklasse (z. B. Models.DataverseDataPoint), um darauf zuzugreifen Anrufer-definierter Kontext (Datensatz-ID, Kategorie usw.). Kann null sein, wenn die Indizes von JavaScript stimmt nicht mehr mit dem aktuellen Datensatz überein (zum Beispiel, weil die Daten ersetzt wurden mitten im Klick).
DatasetIndexint
0
Der nullbasierte Index des Datensatzes, der das angeklickte Element enthält.
DatasetLabelstring
Das Label des Datensatzes, zu dem das angeklickte Element gehört (zum Beispiel 'Sales'), oder eine leere Zeichenkette, wenn der Datensatz kein Label hat.
Labelstring
Das Kategorielabel, das mit dem angeklickten Element verbunden ist (zum Beispiel 'Januar'), oder eine leere Zeichenkette, wenn das Horoskop keine Labels hat.
Valuedouble
0
Der numerische Wert des angeklickten Datenpunkts.
Name: DataIndex
Typ: int
Default: 0
Beschreibung: Der nullbasierte Index des Datenpunkts innerhalb seines Datensatzes.
Name: DataPoint
Typ: DataPoint?
Beschreibung: Die tatsächliche Models.DataPoint Instanz, die das geklickte Element unterstützt. Musterabgleich mit deiner benutzerdefinierten Unterklasse (z. B. Models.DataverseDataPoint), um darauf zuzugreifen Anrufer-definierter Kontext (Datensatz-ID, Kategorie usw.). Kann null sein, wenn die Indizes von JavaScript stimmt nicht mehr mit dem aktuellen Datensatz überein (zum Beispiel, weil die Daten ersetzt wurden mitten im Klick).
Name: DatasetIndex
Typ: int
Default: 0
Beschreibung: Der nullbasierte Index des Datensatzes, der das angeklickte Element enthält.
Name: DatasetLabel
Typ: string
Beschreibung: Das Label des Datensatzes, zu dem das angeklickte Element gehört (zum Beispiel 'Sales'), oder eine leere Zeichenkette, wenn der Datensatz kein Label hat.
Name: Label
Typ: string
Beschreibung: Das Kategorielabel, das mit dem angeklickten Element verbunden ist (zum Beispiel 'Januar'), oder eine leere Zeichenkette, wenn das Horoskop keine Labels hat.
Name: Value
Typ: double
Default: 0
Beschreibung: Der numerische Wert des angeklickten Datenpunkts.

Datenquellen

Datenquellenklassen, die Diagrammdaten aus Dataverse über FetchXML-Abfragen laden.

DataverseChartDataSource

Basis-Datenquellenklasse, die rohe FetchXML- und Spaltenabbildungen akzeptiert. Führt die Abfrage über IPowerPortalsProServiceaus, übernimmt RelatedRecordValue das Unwraping für aggregierte Ergebnisse und formt Zeilen in Einzel- oder Mehrreihen ChartData.

Reagieren Blazor

DataverseChartDataSource Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
FetchXmlstring?
Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
LabelColumnstring
Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
SeriesColumnstring?
Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
SingleSeriesLabelstring
Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
ValueColumnstring
Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.
Name: FetchXml
Typ: string?
Beschreibung: Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
Name: LabelColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
Name: SeriesColumn
Typ: string?
Beschreibung: Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
Name: SingleSeriesLabel
Typ: string
Beschreibung: Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
Name: ValueColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.

Methoden

Name
Parameter
Typ
Beschreibung
LoadAsyncIChartService chartService
Task<ChartData>
Lädt Diagrammdaten über das geteilte Services.IChartService.
Name: LoadAsync
Parameter: IChartService chartService
Typ: Task<ChartData>
Beschreibung: Lädt Diagrammdaten über das geteilte Services.IChartService.

AggregateDataverseChartDataSource

Eine Unterklasse, die eine aggregierte FetchXML-Abfrage aus einfachen Eigenschaften (TableName, GroupByColumn, AggregateColumn, Aggregate) erstellt, anstatt rohes FetchXML zu benötigen. Unterstützt Date-Bucketing, Multi-Series, ansichtsbasierte Filterung, Inline-Filterfragmente und verknüpfte Entitäts-Joins.

Reagieren Blazor

AggregateDataverseChartDataSource Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
AggregateAggregateType
Sum
Die aggregierte Funktion angewandt auf AggregateDataverseChartDataSource.AggregateColumn.
AggregateColumnstring
Die Dataverse-Spalte zum Aggregieren. Für AggregateType.Count Jede Kolumne funktioniert. Mengen DataverseChartDataSource.ValueColumn Auf der Basis Klasse, damit sie synchron bleiben.
FetchXmlstring?
Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
FilterXmlstring?
Optionales rohes FetchXML-Filterfragment, das in das Fragment injiziert werden kann generierte Abfrage (ein vollständiger <Filter>... </Filter>).
GroupByColumnstring
Die Spalte Dataverse, nach der gruppiert werden — wird zur X-Achse des Diagramms. Etiketten. Mengen DataverseChartDataSource.LabelColumn auf der Basisklasse, damit sie synchron bleiben.
GroupByDateGroupingChartDateGrouping
None
Wenn AggregateDataverseChartDataSource.GroupByColumn eine Date-Time-Spalte ist, steuert Wie die Daten eingeteilt werden.
GroupByLinkedEntityChartLinkedEntity?
Optionale Linked-Entity-Kette für AggregateDataverseChartDataSource.GroupByColumn. Wenn gesetzt, wird das Groupby-Attribut innerhalb der Link-Entität platziert im generierten FetchXML.
LabelColumnstring
Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
SeriesColumnstring?
Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
SeriesDateGroupingChartDateGrouping
None
Optionale Datumsgruppierung für die Serie – angewendet auf dieselbe Spalte als AggregateDataverseChartDataSource.GroupByColumn. Verwendung von Jahres-zu-Jahres-Charts ChartDateGrouping.Month auf AggregateDataverseChartDataSource.GroupByDateGrouping und ChartDateGrouping.Year auf diesem Grundstück. Wenn gesetzt, DataverseChartDataSource.SeriesColumn wird ignoriert.
SeriesLinkedEntityChartLinkedEntity?
Optionale Linked-Entity-Kette für DataverseChartDataSource.SeriesColumn.
SingleSeriesLabelstring
Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
TableNamestring
Die Dataverse-Tabelle zum Abfragen (z. B. 'opportunity').
Topint?
Optionale maximale Anzahl gruppierter Zeilen zum Zurücksenden.
ValueColumnstring
Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.
ViewIdGuid?
Optionale gespeicherte Ansicht-ID. Wenn gesetzt, sind die Filterbedingungen der Ansicht werden in die generierte aggregierte Abfrage eingefügt. Bestimmt, welche Aufnahmen sind enthalten; Die aggregierte Konfiguration bestimmt, wie sie sind gruppiert.
Name: Aggregate
Typ: AggregateType
Default: Sum
Beschreibung: Die aggregierte Funktion angewandt auf AggregateDataverseChartDataSource.AggregateColumn.
Name: AggregateColumn
Typ: string
Beschreibung: Die Dataverse-Spalte zum Aggregieren. Für AggregateType.Count Jede Kolumne funktioniert. Mengen DataverseChartDataSource.ValueColumn Auf der Basis Klasse, damit sie synchron bleiben.
Name: FetchXml
Typ: string?
Beschreibung: Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
Name: FilterXml
Typ: string?
Beschreibung: Optionales rohes FetchXML-Filterfragment, das in das Fragment injiziert werden kann generierte Abfrage (ein vollständiger <Filter>... </Filter>).
Name: GroupByColumn
Typ: string
Beschreibung: Die Spalte Dataverse, nach der gruppiert werden — wird zur X-Achse des Diagramms. Etiketten. Mengen DataverseChartDataSource.LabelColumn auf der Basisklasse, damit sie synchron bleiben.
Name: GroupByDateGrouping
Typ: ChartDateGrouping
Default: None
Beschreibung: Wenn AggregateDataverseChartDataSource.GroupByColumn eine Date-Time-Spalte ist, steuert Wie die Daten eingeteilt werden.
Name: GroupByLinkedEntity
Typ: ChartLinkedEntity?
Beschreibung: Optionale Linked-Entity-Kette für AggregateDataverseChartDataSource.GroupByColumn. Wenn gesetzt, wird das Groupby-Attribut innerhalb der Link-Entität platziert im generierten FetchXML.
Name: LabelColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
Name: SeriesColumn
Typ: string?
Beschreibung: Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
Name: SeriesDateGrouping
Typ: ChartDateGrouping
Default: None
Beschreibung: Optionale Datumsgruppierung für die Serie – angewendet auf dieselbe Spalte als AggregateDataverseChartDataSource.GroupByColumn. Verwendung von Jahres-zu-Jahres-Charts ChartDateGrouping.Month auf AggregateDataverseChartDataSource.GroupByDateGrouping und ChartDateGrouping.Year auf diesem Grundstück. Wenn gesetzt, DataverseChartDataSource.SeriesColumn wird ignoriert.
Name: SeriesLinkedEntity
Typ: ChartLinkedEntity?
Beschreibung: Optionale Linked-Entity-Kette für DataverseChartDataSource.SeriesColumn.
Name: SingleSeriesLabel
Typ: string
Beschreibung: Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
Name: TableName
Typ: string
Beschreibung: Die Dataverse-Tabelle zum Abfragen (z. B. 'opportunity').
Name: Top
Typ: int?
Beschreibung: Optionale maximale Anzahl gruppierter Zeilen zum Zurücksenden.
Name: ValueColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.
Name: ViewId
Typ: Guid?
Beschreibung: Optionale gespeicherte Ansicht-ID. Wenn gesetzt, sind die Filterbedingungen der Ansicht werden in die generierte aggregierte Abfrage eingefügt. Bestimmt, welche Aufnahmen sind enthalten; Die aggregierte Konfiguration bestimmt, wie sie sind gruppiert.

Methoden

Name
Parameter
Typ
Beschreibung
LoadAsyncIChartService chartService
Task<ChartData>
Lädt Diagrammdaten über das geteilte Services.IChartService.
Name: LoadAsync
Parameter: IChartService chartService
Typ: Task<ChartData>
Beschreibung: Lädt Diagrammdaten über das geteilte Services.IChartService.

ViewDataverseChartDataSource

Eine Unterklasse, die ihr FetchXML aus einer gespeicherten Dataverse-Ansicht (gespeicherte Abfrage) auflöst. Der Aufrufer setzt LabelColumn weiterhin und ValueColumn an, um anzuzeigen, welche Spalten auf Labels und Werte abgebildet sind.

Reagieren Blazor

ViewDataverseChartDataSource Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
FetchXmlstring?
Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
LabelColumnstring
Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
SeriesColumnstring?
Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
SingleSeriesLabelstring
Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
ValueColumnstring
Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.
ViewIdGuid
00000000-0000-0000-0000-000000000000
Die eindeutige Identifikatorin der gespeicherten Ansicht von Dataverse zum Laden. Die server holt bei jedem Aufruf sein FetchXml (nicht zwischengespeichert schichten; ViewMetadataCache übernimmt das Caching serverseitig).
Name: FetchXml
Typ: string?
Beschreibung: Die FetchXML-Abfrage soll ausgeführt werden. Die Basisklasse sendet dies in die direkt anfordern; Unterklassenübersteuerung Models.ChartDataRequest) um einen anderen Eingabemodus zu verwenden.
Name: LabelColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, der für Diagrammbezeichnungen verwendet wird (X-Achse). Für rohe Arbeiten FetchXML – dies ist der logische Name des Attributs (oder sein Alias, falls einer wurde im FetchXML spezifiziert).
Name: SeriesColumn
Typ: string?
Beschreibung: Optionaler Ergebnis-Spaltenname verwendet zur Aufteilung von Zeilen in mehrere Datensätze. Wenn gesetzt, sind Zeilen mit demselben Reihenwert in einem Datensatz zusammengefasst.
Name: SingleSeriesLabel
Typ: string
Beschreibung: Optionale Datensatzbeschriftung, die auf den einzelnen emittierten Datensatz angewendet wird, wenn DataverseChartDataSource.SeriesColumn nicht festgelegt ist. Verwendung von Multiserien-Abfragen den formatierten Serienwert als Datensatzbeschriftung und ignorieren Sie dies.
Name: ValueColumn
Typ: string
Beschreibung: Der resultierende Spaltenname, aus dem numerische Werte abgelesen werden kann. Muss beziehen Sie sich auf eine numerische Spalte in den zurückgegebenen Zeilen.
Name: ViewId
Typ: Guid
Default: 00000000-0000-0000-0000-000000000000
Beschreibung: Die eindeutige Identifikatorin der gespeicherten Ansicht von Dataverse zum Laden. Die server holt bei jedem Aufruf sein FetchXml (nicht zwischengespeichert schichten; ViewMetadataCache übernimmt das Caching serverseitig).

Methoden

Name
Parameter
Typ
Beschreibung
LoadAsyncIChartService chartService
Task<ChartData>
Lädt Diagrammdaten über das geteilte Services.IChartService.
Name: LoadAsync
Parameter: IChartService chartService
Typ: Task<ChartData>
Beschreibung: Lädt Diagrammdaten über das geteilte Services.IChartService.

ChartLinkedEntity

Beschreibt eine verknüpfte Entität (Join), die von verwendet wird AggregateDataverseChartDataSource , um ein Groupby- oder Serienattribut in eine verwandte Tabelle zu setzen. Unterstützt unbegrenztes Verschachteln über die LinkedEntity Eigenschaft für Multi-Hop-Joins (z. B. Opportunity → Konto → Geschäftseinheit).

ChartLinkedEntity Baureihe

Eigenschaften

Name
Typ
Default
Beschreibung
Fromstring
Spalte in der verknüpften Tabelle, die den Join-Schlüssel bereitstellt (z. B. 'accountid').
JoinTypeJoinOperator
Inner
Join-Typ. Standardmäßig gilt JoinOperator.Inner.
LinkedEntityChartLinkedEntity?
Optionale kindlich verknüpfte Entität für Mehrfach-Hop-Joins. Die Groupby/Serien-Attribut wird auf das innerste Element gesetzt Entität in der Kette.
TableNamestring
Logischer Name der verknüpften Tabelle (z. B. 'Konto').
Tostring
Spalte in der Elterntabelle (oder der übergeordneten Link-Entität), der man sich anschließen kann (z. B. 'customerid').
Name: From
Typ: string
Beschreibung: Spalte in der verknüpften Tabelle, die den Join-Schlüssel bereitstellt (z. B. 'accountid').
Name: JoinType
Typ: JoinOperator
Default: Inner
Beschreibung: Join-Typ. Standardmäßig gilt JoinOperator.Inner.
Name: LinkedEntity
Typ: ChartLinkedEntity?
Beschreibung: Optionale kindlich verknüpfte Entität für Mehrfach-Hop-Joins. Die Groupby/Serien-Attribut wird auf das innerste Element gesetzt Entität in der Kette.
Name: TableName
Typ: string
Beschreibung: Logischer Name der verknüpften Tabelle (z. B. 'Konto').
Name: To
Typ: string
Beschreibung: Spalte in der Elterntabelle (oder der übergeordneten Link-Entität), der man sich anschließen kann (z. B. 'customerid').

Teilen einer Datenquelle zwischen einem Raster und einem Diagramm

A ViewDataSource kann a MainGrid und eine (oder mehr) DataverseChart Komponenten im Gleichschritt antreiben. Ein Server-Roundtrip gibt die Zeilenseite und die Diagrammaggregation atomar zurück, sodass es kein Rennen gibt, bei dem das Diagramm Zahlen für einen alten Filter anzeigt, während das Raster auf einem neuen ist. Suche, sortieren, Seiten und sehen Sie Änderungen auf beiden Konsumenten über dieselbe Datenquelle an.

Konstruiere die Datenquelle in OnInitialized (damit die injizierte IGridService verfügbar ist) und übergebe sie an beide Ansichten über DataSource. Das Raster stellt die Zeilenseite dar; Das Diagramm rendert AggregationResults[AggregationIndex]. Mehrere Aggregationen werden unterstützt – jeder Eintrag erzeugt ein separates Diagramm, das auf dieselbe Datenquelle zeigt.

React
Blazor

Das Klicken auf einen Diagrammschnitt setzt die Datenquelle Highlight, wodurch nicht übereinstimmende Zeilen im gepaarten Raster (und nicht übereinstimmende Schnitte im Diagramm) ohne erneutes Abrufen gedimmt werden. Klicke erneut auf denselben Slice, um ihn zu löschen. Für Drill-Through-Navigation oder einen harten Filter solltest du dich selbst einstellen CrossFilterMode="ChartCrossFilterMode.None" und beherrschen OnElementClick .