================================================================================ MANUAL DE AYUDA — IMPORTADOR DESDE FACTUSOL (ACCESS) ================================================================================ 1. DESCRIPCIÓN Y PROPÓSITO GENERAL -------------------------------------------------------------------------------- Este módulo proporciona la interfaz de usuario y la lógica de negocio para realizar la importación de datos históricos y de catálogo desde una base de datos Factusol (formato Microsoft Access.mdb/.accdb) hacia las tablas relacionales de la base de datos MariaDB (,. ). Hereda visualmente de. 2. GUÍA DE USO Y PROCEDIMIENTO PASO A PASO -------------------------------------------------------------------------------- ▶ Paso 1: Introducción de Datos: Rellene los campos obligatorios del formulario (identificados con etiqueta destacada) y navegue entre las distintas pestañas de información si están disponibles. ▶ Paso 2: Validación de Información: Verifique que los importes, fechas o clasificaciones introducidas sean correctas antes de confirmar. ▶ Paso 3: Guardar Cambios: Pulse el botón "Guardar" ([💾]) para validar y almacenar la información en el sistema. ▶ Paso 4: Descartar Modificaciones: Si desea anular los cambios antes de guardar, pulse "Cancelar" ([✖]) para restaurar los valores originales. ▶ Paso 5: Navegación entre Registros: Utilice los botones de navegación ("Primero", "Anterior", "Siguiente", "Último") para revisar otras fichas del listado sin cerrar el editor. ▶ Paso 6: Cerrar Ventana: Pulse "Salir" ([🚪]) o la tecla [Escape] para volver a la pantalla principal. 3. GUÍA DE CAMPOS Y CONTROLES PRINCIPALES -------------------------------------------------------------------------------- • Campos Principales: Identificadores de cabecera (Código, Nombre / Razón Social, Fechas, Estado). • Casilla "Activo": Permite habilitar o deshabilitar el registro en el sistema. • Pestañas de Detalle: Secciones temáticas para clasificar la información comercial, operativa y técnica. 4. ACCIONES Y BOTONES DE LA BARRA DE HERRAMIENTAS -------------------------------------------------------------------------------- * [💾] Guardar : Valida y almacena los datos introducidos en la base de datos. * [✖] Cancelar : Descarta los cambios no guardados y restaura el estado original. * [➕] Añadir : Limpia los campos del formulario para iniciar una nueva alta. * [🗑] Eliminar : Elimina el registro actual previa confirmación. * [⏮] Primero : Se desplaza al primer registro del catálogo. * [◀] Anterior : Retrocede al registro anterior. * [▶] Siguiente : Avanza al siguiente registro. * [⏭] Último : Se desplaza al último registro del catálogo. * [🚪] Salir : Cierra la ventana de edición. * [❓] Ayuda : Muestra la guía de uso de esta ficha. 5. ATAJOS DE TECLADO Y NAVEGACIÓN RÁPIDA -------------------------------------------------------------------------------- • [Enter] : Confirma la selección, abre la ficha o avanza al siguiente campo. • [Escape] : Cierra la ventana actual o cancela la edición en curso. • [Espacio] : Marca o desmarca casillas de verificación (Checkboxes) en rejilla. • [F5] : Refresca inmediatamente los datos desde el servidor. • [Flechas Arriba/Abajo] : Desplaza el cursor entre registros de la lista. 6. REGLAS DE NEGOCIO Y NOTAS IMPORTANTES -------------------------------------------------------------------------------- ⚠ Resolución de Artículos: Como la tabla no tiene una columna codigo, la resolución y duplicidad de artículos se realiza comparando la descripción del artículo. En el mapeo de líneas de documentos, ResolveOrCreateArticulo realiza una búsqueda por la descripción provista por Factusol y, en caso de no existir localmente, crea el registro del artículo de forma dinámica autogenerando el id. ⚠ Precios de Venta (Tarifa 1): Para los artículos, se realiza un LEFT JOIN con la subconsulta de la tarifa 1 (F_LTA filtrando TARLTA = 1) para obtener el precio de venta unitario asignándolo a pvp1. Si no existe precio definido en dicha tarifa, se recurre a PV1ART de la tabla principal de artículos. ⚠ Resolución de Cliente UUID: Busca localmente un cliente por su NIF o, de forma alternativa, por su Nombre Fiscal desde la tabla Factusol F_CLI. ⚠ Normalización del NIF: Al importar clientes y resolver sus identificadores, se normaliza el campo NIF eliminando todos los espacios, guiones y convirtiendo las letras a mayúsculas para mantener consistencia en la base de datos local. ⚠ Conectividad ADO en Caliente: Construcción dinámica del ConnectionString intentando primero usar el motor ACE OLEDB (Microsoft.ACE.OLEDB.12.0 para.accdb) y retrocediendo a Jet OLEDB (Microsoft.Jet.OLEDB.4.0 para.mdb más antiguos) si el primero no está registrado en el sistema. ⚠ Mapeo Resiliente: Si alguna columna o registro de Factusol está corrupto o es de tipo incompatible, se gestiona individualmente mediante bloques try.except para no detener la importación del resto del lote.