Referência da API de Gráficos

Esta página documenta todas as classes públicas, interfaces e enum na biblioteca de gráficos PowerPortalsPro.

Componentes

Os componentes Blazor que renderizam gráficos.

FluentUIChart

Um wrapper consciente do tema ao redor do componente base Chart . Lê as cores dos tokens ativos de design da interface do Fluent, preenche automaticamente as cores do conjunto de dados a partir de uma paleta derivada do Fluent e retematiza o gráfico quando o usuário alterna entre o modo claro e escuro.

React Blazor

FluentUIChart Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
DatasetsList<ChartDataset>
Obtém ou configura os conjuntos de dados para plotar. Qualquer conjunto de dados que sai ChartDataset.BackgroundColor ou ChartDataset.BorderColor null será preenchido automaticamente a partir da paleta ativa do Fluent.
EnableAnimationbool
True
Se as animações de gráficos estão ativadas. O padrão é verdadeiro.
Heightstring?
400px
Recebe ou define a altura opcional de CSS aplicada ao contêiner do mapa. O padrão é 400px.
LabelsList<string>
Recebe ou define os rótulos de categoria renderizados ao longo do eixo primário do gráfico.
LegendPositionChartLegendPosition?
Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js (ChartLegendPosition.Top) é usado.
OrientationChartOrientation?
Orientação do mapa. Quando ChartOrientation.Horizontal, categorias aparecem no Eixo Y e valores no eixo X. Os gráficos de funil são padrão para horizontais para um funil top-down. Quando nulo, usa-se o padrão para o tipo de gráfico.
ShowBorderbool
True
Se devo envolver o gráfico com uma borda temática com cantos arredondados. O padrão é verdadeiro.
Stackedbool
False
Se empilhar conjuntos de dados uns sobre os outros em vez de lado a lado. Vale para gráficos de barras e linhas.
Titlestring?
Título da tabela exibido acima da parada. Quando nulo, nenhum título é mostrado.
TypeChartType
Bar
Obtém ou define o tipo de gráfico a ser renderizado (por exemplo ChartType.Bar, , ChartType.LineChartType.Pie, ChartType.Doughnut).
Widthstring?
Recebe ou define a largura opcional de CSS aplicada ao contêinere do gráfico.
XAxisPrefixstring?
String opcional prependida a cada etiqueta do eixo X.
XAxisSuffixstring?
String opcional adicionada a cada etiqueta do tick do eixo X.
YAxisPrefixstring?
String opcional prependida a cada etiqueta de tick do eixo Y e valor da tooltip (por exemplo , '$' para moeda).
YAxisSuffixstring?
String opcional adicionada a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo , '%' para porcentagens).
Nome: Datasets
Tipo: List<ChartDataset>
Descrição: Obtém ou configura os conjuntos de dados para plotar. Qualquer conjunto de dados que sai ChartDataset.BackgroundColor ou ChartDataset.BorderColor null será preenchido automaticamente a partir da paleta ativa do Fluent.
Nome: EnableAnimation
Tipo: bool
Padrão: True
Descrição: Se as animações de gráficos estão ativadas. O padrão é verdadeiro.
Nome: Height
Tipo: string?
Padrão: 400px
Descrição: Recebe ou define a altura opcional de CSS aplicada ao contêiner do mapa. O padrão é 400px.
Nome: Labels
Tipo: List<string>
Descrição: Recebe ou define os rótulos de categoria renderizados ao longo do eixo primário do gráfico.
Nome: LegendPosition
Tipo: ChartLegendPosition?
Descrição: Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js (ChartLegendPosition.Top) é usado.
Nome: Orientation
Tipo: ChartOrientation?
Descrição: Orientação do mapa. Quando ChartOrientation.Horizontal, categorias aparecem no Eixo Y e valores no eixo X. Os gráficos de funil são padrão para horizontais para um funil top-down. Quando nulo, usa-se o padrão para o tipo de gráfico.
Nome: ShowBorder
Tipo: bool
Padrão: True
Descrição: Se devo envolver o gráfico com uma borda temática com cantos arredondados. O padrão é verdadeiro.
Nome: Stacked
Tipo: bool
Padrão: False
Descrição: Se empilhar conjuntos de dados uns sobre os outros em vez de lado a lado. Vale para gráficos de barras e linhas.
Nome: Title
Tipo: string?
Descrição: Título da tabela exibido acima da parada. Quando nulo, nenhum título é mostrado.
Nome: Type
Tipo: ChartType
Padrão: Bar
Descrição: Obtém ou define o tipo de gráfico a ser renderizado (por exemplo ChartType.Bar, , ChartType.LineChartType.Pie, ChartType.Doughnut).
Nome: Width
Tipo: string?
Descrição: Recebe ou define a largura opcional de CSS aplicada ao contêinere do gráfico.
Nome: XAxisPrefix
Tipo: string?
Descrição: String opcional prependida a cada etiqueta do eixo X.
Nome: XAxisSuffix
Tipo: string?
Descrição: String opcional adicionada a cada etiqueta do tick do eixo X.
Nome: YAxisPrefix
Tipo: string?
Descrição: String opcional prependida a cada etiqueta de tick do eixo Y e valor da tooltip (por exemplo , '$' para moeda).
Nome: YAxisSuffix
Tipo: string?
Descrição: String opcional adicionada a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo , '%' para porcentagens).

Eventos

Nome
Tipo
Descrição
OnElementClickEventCallback<ChartClickEventArgs>
Aumenta quando o usuário clica em um elemento gráfico renderizado (barra, fatia, ponto, etc.). Encaminhados para o subjacente Components.Chart; cliques no fundo do gráfico são ignorados.
Nome: OnElementClick
Tipo: EventCallback<ChartClickEventArgs>
Descrição: Aumenta quando o usuário clica em um elemento gráfico renderizado (barra, fatia, ponto, etc.). Encaminhados para o subjacente Components.Chart; cliques no fundo do gráfico são ignorados.

Métodos

