Detalle
| Tipo de documento | Manual de Usuario |
| Módulo | Herramientas |
| Formulario | frmReporteOnline_Setup_AddMod (caption "Configuración de Reporte Online (ADS)") |
| Tipo de pantalla | Configuración (parámetros de conexión del servicio) |
Introducción
Reporte Online (ADS) es la pantalla de configuración del servicio de reporte online del proveedor de información externo (ADS). Guarda las credenciales y los datos de conexión (host, usuarios y contraseñas web y XML, TTL de caché) que el sistema utiliza para consultar el servicio online. No procesa datos de negocio: es un formulario de setup de un único registro de parámetros.
Acceso al módulo
Menú principal → Herramientas → Reporte Online (btnHerr_ReporteOnLine). Se abre como diálogo modal (ShowDialog), centrado sobre la ventana padre y con tamaño fijo.
Pantalla principal
Un único GroupBox con los campos de configuración y un botón Aceptar en la barra de herramientas superior. Al cargar, el formulario lee el registro existente (objReporteOnline_Setup.Load()) y completa los campos.
Parámetros
| Campo | Control | Descripción |
|---|---|---|
| Cod. Cliente (ADS) | txtCodCliente |
Código de cliente en ADS (en la versión analizada la asignación está comentada en el código) |
| User Name | txtUserName |
Usuario web del servicio (mapea a UserNameWeb) |
| PassWord | txtPassWord |
Contraseña web del servicio (mapea a PassWordWeb) |
| Host Consulta | txtUrlConsulta |
Host/URL del servicio de consulta (valor por defecto http://200.69.209.148, mapea a HostWeb) |
| XML User Name | txtXMLUserName |
Usuario para la interfaz XML (mapea a UserName) |
| XML PassWord | txtXMLPassWord |
Contraseña para la interfaz XML (mapea a PassWord) |
| TTL | txtTTL |
Tiempo de vida / caché (entero, por defecto 30) |
Al pasar Enter en cualquier campo se avanza al siguiente (Tab automático).
Resultado del proceso
Al presionar Aceptar (cmdNuevo), el formulario asigna los valores a objReporteOnline_Setup y ejecuta Save():
- Si guarda correctamente, cierra el formulario.
- Si falla, muestra el mensaje de error del objeto (
ErrorMessage) y deja el formulario abierto.
El TTL se valida como numérico; si no lo es, se guarda 0.
Acciones disponibles
- Aceptar (
cmdNuevo): guarda la configuración (alta o modificación del único registro de parámetros) y cierra.
Ejemplo práctico
- Desde Herramientas → Reporte Online se abre la configuración.
- El formulario muestra los valores actuales del servicio (si existían).
- Se cargan/ajustan el Host Consulta, los usuarios y contraseñas (web y XML) y el TTL.
- Se presiona Aceptar; si los datos son válidos, la configuración queda guardada y el sistema la usará para las consultas online posteriores.
Consejos útiles
- El Host Consulta debe apuntar al servidor del servicio ADS; el valor por defecto es sólo un ejemplo y normalmente se reemplaza por el host del entorno.
- Hay dos juegos de credenciales: las web (UserName/PassWord) y las XML (XML UserName/XML PassWord). Cargá ambas según lo provea el proveedor.
- El TTL controla la vigencia/caché de la información; un valor bajo refresca más seguido pero genera más consultas.
Preguntas frecuentes
¿Para qué sirve esta pantalla?
Es la configuración del servicio de Reporte Online (ADS): guarda host y credenciales que el sistema usa para consultar información online. No genera reportes por sí misma.¿Cuál es la diferencia entre las credenciales web y las XML?
Las credenciales web (UserName/PassWord) y las XML (XML UserName/XML PassWord) corresponden a dos interfaces distintas del servicio. Se cargan por separado según lo que provea ADS.¿Qué significa el campo TTL?
Es el tiempo de vida / caché de la información consultada (por defecto 30). Debe ser numérico; si no lo es, se guarda 0.El botón no cierra el formulario.
Significa que el guardado falló. El sistema muestra el mensaje de error del objeto de configuración; corregí los datos e intentá de nuevo.¿Por qué el campo Cod. Cliente no parece guardarse?
En la versión analizada la asignación de ese campo está comentada en el código, por lo que el valor visible no se persiste. Verificar contra el binario instalado.Permisos
El formulario no aplica permisos por acción (IsAllowedObject) en su código. El acceso depende de la visibilidad del botón de menú Herramientas → Reporte Online. Verificar contra el binario instalado si la habilitación del menú se controla por seguridad en el host.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
frmReporteOnline_Setup_AddMod |
Configuración del servicio Reporte Online (caption "Configuración de Reporte Online (ADS)") |
ReporteOnline.ReporteOnline_Setup |
Clase de negocio (en ReporteOnline.dll) con Load/Save de los parámetros |
Permisos reales
| Permiso | Acción |
|---|---|
| (sin permiso específico en el formulario) | El form no llama a IsAllowedObject; el acceso se controla por el menú Herramientas |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
Reporte_Online_Setup |
Registro único de parámetros: Id, UserName, PassWord, TTL, Activo, UserNameWeb, PasswordWeb, HostWeb |
Reporte_Online_Log |
Log de consultas del servicio (procedimientos ReporteOnline_Log_*) |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Lotes de Datanet | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| Transferencias Bancarias | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- Formulario legacy (VB.NET). La lógica de negocio está en la librería compilada
ReporteOnline.dll(carpetasLibyBuilds), no en código fuente del workspace. Verificar contra el binario instalado para confirmar el comportamiento exacto de Load/Save. - El mapeo de controles a propiedades es cruzado: "User Name"/"PassWord" de la UI corresponden a
UserNameWeb/PassWordWeb, mientras que "XML User Name"/"XML PassWord" corresponden aUserName/PassWordde la tabla. - El campo "Cod. Cliente (ADS)" aparece en pantalla pero su asignación está comentada en el código de la versión analizada (no se guarda).
- La persistencia se realiza vía stored procedures
ReporteOnline_Setup_Add/_Mod/_Search/_Delsobre la tablaReporte_Online_Setup.