Skip to Content
Componentes

Tablas e informes

Componentes que ejecutan un informe de Dinaup Flex por su GUID y muestran sus filas como tabla, tarjetas, gráfica o clasificación, con filtros por columna.

Estos componentes ejecutan un informe de Flex por su ReportId y muestran sus filas con el aspecto de Play, sin declarar columnas. DnzReportView muestra la tabla completa. DnzReportProvider carga el informe una vez y lo reparte a varias vistas.

NecesitasComponente
La tabla con buscador, filtros, paginación y CSVDnzReportView
Cargar el informe una vez y mostrarlo de varias formasDnzReportProvider
Las filas como tarjetas con imagen, título e importeDnzCardList
Una gráfica agrupada por categoríaDnzChartView
Las N filas de mayor valorDnzTopN
Totales de dinero, minutos y booleanosDnzSummaryBar, en KPIs y métricas
Cuántas filas hay en cada estadoDnzStatusSummary, en Etiquetas y estados
Pedir las variables que faltan antes de ejecutarDnzResponseQuestions

DnzReportView

La tabla de Play a partir de un ReportId: columnas tipadas, orden, filtros por columna, paginación en servidor, CSV y apertura de la ficha al pulsar una fila.

Un informe de facturas de venta pintado por DnzReportView: buscador, columnas de texto, fecha, importe, sí o no y estado con su etiqueta de color, y los totales del pie
<DnzReportView Client=@Client ReportId="3f2a9c10-8b4e-4d21-9f77-1a2b3c4d5e6f" OnItemSelect=@AbrirFactura />

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

Las filas son DinaupDynamicRowDTO: GetLegible("keyword") da el texto de una columna, y ID y SectionId (string) sirven para abrir la ficha. Para embeberlo en otra ficha, pasa ShowTitle=false ShowAdd=false.

ParámetroTipoPor defectoQué hace
ClientDinaupClientCObligatorio. Cliente que ejecuta el informe.
ReportIdstring""Obligatorio. GUID del informe. Con el GUID de una sección, el servidor carga su informe principal (el del rol, si lo tiene).
VariablesValuesDictionary<string, string>nullValores de las variables. Las que falten las pide DnzResponseQuestions.
QuerySearchstring""Búsqueda inicial. Cambiarla recarga el informe.
AdvancedFilterList<FilterCondition>nullFiltros en servidor de entrada, además de los del usuario.
Limitint25Filas por página. El usuario elige entre 25, 50, 100, 250, 500, 1000 y 3000.
OrdenDictionary<string, bool>nullOrden inicial por columna (true = descendente).
ShowTitlebooltrueCabecera con icono, título y selector de columnas visibles.
Titlestring""Sobrescribe el título del informe.
ShowSearchbooltrueBuscador de la cabecera.
FiltrablebooltrueFiltros por columna.
ShowAddbooltrueBotón de crear un registro de la sección.
ShowLoadTimebooltrueTiempo de carga; al pulsarlo abre DnzReportDebugDialog con los tiempos y metadatos del informe.
AdminModeboolfalseCarga en modo administrador.
ToolBarTemplateRenderFragmentnullBotones extra en la barra de herramientas.
OnItemSelectEventCallback<DinaupDynamicRowDTO>Al pulsar una fila. Sustituye la apertura de la ficha.
OnDataChangedEventCallbackCada vez que el informe recarga.
AllowCellSelectionboolfalseSelección de celdas con Ctrl+clic y Mayús+clic.
SelectedCellsChangedEventCallback<DnzCellSelection>La selección de celdas cada vez que cambia.
FetchInterceptorFunc<string, bool, Func<Task<ReportResponse>>, Task<ReportResponse>>nullGancho de caché: recibe la clave de la petición, si es refresco forzado y la carga real, y decide si sirve de caché.