Nome
Parâmetros
Tipo
Descrição
ExportAsImageAsyncTask<string>
Exporta o gráfico atual como uma imagem PNG e retorna os dados como uma imagem codificada em Base64 URI de dados (por exemplo, 'data:image/png; base64,...'). Retorna nulo se o gráfico ainda não foi renderizado.
Nome: ExportAsImageAsync
Tipo: Task<string>
Descrição: Exporta o gráfico atual como uma imagem PNG e retorna os dados como uma imagem codificada em Base64 URI de dados (por exemplo, 'data:image/png; base64,...'). Retorna nulo se o gráfico ainda não foi renderizado.

DataverseChart

Um componente de conveniência que envolve FluentUIChart e controla o ciclo de vida do carregamento dos dados. Aceita um DataverseChartDataSource, lida com o estado de carregamento, exibição de erro e oferece um botão opcional de atualizar.

React Blazor

DataverseChart Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
AggregationIndexint
0
Qual entrada em ViewDataSource.AggregationResults renderizar. O padrão é 0. Permite configurar uma fonte de dados com múltiplas agregações, impulsionam vários gráficos (um por métrica). Ignorado quando DataverseChart.Source é usado em vez disso.
CrossFilterModeChartCrossFilterMode
Highlight
Comportamento de slice-click quando um DataverseChart.DataSource é fornecido. Padrão para ChartCrossFilterMode.Highlight — suave filtro cruzado que enfatiza o irmão slice e dims combinados Linhas não correspondentes sem buscar novamente. O fornecido pelo consumidor DataverseChart.OnElementClick ainda dispara ao lado, para camadas Comportamento de telemetria / perfuração. Ignorado quando DataverseChart.Source é usado.
DataSourceViewDataSource?
Instância compartilhada Data.ViewDataSource (normalmente também dirigindo um par <MainGrid>). Mutuamente exclusivo com DataverseChart.Source. O gráfico lê seus dados de forma reativa de ViewDataSource.AggregationResults e despacha o estado do filtro cruzado em cliques de fatia por DataverseChart.CrossFilterMode. Uma ida e volta ao servidor então mantém a página da linha da grade e a agregação do gráfico atômicamente consistente.
DefaultViewIdGuid?
ID de visualização padrão opcional para pré-selecionar no menu suspenso da visualização. Se não for definido, o primeiro a visualização em DataverseChart.ViewIds (ou a visualização padrão da tabela) está selecionada.
EnableAnimationbool
True
Se as animações de gráficos estão ativadas. O padrão é verdadeiro.
Heightstring?
400px
Altura opcional de CSS aplicada a todo o componente (incluindo o seletor de visão menu suspenso e borda temática, quando mostrado). O mapa interno preenche o espaço que quer permanece após a barra de ferramentas e o seletor. O padrão é 400px.
LegendPositionChartLegendPosition?
Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js (ChartLegendPosition.Top) é usado.
OrientationChartOrientation?
Orientação do mapa. Os gráficos de funil são padrão para ChartOrientation.Horizontal para um funil de cima para baixo. Quando nulo, usa-se o padrão para o tipo de gráfico.
ShowBorderbool
True
Se devo envolver o gráfico com uma borda temática com cantos arredondados. O padrão é verdadeiro.
ShowExportButtonbool
True
Se deve mostrar um botão de download que exporta o gráfico como uma imagem PNG. O padrão é verdadeiro.
ShowRefreshButtonbool
True
Se deve mostrar um botão de atualização no canto superior direito do gráfico. O padrão é verdadeiro.
SourceDataverseChartDataSource?
Fonte de dados independente baseada em classes. Mutuamente exclusivo com DataverseChart.DataSource — exatamente um dos dois deve ser forneceu. Com DataverseChart.Source, esse componente possui o ciclo de vida de carregamento + atualização e despachos através Services.IChartService diretamente. Use quando um gráfico possui seu Busca própria (sem grade pareada).
Stackedbool
False
Se empilhar conjuntos de dados uns sobre os outros em vez de lado a lado.
Titlestring?
Título da tabela exibido acima da parada. Quando nulo, nenhum título é mostrado.
TypeChartType
Bar
O tipo de gráfico a renderizar.
ViewIdsList<Guid>?
Lista opcional de IDs de visualização do Dataverse para exibir em um menu suspenso acima do gráfico. Quando o O usuário seleciona uma visualização, suas condições de filtro são mesclaras à fonte de dados e ao gráfico Recarrega. Obras com Components.AggregateDataverseChartDataSource e Components.ViewDataverseChartDataSource.
Widthstring?
Largura CSS opcional aplicada ao contêiner do gráfico.
XAxisPrefixstring?
String opcional prependida a cada etiqueta do eixo X.
XAxisSuffixstring?
String opcional adicionada a cada etiqueta do tick do eixo X.
YAxisPrefixstring?
String opcional prependida a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo, '$').
YAxisSuffixstring?
String opcional adicionada a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo, '%').
Nome: AggregationIndex
Tipo: int
Padrão: 0
Descrição: Qual entrada em ViewDataSource.AggregationResults renderizar. O padrão é 0. Permite configurar uma fonte de dados com múltiplas agregações, impulsionam vários gráficos (um por métrica). Ignorado quando DataverseChart.Source é usado em vez disso.
Nome: CrossFilterMode
Tipo: ChartCrossFilterMode
Padrão: Highlight
Descrição: Comportamento de slice-click quando um DataverseChart.DataSource é fornecido. Padrão para ChartCrossFilterMode.Highlight — suave filtro cruzado que enfatiza o irmão slice e dims combinados Linhas não correspondentes sem buscar novamente. O fornecido pelo consumidor DataverseChart.OnElementClick ainda dispara ao lado, para camadas Comportamento de telemetria / perfuração. Ignorado quando DataverseChart.Source é usado.
Nome: DataSource
Tipo: ViewDataSource?
Descrição: Instância compartilhada Data.ViewDataSource (normalmente também dirigindo um par <MainGrid>). Mutuamente exclusivo com DataverseChart.Source. O gráfico lê seus dados de forma reativa de ViewDataSource.AggregationResults e despacha o estado do filtro cruzado em cliques de fatia por DataverseChart.CrossFilterMode. Uma ida e volta ao servidor então mantém a página da linha da grade e a agregação do gráfico atômicamente consistente.
Nome: DefaultViewId
Tipo: Guid?
Descrição: ID de visualização padrão opcional para pré-selecionar no menu suspenso da visualização. Se não for definido, o primeiro a visualização em DataverseChart.ViewIds (ou a visualização padrão da tabela) está selecionada.
Nome: EnableAnimation
Tipo: bool
Padrão: True
Descrição: Se as animações de gráficos estão ativadas. O padrão é verdadeiro.
Nome: Height
Tipo: string?
Padrão: 400px
Descrição: Altura opcional de CSS aplicada a todo o componente (incluindo o seletor de visão menu suspenso e borda temática, quando mostrado). O mapa interno preenche o espaço que quer permanece após a barra de ferramentas e o seletor. O padrão é 400px.
Nome: LegendPosition
Tipo: ChartLegendPosition?
Descrição: Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js (ChartLegendPosition.Top) é usado.
Nome: Orientation
Tipo: ChartOrientation?
Descrição: Orientação do mapa. Os gráficos de funil são padrão para ChartOrientation.Horizontal para um funil de cima para baixo. Quando nulo, usa-se o padrão para o tipo de gráfico.
Nome: ShowBorder
Tipo: bool
Padrão: True
Descrição: Se devo envolver o gráfico com uma borda temática com cantos arredondados. O padrão é verdadeiro.
Nome: ShowExportButton
Tipo: bool
Padrão: True
Descrição: Se deve mostrar um botão de download que exporta o gráfico como uma imagem PNG. O padrão é verdadeiro.
Nome: ShowRefreshButton
Tipo: bool
Padrão: True
Descrição: Se deve mostrar um botão de atualização no canto superior direito do gráfico. O padrão é verdadeiro.
Nome: Source
Tipo: DataverseChartDataSource?
Descrição: Fonte de dados independente baseada em classes. Mutuamente exclusivo com DataverseChart.DataSource — exatamente um dos dois deve ser forneceu. Com DataverseChart.Source, esse componente possui o ciclo de vida de carregamento + atualização e despachos através Services.IChartService diretamente. Use quando um gráfico possui seu Busca própria (sem grade pareada).
Nome: Stacked
Tipo: bool
Padrão: False
Descrição: Se empilhar conjuntos de dados uns sobre os outros em vez de lado a lado.
Nome: Title
Tipo: string?
Descrição: Título da tabela exibido acima da parada. Quando nulo, nenhum título é mostrado.
Nome: Type
Tipo: ChartType
Padrão: Bar
Descrição: O tipo de gráfico a renderizar.
Nome: ViewIds
Tipo: List<Guid>?
Descrição: Lista opcional de IDs de visualização do Dataverse para exibir em um menu suspenso acima do gráfico. Quando o O usuário seleciona uma visualização, suas condições de filtro são mesclaras à fonte de dados e ao gráfico Recarrega. Obras com Components.AggregateDataverseChartDataSource e Components.ViewDataverseChartDataSource.
Nome: Width
Tipo: string?
Descrição: Largura CSS opcional aplicada ao contêiner do gráfico.
Nome: XAxisPrefix
Tipo: string?
Descrição: String opcional prependida a cada etiqueta do eixo X.
Nome: XAxisSuffix
Tipo: string?
Descrição: String opcional adicionada a cada etiqueta do tick do eixo X.
Nome: YAxisPrefix
Tipo: string?
Descrição: String opcional prependida a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo, '$').
Nome: YAxisSuffix
Tipo: string?
Descrição: String opcional adicionada a cada etiqueta de tick do eixo Y e valor da dica de ferramenta (por exemplo, '%').

