Tablas e informes

Un informe de Dinaup Flex se define en el servidor: se pide por su ReportId con el SDK .NET y devuelve filas tipadas con sus columnas, formatos y totales. Esta familia toma ese resultado y lo muestra (tabla, tarjetas, gráfica o clasificación) con el mismo aspecto que Play y sin escribir ninguna RadzenDataGridColumn.

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

Qué componente uso

Tabla suelta o cuadro de mando

<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, filtros por columna, paginación en servidor, exportación a CSV y apertura de la ficha al pulsar una fila.

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

@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="3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f" ShowTitle=false ShowAdd=false />

Parámetros

Métodos públicos por @ref: UpdateAsync() recarga el informe, UpdateSearchAsync(string query) cambia la búsqueda y ClearCellSelectionAsync() vacía la selección de celdas. GenerateCsvAsync() devuelve el CSV, su nombre de fichero y el número de filas, sin descargarlo. LoadedReportId dice qué informe se cargó de verdad. Si en ReportId pasas el GUID de una sección, el servidor carga su informe principal (el del rol, si lo tiene). Vale "" hasta la primera carga.

La paginación no usa el recuento del servidor. Siguiente se activa cuando la página vuelve llena, y la navegación para en la fila 50.000: más allá, filtra.

El botón de exportar recorre el informe en páginas de 5.000 filas hasta 50.000 y separa con ;. Escribe las fechas con hora en la hora de la empresa (ICultureService), como las muestra la tabla. ReportCsvExporter.Build(rows, columns, title, regionService) hace la misma serialización para integraciones y pide el ICultureService como cuarto parámetro.

Columnas automáticas

No declaras columnas. DnzReportView lee el formato de cada campo del informe y elige la plantilla: importes con DnzSpanMoney y suma en el pie, decimales y enteros con suma, fechas en formato local, booleanos como etiqueta, estados con color. Tú indicas el ReportId; el formato lo decide el informe.

Lo único que personalizas por plantilla es la barra de herramientas, con 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>

Selección de celdas

Con AllowCellSelection=true, Ctrl+clic suma o quita una celda y Mayús+clic marca el rectángulo que va desde la última celda elegida. Un clic sin teclas abre la ficha, como sin selección, y vacía lo elegido. SelectedCellsChanged entrega un DnzCellSelection con tres lecturas de la misma selección: Cells (fila y campo de cada celda, como DnzSelectedCell(RowId, Keyword)), RowIds (sobre qué registros se va a escribir) y Keywords (qué campos tienen algo elegido). Sirve de base para una edición masiva o para copiar.

Qué pasa al pulsar una fila

Sin OnItemSelect, el componente pregunta primero al DnzInterceptorService registrado por AddDinaZen (OnOpenRecord) y, si nadie intercepta, abre la ficha con DnzFormView.OpenAsync. El botón de añadir hace lo mismo con OnOpenNewRecord. Así la app anfitriona decide cómo se abren las fichas sin cambiar cada tabla.

@inject DnzInterceptorService Interceptor

@code {
    protected override void OnInitialized()
    {
        Interceptor.OnOpenRecord = async req =>
        {
            DnzFormView.OpenAsWindow(WindowManager, req.Client, req.SectionId, req.RowId, title: req.Title);
            return true;
        };
    }
}

Abrirlo sin colocarlo en el marcado

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%", List<FilterCondition> filter = null)

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 sin tabla: carga el informe una vez y lo reparte por cascada a sus hijos como ReportContext. Es la fuente de datos para cuadros de mando con varias vistas del mismo informe.

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

Parámetros

ReportContext

Lo que reciben los hijos por [CascadingParameter].

DnzCardList

Muestra las filas del informe como tarjetas en vez de rejilla: título, imagen de vista previa 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

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. Va 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

Acepta atributos extra que se aplican al div raíz.

DnzTopN

Clasificación en barras horizontales con las N filas de mayor (o menor) valor del informe. Va dentro de DnzReportProvider.

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

Parámetros

DnzResponseQuestions

Formulario que pide al usuario las variables que el informe o el documento necesita antes de ejecutarse. DnzReportView y DnzReportProvider lo montan solos cuando VariablesValues no cubre todas las variables; lo instancias tú solo si construyes la petición a mano.

<DnzResponseQuestions Variables=@_report.VariableList.Variables VariableValues=@_valores Client=@Client StorageKey=@reportId OnConfirm=@Ejecutar />

Parámetros

DnzFilter

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

Parámetros

DnzFilter delega en el filtro especializado según el formato de la columna:

DnzReportDebugDialog

Diálogo con el desglose de tiempos (cliente y servidor) y los metadatos de un informe ya cargado. DnzReportView lo abre al pulsar el tiempo de carga (ShowLoadTime).

Task DnzReportDebugDialog.OpenAsync(DialogService ds, DinaupReportDataDTO data, long clientMs, string reportId)

Leer una fila

Las filas que reparten estos componentes son DinaupDynamicRowDTO. Para el texto de una columna usa GetLegible("keyword"); ID y SectionId vienen rellenos (como string) 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 cuadro de mando.
• Datos tipados (Spans): DnzSpanMoney, DnzSpanMinutes y el resto, lo que estas vistas usan por dentro.
• Patrones de uso: ejemplos completos que combinan estos componentes con el SDK.
• Informes de Dinaup Flex: qué es un informe, su ReportId, variables y filtros.
• Cliente Dinaup: cómo ejecutar el informe con Report_GetAsync.

→ Componentes · DinaZen · SDK .NET