Detalle
| Campo | Valor |
|---|---|
| Tipo de documento | Manual de Usuario |
| Módulo | Herramientas |
| Formulario | frmAgenda |
| Caption | Agenda |
Introducción
La Agenda es una libreta de contactos personales/corporativos dentro de Plenario v14. Permite registrar nombre, apellido, empresa, teléfonos (particular, celular, laboral) y correo electrónico de cada contacto, y consultarlos rápidamente por Id, nombre, apellido o empresa. Funciona como directorio de referencia interno y puede invocarse en modo "selección" desde otros formularios para devolver el contacto elegido.
Acceso al módulo
El formulario frmAgenda se abre desde el menú de Herramientas/Archivos de Plenario. Puede abrirse en dos modos:
- Modo administración (por defecto): para dar de alta, modificar, eliminar y consultar contactos.
- Modo selección (
bnReturnSelectedValue = True): cuando otro formulario lo invoca para elegir uno o varios contactos; al confirmar, devuelve el/los Id seleccionados y se cierra.
Pantalla principal
La pantalla muestra una barra de herramientas superior con las operaciones (Nuevo, Modificar, Eliminar, Imprimir), una barra de búsqueda con los campos de filtro, una grilla central con los contactos y una barra de estado inferior que indica el total de registros y la cantidad de registros seleccionados.
Filtros de búsqueda
| Filtro | Descripción |
|---|---|
| ID | Id del contacto (numérico). Si no es numérico, se ignora (toma 0). |
| Nombre | Nombre del contacto. |
| Apellido | Apellido del contacto. |
| Empresa | Razón social / empresa asociada al contacto. |
Al presionar Buscar se ejecuta la consulta y se refresca la grilla; tras buscar, los campos de filtro se limpian automáticamente para una nueva consulta.
Resultados
La grilla de resultados muestra las siguientes columnas:
| Columna | Contenido |
|---|---|
| Id | Identificador del contacto |
| Apellidos | Apellido |
| Nombres | Nombre |
| Teléfono Particular | Teléfono particular |
| Teléfono Celular | Teléfono celular |
| Teléfono Laboral | Teléfono laboral |
| Correo electrónico | |
| Pag. Web | Página web |
| Fecha de Alta | Fecha de alta del registro |
| Fecha de Nacimiento | Fecha de nacimiento |
| Dirección | Domicilio |
| Empresa | Razón social / empresa |
La barra de estado muestra "Total de Registros N" y "Registros Seleccionados : N".
Acciones disponibles
| Acción | Cómo se invoca | Descripción |
|---|---|---|
| Nuevo | Botón Nuevo / tecla Insert sobre la grilla | Abre el alta de contacto (frmAgenda_AddMod). Al confirmar, agrega la fila a la grilla. |
| Modificar | Botón Modificar / doble clic / Enter o Espacio sobre la grilla | Abre el contacto seleccionado para editarlo. |
| Eliminar | Botón Eliminar / tecla Delete sobre la grilla | Pide confirmación y elimina el contacto seleccionado. |
| Imprimir | Botón Imprimir / menú "Resultado de la Búsqueda" | Genera la vista previa de impresión del resultado. |
| Seleccionar (modo selección) | Doble clic / Enter | Devuelve el/los Id seleccionados al formulario que llamó y cierra. |
Ejemplo práctico
- Abra la Agenda desde Herramientas.
- Escriba el apellido en el filtro Apellido y presione Buscar.
- Ubique el contacto en la grilla y haga doble clic para ver/modificar sus datos.
- Si necesita un contacto nuevo, presione Nuevo, complete los datos y confirme.
Consejos útiles
- Use las teclas rápidas sobre la grilla: Insert para nuevo, Delete para eliminar, Enter/Espacio para modificar y Esc para cerrar.
- Puede seleccionar varios registros a la vez; la barra inferior indica cuántos hay seleccionados.
- Tras cada búsqueda los filtros se limpian; vuelva a cargar el criterio para una nueva consulta.
Preguntas frecuentes
¿Puedo seleccionar más de un contacto a la vez?
Sí. En modo selección, el formulario devuelve todos los Id seleccionados en una lista. En modo administración la selección múltiple se usa principalmente para visualizar el conteo en la barra de estado.¿Qué pasa si escribo texto en el filtro ID?
Si el valor del ID no es numérico, el sistema lo ignora (lo toma como 0) y filtra por el resto de los campos.¿Por qué se vacían los filtros después de buscar?
Es el comportamiento del formulario: al terminar la búsqueda limpia los campos para facilitar una nueva consulta. Los resultados quedan en la grilla.¿Puedo imprimir solo lo que estoy viendo?
Sí. La opción Imprimir / "Resultado de la Búsqueda" genera la vista previa del contenido actual de la grilla.Permisos
| Permiso | Acción |
|---|---|
| Archivos.Agenda.Nuevo | Permite cargar un dato a la Agenda |
| Archivos.Agenda.Modificar | Permite modificar un dato de Agenda |
| Archivos.Agenda.Eliminar | Permite eliminar un dato de la Agenda |
Los permisos pertenecen a la categoría Archivos.Agenda y se validan mediante IsAllowedObject.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
| frmAgenda | Listado, búsqueda y operaciones sobre contactos |
| frmAgenda_AddMod | Alta y modificación de un contacto |
Permisos reales
| Permiso | Acción |
|---|---|
| Archivos.Agenda.Nuevo | Alta de contacto |
| Archivos.Agenda.Modificar | Modificación de contacto |
| Archivos.Agenda.Eliminar | Eliminación de contacto |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
| Agenda | Almacena los contactos de la agenda |
Operaciones de datos vía stored procedures: Agenda_Search, Agenda_Add, Agenda_Mod, Agenda_Del. El nuevo Id se obtiene mediante numeración Get_CodNew("Agenda","Id").
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Llamados | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- Formulario legacy (VB.NET, clase
clsAgendasobre stored procedures). Verificar contra el binario instalado.