Eventos

Nome
Tipo
Descrição
OnElementClickEventCallback<ChartClickEventArgs>
Aumenta quando o usuário clica em um elemento gráfico renderizado.
Nome: OnElementClick
Tipo: EventCallback<ChartClickEventArgs>
Descrição: Aumenta quando o usuário clica em um elemento gráfico renderizado.

Tipos de Gráficos & Enums

Enumerações para seleção de tipos de gráficos e agrupamento de datas.

ChartType

O conjunto de tipos de gráficos suportados pela biblioteca de Chart.js subjacente: Bar, Line, Pie, Doughnut, PolarArea, Radar, Bubble e Scatter.

React Blazor

ChartType Enum

Values

Nome
Value
Descrição
Bar0
Gráfico de barras verticais (Chart.js 'barra').
Line1
Gráfico de linhas (Chart.js 'linha').
Pie2
Gráfico de pizza (Chart.js 'torta').
Doughnut3
Tabela de donuts (Chart.js 'donut').
PolarArea4
Mapa de área polar (Chart.js 'polarArea').
Radar5
Mapa de radar (Chart.js 'radar').
Bubble6
Gráfico de bolhas (Chart.js 'bolha').
Scatter7
Gráfico de dispersão (Chart.js 'dispersão').
Funnel8
Gráfico de funil (via plugin chartjs-chart-funnel, tipo 'funnel').
Nome: Bar
Value: 0
Descrição: Gráfico de barras verticais (Chart.js 'barra').
Nome: Line
Value: 1
Descrição: Gráfico de linhas (Chart.js 'linha').
Nome: Pie
Value: 2
Descrição: Gráfico de pizza (Chart.js 'torta').
Nome: Doughnut
Value: 3
Descrição: Tabela de donuts (Chart.js 'donut').
Nome: PolarArea
Value: 4
Descrição: Mapa de área polar (Chart.js 'polarArea').
Nome: Radar
Value: 5
Descrição: Mapa de radar (Chart.js 'radar').
Nome: Bubble
Value: 6
Descrição: Gráfico de bolhas (Chart.js 'bolha').
Nome: Scatter
Value: 7
Descrição: Gráfico de dispersão (Chart.js 'dispersão').
Nome: Funnel
Value: 8
Descrição: Gráfico de funil (via plugin chartjs-chart-funnel, tipo 'funnel').

ChartDateGrouping

Intervalos de data por bucket para agrupar colunas de data-hora em consultas agregadas. Inclui valores simples (Dia, Mês, Ano) e valores combinados (MêsAndAno, TrimestreAndAno, etc.) que produzem etiquetas formatadas como "Jan 2024".

