Detalle
| Campo |
Valor |
| Manual de Usuario |
ABM (alta, modificación y baja) de las líneas de productos: la clasificación que agrupa los productos por línea o familia para organizarlos, reportarlos y segmentarlos |
| Módulo |
Gestión Comercial |
| Pantalla |
Líneas de Productos (Gestión → Productos → Líneas) |
| Tipo |
ABM |
Introducción
Las líneas de productos son una clasificación que permite agrupar los productos por línea o familia (por ejemplo "Lácteos", "Electrodomésticos", "Servicios"). Sirven para ordenar el catálogo, filtrar productos y obtener reportes segmentados por línea.
Esta pantalla es un ABM simple: cada línea tiene un ID (numérico, asignado automáticamente por el sistema) y una Descripción (el nombre de la línea, hasta 100 caracteres). Desde acá se crean nuevas líneas, se modifica su descripción y se dan de baja las que ya no se usan.
La baja es lógica: al eliminar una línea, el sistema la marca como inactiva (Activo = false) en lugar de borrarla físicamente. Por eso las líneas eliminadas dejan de aparecer en el listado, pero los productos que ya las tenían asignadas conservan la referencia.
Acceso al módulo
- Ingresar al Back Office de Plenario.
- Abrir la solapa/cinta Gestión.
- Dentro del grupo Productos, abrir el botón Más y elegir la opción Líneas.
Importante: El acceso requiere el permiso Gestion.Archivos.Productos.Lineas, que debe solicitarse al administrador del sistema. Sin ese permiso la opción no abre la pantalla.
Pantalla principal
La pantalla está dividida en tres partes:
- Una cinta/barra de acciones (ribbon) en la parte superior, con los botones Nuevo, Modificar y Eliminar.
- Un panel de búsqueda con los filtros por ID y Descripción y el botón Buscar.
- Una grilla de resultados que lista las líneas activas, con las columnas ID y Descripción.
Al abrir la pantalla, el sistema carga automáticamente todas las líneas activas. La grilla es de solo lectura (no se edita directamente sobre la celda): para cambiar una línea se usa el botón Modificar o se hace doble clic sobre la fila.
Filtros de búsqueda
| Campo |
Descripción |
| ID |
Número identificador de la línea. Si se deja en 0 (o vacío), no filtra por ID y trae todas |
| Descripción |
Texto a buscar dentro del nombre de la línea. Funciona por coincidencia parcial (trae todas las líneas cuya descripción contenga el texto ingresado). Vacío no filtra |
| Buscar |
Aplica los filtros y actualiza la grilla |
| Limpiar parámetros |
Casilla que vacía los campos de búsqueda para volver a empezar |
Importante: La grilla muestra únicamente líneas activas. Una línea dada de baja no vuelve a aparecer en los resultados aunque coincida con el filtro.
Resultados
| Columna |
Descripción |
| ID |
Número identificador único de la línea, asignado automáticamente al crearla |
| Descripción |
Nombre de la línea de productos |
La grilla permite ordenar y filtrar por columna con las herramientas estándar de la grilla. Al pie se puede ver la cantidad de registros listados.
Acciones disponibles
| Acción |
Descripción |
| Nuevo |
Abre la ventana de alta para crear una línea nueva |
| Modificar |
Abre la ventana de edición con la línea seleccionada para cambiar su descripción |
| Eliminar |
Da de baja lógica la línea seleccionada (la marca como inactiva) |
| Buscar |
Aplica los filtros del panel de búsqueda y refresca la grilla |
Nuevo
- Hacer clic en Nuevo.
- Se abre la ventana Alta y/o Modificación de Líneas de Productos.
- Completar el campo Descripción con el nombre de la línea (hasta 100 caracteres).
- Presionar Aceptar (o Enter). El sistema asigna el ID automáticamente y guarda. Al cerrar la ventana, la grilla se actualiza.
El campo Descripción es obligatorio: si se deja vacío, el sistema avisa "No se ha definido un contenido para Descripcion" y no guarda.
Modificar
- Seleccionar la línea en la grilla.
- Hacer clic en Modificar (o doble clic sobre la fila).
- En la ventana, actualizar la Descripción.
- Presionar Aceptar para guardar los cambios.
Eliminar
- Seleccionar la línea que se desea dar de baja.
- Hacer clic en Eliminar.
- Confirmar cuando el sistema pregunte "Desea eliminar el registro seleccionado ?".
La baja es lógica: la línea no se borra de la base, solo se marca como inactiva y deja de listarse.
Ejemplo práctico
Crear la línea "Lácteos" y luego corregir un error de tipeo:
- Abrir Gestión → Productos → Más → Líneas.
- Hacer clic en Nuevo.
- En Descripción escribir
Lacteos y presionar Aceptar. El sistema crea la línea con un ID automático.
- Notar el error y seleccionar la línea recién creada en la grilla.
- Hacer clic en Modificar, corregir la descripción a
Lácteos y presionar Aceptar.
- La grilla muestra la línea actualizada.
Consejos útiles
- Antes de eliminar una línea, verificá que no esté siendo usada por productos activos. La baja es lógica y no rompe nada, pero los productos asignados quedan apuntando a una línea inactiva.
- Usá descripciones claras y consistentes (por ejemplo, siempre en singular o siempre en plural) para que los filtros y reportes sean prolijos.
- El filtro de Descripción busca por coincidencia parcial: escribir "lac" alcanza para encontrar "Lácteos". No hace falta el nombre completo.
- Si no ves una línea que esperabas, revisá que no haya sido dada de baja: las inactivas no aparecen en la grilla.
- El ID lo asigna el sistema automáticamente; no es un dato que cargue el usuario.
Preguntas frecuentes
¿Puedo cambiar el ID de una línea?
No. El ID lo genera el sistema automáticamente al crear la línea y no es editable. Solo se puede modificar la Descripción.
¿Qué pasa con los productos cuando elimino una línea?
La eliminación es una baja lógica: la línea se marca como inactiva, no se borra. Los productos que ya la tenían asignada conservan la referencia, pero conviene reasignarlos a una línea activa para mantener el catálogo ordenado.
¿Por qué una línea no aparece en la grilla?
Porque fue dada de baja (está inactiva) o no coincide con el filtro de búsqueda aplicado. La grilla solo muestra líneas activas. Limpiá los filtros con "Limpiar parámetros" y volvé a buscar.
¿Hay un largo máximo para la descripción?
Sí, hasta 100 caracteres.
¿Se puede recuperar una línea eliminada?
Desde esta pantalla no, porque solo lista las activas. La línea sigue existiendo en la base como inactiva; su reactivación requiere intervención de soporte/sistemas.
Permisos
| Permiso |
Descripción |
Gestion.Archivos.Productos.Lineas |
Habilita el acceso a la pantalla de Líneas de Productos (alta, modificación y baja) |
Los permisos se asignan por grupo/usuario y deben solicitarse al administrador del sistema.
Información técnica
Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (proyectos VPNET_WinForms y VPNET_DataModel; el menú VB VisualPlenarioNET\VisualPlenarioNET\frmMainParts\frmNewMain.vb).
Formularios principales
| Componente |
Detalle |
| Formulario principal |
frmGestion_Productos_Lineas.cs (VPNET_WinForms\VPNET_WinForms\Gestion\) — C# DevExpress, hereda de FrmResult (ribbon RB_Nuevo/RB_Modificar/RB_Eliminar, grilla DevExpress) |
| Ventana de alta/modificación |
frmGestion_Productos_Lineas_AddMod.cs — hereda de FrmAddMod; campo textEdit1 (Descripción). Enter dispara bt_Aceptar_ItemClick |
| Manager |
Gestion_Productos_Lineas_Manager.cs (VPNET_DataModel\Manager\Gestion\Gestion\) → Base_Manager<Gestion_Productos_Lineas,...> (Entity Framework Code First) |
| Entidad / Mapping |
Gestion_Productos_Lineas (Modelo\) campos Id:int, Descripcion:string, Activo:bool? · Gestion_Productos_LineasMap (Mappings\Gestion\): Descripcion IsRequired().HasMaxLength(100), Id DatabaseGeneratedOption.None |
| Parámetros de búsqueda |
clase interna ParametrosBusquedas : ParametrosBase (Id, Descripcion, Activo) |
| Apertura del form |
frmNewMain.vb → btnGestion_Lineas_ItemClick → KeyLicences.Instance.Access(2, 6, Nothing, 2) + clsSeguridad.IsAllowedObject(..., "Gestion.Archivos.Productos.Lineas", ...) → ShowFrmInDockPanel(New frmGestion_Productos_Lineas) |
| Form legacy (en desuso) |
frmProductos_Lineas.vb (VisualPlenarioNET.Legacy\Gestion\) — versión VB anterior con ListView y clsGestion_productos_Lineas. Ya no está cableado al menú |
Permisos reales
| Permiso |
Habilita |
Gestion.Archivos.Productos.Lineas |
Abrir el formulario (único permiso que valida la versión C# vigente). Objeto padre: Gestion.Archivos.Productos |
Tablas de base de datos principales
| Tabla |
Detalle |
Gestion_Productos_Lineas |
Id (int, PK, asignado por GetNextId_Numeraciones), Descripcion (varchar 100, NOT NULL), Activo (bit, nullable). Acceso por EF Code First (no usa stored procedures) |
Relación con otros módulos / manuales
Notas para soporte (comportamiento real del código)
- La grilla muestra solo activos: tanto en
Load como en btnBuscar_Click el form fuerza par.Activo = true y el GetDatasources del manager filtra siempre Activo == true. El campo Activo no es un filtro elegible por el usuario.
- Alta nueva: el manager arranca con
Id = 0, Activo = true; el AddMod asigna Id = GetNextId_Numeraciones("Gestion_Productos_Lineas") antes de Save(). Validación: si Descripcion vacía muestra "No se ha definido un contenido para Descripcion." y no guarda.
- Baja lógica:
_EntityModel.Activo = false + Save() (no hay DELETE físico). Confirmación: "Desea eliminar el registro seleccionado ?".
- La versión C# vigente no valida los sub-permisos
Gestion.Archivos.Productos.Lineas.nuevo/.Modificar/.Eliminar; esos solo existen en el form legacy VB en desuso.
Ver también