Detalle
| Tipo de documento | Manual de Usuario |
|---|---|
| Módulo | Inicio / Clientes |
| Formulario | FormClientesDocumentosCamposAdicionales |
| Versión del manual | 1.0 |
Introducción
El formulario FormClientesDocumentosCamposAdicionales (caption "Campos Adicionales") administra los campos adicionales que pueden asociarse a la documentación de clientes. Son campos definidos por el usuario que luego se completan con valores específicos en los documentos de cada cliente, permitiendo extender la información que el sistema captura sobre la documentación más allá de los datos estándar.
Es un ABM moderno construido sobre DevExpress (grilla bandeada + Ribbon) y Entity Framework.
Acceso al módulo
Se accede desde el menú de Herramientas / Documentación de Clientes mediante el botón o tile "Campos Adicionales".
Pantalla principal
La pantalla se compone de:
- Un panel de búsqueda (que puede mostrarse/ocultarse).
- Una grilla con los campos adicionales existentes, mostrando principalmente el Nombre (y la Descripción) de cada campo.
- Una barra (Ribbon) con los botones de ABM: Nuevo, Modificar, Eliminar, Imprimir/Resultado de búsqueda.
- Una barra de estado que indica "Registros Seleccionados".
Al abrir, el formulario muestra una pantalla de espera (WaitForm) mientras inicializa.
Filtros de búsqueda
El panel de búsqueda permite filtrar por:
| Parámetro | Descripción |
|---|---|
| Id | Identificador del campo adicional. |
| Nombre | Búsqueda parcial por nombre (contiene, no distingue mayúsculas/minúsculas). |
Botones del panel: Buscar ejecuta la consulta; el botón de limpiar parámetros reinicia los filtros. El panel de búsqueda puede mostrarse u ocultarse con su checkbutton.
Resultados
La grilla lista los campos adicionales que cumplen el filtro. El conteo de registros seleccionados se actualiza en la barra de estado. Existe la opción de vista previa / impresión del resultado.
Acciones disponibles
| Acción | Cómo se ejecuta | Qué hace |
|---|---|---|
| Nuevo | Botón "Nuevo" del Ribbon | Abre FormClientesDocumentosCamposAdicionalesAddMod para crear un campo adicional. |
| Modificar | Botón "Modificar", doble clic, Enter | Edita el campo adicional seleccionado. |
| Eliminar | Botón "Eliminar" | Elimina el campo seleccionado. Ver advertencia abajo. |
| Imprimir / Vista previa | Botón de resultado de búsqueda / Imprimir | Muestra la vista previa imprimible de la grilla. |
Advertencia importante sobre eliminación: al eliminar un campo adicional, el sistema verifica cuántos documentos de clientes ya tienen valores cargados para ese campo. Si existen, muestra un aviso del tipo: "Existen N documento(s) de clientes con este campo adicional. Se eliminarán automáticamente estos datos de los documentos del cliente. ¿Desea continuar?". Si se confirma, se borran también todos los valores asociados en los documentos de clientes (tabla de valores). La eliminación del campo es física.
Ejemplo práctico
Crear un campo adicional "Número de Póliza" para documentación de clientes:
- Abrir Campos Adicionales desde el menú de Documentación de Clientes.
- Presionar Nuevo.
- Cargar el Nombre del campo (y, opcionalmente, la Descripción).
- Aceptar. El campo queda disponible para completarse en los documentos de clientes.
Consejos útiles
- Use nombres claros y unívocos: el Nombre es lo que verán los operadores al cargar valores en los documentos.
- Antes de eliminar un campo, revise el aviso de cuántos documentos lo usan: la baja arrastra los valores cargados en esos documentos.
- Use el panel de búsqueda por Nombre para localizar rápidamente un campo en instalaciones con muchos campos definidos.
Preguntas frecuentes
¿Qué es un campo adicional de documento?
Es un campo definido por el usuario que se asocia a la documentación de clientes. Una vez creado, puede completarse con un valor distinto en cada documento de cliente, ampliando la información que el sistema guarda sobre cada documento.Si elimino un campo adicional, ¿qué pasa con los valores ya cargados?
El sistema avisa cuántos documentos de clientes tienen ese campo cargado y, si confirma la eliminación, borra automáticamente esos valores junto con el campo. Es una baja física, no recuperable.¿La búsqueda por Nombre distingue mayúsculas?
No. La búsqueda por Nombre es parcial (tipo "contiene") y no distingue mayúsculas de minúsculas.¿Por qué tarda unos instantes al abrir?
Al iniciarse muestra una pantalla de espera mientras carga el contexto de datos y la grilla. Es normal.Permisos
No se encontró un control de permisos (IsAllowedObject / KeyLicences...Access) ni en el botón de menú que abre el formulario ni dentro del formulario para las operaciones de Nuevo/Modificar/Eliminar. El acceso queda determinado únicamente por la visibilidad del menú/tile correspondiente. Verificar contra la configuración de seguridad de la instalación si se requiere restringir esta opción.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
| FormClientesDocumentosCamposAdicionales | Listado/ABM de campos adicionales de documentos de clientes. |
| FormClientesDocumentosCamposAdicionalesAddMod | Alta/Modificación de un campo adicional. |
Permisos reales
| Permiso | Acción |
|---|---|
| (no se encontró) | El formulario y su botón de menú no invocan IsAllowedObject; el acceso depende de la visibilidad del menú/tile. |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
Gestion_Documentos_CamposAdicionales |
Define los campos adicionales. Campos: Id, Nombre, Descripcion, Eliminado. |
Gestion_Documentos_Documentos_CamposAdicionales_Valores |
Valores cargados de cada campo en los documentos de clientes (Id_Campo referencia al campo). Se borran al eliminar el campo. |
Managers y clases de negocio
| Componente | Detalle |
|---|---|
Gestion_Documentos_CamposAdicionalesManager |
Manager EF (VisualPlenarioNetContext, mapeo Gestion_Documentos_CamposAdicionalesMap). |
Stored Procedures y funciones
El ABM se resuelve por EF Code First vía el manager; no usa Stored Procedures.
Relación con otros módulos / manuales
| Se conecta con | Cómo |
|---|---|
| Documentos de Clientes | Los campos adicionales se cargan sobre los documentos del cliente. Ver ABM de documentos. |
| Subagrupaciones de documentos | Otra parte de la configuración de documentos. Ver Subagrupaciones de documentos. |
Notas para soporte
- No hay chequeo de permisos en este formulario (a diferencia de Subagrupaciones, que sí valida
Clientes.Documentos.AdministarConfiguracion). Si el cliente necesita restringir Campos Adicionales, hay que evaluarlo a nivel desarrollo. - La eliminación es física y en cascada sobre los valores cargados en documentos (tabla
..._Valores). Confirmar con el usuario antes de borrar campos en uso. - La entidad expone un campo
Eliminado, pero el formulario realiza un borrado físico (EntityState.Deleted) en el método de eliminar, no una baja lógica.