React Blazor

ChartDateGrouping Enum

Values

Nome
Value
Descrição
None0
Sem agrupamento de datas — a coluna é agrupada pelo seu valor bruto.
Day1
Agrupe por dia (grouping='day'). Rótulo: número do dia.
Week2
Agrupe por semana ISO (grouping='semana'). Rótulo: número da semana.
Month3
Agrupe por mês do calendário (grouping='mês'). Rótulo: nome abreviado do mês (jan, fev, ...) na cultura atual.
Quarter4
Agrupe por trimestre do calendário (grouping='trimestre'). Rótulo: número de um quarto de dólar.
Year5
Agrupe por ano civil (grouping='year'). Gravadora: ano.
MonthAndYear6
Grupo por mês + ano. Rótulo: 'Jan 2024'.
DayAndMonth7
Agrupar por dia + mês. Rótulo: '15 de janeiro'.
DayAndMonthAndYear8
Agrupe por dia + mês + ano. Rótulo: '15 Jan 2024'.
WeekAndYear9
Agrupe por semana ISO + ano. Rótulo: 'W15 2024'.
QuarterAndYear10
Agrupar por trimestre + ano. Rótulo: 'Q1 2024'.
Nome: None
Value: 0
Descrição: Sem agrupamento de datas — a coluna é agrupada pelo seu valor bruto.
Nome: Day
Value: 1
Descrição: Agrupe por dia (grouping='day'). Rótulo: número do dia.
Nome: Week
Value: 2
Descrição: Agrupe por semana ISO (grouping='semana'). Rótulo: número da semana.
Nome: Month
Value: 3
Descrição: Agrupe por mês do calendário (grouping='mês'). Rótulo: nome abreviado do mês (jan, fev, ...) na cultura atual.
Nome: Quarter
Value: 4
Descrição: Agrupe por trimestre do calendário (grouping='trimestre'). Rótulo: número de um quarto de dólar.
Nome: Year
Value: 5
Descrição: Agrupe por ano civil (grouping='year'). Gravadora: ano.
Nome: MonthAndYear
Value: 6
Descrição: Grupo por mês + ano. Rótulo: 'Jan 2024'.
Nome: DayAndMonth
Value: 7
Descrição: Agrupar por dia + mês. Rótulo: '15 de janeiro'.
Nome: DayAndMonthAndYear
Value: 8
Descrição: Agrupe por dia + mês + ano. Rótulo: '15 Jan 2024'.
Nome: WeekAndYear
Value: 9
Descrição: Agrupe por semana ISO + ano. Rótulo: 'W15 2024'.
Nome: QuarterAndYear
Value: 10
Descrição: Agrupar por trimestre + ano. Rótulo: 'Q1 2024'.

Modelo de Dados

As classes e interfaces que representam dados de gráficos, pontos de dados, temas e payloads de eventos de cliques.

ChartData

Agrupa os dados totalmente moldados necessários para renderizar um gráfico: uma lista de etiquetas de categoria (eixo X) e um ou mais conjuntos de dados. Retornado por métodos de fonte LoadAsync de dados.

ChartData Classe

Propriedades

Nome
Tipo
Padrão
Descrição
DatasetsList<ChartDataset>
Conjuntos de dados para plotar. O conjunto de dados de ChartDataset.Data cada conjunto o comprimento deve corresponder ChartData.Labels; os baldes que faltam são preenchido zero pelo servidor para que o alinhamento posicional seja preservado Em várias séries.
LabelsList<string>
Etiquetas de categoria renderizadas ao longo do eixo primário.
Nome: Datasets
Tipo: List<ChartDataset>
Descrição: Conjuntos de dados para plotar. O conjunto de dados de ChartDataset.Data cada conjunto o comprimento deve corresponder ChartData.Labels; os baldes que faltam são preenchido zero pelo servidor para que o alinhamento posicional seja preservado Em várias séries.
Nome: Labels
Tipo: List<string>
Descrição: Etiquetas de categoria renderizadas ao longo do eixo primário.

ChartDataset

Representa um único conjunto de dados (série) em um gráfico. Contém pontos de dados, um rótulo de legenda e substituições opcionais de cor para fundo e borda.

ChartDataset Classe

Propriedades

Nome
Tipo
Padrão
Descrição
BackgroundColorstring?
Cor de fundo padrão para cada elemento deste conjunto de dados para Tipos de cartas cartesianas. Para tipos de cartas radiais por ponto DataPoint.BackgroundColor Os overrides vencem. Quando null, o wrapper FluentUIChart preenche automaticamente a partir do ativo Paladar fluente.
BorderColorstring?
Cor padrão da borda. Semântica de precedência da mesma ChartDataset.BackgroundColor.
BorderWidthdouble
1
Largura da borda dos elementos em pixels. Valores fracionários são suportados (por exemplo, 0,5 para linhas finas, beirando telas de alto DPI). O padrão é 1.
DataList<DataPoint>
Pontos de dados neste conjunto de dados. Itens são Models.DataPoint ou uma subclasse (Models.DataverseDataPoint quando a fonte de dados é respaldado pelo Dataverse). O discriminador polimórfico '$type' é preservado através do JSON.
Labelstring
Rótulo legendário para esse conjunto de dados (ex.: 'Vendas' ou 'Venceu').
Nome: BackgroundColor
Tipo: string?
Descrição: Cor de fundo padrão para cada elemento deste conjunto de dados para Tipos de cartas cartesianas. Para tipos de cartas radiais por ponto DataPoint.BackgroundColor Os overrides vencem. Quando null, o wrapper FluentUIChart preenche automaticamente a partir do ativo Paladar fluente.
Nome: BorderColor
Tipo: string?
Descrição: Cor padrão da borda. Semântica de precedência da mesma ChartDataset.BackgroundColor.
Nome: BorderWidth
Tipo: double
Padrão: 1
Descrição: Largura da borda dos elementos em pixels. Valores fracionários são suportados (por exemplo, 0,5 para linhas finas, beirando telas de alto DPI). O padrão é 1.
Nome: Data
Tipo: List<DataPoint>
Descrição: Pontos de dados neste conjunto de dados. Itens são Models.DataPoint ou uma subclasse (Models.DataverseDataPoint quando a fonte de dados é respaldado pelo Dataverse). O discriminador polimórfico '$type' é preservado através do JSON.
Nome: Label
Tipo: string
Descrição: Rótulo legendário para esse conjunto de dados (ex.: 'Vendas' ou 'Venceu').

