← Índice de manuales
Manual funcional · Sistema Plenario v14

Subagrupaciones de Documentos de Clientes

El formulario FormClientesDocumentosSubAgrupaciones (caption "Subagrupaciones") administra las subagrupaciones usadas para organizar la documentación de clientes. Son una categoría de clasificación dentro del esquema de…

Módulo: Inicio / ClientesVersión: 1.0Actualizado: 2026-06-23

Subagrupaciones de Documentos de Clientes

Detalle

Tipo de documento Manual de Usuario
Módulo Inicio / Clientes
Formulario FormClientesDocumentosSubAgrupaciones
Versión del manual 1.0

Introducción

El formulario FormClientesDocumentosSubAgrupaciones (caption "Subagrupaciones") administra las subagrupaciones usadas para organizar la documentación de clientes. Son una categoría de clasificación dentro del esquema de agrupación de documentos, que ayuda a ordenar y agrupar la documentación que se exige y se asigna a los clientes.

Es un ABM 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 "Subagrupaciones".

Pantalla principal

La pantalla se compone de:

  • Un panel de búsqueda (mostrable/ocultable).
  • Una grilla con las subagrupaciones existentes, mostrando principalmente el Nombre (y Descripción).
  • Una barra (Ribbon) con los botones de ABM: Nuevo, Modificar, Eliminar/Habilitar, 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

Parámetro Descripción
Id Identificador de la subagrupación.
Nombre Búsqueda parcial por nombre (contiene, no distingue mayúsculas/minúsculas).

Botones: Buscar ejecuta la consulta; el botón de limpiar parámetros reinicia los filtros. El panel de búsqueda se muestra/oculta con su checkbutton.

Resultados

La grilla lista las subagrupaciones que cumplen el filtro. El conteo de registros seleccionados se actualiza en la barra de estado. Existe 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 FormClientesDocumentosSubGrupoAddMod para crear una subagrupación. Requiere permiso.
Modificar Botón "Modificar", doble clic, Enter Edita la subagrupación seleccionada. Requiere permiso.
Eliminar / Habilitar Botón "Eliminar" Baja lógica (alterna el campo Eliminado). Pide confirmación. Requiere permiso.
Imprimir / Vista previa Botón de resultado de búsqueda / Imprimir Muestra la vista previa imprimible de la grilla.

Notas confirmadas en código: - La eliminación es lógica: el botón alterna el campo Eliminado. Por eso el botón cambia su texto entre "Eliminar" (si el registro está activo) y "Habilitar" (si está marcado como eliminado), según la fila seleccionada. - Las operaciones de Nuevo, Modificar y Eliminar/Habilitar verifican el permiso antes de ejecutarse.

Ejemplo práctico

Crear una nueva subagrupación "Documentación Impositiva":

  1. Abrir Subagrupaciones desde el menú de Documentación de Clientes.
  2. Presionar Nuevo (si tiene permiso).
  3. Cargar el Nombre (y, opcionalmente, la Descripción).
  4. Aceptar. La subagrupación queda disponible para organizar la documentación de clientes.

Consejos útiles

  • Para retirar de uso una subagrupación sin perder el histórico, use Eliminar (baja lógica). Para reactivarla, selecciónela y use Habilitar.
  • El texto del botón "Eliminar/Habilitar" depende del estado de la fila seleccionada: si dice "Habilitar", esa subagrupación está actualmente dada de baja.
  • Use la búsqueda por Nombre para ubicar rápidamente una subagrupación.

Preguntas frecuentes

¿Qué es una subagrupación de documentos? Es una categoría de clasificación usada para organizar la documentación de clientes dentro del esquema de agrupación de documentos.
¿Por qué el botón a veces dice "Eliminar" y a veces "Habilitar"? Porque la baja es lógica. Si la subagrupación seleccionada está activa, el botón ofrece "Eliminar"; si ya está dada de baja, ofrece "Habilitar" para reactivarla.
¿Por qué no puedo crear o eliminar subagrupaciones? Las operaciones de Nuevo, Modificar y Eliminar requieren el permiso "Clientes.Documentos.AdministarConfiguracion". Si no lo tiene asignado, la acción no se ejecuta.
¿La búsqueda por Nombre distingue mayúsculas? No. Es una búsqueda parcial (tipo "contiene") que no distingue mayúsculas de minúsculas.

Permisos

Operación Permiso Notas
Nuevo Clientes.Documentos.AdministarConfiguracion Verificado con IsAllowedObject dentro del formulario.
Modificar Clientes.Documentos.AdministarConfiguracion Verificado con IsAllowedObject dentro del formulario.
Eliminar / Habilitar Clientes.Documentos.AdministarConfiguracion Verificado con IsAllowedObject dentro del formulario.

Nota: el nombre del permiso está escrito así en el código ("AdministarConfiguracion", sin la "r" intermedia). El módulo de seguridad asociado es "Archivos.Clientes.Documentacion".

Información técnica

Basada en el análisis del formulario real de la v14

Formularios principales

Form Rol
FormClientesDocumentosSubAgrupaciones Listado/ABM de subagrupaciones de documentos de clientes.
FormClientesDocumentosSubGrupoAddMod Alta/Modificación de una subagrupación.

Permisos reales

Permiso Acción
Clientes.Documentos.AdministarConfiguracion Habilita Nuevo, Modificar y Eliminar/Habilitar de subagrupaciones (módulo de seguridad "Archivos.Clientes.Documentacion").

Tablas de base de datos principales

Tabla Uso
Gestion_Documentos_SubAgrupaciones Almacena las subagrupaciones. Campos: Id, Nombre (req., máx 50), Descripcion (máx 250), Eliminado.

Managers y clases de negocio

Componente Detalle
Gestion_Documentos_SubAgrupacionesManager Manager EF (VisualPlenarioNetContext, mapeo Gestion_Documentos_SubAgrupacionesMap). Reutiliza Gestion_Documentos_GruposManager para los parámetros de búsqueda.

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 Las subagrupaciones organizan los documentos del cliente. Ver ABM de documentos.
Campos adicionales de documentos Otra parte de la configuración de documentos. Ver Campos adicionales de documentos.

Notas para soporte

  • La eliminación es lógica (campo Eliminado que se alterna), a diferencia de Campos Adicionales que borra físicamente. Por eso el botón muestra "Eliminar" o "Habilitar" según el estado.
  • El botón de menú/tile que abre el formulario no chequea permiso; el control de Clientes.Documentos.AdministarConfiguracion está dentro del formulario, en cada operación de ABM (no en la apertura ni en la consulta).
  • Detalle de código: el caption del manager interno reutiliza la clase base Gestion_Documentos_GruposManager para los parámetros de búsqueda; no afecta el comportamiento funcional.
¿Te resultó útil este manual?