Detalle
| Manual de Usuario | |
|---|---|
| Módulo | Préstamos / Archivos |
| Formulario | frmEntidades_Grupos |
| Tipo | ABM (Altas, Bajas y Modificaciones) |
| Versión del manual | 1.0 |
Introducción
La pantalla Grupos de entidades administra las agrupaciones de entidades utilizadas en el módulo de Préstamos. Un grupo agrupa entidades bajo una descripción común y guarda sus datos de contacto (domicilio, localidad, provincia, teléfono, mail). Internamente trabaja sobre la clase clsPrestamos_Entidades_Agrupaciones, que persiste en la tabla Prestamos_entidades_agrupaciones.
El formulario puede usarse en dos modalidades: como ABM normal, o como selector (cuando se construye con bnReturnSelectedValue = True), devolviendo el Id del grupo elegido al formulario que lo invocó.
Acceso al módulo
Se accede desde el menú de Préstamos → Archivos → Grupos de entidades. Al abrir, el formulario ejecuta Buscar() y carga la grilla con todos los grupos existentes.
Pantalla principal
- Barra superior (
tlsStandard): botones Nuevo, Modificar y Eliminar. - Grilla (
grdClientes/GridView1): lista los grupos. Permite multiselección, fila de autofiltro y pie de totales. - Menú contextual (
cmsStandard): Nuevo, Modificar, Eliminar (clic derecho). - Barra de estado (
tslStandard): muestra la cantidad de registros o la cantidad seleccionada.
Las filas con Activo = falso se muestran en gris (regla de formato condicional sobre la columna Activo).
Filtros de búsqueda
La grilla incluye una fila de autofiltro (ShowAutoFilterRow) que permite filtrar por cualquier columna escribiendo en la cabecera. No hay un panel de parámetros separado: la búsqueda inicial trae todos los registros vía Search().
Resultados
La grilla muestra las siguientes columnas:
| Columna | Campo |
|---|---|
| Id | Id |
| Nombre de Grupo | Descripcion |
| Sigla | Sigla |
| Activo | Activo (no visible, usado para el formato gris) |
| Domicilio | Domicilio |
| Localidad | Localidad |
| Provincia | ProvinciaNombre |
| C. Postal | CodPos |
| Teléfono | Telefono |
El pie de la grilla y la barra de estado indican la cantidad de registros (o de seleccionados).
Acciones disponibles
| Acción | Cómo se dispara | Descripción |
|---|---|---|
| Nuevo | Botón Nuevo, menú contextual, tecla Insert | Abre frmEntidades_Grupos_AddMod para crear un grupo; al cerrar, refresca la grilla |
| Modificar | Botón Modificar, menú contextual, doble clic, Enter | Abre el AddMod cargando el grupo seleccionado y refresca |
| Eliminar | Botón Eliminar, menú contextual, tecla Delete | Baja lógica: marca Activo = False y guarda (no borra físicamente) |
| Seleccionar | Doble clic / Enter en modo selector | Si el form se abrió con bnReturnSelectedValue, devuelve el Id del grupo y se cierra |
La eliminación es una baja lógica: el registro queda con Activo = False y se muestra en gris, no se elimina de la base. Soporta eliminación múltiple sobre la selección.
Ejemplo práctico
- Abrir Grupos de entidades.
- Presionar Nuevo.
- Completar Nombre de Grupo (Descripción), Sigla y datos de contacto.
- Guardar. El nuevo grupo aparece en la grilla.
- Para dar de baja un grupo, seleccionarlo y presionar Eliminar; confirmar. El grupo pasa a mostrarse en gris (Activo = falso).
Consejos útiles
- Usá el autofiltro de la cabecera para encontrar un grupo por nombre o sigla rápidamente.
- Recordá que Eliminar no borra: hace baja lógica (Activo = falso), por eso los grupos inactivos siguen visibles en gris.
- Podés seleccionar varios grupos a la vez (multiselección) para darlos de baja juntos.
- Insert = Nuevo, Delete = Eliminar, Enter/doble clic = Modificar (o seleccionar en modo selector).
Preguntas frecuentes
Si elimino un grupo, ¿se borra de la base?
No. Se hace una baja lógica: el campoActivo pasa a falso y la fila se muestra en gris, pero el registro permanece en la tabla.
¿Por qué algunos grupos aparecen en gris?
Porque están inactivos (Activo = False). El formato condicional de la grilla los pinta en color plata.
¿Cómo busco un grupo puntual?
Usando la fila de autofiltro de la grilla: escribí en la columna correspondiente (por ejemplo Nombre de Grupo o Sigla).¿Puedo eliminar varios grupos a la vez?
Sí, la grilla permite multiselección y la rutina de eliminación recorre los registros seleccionados.¿Qué pasa al hacer doble clic sobre una fila?
En modo ABM normal abre la modificación del grupo; si el formulario se abrió como selector, devuelve el Id seleccionado y se cierra.Permisos
El formulario controla cada operación con IsAllowedObject(...):
| Permiso | Acción |
|---|---|
| Prestamos.Archivos.Grupos_Entidades.Nuevo | Permite Crear Grupos de Entidades |
| Prestamos.Archivos.Grupos_Entidades.Modificar | Permite Modificar Grupos de Entidades |
| Prestamos.Archivos.Grupos_Entidades.Eliminar | Permite Eliminar Grupos de Entidades |
Categoría/objeto padre de los tres permisos: Prestamos.Archivos.Grupos_Entidades.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
| frmEntidades_Grupos | Pantalla principal: grilla y ABM/selector de grupos |
| frmEntidades_Grupos_AddMod | Alta/edición de un grupo |
Permisos reales
| Permiso | Acción |
|---|---|
| Prestamos.Archivos.Grupos_Entidades.Nuevo | Crear grupo de entidades |
| Prestamos.Archivos.Grupos_Entidades.Modificar | Modificar grupo de entidades |
| Prestamos.Archivos.Grupos_Entidades.Eliminar | Eliminar (baja lógica) grupo de entidades |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
| Prestamos_entidades_agrupaciones | Almacena los grupos (Descripcion, Sigla, Activo, Domicilio, Localidad, Id_Provincia, CodPos, Telefono, Mail, Logo) |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Campos definidos por el usuario | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| Documentaciones | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- El formulario está en el proyecto VB
VisualPlenarioNET\Prestamos; la clase de negocioclsPrestamos_Entidades_Agrupaciones(enClassVisualPlenarioNET\Prestamos) usa los stored proceduresPrestamos_entidades_agrupaciones_Search/_Add/_Mod/_Del. - La eliminación es baja lógica (
Activo = False+Save()), no_Del. Verificar el SP_Delsolo si se requiere borrado físico. - La columna
ProvinciaNombrede la grilla proviene delSearch()(join), no es un campo directo de la entidad (la entidad guardaId_Provincia).