DataPoint

Implementação padrão de IDataPoint. Subclasse para anexar contexto definido pelo chamador (id de registro, região, etc.) que estará disponível para manipuladores de cliques.

DataPoint Classe

Propriedades

Nome
Tipo
Padrão
Descrição
BackgroundColorstring?
Cor de fundo por ponto. Usado por tipos de gráficos radiais (pie, donut, polarArea) para colorir segmentos individuais distintamente. Quando nulo, o wrapper FluentUIChart preenche automaticamente a partir do Paleta ativa.
BorderColorstring?
Cor da borda por ponto. Mesmas semânticas que DataPoint.BackgroundColor.
Valuedouble
0
O valor numérico representado por Chart.js.
Nome: BackgroundColor
Tipo: string?
Descrição: Cor de fundo por ponto. Usado por tipos de gráficos radiais (pie, donut, polarArea) para colorir segmentos individuais distintamente. Quando nulo, o wrapper FluentUIChart preenche automaticamente a partir do Paleta ativa.
Nome: BorderColor
Tipo: string?
Descrição: Cor da borda por ponto. Mesmas semânticas que DataPoint.BackgroundColor.
Nome: Value
Tipo: double
Padrão: 0
Descrição: O valor numérico representado por Chart.js.

DataverseDataPoint

Uma implementação que mantém o Dataverse TableRecord subjacente de onde IDataPoint foi projetada. Os manipuladores de cliques podem fazer patternmatching nesse tipo para acessar o id da linha, nome da tabela e valores das colunas.

DataverseDataPoint Classe

Propriedades

Nome
Tipo
Padrão
Descrição
BackgroundColorstring?
Cor de fundo por ponto. Usado por tipos de gráficos radiais (pie, donut, polarArea) para colorir segmentos individuais distintamente. Quando nulo, o wrapper FluentUIChart preenche automaticamente a partir do Paleta ativa.
BorderColorstring?
Cor da borda por ponto. Mesmas semânticas que DataPoint.BackgroundColor.
RecordTableRecord?
A linha do Dataverse de onde esse ponto de dados foi projetado. Anulável porque baldes com zero preenchimento em um pivô multi-série não possuem um Registro de origem.
Valuedouble
0
O valor numérico representado por Chart.js.
Nome: BackgroundColor
Tipo: string?
Descrição: Cor de fundo por ponto. Usado por tipos de gráficos radiais (pie, donut, polarArea) para colorir segmentos individuais distintamente. Quando nulo, o wrapper FluentUIChart preenche automaticamente a partir do Paleta ativa.
Nome: BorderColor
Tipo: string?
Descrição: Cor da borda por ponto. Mesmas semânticas que DataPoint.BackgroundColor.
Nome: Record
Tipo: TableRecord?
Descrição: A linha do Dataverse de onde esse ponto de dados foi projetado. Anulável porque baldes com zero preenchimento em um pivô multi-série não possuem um Registro de origem.
Nome: Value
Tipo: double
Padrão: 0
Descrição: O valor numérico representado por Chart.js.

ChartTheme

Sobreposições de tema e formatação aplicadas a uma instância de gráfico — cor do texto, cor da grade, formatação de valores no eixo Y (prefixo/sufixo), título do gráfico, modo empilhado e posição da legenda.

React Blazor

ChartTheme Classe

Propriedades

