Vistas especializadas

Piezas para planificar, elegir periodos, mostrar documentos y código, y montar horarios. Las que dependen del día (Gantt, rangos, periodos, meses) usan el día de la empresa (ICultureService), no el del servidor.

DnzGenericGantt

Filas por grupo (empleado, recurso, tarea) y barras por intervalo, con navegación, vistas (horas, semana, mes, año) y zoom. Arranca en vista de horas sobre el día de hoy de la empresa. Los tipos están en DinaZen.Components.Gantt.Models.

@inject Dinaup.CultureService.ICultureService RegionService

<DnzGenericGantt Groups=@_grupos SourceItems=@_citas OnItemClick=@AbrirCita />

@code {
    private List<GanttGroup> _grupos = new();
    private List<GanttItem> _citas = new();

    protected override void OnInitialized()
    {
        var hoy = RegionService.LocalNow().Date;
        _grupos.Add(new GanttGroup { Id = "tecnico-1", Text = "Laura (Taller A)" });
        _citas.Add(new GanttItem("c-1001", "tecnico-1", "Revisión 8430-KLM", hoy.AddHours(9), hoy.AddHours(11), null, "background:#0d6efd;color:#fff"));
    }
}

DnzGenericGantt monta su barra DnzGanttToolBar (anterior, siguiente, Hoy, vista y zoom). Solo la instancias si construyes tu propio Gantt: recibe un GanttViewport (FocusDate, ViewMode, Zoom de 100 por defecto, y GetRange() con el intervalo visible) y devuelve una copia nueva en ViewportChanged. GanttViewMode tiene Hour, Day, Week, Month y Year; la barra ofrece todos menos Day.

DnzHighlightCode y DnzCodeWindow

Código con resaltado de sintaxis (highlight.js), botón de copiar y números de línea opcionales. DnzHighlightCode es plano, para una ficha o subpágina. DnzCodeWindow añade la barra de ventana, temas y pie, para páginas de presentación.

<DnzHighlightCode Code=@_snippet Language="csharp" DnzFileName="Program.cs" ShowLineNumbers=true />
<DnzCodeWindow Code=@_setup Language="csharp" Title="Program.cs" Theme="DnzCodeWindow.DnzCodeWindowTheme.Dracula" />

DnzDateRangeSelector y DnzDateTimeRangeSelector

Desplegable de rangos predefinidos (Hoy, Ayer, Últimos 7 días, Últimos 30 días, Este mes, Mes pasado, Este trimestre, Trimestre pasado, Este año, Año pasado y Personalizado). Con Personalizado aparecen los selectores Desde y Hasta. DnzDateRangeSelector devuelve DateOnly; DnzDateTimeRangeSelector añade la hora (HH:mm) y devuelve DateTime, para registros, fichajes o auditoría.

<DnzDateRangeSelector @bind-SelectedPreset=@_preset OnRangeChanged=@CargarFacturas />

@code {
    private DnzDateRangeSelector.DateRangePreset _preset = DnzDateRangeSelector.DateRangePreset.Last30Days;

    private async Task CargarFacturas((DateOnly From, DateOnly To) rango) => await RecargarAsync(rango.From, rango.To);
}

Los valores de los dos enums son Today, Yesterday, Last7Days, Last30Days, ThisMonth, LastMonth, ThisQuarter, LastQuarter, ThisYear, LastYear y Custom.

DnzDateRangeCard

Una DnzCard con título, icono, un DnzDateRangeSelector, un DnzLoader mientras Loading es true y la hora de la última actualización. Devuelve el rango como DateTime: From a las 00:00 y To al final del día.

<DnzDateRangeCard Title="Historial" Icon="history" DefaultPreset="DnzDateRangeSelector.DateRangePreset.Last30Days" Loading=@_loading OnRangeChanged=@OnRangeChanged>
    <HistorialTablaU Data=@_filas />
</DnzDateRangeCard>

Parámetros: Title, Icon, ChildContent, Loading, DefaultPreset (Last7Days), PresetChanged y OnRangeChanged.

DnzPeriodSelector

Navega por periodo con granularidad y emite un PeriodSelection(PeriodGrain Grain, DateOnly Start, DateOnly End, string Label), sin repetir el mismo periodo dos veces seguidas.

<DnzPeriodSelector OnChanged=@OnPeriodoChanged InitialGrain="DnzPeriodSelector.PeriodGrain.Mes" />

DnzMonthNavSelector

Flecha atrás, el mes en un desplegable y flecha adelante. Emite siempre el día 1 del mes. Las pulsaciones seguidas de flecha se acumulan DelaySalto milisegundos (2000; 0 emite al momento) para no cargar cada mes intermedio.

<DnzMonthNavSelector @bind-Value=@_mes />

Value (DateOnly) admite cualquier día del mes y, sin asignar, muestra el mes actual de la empresa. También acepta Class y Style.

DnzDynamicDocumentView

Ejecuta un documento dinámico por su DocId y muestra el resultado con botones de imprimir, enviar por correo y enviar a firmar. Los de correo y firma aparecen solo si pasas los EventCallback o la app registra los ganchos en DnzInterceptorService.

<DnzDynamicDocumentView Client=@Client DocId="2b7e1a40-6c3d-4f8e-9a12-0c5d6e7f8a9b" VariableValues=@(new() { ["FacturaId"] = facturaId }) />

UpdateAsync() por @ref vuelve a ejecutarlo. Métodos estáticos:

Task DnzDynamicDocumentView.OpenAsync(DialogService dialogService, DinaupClientC client, string docId, Dictionary<string, string> variableValues = null, List<DinaupDynamicDocumentDTO> compatibleDocuments = null, EventCallback<DinaupDocumentRequest>? onSendEmail = null, EventCallback<DinaupDocumentRequest>? onSendEmailWithAttachment = null, string width = "85%", string height = "80%")
Task DnzDynamicDocumentView.OpenPreloadedAsync(DialogService dialogService, DynamicDocumentsGetResponse result, string title = "Documento", string width = "80%", string height = "90%")
string DnzDynamicDocumentView.OpenAsWindow(DnzWindowManagerService windowManager, DinaupClientC client, string docId, Dictionary<string, string> variableValues = null, List<DinaupDynamicDocumentDTO> compatibleDocuments = null, string title = "Documento", string icon = "description")

Visores

Piezas de RRHH

Componentes de horarios y fichajes de Play Recursos Humanos. Reciben los datos ya procesados. Están en DinaZen.Components.Rrhh y sus modelos, en DinaZen.Components.Rrhh.Models.

TimeIntervalRrhh se construye con new TimeIntervalRrhh(start, end, category) y tiene Start, End, Category, SubCategoryId, Abierto y Duration. TimeIntervalTemplateRrhh(name, icon, params (startH, startM, endH, endM, category)[] intervals) define una plantilla de tramos.