← Índice de manuales
Manual funcional · Sistema Plenario v14

Administrador de Licencias - Plenario v14

El Administrador de Licencias es la herramienta con la que Plenario administra las licencias por cliente/empresa: qué módulos y submódulos tiene habilitados, su vigencia, cantidad de usuarios y puestos permitidos, y la…

Módulo: HerramientasVersión: 1.0Actualizado: 2026-06-23

Detalle

Campo Valor
Manual de Usuario Administrador de Licencias - Plenario v14
Módulo Herramientas
Ventanas Administrador de Licencias (Licencias 3.0)
Versión 1.0

Introducción

El Administrador de Licencias es la herramienta con la que Plenario administra las licencias por cliente/empresa: qué módulos y submódulos tiene habilitados, su vigencia, cantidad de usuarios y puestos permitidos, y la generación de la key (hash cifrado) que el sistema valida al iniciar.

La grilla principal lista las licencias por cliente con un detalle expandible de módulos/submódulos. Desde la barra se puede agregar, modificar y generar la key de una licencia, ver el log de cambios de la licencia, decodificar una key existente, y abrir la ficha o el legajo del cliente asociado.

Es una herramienta de uso interno de Plenario (administración de licencias del producto). El título de la ventana incluye la cadena de conexión activa (servidor/base), por lo que indica sobre qué base se está operando.

Acceso al módulo

Ventana Ruta
Administrador de Licencias Herramientas → Administrador de Licencias

El acceso y las operaciones requieren permisos del grupo Plenario.Licencias (ver Permisos).

Pantalla principal

Al abrir, la ventana lee la cadena de conexión y arma el título "Licencias 3.0 - ". Muestra la grilla maestro de licencias con un nivel de detalle (Licencias_Detalle) expandible por módulo/submódulo, y restaura el layout de columnas guardado por usuario.

Botón Descripción
Nuevo Agrega una licencia (abre FormLicencias_Detalle).
Modificar Edita la licencia seleccionada.
Generar Licencia Genera la key (hash) de la licencia seleccionada.
Log de Licencias Abre el log de cambios de la licencia (FormPlenario_Licencias_Log).
Decodificar Abre FormDecodeLicense para inspeccionar/decodificar una key existente.
Ver Cliente Abre la ficha del cliente asociado a la licencia.
Ver Legajo Abre el legajo del cliente asociado a la licencia.

El botón Eliminar está deshabilitado/oculto en esta ventana (RB_Eliminar no visible): las licencias no se borran desde aquí.

Filtros de búsqueda

La búsqueda se hace por parámetros simples y se aplica con Buscar.

Filtro Descripción
Id Cliente Filtra por identificador de cliente (Id_Cliente).
Descripción Filtra por nombre del cliente (contiene texto).
Limpiar parámetros Restablece Id y Descripción a valores vacíos.

Resultados

La grilla muestra una licencia por cliente. Cada fila se puede expandir para ver el detalle de módulos/submódulos habilitados.

Dato Descripción
Cliente Cliente/empresa titular de la licencia.
Condición de Venta Forma de pago asociada al cliente (resuelta por join).
Vigencia Fechas desde/hasta o vigencia ilimitada.
Detalle (expandible) Módulos y submódulos habilitados, por área y entorno.

El layout de la grilla se guarda por usuario al cerrar la ventana (registro de Windows) y se restaura al abrirla. Existe la opción de restaurar las columnas a los valores originales.

Acciones disponibles

Agregar una licencia

  1. Nuevo. Se valida el permiso Plenario.Licencias.Agregar.
  2. En FormLicencias_Detalle, cargar el cliente, la vigencia y los módulos/submódulos.
  3. Aceptar. La grilla se refresca con la nueva licencia.

Modificar una licencia

  1. Seleccionar la licencia (o doble clic) y Modificar. Se valida Plenario.Licencias.Modificar.
  2. Editar los datos y el detalle en FormLicencias_Detalle.
  3. Al cerrar, el manager refresca y la grilla muestra los cambios.

Generar la key (hash) de la licencia

  1. Seleccionar la licencia y Generar Licencia. Se valida Plenario.Licencias.Generar.
  2. En Form_Licencias_GenerarHash se genera la key cifrada de la empresa (KeyEmpresaId + KeyLicences).
  3. Esa key es la que el sistema cliente valida al iniciar para habilitar usuarios, puestos y módulos.

Decodificar una key

  1. Decodificar abre FormDecodeLicense.
  2. Permite ingresar/inspeccionar una key existente y ver su contenido (empresa, módulos, vigencia).

Ver log, cliente o legajo

Acción Resultado
Log de Licencias Abre el historial de cambios de la licencia seleccionada.
Ver Cliente Abre la ficha del cliente (MostrarCliente).
Ver Legajo Abre el legajo del cliente (VerLegajoCliente).

Ejemplo práctico