Nome
Tipo
Padrão
Descrição
EnableAnimationbool
True
Obtém ou define se as animações dos gráficos estão ativadas. O padrão é verdadeiro. Defina para false para desabilitar todas as animações de entrada e atualização.
GridColorstring?
Obtém ou define a cor usada para eixos, linhas de grade e bordas.
IndexAxisChartIndexAxis?
A Chart.js direção do eixo da categoria. Definido pela camada de componentes a partir do chamador Components.ChartOrientation via Components.ChartOrientation); os consumidores devem definir a Orientação no componente em vez dessa propriedade diretamente. Quando nulo, a camada JS aplica um padrão específico do tipo de gráfico. O enum o valor é convertido para a cadeia Chart.js minúscula no momento da serialização JSON (veja Components.ChartIndexAxis).
LegendPositionChartLegendPosition?
Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js é usado. O valor de enum é convertido para a string Chart.js minúscula no tempo de serialização JSON (veja Components.ChartLegendPosition).
Stackedbool
False
Obtém ou define se os eixos X e Y estão empilhados. Quando é verdade, os conjuntos de dados são empilhados por cima um do outro, em vez de exibidos lado a lado. Vale para gráficos de barras e linhas.
TextColorstring?
Obtém ou define a cor usada para texto padrão, legendas, marcadores de eixo e títulos.
Titlestring?
Recebe ou define o texto do título do gráfico exibido acima do gráfico. Quando nulo, nenhum título é mostrado.
XAxisPrefixstring?
Recebe ou define uma string prependida a cada etiqueta de tick do eixo X (por exemplo , 'Q' para quartos). Quando nulo, nenhum prefixo é aplicado.
XAxisSuffixstring?
Recebe ou define uma string anexada a cada etiqueta de tick do eixo X. Quando nulo, nenhum sufixo é aplicado.
YAxisPrefixstring?
Recebe ou define uma string prependida a cada etiqueta de tick e valor de tooltip no eixo Y (por exemplo , '$' para moeda). Quando nulo, nenhum prefixo é aplicado.
YAxisSuffixstring?
Recebe ou define uma string anexada a cada etiqueta de tick do eixo Y e valor de tooltip (por exemplo , '%' para porcentagens). Quando nulo, nenhum sufixo é aplicado.
Nome: EnableAnimation
Tipo: bool
Padrão: True
Descrição: Obtém ou define se as animações dos gráficos estão ativadas. O padrão é verdadeiro. Defina para false para desabilitar todas as animações de entrada e atualização.
Nome: GridColor
Tipo: string?
Descrição: Obtém ou define a cor usada para eixos, linhas de grade e bordas.
Nome: IndexAxis
Tipo: ChartIndexAxis?
Descrição: A Chart.js direção do eixo da categoria. Definido pela camada de componentes a partir do chamador Components.ChartOrientation via Components.ChartOrientation); os consumidores devem definir a Orientação no componente em vez dessa propriedade diretamente. Quando nulo, a camada JS aplica um padrão específico do tipo de gráfico. O enum o valor é convertido para a cadeia Chart.js minúscula no momento da serialização JSON (veja Components.ChartIndexAxis).
Nome: LegendPosition
Tipo: ChartLegendPosition?
Descrição: Posicionamento da legenda em relação à área do mapa, ou ChartLegendPosition.Hidden para esconder tudo completamente. Quando nulo, o padrão de Chart.js é usado. O valor de enum é convertido para a string Chart.js minúscula no tempo de serialização JSON (veja Components.ChartLegendPosition).
Nome: Stacked
Tipo: bool
Padrão: False
Descrição: Obtém ou define se os eixos X e Y estão empilhados. Quando é verdade, os conjuntos de dados são empilhados por cima um do outro, em vez de exibidos lado a lado. Vale para gráficos de barras e linhas.
Nome: TextColor
Tipo: string?
Descrição: Obtém ou define a cor usada para texto padrão, legendas, marcadores de eixo e títulos.
Nome: Title
Tipo: string?
Descrição: Recebe ou define o texto do título do gráfico exibido acima do gráfico. Quando nulo, nenhum título é mostrado.
Nome: XAxisPrefix
Tipo: string?
Descrição: Recebe ou define uma string prependida a cada etiqueta de tick do eixo X (por exemplo , 'Q' para quartos). Quando nulo, nenhum prefixo é aplicado.
Nome: XAxisSuffix
Tipo: string?
Descrição: Recebe ou define uma string anexada a cada etiqueta de tick do eixo X. Quando nulo, nenhum sufixo é aplicado.
Nome: YAxisPrefix
Tipo: string?
Descrição: Recebe ou define uma string prependida a cada etiqueta de tick e valor de tooltip no eixo Y (por exemplo , '$' para moeda). Quando nulo, nenhum prefixo é aplicado.
Nome: YAxisSuffix
Tipo: string?
Descrição: Recebe ou define uma string anexada a cada etiqueta de tick do eixo Y e valor de tooltip (por exemplo , '%' para porcentagens). Quando nulo, nenhum sufixo é aplicado.

ChartClickEventArgs

Carga útil que descreve um clique em um único elemento do gráfico (barra, fatia, ponto, etc.). Contém o índice do conjunto de dados, índice de dados, etiqueta, valor, etiqueta do conjunto de dados e a instância original IDataPoint para correspondência de padrões.

React Blazor

ChartClickEventArgs Classe

Propriedades

Nome
Tipo
Padrão
Descrição
DataIndexint
0
O índice base zero do ponto de dados dentro do seu conjunto de dados.
DataPointDataPoint?
A instância real Models.DataPoint que apoia o elemento clicado. Faça a correspondência de padrões com sua subclasse personalizada (por exemplo, Models.DataverseDataPoint) para acessar Contexto definido pelo chamador (ID do registro, categoria, etc.). Pode ser nulo se os índices de O JavaScript não corresponde mais ao conjunto de dados atual (por exemplo, porque os dados foram substituídos meio clique).
DatasetIndexint
0
O índice baseado em zero do conjunto de dados que contém o elemento clicado.
DatasetLabelstring
O rótulo do conjunto de dados ao qual o elemento clicado pertence (por exemplo , 'Vendas'), ou uma string vazia se o conjunto de dados não tiver rótulo.
Labelstring
O rótulo de categoria associado ao elemento clicado (por exemplo , 'Janeiro'), ou uma sequência vazia se o gráfico não tiver rótulos.
Valuedouble
0
O valor numérico do ponto de dados clicado.
Nome: DataIndex
Tipo: int
Padrão: 0
Descrição: O índice base zero do ponto de dados dentro do seu conjunto de dados.
Nome: DataPoint
Tipo: DataPoint?
Descrição: A instância real Models.DataPoint que apoia o elemento clicado. Faça a correspondência de padrões com sua subclasse personalizada (por exemplo, Models.DataverseDataPoint) para acessar Contexto definido pelo chamador (ID do registro, categoria, etc.). Pode ser nulo se os índices de O JavaScript não corresponde mais ao conjunto de dados atual (por exemplo, porque os dados foram substituídos meio clique).
Nome: DatasetIndex
Tipo: int
Padrão: 0
Descrição: O índice baseado em zero do conjunto de dados que contém o elemento clicado.
Nome: DatasetLabel
Tipo: string
Descrição: O rótulo do conjunto de dados ao qual o elemento clicado pertence (por exemplo , 'Vendas'), ou uma string vazia se o conjunto de dados não tiver rótulo.
Nome: Label
Tipo: string
Descrição: O rótulo de categoria associado ao elemento clicado (por exemplo , 'Janeiro'), ou uma sequência vazia se o gráfico não tiver rótulos.
Nome: Value
Tipo: double
Padrão: 0
Descrição: O valor numérico do ponto de dados clicado.

Fontes de Dados

Classes de fonte de dados que carregam dados de gráficos do Dataverse via consultas FetchXML.

DataverseChartDataSource

Classe base de fonte de dados que aceita FetchXML bruto e mapeamentos de colunas. Executa a consulta via IPowerPortalsProService, cuida RelatedRecordValue do desdobramento para resultados agregados, e molda as linhas em séries simples ou múltiplas ChartData.

React Blazor

DataverseChartDataSource Classe

Propriedades

Nome
Tipo
Padrão
Descrição
FetchXmlstring?
A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
LabelColumnstring
O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
SeriesColumnstring?
Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
SingleSeriesLabelstring
Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
ValueColumnstring
O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.
Nome: FetchXml
Tipo: string?
Descrição: A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
Nome: LabelColumn
Tipo: string
Descrição: O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
Nome: SeriesColumn
Tipo: string?
Descrição: Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
Nome: SingleSeriesLabel
Tipo: string
Descrição: Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
Nome: ValueColumn
Tipo: string
Descrição: O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.

