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.
| Necesitas | Componente |
|---|---|
| La tabla con buscador, filtros, paginación y CSV | DnzReportView |
| Cargar el informe una vez y mostrarlo de varias formas | DnzReportProvider |
| Las filas como tarjetas con imagen, título e importe | DnzCardList |
| Una gráfica agrupada por categoría | DnzChartView |
| Las N filas de mayor valor | DnzTopN |
| Totales de dinero, minutos y booleanos | DnzSummaryBar, en KPIs y métricas |
| Cuántas filas hay en cada estado | DnzStatusSummary, en Etiquetas y estados |
| Pedir las variables que faltan antes de ejecutar | DnzResponseQuestions |
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.
<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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | Obligatorio. Cliente que ejecuta el informe. | |
ReportId | string | "" | Obligatorio. GUID del informe. Con el GUID de una sección, el servidor carga su informe principal (el del rol, si lo tiene). |
VariablesValues | Dictionary<string, string> | null | Valores de las variables. Las que falten las pide DnzResponseQuestions. |
QuerySearch | string | "" | Búsqueda inicial. Cambiarla recarga el informe. |
AdvancedFilter | List<FilterCondition> | null | Filtros en servidor de entrada, además de los del usuario. |
Limit | int | 25 | Filas por página. El usuario elige entre 25, 50, 100, 250, 500, 1000 y 3000. |
Orden | Dictionary<string, bool> | null | Orden inicial por columna (true = descendente). |
ShowTitle | bool | true | Cabecera con icono, título y selector de columnas visibles. |
Title | string | "" | Sobrescribe el título del informe. |
ShowSearch | bool | true | Buscador de la cabecera. |
Filtrable | bool | true | Filtros por columna. |
ShowAdd | bool | true | Botón de crear un registro de la sección. |
ShowLoadTime | bool | true | Tiempo de carga; al pulsarlo abre DnzReportDebugDialog con los tiempos y metadatos del informe. |
AdminMode | bool | false | Carga en modo administrador. |
ToolBarTemplate | RenderFragment | null | Botones extra en la barra de herramientas. |
OnItemSelect | EventCallback<DinaupDynamicRowDTO> | Al pulsar una fila. Sustituye la apertura de la ficha. | |
OnDataChanged | EventCallback | Cada vez que el informe recarga. | |
AllowCellSelection | bool | false | Selección de celdas con Ctrl+clic y Mayús+clic. |
SelectedCellsChanged | EventCallback<DnzCellSelection> | La selección de celdas cada vez que cambia. | |
FetchInterceptor | Func<string, bool, Func<Task<ReportResponse>>, Task<ReportResponse>> | null | Gancho 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
DnzSpanMoneyy suma al pie, números con suma, fechas en formato local, booleanos como etiqueta, estados con color. - Columnas visibles y orden. Se guardan en
localStoragepor ruta yReportIdsolo si ponesDnzReportView.DisableLocalStorageSettings = falseal arrancar la app (por defecto valetrue). - 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.
DnzCellSelectiontraeCells(cada celda comoDnzSelectedCell(RowId, Keyword)),RowIdsyKeywords, 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;
};
}
}| Gancho | Cuándo | Devuelve true para |
|---|---|---|
OnOpenRecord | Antes de abrir un registro (fila de informe, Acceder en un campo relación). | Omitir la apertura por defecto. |
OnOpenNewRecord | Antes de crear un registro (botón de añadir). | Omitir la apertura por defecto. |
OnFormSaved | Tras guardar un formulario, antes de cerrarlo. | Que el formulario no se cierre. |
OnGetFormExtensions | Al montar el pie del formulario. | Devuelve la lista de botones de extensión. |
OnDocumentSendEmail, OnDocumentSendEmailWithAttachment, OnDocumentRequestSign | Acciones 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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | Obligatorio. Cliente que ejecuta el informe. | |
ReportId | string | "" | Obligatorio. GUID del informe. |
VariablesValues | Dictionary<string, string> | null | Valores de las variables. Las que falten se piden antes de mostrar los hijos. |
QuerySearch | string | "" | Búsqueda aplicada a la carga. |
AdvancedFilter | List<FilterCondition> | null | Filtros en servidor. |
Limite | int | 500 | Filas que trae. |
Orden | Dictionary<string, bool> | null | Orden de las filas. |
AdminMode | bool | false | Carga en modo administrador. |
ChildContent | RenderFragment | null | Las vistas que leen el contexto. |
OnDataLoaded | EventCallback | Al terminar la carga. |
ReportContext
| Propiedad | Tipo | Qué trae |
|---|---|---|
Client | DinaupClientC | El cliente de la carga. |
Report | DinaupReportDTO | Definición del informe. |
DataList | DinaupReportDataDTO | Respuesta completa de la API. |
Rows | List<DinaupDynamicRowDTO> | Las filas. |
TotalResults | int | Recuento del servidor. No es fiable: si no cabe en su tiempo, trae solo las filas de esta carga. |
Mapping | ReportColumnMapping | La 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. |
IsLoading | bool | Carga en curso. |
ErrorMessage | string | Error de la carga. |
RefreshAsync | Func<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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
MaxFields | int | 4 | Campos secundarios por tarjeta, sin contar título ni importe. |
OnItemSelect | EventCallback<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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
ChartType | ChartTypeE | Column | Column, Bar, Line, Area o Pie. |
ValueColumn | string | null | Clave de la métrica. Sin valor, la numérica principal. |
CategoryColumn | string | null | Clave de la categoría. Sin valor, la de estado o la primera de texto. |
MaxItems | int | 20 | Categorí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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
N | int | 10 | Filas de la clasificación. |
ShowTitle | bool | true | Cabecera Top N con el nombre de la columna. |
ValueColumn | string | null | Columna que ordena. Sin valor, la numérica principal. |
Ascending | bool | false | Los 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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Variables | Dictionary<string, DinaupVariableDTO> | new() | Obligatorio. Variables que pide el servidor, por clave. |
VariableValues | Dictionary<string, string> | new() | Valores ya conocidos. Se rellenan al confirmar. |
FixedKeys | IReadOnlyCollection<string> | null | Claves que no se preguntan, salvo que no tengan valor. |
Client | DinaupClientC | null | Solo para las variables de relación (Guid). |
StorageKey | string | "" | Clave con la que recuerda las respuestas en el navegador. Vacío no recuerda. |
OnConfirm | EventCallback<Dictionary<string, string>> | Con todas las respuestas al confirmar. |