Entrada de datos y formularios
Componentes para capturar datos: búsqueda diferida, subida de ficheros, texto rico, imagen, etiquetas, JSON, pasos y la ficha dinámica de Flex.
Componentes para lo que el usuario teclea, pega o sube, y DnzFormView, que muestra la ficha completa de una sección a partir de su GUID. Casi todos se enlazan con @bind-Value.
| Necesitas | Componente |
|---|---|
| La ficha completa de una sección, con guardado | DnzFormView |
| Una caja de búsqueda que no consulte en cada tecla | DnzSearchInput |
| Subir ficheros y registrarlos en Dinaup | DnzFileUploaderButton |
| Mostrar un fichero subido con icono, tamaño y descarga | DnzFileName |
| Editar texto rico (HTML) | DnzHtmlEditor |
| Recortar, rotar o mejorar una imagen | DnzImageEditor, DnzImageEditorDialog |
| Editar una lista de etiquetas | DnzTagListEditor |
| Editar pares clave/valor como JSON | DnzJsonKVEditor |
| Mostrar una lista de pasos numerados | DnzStepper |
| Elegir un valor, una fila o una ficha | Selectores |
DnzFormView
Recibe el cliente y el GUID de una sección y muestra la ficha tal como está definida en Dinaup: cabecera, pestañas, controles, listas, botones, guardar y cancelar. Con DatoId vacío abre un alta.
<DnzFormView Client=@Client SectionId=@SectionsD.EntidadesD._SectionID DatoId=@ClienteId OnClosed=@OnFichaCerrada />
@code {
private void OnFichaCerrada(DinaupFormResult result)
{
if (result.Reason == DinaupFormCloseReason.Saved)
RecargarLista();
}
}| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | Obligatorio. Cliente ya inicializado. | |
SectionId | string | "" | GUID de la sección. Excluyente con Token. |
DatoId | string | "" | GUID del registro a editar. Vacío abre un alta. |
Token | string | "" | Adopta un formulario que ya existe en el servidor (subventana de alta, cola de agregado, selector de relación). Excluyente con SectionId. |
UserId | string | "" | ID del usuario en cuyo nombre se abre. |
OnFormatearCodigo | Func<string, Task<string>> | null | Gancho para formatear un código de subcuenta al pulsar Enter. |
OnClosed | EventCallback<DinaupFormResult> | Al cerrar, con el resultado. | |
OnAnnotationOpen | EventCallback<DinaupAnnotationRequest> | Al abrir comentarios, ficheros o galería, con SectionId, RowId, Type y Client. | |
WindowId | string | null | ID de la ventana flotante que lo contiene. |
PreFillValues | Dictionary<string, string> | null | Valores precargados en un alta (clave del campo a valor). |
PreFillList | List<Dictionary<string, string>> | null | Filas precargadas en los campos de lista de un alta. |
AttachFileId | Guid | Guid.Empty | Fichero que se adjunta al guardar. |
DinaupFormResult trae Reason (Cancelled, Saved, Error, SessionExpired), RowId, SectionId, WasModified y Title. Por @ref, LoadForm() recarga la ficha y List_AddNewItem(Dictionary<string, string> addValues = null) añade una fila a la lista primaria.
- Las fechas con hora se eligen en la hora de la empresa (
ICultureService, Madrid por defecto) y se guardan en UTC. Los botones Ahora, Hoy y Mañana usan esa hora. - Un campo confidencial o de contraseña se muestra oculto, con un botón para verlo y otro para copiarlo.
- Antes de abrir o guardar consulta el
DnzInterceptorService.
La maqueta de escritorio pide 1000 px de ancho de contenedor. Por debajo, el formulario pasa a la maqueta móvil: pestañas apiladas y un campo por fila. Reserva ese ancho al abrirlo en un diálogo o una ventana estrecha.
Lo habitual es abrirlo como modal o como ventana flotante:
Task<DinaupFormResult> DnzFormView.OpenAsync(DialogService dialogService, DinaupClientC client, string sectionId, string datoId = "", string title = "", string width = "min(96%, 1100px)", string height = "min(90%, 1000px)")
string DnzFormView.OpenAsWindow(DnzWindowManagerService windowManager, DinaupClientC client, string sectionId, string datoId = "", string title = "", string icon = "")OpenAsWindow devuelve el windowId. Las pestañas las monta DnzFormTab con DnzContainer y DnzControl: piezas del formulario de Flex.
DnzSearchInput
Caja de búsqueda con lupa que avisa 500 ms después de la última tecla. Conecta la recarga a BounceValueChanged.
<DnzSearchInput Placeholder="Buscar cliente" BounceValueChanged=@OnBuscar />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
BounceValueChanged | EventCallback<string> | 500 ms tras la última tecla, con el texto. | |
OnTyping | EventCallback | En cada tecla, para mostrar un indicador de búsqueda. | |
Value | string | null | Texto del campo. |
Placeholder | string | "Buscar..." | Texto con el campo vacío. |
Class | string | "" | Clases del contenedor. |
Style | string | "" | Estilo del contenedor. |
Los atributos extra (autofocus, maxlength) van al <input>.
DnzFileUploaderButton
Sube los ficheros elegidos y devuelve los DinaupFileDTO ya registrados en Dinaup con Client.File_UploadURLAsync. Con una sola imagen, abre antes el editor de imagen.
<DnzFileUploaderButton Client=@Client OnFilesUploaded=@OnFicherosSubidos AcceptExtensions=@(new[] { ".pdf", ".docx" }) MaxFiles="5" ButtonText="Adjuntar documento" ButtonIcon="upload_file" OnError=@OnErrorSubida />Sin Client, los ficheros se suben pero Dinaup no los registra. Para registrarlos a mano, usa OnEachFileUploaded y llama a File_UploadURLAsync(url, fileName).
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | null | Cliente que registra los ficheros. |
PresignEndpoint | string | "/file/upload/sign" | Endpoint que firma la subida. |
OnFilesUploaded | EventCallback<List<DinaupFileDTO>> | Al terminar el lote, con los ficheros registrados. | |
OnEachFileUploaded | EventCallback<PresignUploadResult> | Por cada fichero. Con delegado, el registro es tuyo y se salta el lote. | |
AcceptExtensions | string[] | [] | Extensiones permitidas. Vacío admite todas. |
MaxSizeBytes | long | 157286400 (150 MB) | Tamaño máximo por fichero. |
MaxFiles | int | 1000 | Ficheros por subida. |
Disabled | bool | false | Inhabilita el botón. |
ButtonText | string | null | Texto del botón. |
ButtonIcon | string | "attach_file" | Icono del botón. |
ButtonStyle | ButtonStyle | Secondary | Estilo del botón. |
ButtonSize | ButtonSize | Small | Tamaño del botón. |
ButtonVariant | Variant | Outlined | Variante del botón. |
UseDashboard | bool | false | Panel de arrastrar y soltar en vez de un botón. |
Note | string | null | Nota del panel. |
EditBeforeUpload | bool | true | Con una sola imagen, la pasa por el editor. |
OnError | EventCallback<string> | Con el mensaje, si falla la subida o el registro. |
DnzFileName
Un fichero ya subido: icono por extensión, nombre, tamaño y botón de descarga o una acción propia. No sube nada.
<DnzFileName DnzFileNameDisplay=@adjunto.Name FileSize=@adjunto.SizeInBytes DownloadURL=@adjunto.url_original Horizontal=true />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
DnzFileNameDisplay | string | "" | Nombre del fichero. La extensión decide el icono. |
FileSize | long? | null | Tamaño en bytes. |
DownloadURL | string | "" | Con valor, muestra el botón de descarga. |
OnClick | EventCallback | Acción propia, si no hay DownloadURL. | |
OnClick_Icon | string | "arrow_right" | Icono de la acción propia. |
Horizontal | bool | false | Disposición en línea. |
IsCompact | bool | false | Icono, nombre y tamaño en una fila. |
DnzHtmlEditor
Editor de texto rico con la barra de herramientas de Dinaup. La barra añade como botones las implementaciones de IDnzTextTool (Id, Name, Icon, Description) registradas en la app, como "resumir" o "traducir".
<DnzHtmlEditor @bind-Value=@Plantilla.Cuerpo EditorStyle="min-height:400px;" />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Value | string | null | El HTML. Con @bind-Value. |
ValueChanged | EventCallback<string> | Al cambiar el contenido. | |
Context | string | "" | Contexto que reciben las herramientas (IDnzTextTool.ProcessAsync(value, context)). |
EditorStyle | string | "min-height:300px;" | Estilo del área de edición. |
UploadUrl | string | "upload/image" | Endpoint de las imágenes pegadas o insertadas. |
Class | string | "" | Clases del contenedor. |
Style | string | "" | Estilo del contenedor. |
DnzImageEditor
Recorte, rotación, volteo, mejora automática y herramientas propias (IDnzImageTool) sobre una URL o un byte[]. Suelto, solo cuando forma parte de la pantalla; si no, usa el diálogo.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
ImageUrl | string | null | URL de la imagen. |
ImageBytes | byte[] | null | Imagen en bytes, en lugar de ImageUrl. |
PresignEndpoint | string | null | Endpoint de firma para las herramientas que suben la imagen. |
ExternalTools | IEnumerable<IDnzImageTool> | null | Herramientas extra (Id, Name, Icon, Description, Order). |
OnSave | EventCallback<byte[]> | Al guardar, con los bytes del resultado. | |
OnCancel | EventCallback | Al cancelar. | |
Style | string | null | Estilo en línea, sobre todo la altura. |
Por @ref: GetResultBytesAsync() devuelve el byte[] del lienzo y UploadResultToS3Async(signEndpoint) lo sube y devuelve un PresignUploadResult.
DnzImageEditorDialog
El editor en un diálogo modal. Los dos métodos devuelven null si el usuario cancela.
Task<byte[]> DnzImageEditorDialog.OpenAsync(DialogService dialogService, string imageUrl = null, byte[] imageBytes = null)
Task<PresignUploadResult> DnzImageEditorDialog.OpenAndUploadToS3Async(DialogService dialogService, string presignEndpoint, string imageUrl = null)var result = await DnzImageEditorDialog.OpenAndUploadToS3Async(DialogService, "/file/upload/sign", imageUrl: Producto.FotoUrl);
if (result.IsNotNull()) Producto.FotoUrl = result.Url;DnzTagListEditor
Edita una List<string>: Enter añade, la X quita. Admite pegar varias separadas por ,, ;, salto de línea o tabulador.
<DnzTagListEditor @bind-Value=@Producto.Etiquetas Title="Etiquetas" Icon="sell" Transform=@(v => v.Trim().ToLower()) />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Value | List<string> | new() | Las etiquetas. Con @bind-Value. |
ValueChanged | EventCallback<List<string>> | Al añadir o quitar. | |
Title | string | "" | Título. Vacío no muestra cabecera ni el botón Clear. |
Icon | string | "" | Icono junto al título. |
Placeholder | string | "Add item..." | Texto guía. |
EmptyText | string | "No items" | Texto sin etiquetas. |
ReadOnly | bool | false | Oculta el campo y las X. |
Validator | Func<string, string> | null | Devuelve un mensaje si el valor no vale, o vacío si vale. |
Transform | Func<string, string> | null | Transforma cada valor antes de añadirlo. |
AllowMultiPaste | bool | true | Pegar varias a la vez. |
Class | string | "" | Clases del contenedor. |
Style | string | "" | Estilo del contenedor. |
DnzJsonKVEditor
Edita pares clave/valor que entran y salen como JSON (string), con Copy, Paste e Import. ValueChanged devuelve el JSON indentado. Parámetros: Value ("{}"), ValueChanged, ReadOnly, Class y Style.
<DnzJsonKVEditor @bind-Value=@Integracion.MetadatosJson />DnzStepper
Lista vertical de pasos numerados, solo de presentación: no controla un asistente ni navega. Cada paso es un DnzStepperStep con su Index (el número del círculo) y su contenido.
<DnzStepper>
<DnzStepperStep Index="1">
<strong>Crea la factura</strong>
<p>Elige cliente y añade las líneas.</p>
</DnzStepperStep>
<DnzStepperStep Index="2">
<strong>Emite y envía</strong>
</DnzStepperStep>
</DnzStepper>