Métodos

Nome
Parâmetros
Tipo
Descrição
LoadAsyncIChartService chartService
Task<ChartData>
Carrega dados do gráfico via o .Services.IChartService
Nome: LoadAsync
Parâmetros: IChartService chartService
Tipo: Task<ChartData>
Descrição: Carrega dados do gráfico via o .Services.IChartService

AggregateDataverseChartDataSource

Uma subclasse que constrói uma consulta agregada FetchXML a partir de propriedades simples (NomeTabla, GroupByColumn, AggregateColumn, Aggregate) em vez de exigir FetchXML bruto. Suporta bucketing de datas, multi-séries, filtragem baseada em visualização, fragmentos de filtro inline e joins de entidades vinculadas.

React Blazor

AggregateDataverseChartDataSource Classe

Propriedades

Nome
Tipo
Padrão
Descrição
AggregateAggregateType
Sum
A função agregada aplicada a AggregateDataverseChartDataSource.AggregateColumn.
AggregateColumnstring
A coluna Dataverse para agregar. Para AggregateType.Count Qualquer coluna serve. Conjuntos DataverseChartDataSource.ValueColumn na base Classe para que eles fiquem sincronizados.
FetchXmlstring?
A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
FilterXmlstring?
Fragmento de filtro FetchXML bruto opcional para injetar no consulta gerada (um <filtro completo>... </filtro>).
GroupByColumnstring
A coluna do Dataverse para agrupar por — torna-se o eixo X do gráfico rótulos. Conjuntos DataverseChartDataSource.LabelColumn na classe base para que fiquem sincronizados.
GroupByDateGroupingChartDateGrouping
None
Quando AggregateDataverseChartDataSource.GroupByColumn é uma coluna de data-hora, controles Como as datas são distribuídas em balde.
GroupByLinkedEntityChartLinkedEntity?
Cadeia opcional de entidades ligadas para AggregateDataverseChartDataSource.GroupByColumn. Quando definido, o atributo groupby é colocado dentro da entidade-link no FetchXML gerado.
LabelColumnstring
O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
SeriesColumnstring?
Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
SeriesDateGroupingChartDateGrouping
None
Agrupamento opcional de datas para a série — aplicado ao mesmo coluna como AggregateDataverseChartDataSource.GroupByColumn. Uso anual dos mapas ChartDateGrouping.Month em AggregateDataverseChartDataSource.GroupByDateGrouping e ChartDateGrouping.Year nesta propriedade. Quando definido, DataverseChartDataSource.SeriesColumn é ignorado.
SeriesLinkedEntityChartLinkedEntity?
Cadeia opcional de entidades vinculadas para DataverseChartDataSource.SeriesColumn.
SingleSeriesLabelstring
Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
TableNamestring
A tabela Dataverse para consultar (por exemplo, 'opportunity').
Topint?
Número máximo opcional de linhas agrupadas para retornar.
ValueColumnstring
O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.
ViewIdGuid?
ID opcional de visualização salva. Quando definido, as condições de filtro da vista são fundidos na consulta agregada gerada. Determina qual Os registros estão incluídos; A configuração agregada determina como eles são agrupados.
Nome: Aggregate
Tipo: AggregateType
Padrão: Sum
Descrição: A função agregada aplicada a AggregateDataverseChartDataSource.AggregateColumn.
Nome: AggregateColumn
Tipo: string
Descrição: A coluna Dataverse para agregar. Para AggregateType.Count Qualquer coluna serve. Conjuntos DataverseChartDataSource.ValueColumn na base Classe para que eles fiquem sincronizados.
Nome: FetchXml
Tipo: string?
Descrição: A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
Nome: FilterXml
Tipo: string?
Descrição: Fragmento de filtro FetchXML bruto opcional para injetar no consulta gerada (um <filtro completo>... </filtro>).
Nome: GroupByColumn
Tipo: string
Descrição: A coluna do Dataverse para agrupar por — torna-se o eixo X do gráfico rótulos. Conjuntos DataverseChartDataSource.LabelColumn na classe base para que fiquem sincronizados.
Nome: GroupByDateGrouping
Tipo: ChartDateGrouping
Padrão: None
Descrição: Quando AggregateDataverseChartDataSource.GroupByColumn é uma coluna de data-hora, controles Como as datas são distribuídas em balde.
Nome: GroupByLinkedEntity
Tipo: ChartLinkedEntity?
Descrição: Cadeia opcional de entidades ligadas para AggregateDataverseChartDataSource.GroupByColumn. Quando definido, o atributo groupby é colocado dentro da entidade-link no FetchXML gerado.
Nome: LabelColumn
Tipo: string
Descrição: O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
Nome: SeriesColumn
Tipo: string?
Descrição: Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
Nome: SeriesDateGrouping
Tipo: ChartDateGrouping
Padrão: None
Descrição: Agrupamento opcional de datas para a série — aplicado ao mesmo coluna como AggregateDataverseChartDataSource.GroupByColumn. Uso anual dos mapas ChartDateGrouping.Month em AggregateDataverseChartDataSource.GroupByDateGrouping e ChartDateGrouping.Year nesta propriedade. Quando definido, DataverseChartDataSource.SeriesColumn é ignorado.
Nome: SeriesLinkedEntity
Tipo: ChartLinkedEntity?
Descrição: Cadeia opcional de entidades vinculadas para DataverseChartDataSource.SeriesColumn.
Nome: SingleSeriesLabel
Tipo: string
Descrição: Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
Nome: TableName
Tipo: string
Descrição: A tabela Dataverse para consultar (por exemplo, 'opportunity').
Nome: Top
Tipo: int?
Descrição: Número máximo opcional de linhas agrupadas para retornar.
Nome: ValueColumn
Tipo: string
Descrição: O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.
Nome: ViewId
Tipo: Guid?
Descrição: ID opcional de visualização salva. Quando definido, as condições de filtro da vista são fundidos na consulta agregada gerada. Determina qual Os registros estão incluídos; A configuração agregada determina como eles são agrupados.

