¡Esta es una revisión vieja del documento!

Tabla de Contenidos

Fábrica - Modelos Logs - Log de Transacciones

Fábrica - Modelos Logs - Log de Transacciones

Este es el log utilizado para registrar los logs en las transacciones de modificación de información de los procesos de las aplicaciones.

Tipos de Transacciones

A continuación se listan los tipos de transacciones que deben ser considerados en el log.

Inserciones de datos.
Actualizaciones de datos.
Eliminación de datos.

¿Donde usar el Servicio?

Este servicio debe consumirse en los procesos de cargas de:

Aplicaciones Java
Aplicaciones .Net
Web Service
Aplicaciones Móbiles
Aplicaciones Powerbuilder (Ver Nota siguiente)
Soluciones que afecten los productos SICOF

Nota: Aplicaciones Powerbuilder

Powerbuilder tiene restricciones para el consumo de servicios Rest por lo tanto en las aplicaciones de esta tecnología se implementará un API para realizar las llamadas.

Diccionario de Datos

#	NAME	NULLEABLE	TYPE	COMMENTS	WS¹⁾
OWNER	SICOF	TABLE	TRANSACTIONAL_LOG	COMMENTS	Contiene el log de transacciones de las aplicaciones de la compañia
1	ID	N	NUMBER	Código interno del registro (Se controla por secuencia)	Interno, Autoincremental
2	FECHA	Y	DATE	Fecha en la cuál se genera la transacción	No utilizado
3	NOMBRE_PROCESO	Y	VARCHAR2(256)	Nombre del proceso que realiza la transacción	Externo, Requerido
4	TIPO_TRANSACCION	Y	VARCHAR2(256)	Identifica el tipo de operación (Insert, Select, Update, Delete, Execute)	Externo, Requerido
5	LOG_TABLA	Y	VARCHAR2(256)	Nombre de la Tabla	Externo, Requerido
6	LOG_COLUMNA	Y	VARCHAR2(256)	Nombre de la columna	Obsoleto, Externo
7	LOG_VALOR_ANT	Y	VARCHAR2(4000)	Valor anterior de la columna	Obsoleto, Externo, Requerido
8	LOG_VALOR_ACT	Y	VARCHAR2(4000)	Valor actual de la columna	Obsoleto, Externo
9	LOG_PETICION	Y	CLOB	Se utiliza en caso de ser necesario para almacenar el bloque de la petición completa realizada	Externo, Requerido
10	LOGIN_USUARIO	Y	VARCHAR2(256)	Login del usuario que realiza el proceso	Externo, Requerido
11	HOST_CLIENTE	Y	VARCHAR2(50)	Host del cliente (Dirección IP)	Externo, Requerido
12	FECHA_REGISTRO	Y	DATE	Fecha del sistema DB	Interno, Formato dd/mm/yyyy hh:mm:ss, Requerido
13	CODIGO_USUARIO	Y	NUMBER	Código del usuario de la sesión en la cuál se genera el error	Externo, Requerido
14	CODIGO_MEMPRESA	Y	VARCHAR2(64)	Código de la empresa de la sesión en la cuál se genera el error	Externo, Requerido
15	CODIGO_APLICACION	Y	NUMBER	Código de la aplicación (Identificador interno numérico)	Externo, Requerido
16	INFO_APP	Y	VARCHAR2(256)	Información de la aplicación (En las situaciónes donde no se identifique código interno se puede enviar el nombre de la aplicación o información adicional)	Externo
17	SESSION_MAC	Y	VARCHAR2(64)	MAC del equipo del usuario	Externo
18	SESSION_BROWSERVERSION	Y	VARCHAR2(64)	Versión del Navegador	Externo, Requerido
19	SESSION_OSTYPE	Y	VARCHAR2(64)	Sistema Operativo	Externo, Requerido

Columna: WS

Se adiciona esta columna para identificar reglas asociadas a la implementación de los servicios web que permiten gestionar el almacenamiento de los logs. La columna es una referencia y no hace parte del servicio sin embargo las reglas que se definen en ella si aplican para la columna relacionada:

Reglas

Interno: Indica que el campo se gestiona dentro del servicio y por lo tanto no se pedira en los parametros.
Autoincremental: Indica que el campo se comporta como una secuencia.
Externo: Indica que el campo debe estar en los parametros del consumo.
Requerido: Indica que el campo debe ser enviado en el consumo y el servicio debe validarlo para continuar.
Obsoleto: Indica que el campo ya no es utilizado en la nueva implementación.
No utilizado: Indica que el campo no será utilizado en ninguna implementación.

Nota

Todas las operaciones del servicio que gestiona la persistencia de la tabla deben estar documentadas incluyendo la definición de los campos, formatos, longitudes de columnas e indicar si es requerido o no.

Columna: LOG_PETICION

Esta columna sirve para almacenar la información de la peticion²⁾ que se realiza en el registro que va a la base de datos. Se define la siguiente estructura base ejemplo:

{
  "columns":[
    {
      "column_name":"Nombre de la columna",
      "column_old_value": "Valor anterior de la columna",
      "column_new_value": "Valor actual de la columna"
    }
  ]
}

Donde:

columns: Arrya de Columnas en la transacción
column_name: Propiedad contenida en cada indice del array json que representa el nombre de la columna en la transacción.
column_old_value: Propiedad contenida en cada indice del array json que representa el valor anterior de la columna en la transacción.
column_new_value: Propiedad contenida en cada indice del array json que representa el valor actual de la columna en la transacción.

Ejemplo:

{
  "columns":[
    {
      "column_name":"codigo_tercero",
      "column_old_value": "1234",
      "column_new_value": "3456"
    },
    {
      "column_name":"valor_debito",
      "column_old_value": "0",
      "column_new_value": "100000"
    }
  ]
}

Modo de uso: Powerbuilder - Documentación

Para visualizar la documentación debe descargar el siguiente repositorio Documentación, abrir la pagina Index.html en su navegador web la cual es similar a la siguiente imagen:

En ella encontrará la documentación de las librerias que hacen parte del framework Objetos SICOF el cuál se irá actualizando frecuentmente a medida que se documenten las clases.

La Libreria que contiene la funcionalidad de los logs es la librería sf00util.pbl

Los Objetos relacionados en el API son:

n_cst_app: Clase contenedora de objetos logs
n_cst_log_transactional: Clase para la gestión de log de transacciones

Modo de uso: Java

Para las aplicaciones desarrolladas en la tecnología Java el log de sesión será implementado por medio de un Servicio Web el cual deberá considerar las reglas de Columna: WS

←Volver atras

¹⁾

Define las reglas que debe aplicar el Web Service

²⁾

Valores anteriores y Actuales según corresponda

Wiki

Herramientas de usuario

Herramientas del sitio