Tablas e informes

Un informe de Dinaup Flex vive en el servidor: tú lo pides por su ReportId con el SDK .NET y te devuelve filas tipadas con sus columnas, formatos y totales. Esta familia coge ese resultado y lo pinta —tabla, tarjetas, gráfica o ranking— con el mismo aspecto que Play y sin que escribas una sola RadzenDataGridColumn a mano.

La decisión es una sola: ¿quieres una rejilla completa o varias vistas del mismo informe a la vez? Para lo primero, DnzReportView directo. Para lo segundo, DnzReportProvider como contenedor que carga el informe una vez y lo reparte por cascada a sus hijos.

¿Tabla suelta o dashboard?

<DnzReportView Client=@Client ReportId="3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f" />

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzChartView ChartType="DnzChartView.ChartTypeE.Column" />
    <DnzTopN N="5" />
</DnzReportProvider>

DnzReportView

La tabla completa de Play a partir de un ReportId: columnas tipadas, orden multi-columna, filtros avanzados, paginación server-side, exportar CSV y doble clic para abrir la ficha.

<RadzenCard>
    <DnzCardTitle Title="Facturas emitidas" Icon="receipt_long" />
    <DnzReportView Client=@Client ReportId="3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f" OnItemSelect=@AbrirFactura />
</RadzenCard>

@code {
    private async Task AbrirFactura(DinaupDynamicRowDTO fila) {
        await DnzFormView.OpenAsync(DialogService, Client, fila.SectionId, fila.ID);
    }
}

Para embeberlo dentro de otra ficha sin barra de título ni botón de añadir:

<DnzReportView Client=@Client ReportId=@Container.TokenList ShowTitle=false ShowAdd=false />

Parámetros

Las columnas se pintan solas

No declaras columnas. DnzReportView lee el formato de cada campo del informe (DEC, INT, DATE, BOOL, texto…) y elige la plantilla adecuada: importes con DnzSpanMoney y suma en el pie, fechas en formato local, booleanos como badge Sí/No, estados con color. Tú solo le das el ReportId; el informe manda.

Lo único que personalizas por plantilla es la barra de herramientas, vía ToolBarTemplate:

<DnzReportView Client=@Client ReportId="3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f">
    <ToolBarTemplate>
        <RadzenButton Text="Acción" Icon="bolt" Size="ButtonSize.Small" Click=@HacerAlgoAsync IsBusy=@_busy />
    </ToolBarTemplate>
</DnzReportView>

Abrirlo sin colocarlo en el markup

DnzReportView expone dos métodos estáticos para abrirlo bajo demanda como diálogo o ventana flotante:

await DnzReportView.OpenAsync(DialogService, Client, "3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f", title: "Facturas");

public static Task OpenAsync(DialogService ds, DinaupClientC client, string reportId, Dictionary<string, string> vars = null, string title = "Informe", string width = "90%", string height = "80%")

DnzReportView.OpenAsWindow(WindowManager, Client, "3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f", title: "Facturas", icon: "receipt_long");

public static string OpenAsWindow(DnzWindowManagerService wm, DinaupClientC client, string reportId, Dictionary<string, string> vars = null, string title = "Informe", string icon = "analytics")

DnzReportProvider

Contenedor "headless": carga el informe una vez y lo reparte por cascada a sus hijos vía ReportContext. No dibuja tabla; es el grifo de datos para dashboards con varias vistas del mismo informe.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <div class="d-flex flex-column gap-3">
        <DnzChartView ChartType="DnzChartView.ChartTypeE.Bar" />
        <DnzTopN N="5" />
        <DnzCardList MaxFields="3" />
    </div>
</DnzReportProvider>

Las vistas hijas van dentro de ChildContent (el contenido entre las etiquetas del Provider), así que es un RenderFragment: metes el markup que quieras y las vistas leen el contexto por cascada.

Parámetros

DnzCardList

Pinta las filas del informe como tarjetas en vez de rejilla: título, una imagen de preview si la fila la trae, unos pocos campos y el importe destacado. Va dentro de un DnzReportProvider.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzCardList MaxFields="4" OnItemSelect=@AbrirFicha />
</DnzReportProvider>

@code {
    private async Task AbrirFicha(DinaupDynamicRowDTO fila) {
        await DnzFormView.OpenAsync(DialogService, Client, fila.SectionId, fila.ID);
    }
}

Parámetros

Además acepta atributos extra (class, style, data-*…) que se aplican al div raíz de la lista.

DnzChartView

Gráfica del informe (columnas, barras, líneas, área o tarta) agrupando por una categoría y sumando una métrica. Vive dentro de DnzReportProvider.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzChartView ChartType="DnzChartView.ChartTypeE.Column" CategoryColumn="cliente" ValueColumn="total_facturado" MaxItems="12" />
</DnzReportProvider>

Parámetros

Además acepta atributos extra que se aplican al div raíz de la gráfica.

DnzTopN

Ranking visual de barras horizontales con las N filas de mayor (o menor) valor del informe. Va dentro de un DnzReportProvider.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzTopN N="5" ValueColumn="total_facturado" />
</DnzReportProvider>

Parámetros

DnzFilter

El sistema de filtros por columna de DnzReportView. No lo colocas tú: la propia tabla lo inserta en la cabecera de cada columna y elige el filtro adecuado según el tipo del campo.

<FilterTemplate Context="data">
    <DnzFilter Column=@col DataColumn=@data />
</FilterTemplate>

Parámetros

DnzFilter es un router: según el formato de la columna delega en el filtro especializado correspondiente. La familia completa:

Leer una fila

Las filas que reparten estos componentes son DinaupDynamicRowDTO. Para sacar el texto de una columna usa .GetLegible("columna"); ID y SectionId vienen rellenos para abrir la ficha.

@code {
    private async Task AbrirFila(DinaupDynamicRowDTO fila) {
        var nombre = fila.GetLegible("cliente");
        await DnzFormView.OpenAsync(DialogService, Client, fila.SectionId, fila.ID);
    }
}

Relacionado

• Selectores — cuando el caso es "elige una ficha" a partir de un informe.
• KPIs y métricas — cifras y comparativas para completar el dashboard.
• Datos tipados (Spans) — DnzSpanMoney, DnzSpanMinutes y demás, lo que estas vistas usan por dentro.
• Cookbook de patrones — recetas de extremo a extremo que combinan estos componentes con el SDK.
• Informes de Dinaup Flex — qué es un informe, su ReportId, variables y filtros. · Filtrar un informe por rango de fechas
• SDK / Cliente Dinaup — cómo ejecutar el informe con Report_GetAsync.

→ Volver a Componentes · DinaZen · SDK .NET