Guía de Operación en Pantalla: Tablas, Filtros y Formularios

Esta guía reúne las herramientas de interacción cotidiana que los usuarios operativos de Axol Systems tienen a su disposición para consultar datos con agilidad, capturar información de forma continua y navegar mediante atajos de teclado.

1. Operación Eficiente de Tablas

La cuadrícula de datos es el espacio central de trabajo para consultar y organizar los registros de tu negocio.

Búsqueda Global y Paginación

Barra de Búsqueda Rápida: Ubicada en la barra superior de la vista. Permite filtrar instantáneamente registros buscando coincidencias de texto en nombres, códigos, folios o fechas.
Paginación Inteligente: Puedes cambiar de página o regular el número de filas por pantalla de forma fluida.

Icono de Filtro Interactivo en Encabezados

Cuando una columna de la tabla tiene un filtro aplicado, se muestra un icono distintivo en color morado (filter_alt) a un lado del nombre de la columna en el encabezado.

Interacción Directa: Puedes hacer clic directamente sobre el icono morado de la columna para abrir la ventana de filtro específica de esa columna (ColumnFilterDialog).
Ventajas: No necesitas abrir el panel lateral completo de filtros para recordar qué criterio tenías activo. Desde este diálogo puedes:
- Revisar la condición actual (ej. “Contiene: PENDIENTE”).
- Modificar el valor o el operador.
- Limpiar el filtro de esa columna con un solo clic.

Atajo `Ctrl + Enter` para Aplicar Filtros

Tanto en el panel lateral de filtros (FilterDrawer) como en el diálogo por columna (ColumnFilterDialog), tras escribir el término que deseas buscar, no es necesario desplazar el cursor hasta el botón inferior:

Presiona Ctrl + Enter desde cualquier campo de texto de filtro para aplicar las condiciones de inmediato.

2. Formularios Dinámicos y Captura Adaptable

Al pulsar el botón de creación o al seleccionar una fila para editar, la aplicación despliega un panel lateral (Drawer) adaptable diseñado específicamente para los requerimientos de captura de la entidad.

Axol Systems implementa un motor de Formularios Dinámicos que permite diseñar múltiples variantes de captura por entidad, organizando la interfaz en grillas responsivas con control preciso del ancho y distribución de campos.

Maquetación en Grillas Responsivas (1 a 6 Columnas)

Los formularios se estructuran sobre un sistema de cuadrícula flexible de 1 a 6 columnas (columns_count), permitiendo maquetar interfaces limpias que aprovechan al máximo el espacio horizontal:

Extensión de Columnas (col_span): Cada campo individual puede abarcar un número variable de columnas dentro de la grilla mediante su parámetro col_span:
- En una grilla de 6 columnas, un campo con "col_span": 6 ocupa el ancho completo de la fila (ideal para descripciones largas o sub-tablas).
- Un campo con "col_span": 3 abarca la mitad del formulario (perfecto para pares como Nombre y Apellido).
- Campos compactos con "col_span": 2 permiten alinear hasta tres campos en una sola línea horizontal (por ejemplo, Cantidad, Precio Unitario e IVA).

{
  "columns_count": 6,
  "fields": [
    { "column": "t1c1", "col_span": 3 },
    { "column": "t1c2", "col_span": 3 },
    { "column": "t1c3", "col_span": 2 },
    { "column": "t1c4", "col_span": 2 },
    { "column": "t1c5", "col_span": 2 },
    { "column": "t1c6", "col_span": 6 }
  ]
}

Adaptabilidad Responsiva: Si el usuario reduce el tamaño de su ventana o consulta la aplicación en una pantalla de menor resolución, el motor ajusta fluidamente la grilla para mantener la legibilidad y evitar desbordamientos.

Ancho Adaptable del Drawer Lateral (`drawer_width_factor`)

El panel lateral de captura se adapta al volumen de información que el usuario necesita visualizar mediante el factor de escala drawer_width_factor (con valores continuos entre 0.2 y 1.0):

Paneles Compactos (0.3 – 0.4): Ocupan entre el 30% y 40% del ancho de pantalla. Ideales para capturas rápidas de catálogos simples (como clientes, categorías o folios) manteniendo visible la tabla de fondo.
Paneles Medios (0.5 – 0.7): Ocupan entre el 50% y 70% del ancho. Adecuados para registros operativos con cuadrículas de 2 a 4 columnas y campos de referencia foránea.
Paneles Amplios / Pantalla Completa (0.8 – 1.0): Ideales para formularios complejos maestro-detalle que incorporan sub-tablas con múltiples partidas (ObjectList), cálculos financieros o vistas previas.

