Categoría: Sistema Administrativo Forseti

Documentación del Sistema Administrativo Forseti “SAF”

Registros del sistema

Forseti ERP gestiona a través de la interfaz del SAF tres tipos distintos de registros: Inicios de Sesión, Registros de Procesos y Registros Administrativos.

Inicios de Sesión

El módulo de inicios de sesión del SAF te permite consultar quién ha iniciado sesión dentro de las interfaces del SAF y CEF.

Vista del Módulo

Panel lateral:

  • Interfaz. Contiene los elementos de las interfaces del SAF y CEF. Siempre aparecerán por defecto los inicios de sesión del SAF.
  • Rango.
    • Hoy. Filtra y muestra solo los inicios de sesión de hoy (Esta es la selección por defecto).
    • Semana. Filtra y muestra los inicios de sesión pertenecientes a los últimos siete días.
    • Mes. La ficha de mes, permite filtrar inicios de sesión de cierto mes específico. Filtrar por mes puede hacer mas lento el servidor temporalmente.
  • Estatus.
    • Todas. Muestra registros que tengan cualquier estatus ya sea que estén activos, bloqueados o cerrados.
    • Activas. Muestra únicamente los inicios de sesión que están activos actualmente.
    • Bloqueadas. Esta ficha muestra aquellos registros que fueron bloqueados por alguna circunstancia, por ejemplo, tres intentos fallidos en la contraseña.
    • Cerradas. Muestra los registros que ya han terminado la sesión. Estos se eliminan hasta que se libere el registro.

Las columnas por defecto que muestra el cuerpo principal de este módulo son la siguientes:

  • IP. Es la dirección IP desde la cual se han conectado (en caso de conexión a través de un proxy será la dirección IP del proxy de red).
  • Host. Es el nombre completo del ordenador. Nota: Si el conector tomcat tiene desactivado “enableLookups” por razones de rendimiento, entonces el host no se resolverá y será el mismo valor de la IP.
  • Fecha. Indica la fecha del registro.
  • Id. Es el Id de sesión con el navegador del cliente.
  • Desde. Es la hora en la que el cliente ha iniciado la sesión según la fecha anterior.
  • Hasta. Es la hora en la que el cliente cerró la sesión. Si la sesión está abierta actualmente, será la misma del inicio.
  • Estatus. Muestra el estatus de la sesión. (Activa, Bloqueada o Cerrada). Nota: Las sesiones activas que por lógica deberían estar ya cerradas (como sesiones de días o meses pasados) demuestran fallas en el servidor como paros inesperados por fallas de luz etc.
  • BD. Es la Base de Datos a la que se ha conectado o intentado conectar el cliente (solo aplica al CEF porque en el SAF, la única base de datos para conectarse será FORSETI_ADMIN ). Nota: En sesiones bloqueadas, puede ser que este nombre no coincida con el nombre de ninguna base de datos registrada en Forseti ERP lo cual dio motivo al bloqueo.
  • Usuario. Es el Rol con el cual el cliente ha iniciado o intentado iniciar sesión. Nota: Al igual que en la base de datos, en sesiones bloqueadas, puede ser que este rol no coincida con el nombre de ningún rol registrado, lo cual dio motivo al bloqueo. Esto también aplica a una introducción de contraseña errónea.
NOTA: Los inicios de sesión activos y cerrados siempre aparecen en color negro, mientras que todos los bloqueados aparecen en color rojo.

Procesos del Módulo de Inicios de Sesión

En el módulo de inicios de sesión intervienen los procesos primarios de eliminar todo, eliminar registro y desbloquear.

Eliminar todo.

Permite eliminar todo el registro de sesiones. Esto eliminará todo y absolutamente todo el registro de sesiones del SAF y CEF sin importar de cual interfaz estemos viendo sus registros ni si están activos, bloqueados o cerrados. Esta opción trunca la tabla tbl_registros de la base de datos principal FORSETI_ADMIN.

Eliminar registro.

Permite liberar parte del registro de sesiones del SAF y CEF sin importar de cual interfaz estemos viendo sus registros. Este proceso nos arroja el siguiente formulario:

  • Fecha. Es la fecha (inclusive) desde la cual vamos a liberar espacio del registro de sesiones hacia atrás en el tiempo.

Desbloquear registro.

Este proceso permite eliminar un registro del SAF o CEF con estatus bloqueado para poder utilizar la IP asociada sin tener que esperar a que se desbloquee automáticamente.

Errores comunes en este Módulo.

ERROR: No se puede desbloquear la IP porque este registro no la está bloqueando.