Métodos por @ref: UpdateAsync() recarga, UpdateSearchAsync(string query) cambia la búsqueda, ClearCellSelectionAsync() vacía la selección y GenerateCsvAsync() devuelve el CSV, su nombre de fichero y el número de filas sin descargarlo. LoadedReportId dice qué informe se cargó ("" hasta la primera carga).

  • 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.
  • CSV. El botón de exportar recorre el informe en páginas de 5.000 filas hasta 50.000, separa con ; y escribe las fechas con hora en la hora de la empresa. ReportCsvExporter.Build(rows, columns, title, regionService) hace lo mismo desde código.
  • Columnas. Salen del formato de cada campo: importes con DnzSpanMoney y suma al pie, números con suma, fechas en formato local, booleanos como etiqueta, estados con color.
  • Columnas visibles y orden. Se guardan en localStorage por ruta y ReportId solo si pones DnzReportView.DisableLocalStorageSettings = false al arrancar la app (por defecto vale true).
  • Selección de celdas. Ctrl+clic suma o quita una celda y Mayús+clic marca el rectángulo desde la última. Un clic sin teclas abre la ficha y vacía la selección. DnzCellSelection trae Cells (cada celda como DnzSelectedCell(RowId, Keyword)), RowIds y Keywords, para una edición masiva o para copiar.

Abrirlo como diálogo o ventana

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)
public static string OpenAsWindow(DnzWindowManagerService wm, DinaupClientC client, string reportId, Dictionary<string, string> vars = null, string title = "Informe", string icon = "analytics")

Cómo se abren las fichas: DnzInterceptorService

Sin OnItemSelect, la tabla pregunta antes al DnzInterceptorService que registra AddDinaZen y, si nadie intercepta, abre la ficha con DnzFormView.OpenAsync. Con sus ganchos, la app anfitriona cambia cómo se abren las fichas sin tocar cada tabla. DnzFormView consulta el mismo servicio.

@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;
        };
    }
}
GanchoCuándoDevuelve true para
OnOpenRecordAntes de abrir un registro (fila de informe, Acceder en un campo relación).Omitir la apertura por defecto.
OnOpenNewRecordAntes de crear un registro (botón de añadir).Omitir la apertura por defecto.
OnFormSavedTras guardar un formulario, antes de cerrarlo.Que el formulario no se cierre.
OnGetFormExtensionsAl montar el pie del formulario.Devuelve la lista de botones de extensión.
OnDocumentSendEmail, OnDocumentSendEmailWithAttachment, OnDocumentRequestSignAcciones de un documento dinámico. Sin delegado, el botón no aparece.

Filtros por columna

La tabla pone en cada cabecera el filtro que corresponde al formato de la columna: DnzTextFilter (texto y por defecto), DnzIntegerFilter, DnzDecimalFilter, DnzDateFilter, DnzDateTimeFilter, DnzTimeFilter, DnzBoolFilter, DnzBadgeFilter (columnas con estilo de etiqueta) y DnzPredefinedFilter (columnas con valores predefinidos). En los de fecha, los atajos de la pestaña Predefinido (Hoy, Ayer, Mes Actual, Mes Anterior) toman el día de la empresa.

DnzReportProvider

No muestra nada: carga el informe y lo pasa en cascada como ReportContext a DnzCardList, DnzChartView, DnzTopN, DnzSummaryBar, DnzStatusSummary o tu propio marcado. Una llamada al servidor, varias vistas.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzSummaryBar />
    <DnzChartView ChartType="DnzChartView.ChartTypeE.Bar" />
    <DnzTopN N="5" />
    <DnzCardList MaxFields="3" />
