KPIs y métricas
Tarjetas, tiras y filas de indicadores, la estadística que elige su formato, comparativas de tiempo y resúmenes de informe.
Componentes para cuadros de mando: la cifra, su etiqueta y la tendencia.
| Necesitas | Componente |
|---|---|
| Una cifra destacada con icono, color y tendencia | DnzKpiCard |
| Varias tarjetas KPI en una rejilla que se adapta al ancho | DnzKpiRow |
| Una tira horizontal compacta de números | DnzKpiInline |
| Un grupo de estadísticas valor + etiqueta en una tarjeta | DnzStatsDisplay |
| Un dato suelto con icono y contenido libre como valor | DnzStatItem |
| Un KPI, una gráfica o una tabla según la forma del dato | DnzDynamicStat |
| Tiempo previsto frente a tiempo real, con semáforo | DnzTimeComparisonDisplay |
| Progreso real frente a progreso esperado | DnzProgressRhythm |
| Los totales de un informe de Flex | DnzSummaryBar |
| Tarjeta pequeña icono + etiqueta + valor | DnzCardKV, en Tarjetas y maquetación |
Casi todos reciben la cifra ya formateada como texto ("1.250 €"): separador de miles, moneda y decimales los pones tú. Las variaciones (DeltaPercent) entran como decimal y DnzDynamicStat formatea según DnzDynamicStatFormatE.
DnzKpiCard y DnzKpiRow
DnzKpiCard muestra título, cifra, icono, color, variación con flecha y un minigráfico opcional. Con más de una, colócalas en un DnzKpiRow, que reparte columnas según MinCardWidth (px, por defecto 220) y las baja de línea cuando no caben.
<DnzKpiRow MinCardWidth="260">
<DnzKpiCard Title="Ventas del mes" Value=@($"€ {ventasMes:N0}") Icon="payments" Color="#1565c0" DeltaPercent=@variacionPct DeltaLabel="frente al mes anterior" />
<DnzKpiCard IsCompact=true Title="Activas" Value=@activas.STR() Icon="check_circle" Color="#16a34a" />
<DnzKpiCard Title="MRR" Value=@($"€ {mrr:N0}") Icon="trending_up" HighlightColor="DnzKpiCard.HighlightColorType.Green" />
</DnzKpiRow>La variación se colorea sola (positivo verde, negativo rojo, cero gris). Si subir es malo (gastos, tiempos), pon DeltaInvertColors=true.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Title | string | "" | Etiqueta de la cifra. |
Value | string | "" | La cifra, ya formateada. |
Icon | string | "" | Icono Material. |
Color | string | "light-dark(black, var(--rz-text-color))" | Color del texto y del icono. |
Description | string | "" | Texto pequeño bajo la cifra. |
IsCompact | bool | false | Versión de una línea. |
HighlightColor | HighlightColorType | Undefined | Degradado de fondo con texto en blanco: Auto, Red, Blue, Green, Yellow, Orange, Purple, Black, White, Gray. |
DeltaPercent | decimal? | null | Porcentaje de cambio, con flecha y signo. |
DeltaLabel | string | "" | Texto junto a la variación. |
DeltaInvertColors | bool | false | Invierte verde y rojo. |
TrendContent | RenderFragment | Minigráfico de tendencia. | |
ButtonText | string | "" | Con texto, un botón de acción al pie. |
ButtonIcon | string | "" | Icono del botón. |
OnClick | EventCallback | Al pulsar el botón. | |
Tooltip | string | "" | Texto al pasar el ratón por la tarjeta. |
Variant | Radzen.Variant? | sin fijar | Variante de la tarjeta base. |
Class | string | "" | Clases CSS extra. |
Style | string | "" | Estilo en línea adicional. |
HighlightColorType.Auto mira los dígitos del Value: verde si hay alguno distinto de cero, rojo si además hay un signo menos y gris sin dígitos. Con formatos poco habituales, fija el color.
DnzKpiInline
Tira de números para cabeceras de ficha o pies de tarjeta. Los elementos van en una lista, no como marcado hijo.
<DnzKpiInline Items=@KpiItems Separator="DnzKpiInline.SeparatorType.Pipe" />
@code {
List<DnzKpiInline.ItemModel> KpiItems = new()
{
new("Horas oficiales", "40h 00m", Icon: "calendar_month"),
new("Realizado", "38h 30m", Icon: "work", ValueColor: "#d97706"),
};
}ItemModel lleva Label, Value y, opcionales, Icon, ValueColor, IconColor (vacío hereda ValueColor) y Tooltip. Separator admite None, MiddleDot (por defecto), Pipe y Slash. También acepta Class, Style y TestId (el data-testid).
DnzStatItem
Icono, valor grande y etiqueta debajo. El valor es contenido libre: cabe un DnzSpanMoney u otro componente.
<DnzStatItem Label="Facturado" Icon="payments"><DnzSpanMoney Amount=@totalFacturado /></DnzStatItem>| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
ChildContent | RenderFragment | El valor. | |
Label | string | "" | Etiqueta bajo el valor. |
Icon | string | "" | Icono Material, o imagen si empieza por / o http. |
IconColor | string | "var(--rz-primary)" | Color del icono. |
IconSize | string | "40px" | Tamaño del icono. |
ValueColor | string | "" | Color del valor. |
ValueSize | string | "fs-3" | Clase Bootstrap de tamaño del valor. |
Visible | bool | true | Con false no se muestra. |
Class | string | "" | Clases del contenedor. |
DnzStatsDisplay
Una celda por métrica (valor grande, unidad pequeña y etiqueta), repartidas en horizontal. Statistics es obligatorio; Variant sin fijar lo decide la profundidad de DnzCard.
<DnzStatsDisplay Statistics=@stats Variant="Variant.Text" />
@code {
private List<DnzStatsDisplay.StatisticModel> stats = new()
{
new() { Value = "12", Label = "Usuarios" },
new() { Value = "45,3", Label = "Base de datos", Unit = "GB" },
};
}DnzDynamicStat
Recibe un DnzDynamicStatData y elige cómo mostrarlo. Con Render="Auto", las series de un solo valor salen como KPI y las series con categorías, como gráfica hasta 20 categorías y como tabla por encima. Con AllowViewSwitch=true, el usuario alterna entre columnas, líneas, anillo, barras apiladas, radar, polar y tabla.
<DnzDynamicStat Data=@_dataEvolucion ChartType="DnzDynamicStatChartTypeE.Line" AllowViewSwitch=true ChartHeight="280" />
@code {
private DnzDynamicStatData _dataEvolucion = new()
{
IsLoaded = true,
Series = new()
{
new DnzDynamicStatSeries
{
Label = "Ingresos", Color = "#16a34a", Format = DnzDynamicStatFormatE.Money,
Items = new() { new("Ene", 48250), new("Feb", 51900) }
},
new DnzDynamicStatSeries
{
Label = "Gastos", Color = "#dc2626", Format = DnzDynamicStatFormatE.Money,
Items = new() { new("Ene", 31200), new("Feb", 29800) }
}
}
};
}Una serie con SingleValue en lugar de Items se muestra como tarjeta KPI: new DnzDynamicStatSeries { Label = "Ventas", SingleValue = 48250, Format = DnzDynamicStatFormatE.Money }.
Muestra un DnzSkeleton mientras IsLoading es true o Data.IsLoaded es false, y el error si Data.ErrorMessage tiene texto. Para rellenarlo, usa IAQuery: una consulta por corte, no por tarjeta.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Data | DnzDynamicStatData | Obligatorio. Series, filas y estado de carga. | |
IsLoading | bool | false | Fuerza el esqueleto. |
Title | string | "" | Título del KPI o la gráfica. |
Icon | string | "" | Icono Material. |
Color | string | "" | Color del texto en modo KPI. |
Render | DnzDynamicStatRenderE | Auto | Auto, Kpi, Chart o Table. |
ChartType | DnzDynamicStatChartTypeE | Column | Column, Bar, Line, Donut, Spider, PolarArea, StackedBar. |
HighlightColor | DnzKpiCard.HighlightColorType | Undefined | Degradado en modo KPI. |
IsCompact | bool | false | KPI de una línea. |
Variant | Radzen.Variant? | sin fijar | Variante de la tarjeta en modo KPI. |
Description | string | "" | Texto bajo la cifra en modo KPI. |
ChartHeight | int | 300 | Alto de la gráfica en px. |
ShowLegend | bool | true | Leyenda. |
ShowDataLabels | bool | false | Valores sobre la gráfica. |
PageSize | int | 10 | Filas por página en modo tabla. |
AllowViewSwitch | bool | false | Barra para cambiar de vista. Solo con datos agrupados. |
OnClick | EventCallback | Al pulsar el KPI. | |
Class | string | "" | Clases CSS extra. |
Style | string | "" | Estilo en línea adicional. |
Los tipos están en DinaZen.Components.DnzDynamicStat:
| Clase | Campos | Para qué |
|---|---|---|
DnzDynamicStatData | Series, Columns, RawRows, ColumnLabels, Total, TimeMs, IsLoaded, ErrorMessage | El paquete completo. IsSingleValue, IsMultiKpi, HasGroupedData y MaxItemCount se calculan y guían Render="Auto". |
DnzDynamicStatSeries | Label, Color, Format, SingleValue, Items | Una serie: un SingleValue (KPI) o una lista de Items (gráfica). GroupedTotal suma los Items. |
DnzDynamicStatDataItem | Category, Value | Un punto: new(category, value). |
DnzStatParameter | Field, Aggregation, Label, Color, Format | Un dato a agregar (Sum, Count, Avg, Min, Max, None), para construir el DnzDynamicStatData desde una consulta. |
DnzDynamicStatFormatE: Auto, Money, Decimal, Integer, Percent y Raw.
DnzTimeComparisonDisplay
Compara tiempo planificado con tiempo real, en minutos: verde hasta el 80 %, amarillo hasta el 100 % y rojo al pasarse. PlannedTime="480" ActualTime="510" muestra 8h 30m / 8h, +30m en rojo y la barra.
<DnzTimeComparisonDisplay PlannedTime="120" ActualTime="90" Label="Montaje" Compact=true />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
PlannedTime | decimal | 0 | Minutos planificados. Con 0, solo muestra el tiempo real. |
ActualTime | decimal | 0 | Minutos reales. Con los dos a 0, no muestra nada. |
ShowProgressBar | bool | true | Barra de progreso (con tiempo planificado). |
ShowDiff | bool | true | Etiqueta con la diferencia (+30m, -1h 10m). |
Compact | bool | false | Una sola línea, para tablas y pies de tarjeta. |
Label | string | "" | Etiqueta encima; también va al texto emergente. |
DnzProgressRhythm
Barra con el progreso real (CurrentProgress) y una marca con el esperado (ExpectedProgress), los dos en porcentaje. Indica si vas adelantado, en ritmo o retrasado. Los textos por defecto están en inglés: cámbialos por parámetro.
<DnzProgressRhythm CurrentProgress="62" ExpectedProgress="70" Title="Objetivo trimestral" ExpectedLabel="esperado" GoalAchievedText="Objetivo cumplido" OnTrackText="En ritmo" AheadText="Adelantado" BehindText="Retrasado" />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
CurrentProgress | decimal | 0 | Progreso real. Por encima de 100, cumplido. |
ExpectedProgress | decimal | 0 | Progreso esperado hoy. Con 0 no hay marca ni comparativa. |
Title | string | "Progress" | Título. |
ExpectedLabel | string | "expected" | Etiqueta del esperado. |
GoalAchievedText | string | "Goal achieved!" | Texto al llegar al 100 %. |
OnTrackText | string | "On track" | Texto si real y esperado coinciden. |
AheadText | string | "Ahead by" | Prefijo si vas por delante. |
BehindText | string | "Behind by" | Prefijo si vas por detrás. |
DnzSummaryBar
Dentro de un DnzReportProvider, suma las columnas de dinero y la de minutos, cuenta los true de las booleanas y muestra el rango de la fecha principal. Sin filas, no aparece.
<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
<DnzSummaryBar />
</DnzReportProvider>