Solo los registros con Estatus de “Bloqueado” son los que están bloqueando la dirección IP asociada a el, por lo tanto, no se pueden eliminar registros con otro estatus porque si así fuera, de todas maneras la IP seguiría bloqueada y el problema no se resolvería.

Registros de Procesos


El módulo de registro de procesos del SAF te permite consultar quién ha utilizado el servidor, en donde y como lo ha estado haciendo.

Vista del Módulo

Panel Lateral:

  • Interfaz. Veremos las fichas de las interfaces del SAF y CEF. Siempre aparecerán por defecto los procesos del SAF.
  • Rango.
    • Hoy. Filtra y muestra solo los procesos de hoy (esta es la selección por defecto).
    • Semana. Filtra y muestra los procesos pertenecientes a los últimos siete días.
    • Mes. La ficha de mes permite filtrar procesos de cierto mes específico. Filtrar por mes puede hacer muy lento el servidor temporalmente.
  • Estatus.
    • Todos. Muestra registros que tengan cualquier estatus, ya sea normales, erróneos, no autorizados o alertas.
    • Normales. Muestra únicamente los procesos que fueron ejecutados con éxito.
    • Erróneos. Son aquellos procesos que durante su ejecución tuvieron algún error controlado e hicieron un “rollback” a la transacción. Por ejemplo, al intentar ingresar una póliza en un mes inexistente fallará la transacción y se devolverá a su estado anterior.
    • No Autorizados. Son procesos que no fueron autorizados. Por ejemplo, el intento de agregar una factura cuando el rol que intenta ejecutarlo no tiene permisos de: Ventas/Módulo Facturación/Proceso Agregar factura.
    • Alertas. Las alertas son intentos por sobrepasar la seguridad del servidor, por ejemplo, ataques de “SQL Injection”, de peticiones “POST” no autorizadas, pero también pueden deberse a “bugs” en el sistema que no se han detectado aún. Cualquiera que sea el motivo, es importante avisar al administrador del servidor sobre el problema. Si se sospecha que la alerta fue lanzada por un bug y a este servidor no se le ha modificado su código fuente, puedes mandar un informe sobre el error. Para esto puedes ingresar a la página Anexos/Apéndices/Informes de fallos de esta documentación.

Las columnas por defecto que muestra el panel de cuerpo principal de este módulo son la siguientes:

  • Estatus. Es el estatus del registro (Normal, Erróneo, No Autorizado o Alerta).
  • Fecha. Indica la fecha y hora en que fué ejecutado el proceso registro.
  • BD. Es la Base de Datos (nombre físico) en la cual se ejecutó este proceso. (Solo aplica al CEF porque en el SAF la única base de datos será FORSETI_ADMIN).
  • Usuario. Es la clave del Rol que ejecutó el proceso o, cef_su en caso de que se haya registrado como dueño de la base de datos en el CEF y saf_su como el usuario administrativo “fsi” en el SAF
  • ID. Es el ID del proceso. Este consta de cinco secciones seperadas por el caracter “pipe”, las cuales son:
    1. ID del Módulo a cuatro letras.
    2. ID del registro en la base de datos resultado de esta transacción, o nada en caso de que este proceso se refiera a una consulta general sobre el módulo.
    3. ID de la entidad a la que pertenece el registro en la base de datos resultado de esta transacción, o nada en caso de no aplicar.
    4. ID secundario del registro en la base de datos resultado de esta transacción, como por ejemplo, alguna partida del registro, o nada en caso de no aplicar.
    5. ID especial que algunos registros contienen, como por ejemplo, ALT o SAL en cuentas por pagar o por cobrar, etc., o nada en caso de no aplicar.
  • Permiso. Es el nombre (mas no la clave o descripción) del permiso involucrado en este proceso.
  • Resultado. Es el resultado de la transacción a la ejecución de este proceso:
    • Los procesos de consulta general a un módulo no muestran resultados.
    • Los procesos de registros exitosos muestra el mensaje de la transacción finalizada del procedimiento.
    • Los procesos no terminados, no autorizados y las alertas, muestran el mensaje de error regresado al usuario.
NOTA: Los procesos con estatus normal siempre aparecen en color negro, mientras que todos los erróneos, no autorizados y alertas aparecen en color rojo.

Procesos del Módulo de Registro de Procesos

En el módulo de registro de procesos intervienen los procesos primarios de eliminar todo y eliminar registro.

Eliminar todo.