Habilitar un módulo nuevo para un cliente y entregar la key:

  1. Herramientas → Administrador de Licencias.
  2. Filtrar por Descripción con el nombre del cliente y Buscar.
  3. Seleccionar la licencia y Modificar; en el detalle agregar el módulo/submódulo y ajustar la vigencia. Aceptar.
  4. Con la licencia seleccionada, Generar Licencia para producir la key actualizada.
  5. (Opcional) Decodificar la key para verificar que incluye el módulo agregado antes de enviarla.

Consejos útiles

  • Confirmá sobre qué base estás trabajando mirando el título de la ventana (incluye servidor/base de la cadena de conexión).
  • Después de modificar el detalle de una licencia, Generar Licencia nuevamente: el cambio recién impacta al cliente cuando se regenera y se aplica la key.
  • Usá Decodificar para auditar una key reportada por un cliente sin tocar la licencia.
  • No busques un botón de borrado: las licencias no se eliminan desde esta ventana (Eliminar está deshabilitado).

Preguntas frecuentes

¿Por qué no puedo eliminar una licencia? La acción Eliminar está deshabilitada/oculta en esta ventana (`RB_Eliminar` no visible y `EliminarLicencia` comentado). Las licencias se administran agregando/modificando y regenerando la key, no borrándolas desde aquí.
Modifiqué la licencia pero el cliente sigue sin el módulo, ¿qué falta? Hay que **Generar Licencia** otra vez para producir la nueva key cifrada; el sistema cliente valida la key al iniciar. Sin regenerar y aplicar la key, el cambio no surte efecto.
¿Cómo verifico qué contiene una key que me pasó un cliente? Usá **Decodificar** (`FormDecodeLicense`): permite descifrar la key y ver empresa, módulos/submódulos y vigencia.
¿Qué controla la licencia exactamente? Cantidad de usuarios y puestos permitidos, vigencia (fechas o ilimitada), modo solo lectura y los módulos/submódulos habilitados por área y entorno. La validación se hace en `KeyLicences`.

Permisos

Las operaciones de alta, modificación y generación validan objetos del grupo Plenario.Licencias mediante IsAllowedObject. Si el usuario no tiene el permiso, la acción no se ejecuta.

Operación Objeto de permiso
Agregar licencia Plenario.Licencias.Agregar
Modificar licencia Plenario.Licencias.Modificar
Generar key de licencia Plenario.Licencias.Generar

El objeto de Agregar se valida con un espacio final literal en la cadena ("Plenario.Licencias.Agregar "); ver Notas para soporte.

Información técnica

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

Formularios principales

Form Rol
Form_Licencias.cs (C#, VPNET_WinForms/Licencias) Hereda de FrmResult. Grilla maestro-detalle de licencias por cliente; barra Nuevo, Modificar, Generar, Log, Decodificar, Ver Cliente, Ver Legajo. Título con la cadena de conexión.
Form_LicenciasAddMod.cs / FormLicencias_Detalle Alta/modificación de la licencia y su detalle de módulos/submódulos.
Form_Licencias_GenerarHash.cs Genera la key (hash) cifrada de la licencia.
FormDecodeLicense Decodifica/inspecciona una key existente.
FormPlenario_Licencias_Log Log de cambios de la licencia.

Permisos reales

Permiso Acción
Plenario.Licencias.Agregar Agregar una licencia (nota: con espacio final en el string).
Plenario.Licencias.Modificar Modificar una licencia.
Plenario.Licencias.Generar Generar la key de la licencia.

Tablas de base de datos principales

Tabla Uso
Plenario_Licencias Maestro de licencias por cliente (vigencia, datos de alta/mod, cliente).
Plenario_Licencias_Detalle Detalle de módulos/submódulos habilitados por licencia.
Plenario_Licencias_Modulo Catálogo de módulos.
Plenario_Licencias_SubModulo Catálogo de submódulos (por módulo).
Gestion_FormasDePago Forma de pago / condición de venta del cliente (join para mostrar).
Plenario_Registro_Usuarios Registro de sesiones usado por KeyLicences.ValidRegisterUser para validar usuarios/puestos.

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
ABM de Usuarios y Permisos - Plenario v14 Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte

  • Permiso "Agregar" con espacio final: el código valida "Plenario.Licencias.Agregar " (con un espacio al final). Al crear el objeto de permiso debe respetarse ese string exacto o la validación no coincidirá.
  • La key se genera/valida en KeyLicences (manager): cifrado/descifrado con Generic_Base_Manager.Encrypt/Decrypt, FingerPrint del equipo y conteo de usuarios/puestos activos contra Plenario_Registro_Usuarios.
  • La key cifrada de toda la empresa se persiste en el parámetro VPNET.Plenario.Licencias; KeyLicences.Instance la lee usando Empresa.Id.
  • El layout de la grilla se guarda/restaura en HKEY_CURRENT_USER\Software\Sistemas Plenario\VisualPlenarioNET\GridsLayouts.
  • EliminarLicencia y la lógica de borrado están comentadas; Eliminar no opera desde esta ventana. Verificar contra el binario instalado ante diferencias.
¿Te resultó útil este manual?