Métodos

Nome
Parâmetros
Tipo
Descrição
LoadAsyncIChartService chartService
Task<ChartData>
Carrega dados do gráfico via o .Services.IChartService
Nome: LoadAsync
Parâmetros: IChartService chartService
Tipo: Task<ChartData>
Descrição: Carrega dados do gráfico via o .Services.IChartService

ViewDataverseChartDataSource

Uma subclasse que resolve seu FetchXML a partir de uma visualização salva do Dataverse (consulta salva). O chamador ainda define LabelColumn e ValueColumn indica quais colunas mapeiam para rótulos e valores.

React Blazor

ViewDataverseChartDataSource Classe

Propriedades

Nome
Tipo
Padrão
Descrição
FetchXmlstring?
A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
LabelColumnstring
O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
SeriesColumnstring?
Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
SingleSeriesLabelstring
Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
ValueColumnstring
O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.
ViewIdGuid
00000000-0000-0000-0000-000000000000
O identificador único do Dataverse salvou a visualização para carregar. O servidor busca seu FetchXml a cada chamada (não cacheado neste caso camadas; ViewMetadataCache cuida do cache do lado do servidor).
Nome: FetchXml
Tipo: string?
Descrição: A consulta FetchXML para executar. A classe base envia isso no solicitar diretamente; Substituição de subclasses Models.ChartDataRequest) para usar um modo de entrada diferente.
Nome: LabelColumn
Tipo: string
Descrição: O nome da coluna do resultado deve ser usado para etiquetas de gráficos (eixo X). Para o raw FetchXML este é o nome lógico do atributo (ou seu alias, se for foi especificado no FetchXML).
Nome: SeriesColumn
Tipo: string?
Descrição: Nome opcional da coluna de resultado usado para dividir linhas em múltiplas conjuntos de dados. Quando definido, linhas que compartilham o mesmo valor de série são agrupados em um único conjunto de dados.
Nome: SingleSeriesLabel
Tipo: string
Descrição: Rótulo opcional de conjunto de dados aplicado ao conjunto de dados emitido individualmente quando DataverseChartDataSource.SeriesColumn não está definido. Uso de consultas multi-série o valor da série formatada como o rótulo do conjunto de dados e ignore isso.
Nome: ValueColumn
Tipo: string
Descrição: O nome da coluna do resultado para ler valores numéricos de. Deve Consulte uma coluna numérica nas linhas retornadas.
Nome: ViewId
Tipo: Guid
Padrão: 00000000-0000-0000-0000-000000000000
Descrição: O identificador único do Dataverse salvou a visualização para carregar. O servidor busca seu FetchXml a cada chamada (não cacheado neste caso camadas; ViewMetadataCache cuida do cache do lado do servidor).

Métodos

Nome
Parâmetros
Tipo
Descrição
LoadAsyncIChartService chartService
Task<ChartData>
Carrega dados do gráfico via o .Services.IChartService
Nome: LoadAsync
Parâmetros: IChartService chartService
Tipo: Task<ChartData>
Descrição: Carrega dados do gráfico via o .Services.IChartService

ChartLinkedEntity

Descreve uma entidade ligada (join) usada por AggregateDataverseChartDataSource para colocar um atributo groupby ou série em uma tabela relacionada. Suporta aninhamento ilimitado via propriedade LinkedEntity para joins multi-hop (por exemplo, opportunity → conta → unidade de negócio).

ChartLinkedEntity Classe

Propriedades

Nome
Tipo
Padrão
Descrição
Fromstring
Coluna na tabela vinculada que fornece a chave de junção (ex.: 'accountid').
JoinTypeJoinOperator
Inner
Tipo de entrada. O padrão é .JoinOperator.Inner
LinkedEntityChartLinkedEntity?
Entidade vinculada a filho opcional para joins multi-hop. O O atributo groupby/série é colocado no mais interno entidade na cadeia.
TableNamestring
Nome lógico da tabela vinculada (ex.: 'conta').
Tostring
Coluna na tabela pai (ou entidade de ligação pai) para se unir a (por exemplo, 'customerid').
Nome: From
Tipo: string
Descrição: Coluna na tabela vinculada que fornece a chave de junção (ex.: 'accountid').
Nome: JoinType
Tipo: JoinOperator
Padrão: Inner
Descrição: Tipo de entrada. O padrão é .JoinOperator.Inner
Nome: LinkedEntity
Tipo: ChartLinkedEntity?
Descrição: Entidade vinculada a filho opcional para joins multi-hop. O O atributo groupby/série é colocado no mais interno entidade na cadeia.
Nome: TableName
Tipo: string
Descrição: Nome lógico da tabela vinculada (ex.: 'conta').
Nome: To
Tipo: string
Descrição: Coluna na tabela pai (ou entidade de ligação pai) para se unir a (por exemplo, 'customerid').

Compartilhamento de uma fonte de dados entre uma grade e um gráfico

A ViewDataSource pode acionar um MainGrid e um (ou mais) DataverseChart componentes em sintonia perfeita. Uma ida e volta do servidor retorna a página da linha e a agregação do gráfico de forma atômica, então não há corrida onde o gráfico mostre números de um filtro antigo enquanto a grade está em um novo. Buscar, ordenar, paginar e visualizar as alterações em qualquer um dos consumidores passam pela mesma fonte de dados.

Construa a fonte de dados em OnInitialized (para que o injetado IGridService esteja disponível) e passe para ambas as vistas via DataSource. A grade renderiza a página da linha; O mapa apresenta AggregationResults[AggregationIndex]. Múltiplas agregações são suportadas — cada entrada alimenta um gráfico separado apontando para a mesma fonte de dados.

React
Blazor

Clicar em uma fatia de gráfico define a , que Highlightescurece as linhas não correspondentes na grade pareada (e as fatias não correspondentes no gráfico) sem necessidade de buscar novamente. Clique na mesma fatia novamente para limpar. Para navegar de perfuração ou um filtro rígido, ajuste CrossFilterMode="ChartCrossFilterMode.None" e se controle OnElementClick por conta própria.