Permite eliminar todo el registro de procesos. Esto eliminará todo y absolutamente todo el registro de procesos del SAF y CEF sin importar de cual interfaz estemos viendo sus registros, ni cual sea su estatus. Esta opción trunca la tabla tbl_regproc de la base de datos principal FORSETI_ADMIN.

Liberar registro.

Permite liberar parte del registro de sesiones del SAF y CEF sin importar de cual interfaz estemos viendo sus registros. Este proceso nos arroja el siguiente formulario:

  • Fecha. Es la fecha (inclusive) desde la cual vamos a liberar espacio del registro de procesos hacia atrás en el tiempo.

Registros Administrativos

El módulo de registros administrativos del SAF te permite consultar los archivos generados por la ejecución automática o manual de procesos administrativos del servidor.

Vista del Módulo

Panel Lateral:

  • Tipo.
    • Actualizaciones. Son los archivos de registro de actualizaciones del servidor. Si se ha seleccionado desde el módulo de Servidor y Empresas en las propiedades del servidor, la opción de Revisión de actualizaciones disponibles para que sean automáticas, entonces se creará un archivo de registro al día de la revisión y en caso de existir una actualización, se anexará su registro a este mismo archivo.
    • Respaldos. Son los archivos de registro de los respaldos automáticos y completos del servidor y de los respaldos manuales de bases de datos en especial.
    • Restauraciones. Son los archivos de registro de la restauración de bases de datos anteriormente respaldadas.
    • Actualizaciones CEF. Son los archivos de registro de la actualización de saldos, existencias y otros elementos de cada empresa instalada en este servidor. Esto sucede cuando las actualizaciones automáticas explicadas en la “Actalización de saldos y otros en todas las empresas” del módulo de Servidor y Empresas en las propiedades del servidor están configuradas. Nota: Las actualizaciones manuales que se hacen desde el CEF no generan este archivo de registro.
    • Altas. Son los registros de la creación de nuevas bases de datos en el servidor PostgreSQL.
    • Bajas. Son los registros de la eliminación de bases de datos en el servidor.
  • Rango.
    • Hoy. Filtra y muestra solo los archivos de hoy (esta es la selección por defecto).
    • Mes. La ficha de mes permite filtrar archivos de cierto mes específico.

En el cuerpo principal de este módulo no encontramos columnas, solo archivos que se guardan en el directorio log de nuestra instalación Forseti ERP y llevan la estructura [TIPO]-[BD]-[YYYY-MM-DD-hh-mm].[log] en su nombre para poder identificarlos, donde:

  • [TIPO] Es el tipo de archivo de registro, estos pueden ser:
    • ACT, para Revisión y Actualizaciones del servidor.
    • RESP, para Respaldos.
    • REST, para Restauraciones.
    • SLDS, para Actualización de saldos, existencias y otros elementos del CEF.
    • CREAR, para Empresas nuevas.
    • ELIM, para Empresas eliminadas.
  • [BD] Es el nombre de la base de datos que propició la generación del archivo de registro. No aplica en revisión y actualizaciones del servidor ni en actualización de saldos, existencias y otros elementos del CEF, ya que estos, son procesos administrativos propios del servidor. En respaldos completos de servidor este elemento llevará el nombre de la base de datos principal FORSETI_ADMIN.
  • [YYYY-MM-DD-hh-mm] Es la fecha de creación del archivo de registro, por ejemplo, si se creó el 25 de noviembre de 2022 a las 8:53 pm, mostrará 2012-11-25-20-53.
  • [log] Es la extensión del archivo. Todos los archivos de registro están en formato de texto plano con la extensión .log y pueden visualizarse en cualquier editor de texto.

Procesos del Módulo de Registros Administrativos

En el módulo de registros administrativos intervienen los procesos primarios de abrir archivo, eliminar todo, y liberar registro.

Abrir archivo

Permite abrir el archivo de registro seleccionado de la lista. Los archivos de registro contienen información importante que sirve para saber como se comportó este proceso administrativo. En los archivos se registran los sucesos paso a paso incluyendo información sobre posibles errores que haya sufrido el proceso.

Eliminar todo.

Permite eliminar todo el registro administrativo. Esto eliminará todos y absolutamente todos los archivos de registro sin importar el tipo al que pertenecen. Esta opción borrará todo el contenido del directorio log de nuestra instalación Forseti ERP.

Liberar registro.

Permite liberar parte del registro administrativo sin importar el tipo de archivo de registro al que pertenecen. Este proceso nos arroja el siguiente formulario:

  • Fecha. Es la fecha ( inclusive ) desde la cual vamos a liberar espacio del registro administrativo, hacia atrás en el tiempo.