Variantes de Formularios por Vista: Botón Primario y Menú Desplegable

Una misma entidad de negocio puede contar con múltiples formularios configurados para diferentes momentos operativos (por ejemplo, una recepción rápida de compras frente a una recepción con desglose de números de serie).

A través de la vinculación de formularios a vistas (view_forms), la interfaz organiza el acceso de forma intuitiva en la barra de herramientas superior:

flowchart LR
    A["Barra de Herramientas de la Vista"] --> B["Botón Primario (is_primary: true)<br>ej. '+ Nuevo Pedido'"]
    A --> C["Menú Desplegable de Variantes<br>ej. '▼ Otras opciones de captura'"]
    C --> D["Formulario Alternativo A<br>(ej. 'Alta Rápida')"]
    C --> E["Formulario Alternativo B<br>(ej. 'Recepción con Serie')"]

Botón Primario de Creación (is_primary: true): El botón de acción principal de la tabla abre directamente el formulario predeterminado para el flujo más frecuente de trabajo.
Menú Desplegable de Variantes Secundarias: Si la vista tiene más de un formulario asignado, junto al botón primario se despliega un botón con flecha desplegable (dropdown). Al pulsarlo, el usuario puede seleccionar cualquiera de las variantes de captura disponibles sin salir de la vista actual.
Formulario de Edición por Defecto (is_edit_default: true): Define qué diseño de formulario se utilizará cuando el operador haga doble clic o pulse el botón de editar en una fila existente de la cuadrícula.

Switch “Continuar Creando” para Captura en Serie

Cuando se requiere registrar un lote consecutivo de registros (por ejemplo, capturar múltiples productos nuevos, registrar clientes en serie o cargar inventario inicial):

Ubicación: En la esquina inferior del drawer de creación se encuentra el interruptor “Continuar creando”.
Comportamiento al activarlo:
1. Capturas los datos del primer registro.
2. Presionas “Guardar” (o el atajo Ctrl + Enter).
3. El sistema guarda el registro en la base de datos y muestra la confirmación de éxito.
4. El panel lateral permanece abierto con los campos restablecidos y listos para la siguiente captura, manteniendo activo el interruptor.
5. Al finalizar el lote, simplemente desactiva el interruptor en el último registro o pulsa Cancelar.

Atajo de Guardado `Ctrl + Enter`

En cualquier formulario de creación, edición o diálogo modal, puedes confirmar y guardar los cambios presionando Ctrl + Enter desde cualquier campo con foco, agilizando la captura continua sin necesidad de mover el cursor hasta el botón inferior.

3. Trabajo con Sub-tablas y Listas de Objetos (`ObjectList`)

Muchos registros complejos contienen partidas o elementos hijos vinculados (por ejemplo, una Orden de Compra contiene múltiples partidas de productos, o una Factura contiene partidas de cobro).

Expansión a Pantalla Completa y Edición Rápida

Botón de Expansión: En los campos de tipo lista de objetos, puedes pulsar el botón de expandir para visualizar las partidas en una tabla amplia a pantalla completa.
Edición y Eliminación Integrada: Desde la vista expandida tienes acceso directo a los botones de Edición y Eliminación para cada registro hijo individual, facilitando la corrección rápida de cantidades, precios o notas sin salir de la vista principal.
Etiquetas y Colecciones: Los campos desplegables de colecciones y etiquetas se visualizan con sus nombres y colores descriptivos dentro de cada fila de la sub-tabla.

4. Selección Ágil de Referencias

Al interactuar con propiedades de tipo Referencia (vínculos a registros de otras entidades como Clientes, Proveedores o Almacenes):

Al pulsar el selector se abre un diálogo modal optimizado con buscador integrado.
Puedes filtrar por nombre o código para localizar el registro exacto.
Al seleccionarlo, la referencia se vincula inmediatamente mostrando la descripción formateada del objeto relacionado.

5. Consulta de Novedades en la Aplicación

Axol Systems cuenta con un diálogo integrado de Notas de Versión:

Tras recibir una actualización o al consultar la información de la aplicación desde el perfil de usuario, podrás ver un resumen visual con las mejoras, correcciones y nuevas funcionalidades agregadas en la versión instalada.