</DnzReportProvider>
ParámetroTipoPor defectoQué hace
ClientDinaupClientCObligatorio. Cliente que ejecuta el informe.
ReportIdstring""Obligatorio. GUID del informe.
VariablesValuesDictionary<string, string>nullValores de las variables. Las que falten se piden antes de mostrar los hijos.
QuerySearchstring""Búsqueda aplicada a la carga.
AdvancedFilterList<FilterCondition>nullFiltros en servidor.
Limiteint500Filas que trae.
OrdenDictionary<string, bool>nullOrden de las filas.
AdminModeboolfalseCarga en modo administrador.
ChildContentRenderFragmentnullLas vistas que leen el contexto.
OnDataLoadedEventCallbackAl terminar la carga.

ReportContext

PropiedadTipoQué trae
ClientDinaupClientCEl cliente de la carga.
ReportDinaupReportDTODefinición del informe.
DataListDinaupReportDataDTORespuesta completa de la API.
RowsList<DinaupDynamicRowDTO>Las filas.
TotalResultsintRecuento del servidor. No es fiable: si no cabe en su tiempo, trae solo las filas de esta carga.
MappingReportColumnMappingLa columna numérica principal (PrimaryNumeric), la de dinero (MoneyColumn), la de minutos (MinutesColumn), la de estado (StatusColumn), las fechas (PrimaryDate, SecondaryDate) y las listas AllNumeric, AllDates, AllStrings, AllBools.
IsLoadingboolCarga en curso.
ErrorMessagestringError de la carga.
RefreshAsyncFunc<Task>Recarga el informe desde un hijo.

Con el Mapping, DnzChartView, DnzTopN y DnzCardList eligen solos la columna. Si no aciertan, fíjala con ValueColumn y CategoryColumn.

DnzCardList

Las filas como tarjetas: título, imagen de vista previa si la fila la trae, unos campos y el importe destacado. Los atributos extra van al div raíz.

ParámetroTipoPor defectoQué hace
MaxFieldsint4Campos secundarios por tarjeta, sin contar título ni importe.
OnItemSelectEventCallback<DinaupDynamicRowDTO>Al pulsar una tarjeta. Sustituye la apertura de la ficha.

DnzChartView

Agrupa las filas por CategoryColumn y suma ValueColumn en cada grupo: un informe de líneas de factura se convierte en "total por cliente".

<DnzChartView ChartType="DnzChartView.ChartTypeE.Column" CategoryColumn="cliente" ValueColumn="total_facturado" MaxItems="12" />
ParámetroTipoPor defectoQué hace
ChartTypeChartTypeEColumnColumn, Bar, Line, Area o Pie.
ValueColumnstringnullClave de la métrica. Sin valor, la numérica principal.
CategoryColumnstringnullClave de la categoría. Sin valor, la de estado o la primera de texto.
MaxItemsint20Categorías de mayor valor que se muestran; el resto se descarta.

DnzTopN

Barras horizontales con las N filas de mayor (o menor) valor. Las columnas de dinero o minutos se muestran con DnzSpanMoney o DnzSpanMinutes. Sin columna numérica, no muestra nada.

ParámetroTipoPor defectoQué hace
Nint10Filas de la clasificación.
ShowTitlebooltrueCabecera Top N con el nombre de la columna.
ValueColumnstringnullColumna que ordena. Sin valor, la numérica principal.
AscendingboolfalseLos valores más bajos primero.

DnzResponseQuestions

Formulario que pide las variables que el informe o el documento necesita. DnzReportView y DnzReportProvider lo montan solos; 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ámetroTipoPor defectoQué hace
VariablesDictionary<string, DinaupVariableDTO>new()Obligatorio. Variables que pide el servidor, por clave.
VariableValuesDictionary<string, string>new()Valores ya conocidos. Se rellenan al confirmar.
FixedKeysIReadOnlyCollection<string>nullClaves que no se preguntan, salvo que no tengan valor.
ClientDinaupClientCnullSolo para las variables de relación (Guid).
StorageKeystring""Clave con la que recuerda las respuestas en el navegador. Vacío no recuerda.
OnConfirmEventCallback<Dictionary<string, string>>Con todas las respuestas al confirmar.

En esta página