Referencia de la API de cartas
Esta página documenta todas las clases públicas, interfaces y enum en la biblioteca de gráficos PowerPortalsPro.
Componentes
Los componentes de Blazor que generan gráficos.
FluentUIChart
Un envoltorio temático alrededor del componente base Chart . Lee los colores de los tokens activos de diseño de Fluent UI, rellena automáticamente los colores del conjunto de datos de una paleta derivada de Fluent y retematiza el gráfico cuando el usuario cambia entre modo claro y oscuro.
FluentUIChart Clase
Parámetros
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
Datasets | List<ChartDataset> | Obtiene o establece los conjuntos de datos para graficar. Cualquier conjunto de datos que deje ChartDataset.BackgroundColor o ChartDataset.BorderColor null se rellenará automáticamente desde la paleta activa de Fluent. | |
EnableAnimation | bool | True | Si las animaciones de gráficos están activadas. Por defecto es |
Height | string? | 400px | Obtiene o establece la altura opcional de CSS aplicada al contenedor de la carta. Por defecto |
Labels | List<string> | Obtiene o establece las etiquetas de categoría renderizadas a lo largo del eje principal del gráfico. | |
LegendPosition | ChartLegendPosition? | Colocación de la leyenda relativa al área del gráfico, o ChartLegendPosition.Hidden para ocultarlo por completo. Cuando ChartLegendPosition.Top) se utiliza. | |
Orientation | ChartOrientation? | Orientación del gráfico. Cuando ChartOrientation.Horizontal, aparecen categorías en el Eje Y y valores en el eje X. Los gráficos de embudo por defecto son horizontales para un embudo de vista superior. Cuando | |
ShowBorder | bool | True | Si envolver el cuadro con un borde temático con esquinas redondeadas. Por defecto es |
Stacked | bool | False | Si apilar conjuntos de datos unos sobre otros en lugar de uno al lado del otro. Se aplica a los gráficos de barras y líneas. |
Title | string? | Título de la lista mostrado encima de la lista. Cuando es nulo, no se muestra título. | |
Type | ChartType | Bar | Obtiene o establece el tipo de gráfico a renderizar (por ejemplo ChartType.Bar, ChartType.Line, ChartType.Pie, ChartType.Doughnut). |
Width | string? | Obtiene o establece el ancho opcional de CSS aplicado al contenedor de la carta. | |
XAxisPrefix | string? | Cadena opcional añadida a cada etiqueta de tick del eje X. | |
XAxisSuffix | string? | Cadena opcional añadida a cada etiqueta de marca del eje X. | |
YAxisPrefix | string? | Cadena opcional añadida a cada etiqueta de tick del eje Y y valor de tooltip (por ejemplo | |
YAxisSuffix | string? | Cadena opcional añadida a cada etiqueta de tick y valor de tooltip del eje Y (por ejemplo |
DatasetsChartDataset.BackgroundColor o ChartDataset.BorderColor null se rellenará automáticamente desde la paleta activa de Fluent.EnableAnimationHeightLabelsLegendPositionChartLegendPosition.Hidden para ocultarlo por completo. Cuando ChartLegendPosition.Top) se utiliza.OrientationChartOrientation.Horizontal, aparecen categorías en el Eje Y y valores en el eje X. Los gráficos de embudo por defecto son horizontales para un embudo de vista superior. Cuando ShowBorderStackedTitleTypeChartType.Bar, ChartType.Line, ChartType.Pie, ChartType.Doughnut).WidthXAxisPrefixXAxisSuffixYAxisPrefixYAxisSuffixEventos
Nombre | Tipo | Descripción |
|---|---|---|
OnElementClick | EventCallback<ChartClickEventArgs> | Se eleva cuando el usuario hace clic en un elemento gráfico renderizado (una barra, un corte, un punto, etc.). Se ignoran los clics en el fondo del gráfico redirigidos al subyacente Components.Chart. |
OnElementClickComponents.Chart.Métodos
Nombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
ExportAsImageAsync | Task<string> | Exporta el gráfico actual como una imagen PNG y devuelve los datos como una codificación Base64 URI de datos (por ejemplo, |
ExportAsImageAsyncDataverseChart
Un componente de conveniencia que envuelve FluentUIChart y controla el ciclo de vida de carga de datos. Acepta un DataverseChartDataSource, gestiona el estado de carga, la visualización de errores y proporciona un botón de actualización opcional.
DataverseChart Clase
Parámetros
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
AggregationIndex | int | 0 | En qué entrada ViewDataSource.AggregationResults para renderizar. Por defecto es DataverseChart.Source se usa en su lugar. |
CrossFilterMode | ChartCrossFilterMode | Highlight | Comportamiento de clic en cortes cuando se suministra a. DataverseChart.DataSource Por defecto — ChartCrossFilterMode.Highlight suave filtro cruzado que enfatiza el hermano de corte y atenuación igualados filas que no coinciden sin volver a buscar. El suministrado por el consumidor DataverseChart.OnElementClick Aún dispara al lado, para capas Telemetría / Comportamiento de simulado. Ignorado cuando DataverseChart.Source se utiliza. |
DataSource | ViewDataSource? | Instancia compartida Data.ViewDataSource (normalmente también conduciendo un par DataverseChart.Source. El gráfico lee sus datos de forma reactiva de ViewDataSource.AggregationResults y despacha el estado del filtro cruzado en clics de corte por DataverseChart.CrossFilterMode. Un viaje de ida y vuelta al servidor entonces mantiene la página de filas de la cuadrícula y la agregación del gráfico de forma atómica consistente. | |
DefaultViewId | Guid? | ID de vista por defecto opcional para preseleccionar en el desplegable de vista. Si no se fija, la primera Vista en DataverseChart.ViewIds (o la vista predeterminada de la tabla) está seleccionada. | |
EnableAnimation | bool | True | Si las animaciones de gráficos están activadas. Por defecto es |
Height | string? | 400px | Altura CSS opcional aplicada a todo el componente (incluido el selector de vistas El desplegable y el borde temático, cuando se muestra). El gráfico interno ocupa el espacio que sea permanece después de la barra de herramientas y el selección. Por defecto |
LegendPosition | ChartLegendPosition? | Colocación de la leyenda relativa al área del gráfico, o ChartLegendPosition.Hidden para ocultarlo por completo. Cuando ChartLegendPosition.Top) se utiliza. | |
Orientation | ChartOrientation? | Orientación del gráfico. Los gráficos de embudo por defecto ChartOrientation.Horizontal para un embudo desde arriba. Cuando | |
ShowBorder | bool | True | Si envolver el cuadro con un borde temático con esquinas redondeadas. Por defecto es |
ShowExportButton | bool | True | Si mostrar un botón de descarga que exporta el gráfico como una imagen PNG. Por defecto es |
ShowRefreshButton | bool | True | Si mostrar un botón de actualización en la esquina superior derecha del gráfico. Por defecto es |
Source | DataverseChartDataSource? | Fuente de datos independiente basada en clases. Mutuamente excluyentes con DataverseChart.DataSource — exactamente uno de los dos debe ser aportó. Con DataverseChart.Source, este componente posee el ciclo de vida de carga + actualización y despachos a través Services.IChartService directamente. Úsalo cuando una carta posee su Buscar su propio (sin cuadrícula emparejada). | |
Stacked | bool | False | Si apilar conjuntos de datos unos sobre otros en lugar de uno al lado del otro. |
Title | string? | Título de la lista mostrado encima de la lista. Cuando es nulo, no se muestra título. | |
Type | ChartType | Bar | El tipo de gráfico a renderizar. |
ViewIds | List<Guid>? | Lista opcional de IDs de vistas de Dataverse para mostrar en un desplegable sobre el gráfico. Cuando el El usuario selecciona una vista, sus condiciones de filtro se fusionan con la fuente de datos y el gráfico recarga. Obras con Components.AggregateDataverseChartDataSource y Components.ViewDataverseChartDataSource. | |
Width | string? | Ancho CSS opcional aplicado al contenedor de la carta. | |
XAxisPrefix | string? | Cadena opcional añadida a cada etiqueta de tick del eje X. | |
XAxisSuffix | string? | Cadena opcional añadida a cada etiqueta de marca del eje X. | |
YAxisPrefix | string? | Cadena opcional añadida a cada etiqueta de tick del eje Y y valor de tooltip (por ejemplo, | |
YAxisSuffix | string? | Cadena opcional añadida a cada etiqueta de tick del eje Y y valor de tooltip (por ejemplo, |
AggregationIndexViewDataSource.AggregationResults para renderizar. Por defecto es DataverseChart.Source se usa en su lugar.CrossFilterModeDataverseChart.DataSource Por defecto — ChartCrossFilterMode.Highlight suave filtro cruzado que enfatiza el hermano de corte y atenuación igualados filas que no coinciden sin volver a buscar. El suministrado por el consumidor DataverseChart.OnElementClick Aún dispara al lado, para capas Telemetría / Comportamiento de simulado. Ignorado cuando DataverseChart.Source se utiliza.DataSourceData.ViewDataSource (normalmente también conduciendo un par DataverseChart.Source. El gráfico lee sus datos de forma reactiva de ViewDataSource.AggregationResults y despacha el estado del filtro cruzado en clics de corte por DataverseChart.CrossFilterMode. Un viaje de ida y vuelta al servidor entonces mantiene la página de filas de la cuadrícula y la agregación del gráfico de forma atómica consistente.DefaultViewIdDataverseChart.ViewIds (o la vista predeterminada de la tabla) está seleccionada.EnableAnimationHeightLegendPositionChartLegendPosition.Hidden para ocultarlo por completo. Cuando ChartLegendPosition.Top) se utiliza.OrientationChartOrientation.Horizontal para un embudo desde arriba. Cuando ShowBorderShowExportButtonShowRefreshButtonSourceDataverseChart.DataSource — exactamente uno de los dos debe ser aportó. Con DataverseChart.Source, este componente posee el ciclo de vida de carga + actualización y despachos a través Services.IChartService directamente. Úsalo cuando una carta posee su Buscar su propio (sin cuadrícula emparejada).StackedTitleTypeViewIdsComponents.AggregateDataverseChartDataSource y Components.ViewDataverseChartDataSource.WidthXAxisPrefixXAxisSuffixYAxisPrefixYAxisSuffixEventos
Nombre | Tipo | Descripción |
|---|---|---|
OnElementClick | EventCallback<ChartClickEventArgs> | Se eleva cuando el usuario hace clic en un elemento gráfico renderizado. |
OnElementClickTipos de cartas y enums
Enumeraciones para la selección de tipos de gráficos y la asignación de fechas.
ChartType
El conjunto de tipos de gráficos soportados por la biblioteca de Chart.js subyacente: Bar, Line, Pie, Doughnut, PolarArea, Radar, Bubble y Scatter.
ChartType Enum
Valores
Nombre | Valor | Descripción |
|---|---|---|
Bar | 0 | Gráfico de barras vertical (Chart.js |
Line | 1 | Gráfico de líneas (Chart.js |
Pie | 2 | Gráfico circular (Chart.js |
Doughnut | 3 | Tabla de rosquillas (Chart.js |
PolarArea | 4 | Carta de área polar (Chart.js |
Radar | 5 | Carta de radar (Chart.js |
Bubble | 6 | Gráfico de burbujas (Chart.js |
Scatter | 7 | Diagrama de dispersión (Chart.js |
Funnel | 8 | Mapa de embudo (mediante |
Bar0Line1Pie2Doughnut3PolarArea4Radar5Bubble6Scatter7Funnel8ChartDateGrouping
Intervalos de bucketing de fechas para agrupar columnas de fecha y hora en consultas agregadas. Incluye valores simples (Día, Mes, Año) y valores combinados (MesAndAño, CuartoYAño, etc.) que producen etiquetas formateadas como "Jan 2024".
ChartDateGrouping Enum
Valores
Nombre | Valor | Descripción |
|---|---|---|
None | 0 | No hay agrupación de fechas — la columna se agrupa por su valor bruto. |
Day | 1 | Agrupa por día ( |
Week | 2 | Agrupa por semana ISO ( |
Month | 3 | Agrupa por mes del calendario ( |
Quarter | 4 | Agrupa por trimestre del calendario ( |
Year | 5 | Agrupa por año natural ( |
MonthAndYear | 6 | Agrupa por mes + año. Etiqueta: |
DayAndMonth | 7 | Agrupar por día + mes. Etiqueta: |
DayAndMonthAndYear | 8 | Agrupa por día + mes + año. Etiqueta: |
WeekAndYear | 9 | Agrupa por semana ISO + año. Etiqueta: |
QuarterAndYear | 10 | Agrupar por trimestre + año. Etiqueta: |
None0Day1Week2Month3Quarter4Year5MonthAndYear6DayAndMonth7DayAndMonthAndYear8WeekAndYear9QuarterAndYear10Modelo de datos
Las clases e interfaces que representan datos de gráficos, puntos de datos, temática y cargas útiles de eventos de clic.
ChartData
Agrupa los datos completos necesarios para renderizar un gráfico: una lista de etiquetas de categoría (eje X) y uno o más conjuntos de datos. Devuelta por métodos de fuente LoadAsync de datos.
ChartData Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
Datasets | List<ChartDataset> | Conjuntos de datos para representar. Cada conjunto de ChartDataset.Data datos la longitud debería coincidir ChartData.Labels; los cubos que faltan son cero llenado por el servidor para que se preserve la alineación posicional A través de las series. | |
Labels | List<string> | Etiquetas de categoría renderizadas a lo largo del eje primario. |
DatasetsChartDataset.Data datos la longitud debería coincidir ChartData.Labels; los cubos que faltan son cero llenado por el servidor para que se preserve la alineación posicional A través de las series.LabelsChartDataset
Representa un único conjunto de datos (serie) en un gráfico. Contiene datos de datos, una etiqueta de leyenda y anulaciones opcionales de color para el fondo y el borde.
ChartDataset Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
BackgroundColor | string? | Color de fondo predeterminado para cada elemento de este conjunto de datos para Tipos de cartas cartesianas. Para tipos de cartas radiales por punto DataPoint.BackgroundColor Anulaciones ganan. Cuando | |
BorderColor | string? | Color predeterminado del borde. Semántica de precedencia igual que ChartDataset.BackgroundColor. | |
BorderWidth | double | 1 | Ancho del borde de los elementos en píxeles. Se soportan valores fraccionarios (por ejemplo, |
Data | List<DataPoint> | Puntos de datos en este conjunto de datos. Los ítems son Models.DataPoint o una subclase (Models.DataverseDataPoint cuando la fuente de datos respaldado por Dataverse). El discriminador polimórfico '$type' es conservado a través de JSON. | |
Label | string | Etiqueta de leyenda para este conjunto de datos (por ejemplo, |
BackgroundColorDataPoint.BackgroundColor Anulaciones ganan. Cuando BorderColorChartDataset.BackgroundColor.BorderWidthDataModels.DataPoint o una subclase (Models.DataverseDataPoint cuando la fuente de datos respaldado por Dataverse). El discriminador polimórfico '$type' es conservado a través de JSON.LabelDataPoint
Implementación predeterminada de IDataPoint. Subclase para adjuntar contexto definido por el llamador (id de registro, región, etc.) que estará disponible para los manejadores de clics.
DataPoint Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
BackgroundColor | string? | Color de fondo por punto. Utilizado por tipos de cartas radiales (pie, donut, polarArea) para colorear segmentos individuales de forma distintiva. Cuando | |
BorderColor | string? | Color de borde por punto. Semántica de la misma DataPoint.BackgroundColor. | |
Value | double | 0 | El valor numérico se representa por Chart.js. |
BackgroundColorBorderColorDataPoint.BackgroundColor.ValueDataverseDataPoint
Una implementación que conserva el Dataverse TableRecord subyacente desde el que IDataPoint fue proyectada. Los handlers de clics pueden hacer coincidencia de patrones en este tipo para acceder al id de la fila, nombre de la tabla y valores de columna.
DataverseDataPoint Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
BackgroundColor | string? | Color de fondo por punto. Utilizado por tipos de cartas radiales (pie, donut, polarArea) para colorear segmentos individuales de forma distintiva. Cuando | |
BorderColor | string? | Color de borde por punto. Semántica de la misma DataPoint.BackgroundColor. | |
Record | TableRecord? | La fila del Dataverse desde la que se proyectó este punto de datos. Nulo Porque los cubos de cero llenos en un pivote multiserie no tienen un Registro de origen. | |
Value | double | 0 | El valor numérico se representa por Chart.js. |
BackgroundColorBorderColorDataPoint.BackgroundColor.RecordValueChartTheme
Anulaciones de tema y formato aplicadas a una instancia de gráfico — color de texto, color de la línea de cuadrícula, formato de valores en el eje Y (prefijo/sufijo), título del gráfico, modo apilado y posición de leyenda.
ChartTheme Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
EnableAnimation | bool | True | Obtiene o establece si las animaciones de gráficos están activadas. Por defecto es |
GridColor | string? | Obtiene o establece el color usado para las líneas de cuadrícula y bordes del eje. | |
IndexAxis | ChartIndexAxis? | La Chart.js dirección eje de categoría. Establecido por la capa de componentes desde la del llamador Components.ChartOrientation vía Components.ChartOrientation); los consumidores deberían establecer Components.ChartIndexAxis). | |
LegendPosition | ChartLegendPosition? | Colocación de la leyenda relativa al área del gráfico, o ChartLegendPosition.Hidden para ocultarlo por completo. Cuando Components.ChartLegendPosition). | |
Stacked | bool | False | Obtiene o establece si los ejes X e Y están apilados. Cuando es cierto, los conjuntos de datos se apilan encima de los demás en vez de exhibidos lado a lado. Se aplica a los gráficos de barras y líneas. |
TextColor | string? | Obtiene o establece el color usado para el texto por defecto, las etiquetas de leyendas, los ticks de eje y los títulos. | |
Title | string? | Aparece o establece el texto del título de la carta que se muestra encima de la carta. Cuando es nulo, no se muestra título. | |
XAxisPrefix | string? | Recibe o establece una cadena añadida a cada etiqueta de tick del eje X (por ejemplo | |
XAxisSuffix | string? | Recibe o establece una cadena añadida a cada etiqueta de tick del eje X. Cuando es nulo, no se aplica ningún sufijo. | |
YAxisPrefix | string? | Recibe o establece una cadena añadida a cada etiqueta de tick y valor de tooltip en el eje Y (por ejemplo | |
YAxisSuffix | string? | Recibe o establece una cadena añadida a cada etiqueta de tick del eje Y y valor de tooltip (por ejemplo |
EnableAnimationGridColorIndexAxisComponents.ChartOrientation vía Components.ChartOrientation); los consumidores deberían establecer Components.ChartIndexAxis).LegendPositionChartLegendPosition.Hidden para ocultarlo por completo. Cuando Components.ChartLegendPosition).StackedTextColorTitleXAxisPrefixXAxisSuffixYAxisPrefixYAxisSuffixChartClickEventArgs
Carga útil que describe un clic en un único elemento de la gráfica (barra, corte, punto, etc.). Contiene el índice del conjunto de datos, índice de datos, etiqueta, valor, etiqueta del conjunto de datos y la instancia original IDataPoint para la comparación de patrones.
ChartClickEventArgs Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
DataIndex | int | 0 | El índice base cero del punto de datos dentro de su conjunto de datos. |
DataPoint | DataPoint? | La instancia real Models.DataPoint que respalda el elemento clicado. Haz la coincidencia de patrones con tu subclase personalizada (por ejemplo, Models.DataverseDataPoint) para acceder Contexto definido por el llamante (ID de registro, categoría, etc.). Puede ser | |
DatasetIndex | int | 0 | El índice en base cero del conjunto de datos que contiene el elemento al que se hace clic. |
DatasetLabel | string | La etiqueta del conjunto de datos al que pertenece el elemento al que se hace clic (por ejemplo | |
Label | string | La etiqueta de categoría asociada al elemento al que se ha hecho clic (por ejemplo | |
Value | double | 0 | El valor numérico del punto de datos con el que se ha hecho clic. |
DataIndexDataPointModels.DataPoint que respalda el elemento clicado. Haz la coincidencia de patrones con tu subclase personalizada (por ejemplo, Models.DataverseDataPoint) para acceder Contexto definido por el llamante (ID de registro, categoría, etc.). Puede ser DatasetIndexDatasetLabelLabelValueFuentes de datos
Clases de fuente de datos que cargan datos de gráficos desde Dataverse mediante consultas FetchXML.
DataverseChartDataSource
Clase base de fuente de datos que acepta FetchXML en bruto y mapeos de columnas. Ejecuta la consulta mediante IPowerPortalsProService, gestiona RelatedRecordValue el despliegue para obtener resultados agregados, y da forma a las filas en series simples o múltiples ChartData.
DataverseChartDataSource Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
FetchXml | string? | La consulta FetchXML para ejecutar. La clase base envía esto en el solicitar directamente; Anulación de subclases Models.ChartDataRequest) para usar un modo de entrada diferente. | |
LabelColumn | string | El nombre de la columna de resultado para usar en las etiquetas de los gráficos (eje X). Para el crudo FetchXML este es el nombre lógico del atributo (o su alias si es que es se especificó en el FetchXML). | |
SeriesColumn | string? | Nombre opcional de columna de resultado usado para dividir filas en múltiples conjuntos de datos. Cuando se establece, las filas que comparten el mismo valor de serie son agrupados en un solo conjunto de datos. | |
SingleSeriesLabel | string | Etiqueta opcional de conjunto de datos aplicada al conjunto de datos emitido de una sola vez cuando DataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto. | |
ValueColumn | string | El nombre de la columna resultante para leer valores numéricos de ellos. Debe Consulta una columna numérica en las filas devueltas. |
FetchXmlModels.ChartDataRequest) para usar un modo de entrada diferente.LabelColumnSeriesColumnSingleSeriesLabelDataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto.ValueColumnMétodos
Nombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
LoadAsync | IChartService chartService | Task<ChartData> | Carga datos del gráfico a través del archivo compartido Services.IChartService. |
LoadAsyncServices.IChartService.AggregateDataverseChartDataSource
Una subclase que construye una consulta agregada FetchXML a partir de propiedades simples (NombreTabla, GroupByColumn, AggregateColumn, Aggregate) en lugar de requerir FetchXML en bruto. Soporta bucketing de fechas, multi-series, filtrado basado en vistas, fragmentos de filtro en línea y uniones de entidades enlazadas.
AggregateDataverseChartDataSource Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
Aggregate | AggregateType | Sum | La función agregada aplicada a AggregateDataverseChartDataSource.AggregateColumn. |
AggregateColumn | string | La columna Dataverse para agregar. Para AggregateType.Count Cualquier columna vale. Conjuntos DataverseChartDataSource.ValueColumn en la base para que se mantengan sincronizados. | |
FetchXml | string? | La consulta FetchXML para ejecutar. La clase base envía esto en el solicitar directamente; Anulación de subclases Models.ChartDataRequest) para usar un modo de entrada diferente. | |
FilterXml | string? | Fragmento de filtro FetchXML en bruto opcional para inyectar en el consulta generada (un | |
GroupByColumn | string | La columna Dataverse para agrupar por — se convierte en el eje X del gráfico etiquetas. Conjuntos DataverseChartDataSource.LabelColumn En la clase base para que se mantengan sincronizados. | |
GroupByDateGrouping | ChartDateGrouping | None | Cuando AggregateDataverseChartDataSource.GroupByColumn es una columna de fecha-hora, controles Cómo se reparten las fechas en cubos. |
GroupByLinkedEntity | ChartLinkedEntity? | Cadena opcional de entidades enlazadas para AggregateDataverseChartDataSource.GroupByColumn. Cuando se establece, el atributo groupby se coloca dentro de la entidad de enlace en el FetchXML generado. | |
LabelColumn | string | El nombre de la columna de resultado para usar en las etiquetas de los gráficos (eje X). Para el crudo FetchXML este es el nombre lógico del atributo (o su alias si es que es se especificó en el FetchXML). | |
SeriesColumn | string? | Nombre opcional de columna de resultado usado para dividir filas en múltiples conjuntos de datos. Cuando se establece, las filas que comparten el mismo valor de serie son agrupados en un solo conjunto de datos. | |
SeriesDateGrouping | ChartDateGrouping | None | Agrupación de fechas opcional para la serie — aplicada a la misma columna como AggregateDataverseChartDataSource.GroupByColumn. Uso de las cartas año tras año ChartDateGrouping.Month en AggregateDataverseChartDataSource.GroupByDateGrouping y ChartDateGrouping.Year en esta propiedad. Cuando se ajusta, DataverseChartDataSource.SeriesColumn es ignorado. |
SeriesLinkedEntity | ChartLinkedEntity? | Cadena opcional de entidades enlazadas para DataverseChartDataSource.SeriesColumn. | |
SingleSeriesLabel | string | Etiqueta opcional de conjunto de datos aplicada al conjunto de datos emitido de una sola vez cuando DataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto. | |
TableName | string | La tabla Dataverse para consultar (por ejemplo, | |
Top | int? | Número máximo opcional de filas agrupadas para devolver. | |
ValueColumn | string | El nombre de la columna resultante para leer valores numéricos de ellos. Debe Consulta una columna numérica en las filas devueltas. | |
ViewId | Guid? | ID opcional de vista guardada. Cuando se ajusta, las condiciones de filtro de la vista se fusionan en la consulta agregada generada. Determina cuál Se incluyen discos; La configuración agregada determina cómo son agrupados. |
AggregateAggregateDataverseChartDataSource.AggregateColumn.AggregateColumnAggregateType.Count Cualquier columna vale. Conjuntos DataverseChartDataSource.ValueColumn en la base para que se mantengan sincronizados.FetchXmlModels.ChartDataRequest) para usar un modo de entrada diferente.FilterXmlGroupByColumnDataverseChartDataSource.LabelColumn En la clase base para que se mantengan sincronizados.GroupByDateGroupingAggregateDataverseChartDataSource.GroupByColumn es una columna de fecha-hora, controles Cómo se reparten las fechas en cubos.GroupByLinkedEntityAggregateDataverseChartDataSource.GroupByColumn. Cuando se establece, el atributo groupby se coloca dentro de la entidad de enlace en el FetchXML generado.LabelColumnSeriesColumnSeriesDateGroupingAggregateDataverseChartDataSource.GroupByColumn. Uso de las cartas año tras año ChartDateGrouping.Month en AggregateDataverseChartDataSource.GroupByDateGrouping y ChartDateGrouping.Year en esta propiedad. Cuando se ajusta, DataverseChartDataSource.SeriesColumn es ignorado.SeriesLinkedEntityDataverseChartDataSource.SeriesColumn.SingleSeriesLabelDataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto.TableNameTopValueColumnViewIdMétodos
Nombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
LoadAsync | IChartService chartService | Task<ChartData> | Carga datos del gráfico a través del archivo compartido Services.IChartService. |
LoadAsyncServices.IChartService.ViewDataverseChartDataSource
Una subclase que resuelve su FetchXML desde una vista guardada de Dataverse (consulta guardada). El llamador sigue estableciendo LabelColumn y ValueColumn para indicar qué columnas corresponden a etiquetas y valores.
ViewDataverseChartDataSource Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
FetchXml | string? | La consulta FetchXML para ejecutar. La clase base envía esto en el solicitar directamente; Anulación de subclases Models.ChartDataRequest) para usar un modo de entrada diferente. | |
LabelColumn | string | El nombre de la columna de resultado para usar en las etiquetas de los gráficos (eje X). Para el crudo FetchXML este es el nombre lógico del atributo (o su alias si es que es se especificó en el FetchXML). | |
SeriesColumn | string? | Nombre opcional de columna de resultado usado para dividir filas en múltiples conjuntos de datos. Cuando se establece, las filas que comparten el mismo valor de serie son agrupados en un solo conjunto de datos. | |
SingleSeriesLabel | string | Etiqueta opcional de conjunto de datos aplicada al conjunto de datos emitido de una sola vez cuando DataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto. | |
ValueColumn | string | El nombre de la columna resultante para leer valores numéricos de ellos. Debe Consulta una columna numérica en las filas devueltas. | |
ViewId | Guid | 00000000-0000-0000-0000-000000000000 | El identificador único del Dataverse guardó la vista para cargar. El el servidor recupera su FetchXml en cada llamada (sin caché en esta capa; ViewMetadataCache gestiona la caché en el lado del servidor). |
FetchXmlModels.ChartDataRequest) para usar un modo de entrada diferente.LabelColumnSeriesColumnSingleSeriesLabelDataverseChartDataSource.SeriesColumn no está fija. Uso de consultas multiserie el valor de serie formateada como etiqueta de conjunto de datos e ignora esto.ValueColumnViewIdMétodos
Nombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
LoadAsync | IChartService chartService | Task<ChartData> | Carga datos del gráfico a través del archivo compartido Services.IChartService. |
LoadAsyncServices.IChartService.ChartLinkedEntity
Describe una entidad vinculada (unión) usada por AggregateDataverseChartDataSource para colocar un atributo groupby o serie en una tabla relacionada. Soporta anidamiento ilimitado a través de la LinkedEntity propiedad para uniones multi-saltos (por ejemplo, opportunity → cuenta → unidad de negocio).
ChartLinkedEntity Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
From | string | Columna en la tabla enlazada que proporciona la clave de unión (por ejemplo, | |
JoinType | JoinOperator | Inner | Tipo de unión. Por defecto es JoinOperator.Inner. |
LinkedEntity | ChartLinkedEntity? | Entidad vinculada a hijo opcional para uniones multi-hop. El Groupby/serie se coloca en la parte más interna entidad en la cadena. | |
TableName | string | Nombre lógico de la tabla enlazada (por ejemplo, | |
To | string | Columna en la tabla padre (o entidad de enlace padre) a unir (por ejemplo, |
FromJoinTypeJoinOperator.Inner.LinkedEntityTableNameToCompartiendo una fuente de datos entre una cuadrícula y un gráfico
A ViewDataSource puede mover a MainGrid y uno (o más) DataverseChart componentes en sincronía. Un recorrido de un servidor devuelve la página de filas y la agregación del gráfico de forma atómica, así que no hay ninguna carrera en la que el gráfico muestre números de un filtro antiguo mientras la cuadrícula está en uno nuevo. Buscar, ordenar, enviar la página y ver los cambios en cualquiera de los dos consumidores fluyen a través de la misma fuente de datos.
Construye la fuente de datos en OnInitialized (para que la inyección IGridService esté disponible) y pásala a ambas vistas mediante DataSource. La cuadrícula renderiza la página de la fila; la carta muestra AggregationResults[AggregationIndex]. Se admiten agregaciones múltiples — cada entrada alimenta un gráfico separado que apunta a la misma fuente de datos.
import { AggregateType, type ChartAggregation } from '@powerportalspro/core';
import { useViewDataSource } from '@powerportalspro/react';
import { ChartType } from '@powerportalspro/react-charts';
import { DataverseChart, MainGrid } from '@powerportalspro/react-fluent';
const AGGREGATIONS: ChartAggregation[] = [
{
groupBy: { column: 'opportunityratingcode' },
aggregateColumn: 'opportunityid',
aggregate: AggregateType.Count,
},
];
export function MyChartAndGrid() {
// Una llamada useViewDataSource alimenta tanto a los consumidores — la página de fila como
// las agregaciones caen en una sola respuesta, manteniéndose atómicamente consistentes.
const ds = useViewDataSource({
viewId: openOpportunitiesViewId,
aggregations: AGGREGATIONS,
});
return (
<>
<DataverseChart dataSource={ds} type={ChartType.Pie} />
<MainGrid dataSource={ds} tableName="opportunity" />
</>
);
}<DataverseChart DataSource="_ds" Type="ChartType.Pie" />
<MainGrid DataSource="_ds" TableName="opportunity" />
@code {
private ViewDataSource? _ds;
protected override void OnInitialized()
{
_ds = new ViewDataSource(_gridService, new ViewDataSourceOptions
{
ViewId = _openOpportunitiesViewId,
Aggregations = new[]
{
new ChartAggregation
{
GroupBy = new ChartGrouping { Column = "opportunityratingcode" },
AggregateColumn = "opportunityid",
Aggregate = AggregateType.Count,
},
},
});
}
public async ValueTask DisposeAsync()
{
if (_ds is not null) await _ds.DisposeAsync();
}
}Al hacer clic en una porción del gráfico, se activa la , que Highlightatenua las filas no coincidentes en la cuadrícula emparejada (y las que no coinciden en el gráfico) sin volver a buscar. Haz clic en la misma porción otra vez para limpiar. Para la navegación de paso a través de un taladro o un filtro duro, ajusta CrossFilterMode="ChartCrossFilterMode.None" y maneja OnElementClick tú mismo.
