Skip to Content
Componentes

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.

NecesitasComponente
La ficha completa de una sección, con guardadoDnzFormView
Una caja de búsqueda que no consulte en cada teclaDnzSearchInput
Subir ficheros y registrarlos en DinaupDnzFileUploaderButton
Mostrar un fichero subido con icono, tamaño y descargaDnzFileName
Editar texto rico (HTML)DnzHtmlEditor
Recortar, rotar o mejorar una imagenDnzImageEditor, DnzImageEditorDialog
Editar una lista de etiquetasDnzTagListEditor
Editar pares clave/valor como JSONDnzJsonKVEditor
Mostrar una lista de pasos numeradosDnzStepper
Elegir un valor, una fila o una fichaSelectores

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.

La ficha de un cliente que pinta DnzFormView: cabecera con la sección, pestañas General, Contacto y Facturación, los campos colocados como en el diseñador y el pie
<DnzFormView Client=@Client SectionId=@SectionsD.EntidadesD._SectionID DatoId=@ClienteId OnClosed=@OnFichaCerrada />

@code {
    private void OnFichaCerrada(DinaupFormResult result)
    {
        if (result.Reason == DinaupFormCloseReason.Saved)
            RecargarLista();
    }
}
ParámetroTipoPor defectoQué hace
ClientDinaupClientCObligatorio. Cliente ya inicializado.
SectionIdstring""GUID de la sección. Excluyente con Token.
DatoIdstring""GUID del registro a editar. Vacío abre un alta.
Tokenstring""Adopta un formulario que ya existe en el servidor (subventana de alta, cola de agregado, selector de relación). Excluyente con SectionId.
UserIdstring""ID del usuario en cuyo nombre se abre.
OnFormatearCodigoFunc<string, Task<string>>nullGancho para formatear un código de subcuenta al pulsar Enter.
OnClosedEventCallback<DinaupFormResult>Al cerrar, con el resultado.
OnAnnotationOpenEventCallback<DinaupAnnotationRequest>Al abrir comentarios, ficheros o galería, con SectionId, RowId, Type y Client.
WindowIdstringnullID de la ventana flotante que lo contiene.
PreFillValuesDictionary<string, string>nullValores precargados en un alta (clave del campo a valor).
PreFillListList<Dictionary<string, string>>nullFilas precargadas en los campos de lista de un alta.
AttachFileIdGuidGuid.EmptyFichero 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

Una fila por componente: la caja de búsqueda Buscar cliente, el botón Adjuntar documento, el editor de etiquetas con tres etiquetas y un DnzStepper de dos pasos

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ámetroTipoPor defectoQué hace
BounceValueChangedEventCallback<string>500 ms tras la última tecla, con el texto.
OnTypingEventCallbackEn cada tecla, para mostrar un indicador de búsqueda.
ValuestringnullTexto del campo.
Placeholderstring"Buscar..."Texto con el campo vacío.
Classstring""Clases del contenedor.
Stylestring""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ámetroTipoPor defectoQué hace
ClientDinaupClientCnullCliente que registra los ficheros.
PresignEndpointstring"/file/upload/sign"Endpoint que firma la subida.
OnFilesUploadedEventCallback<List<DinaupFileDTO>>Al terminar el lote, con los ficheros registrados.
OnEachFileUploadedEventCallback<PresignUploadResult>Por cada fichero. Con delegado, el registro es tuyo y se salta el lote.
AcceptExtensionsstring[][]Extensiones permitidas. Vacío admite todas.
MaxSizeByteslong157286400 (150 MB)Tamaño máximo por fichero.
MaxFilesint1000Ficheros por subida.
DisabledboolfalseInhabilita el botón.
ButtonTextstringnullTexto del botón.
ButtonIconstring"attach_file"Icono del botón.
ButtonStyleButtonStyleSecondaryEstilo del botón.
ButtonSizeButtonSizeSmallTamaño del botón.
ButtonVariantVariantOutlinedVariante del botón.
UseDashboardboolfalsePanel de arrastrar y soltar en vez de un botón.
NotestringnullNota del panel.
EditBeforeUploadbooltrueCon una sola imagen, la pasa por el editor.
OnErrorEventCallback<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ámetroTipoPor defectoQué hace
DnzFileNameDisplaystring""Nombre del fichero. La extensión decide el icono.
FileSizelong?nullTamaño en bytes.
DownloadURLstring""Con valor, muestra el botón de descarga.
OnClickEventCallbackAcción propia, si no hay DownloadURL.
OnClick_Iconstring"arrow_right"Icono de la acción propia.
HorizontalboolfalseDisposición en línea.
IsCompactboolfalseIcono, 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ámetroTipoPor defectoQué hace
ValuestringnullEl HTML. Con @bind-Value.
ValueChangedEventCallback<string>Al cambiar el contenido.
Contextstring""Contexto que reciben las herramientas (IDnzTextTool.ProcessAsync(value, context)).
EditorStylestring"min-height:300px;"Estilo del área de edición.
UploadUrlstring"upload/image"Endpoint de las imágenes pegadas o insertadas.
Classstring""Clases del contenedor.
Stylestring""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ámetroTipoPor defectoQué hace
ImageUrlstringnullURL de la imagen.
ImageBytesbyte[]nullImagen en bytes, en lugar de ImageUrl.
PresignEndpointstringnullEndpoint de firma para las herramientas que suben la imagen.
ExternalToolsIEnumerable<IDnzImageTool>nullHerramientas extra (Id, Name, Icon, Description, Order).
OnSaveEventCallback<byte[]>Al guardar, con los bytes del resultado.
OnCancelEventCallbackAl cancelar.
StylestringnullEstilo 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ámetroTipoPor defectoQué hace
ValueList<string>new()Las etiquetas. Con @bind-Value.
ValueChangedEventCallback<List<string>>Al añadir o quitar.
Titlestring""Título. Vacío no muestra cabecera ni el botón Clear.
Iconstring""Icono junto al título.
Placeholderstring"Add item..."Texto guía.
EmptyTextstring"No items"Texto sin etiquetas.
ReadOnlyboolfalseOculta el campo y las X.
ValidatorFunc<string, string>nullDevuelve un mensaje si el valor no vale, o vacío si vale.
TransformFunc<string, string>nullTransforma cada valor antes de añadirlo.
AllowMultiPastebooltruePegar varias a la vez.
Classstring""Clases del contenedor.
Stylestring""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>

En esta página