Este es el log utilizado para registrar las notificaciones que puedan presentar en los procesos de cargas de información.

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

• Inicio de Carga
• Fin de Carga
• Errores en las lineas procesadas
• Errores en columnas de las lineas procesadas

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

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.

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:

• 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.

• 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.

Esta columna sirve para almacenar todas la notificaciones que se pueden presentar al procesar una linea del archivo de la carga. Se define la siguiente estructura base ejemplo:

{
  "columns":[
    {
      "column_name":"Requerido: Nombre de la columna",
      "column_value": "Requerido: Valor de la columna",
      "column_notifications":
        [
          {"msg":"Requerido: Mensaje de Notificación 1"},
          {"msg":"Requerido: Mensaje de Notificación 2"},
          {"msg":"Requerido: Mensaje de Notificación N"}
        ]
    }
  ]
}

Donde:

• columns: Arrya de Columnas del archivo de carga
• column_name: Propiedad contenida en cada indice del array json que representa el nombre de la columna analizada del proceso de carga.
• column_value: Propiedad contenida en cada indice del array json que representa el valor de la columna analizada del proceso de carga.
• column_notifications: Propiedad contenida en cada indice del array json que representa el array de notificaciones de la columna analizada del proceso de carga.
• msg: Propiedad contenida en cada indice de column_notifications de la columna analizada del proceso de carga.

Ejemplo:

{
  "columns":[
    {
      "column_name":"fecha_sistema",
      "column_value": "01/01/20",
      "column_notifications":
        [
          {"msg":"El año de la fecha es menor a la vigencia actual"},
          {"msg":"La fecha no tiene el formato dd/mm/yyyy"}
        ]
    }
  ]
}

• Los valores de las columnas deben ser registrados como String

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_file_upload: Clase para la gestión de log de cargas

Para facilitar la implementación y uso del API de gestión de errores se crea un objeto interno privado en la clase global guo_app el cual puede ser accedido por el método of_log_error() que devuelve la instancia del objeto. Sin embargo para implementaciones específicas se puede optar por crear y administrar la clase de error n_cst_log_error según considere el desarrollador.

A continuación se listan ejemplos de uso el cuál presenta las forma de utilizar el API, para más información debe consultar la documentación en el repositorio.

/*Ejemplos de uso utilizando la instancia genérica de la clase guo_app*/
guo_app.of_log_error( ).of_add_log("EJEMPLO_CODE", 10, true, SQLCA)
guo_app.of_log_error( ).of_add_log("EJEMPLO_CODE", "ERROR_DB", true, SQLCA)
guo_app.of_log_error( ).of_add_log("EJEMPLO_CODE", 10, ls_args, true, SQLCA)
guo_app.of_log_error( ).of_add_log_text("Ejemplo", "ERROR_DB", "Presupuesto", true, SQLCA)
guo_app.of_log_error( ).of_add_log_text( sqldbcode, sqlerrtext, dataobject, sqlsyntax, ls_ventana, true, lts_db)
 
/*Ejemplo de uso definiendo la clase de error, 
instancia el array de formateo de mensaje y 
registra en el log el mensaje formateado. 
Posteriormente elimina la instancia de la clase de gestión de error.
"El array de formateo se utiliza cuando el mensaje se genera por expresiones: 
Ejemplo:
Mensaje Base = Hola #1 (identificado con el código de mensaje SALUDO_CODE), 
se crea un array con un expresión de la siguiente forma 
array[1] = "Mundo", 
de esta forma al usar el método of_add_log se genera el mensaje: Hola Mundo".
*/
n_cst_log_error luo_log_error
String ls_args[]
ls_args[1] = "Mundo"
luo_log_error = Create n_cst_log_error
luo_log_error.of_add_log("SALUDO_CODE", 10, ls_args, true, SQLCA)
destroy luo_log_error
 
/*Ejemplo de uso definiendo la clase de error y 
registra en el log el mensaje por medio de un código de mensaje. 
Posteriormente elimina la instancia de la clase de gestión de error.*/
n_cst_log_error luo_log_error
luo_log_error = Create n_cst_log_error
luo_log_error.of_add_log("EJEMPLO_CODE", 10, true, SQLCA)
destroy luo_log_error
 
/*Ejemplo de uso definiendo la clase de error y 
registra en el log el mensaje por medio de un código de mensaje. 
Posteriormente elimina la instancia de la clase de gestión de error.*/
n_cst_log_error luo_log_error
luo_log_error = Create n_cst_log_error
luo_log_error.of_add_log("EJEMPLO_CODE", "ERROR_DB", true, SQLCA)
destroy luo_log_error

• El API puede ser activada o desactivada por medio de la constante: LOG_ERRORS (Solo en aplicaciones SICOF ERP (Appeon/Powerbuilder)).
• El desarrollador es el encargado de gestionar la transacción que realiza la persistencia.
• Se automatiza el registro de errores en los objetos uo_datawindow y uo_datastore en toda su herencia.
• Se automatiza el registro de errores genéricos no controlados lanzados por el evento systemerror de Powerbuilder.
• Para el procesamiento de logs de bloques se implementa Clase sailjson para procesamiento de cadenas de texto en ese formato.

Se adicionan métodos de procesamiento de bloques en formato json los cuales pueden ser utilizados para registrar trazas de error a continuación se muestran ejemplos de uso del API.

sailjson ljson, ljson1 
String ls_content
 
ljson = create sailjson
ljson.setattribute( 'version', '1001')
//add json object
ljson1 = ljson.addobject( 'header')
ljson1.setattribute( 'count', 3)
ljson1.setattribute( 'comment', 'items count')
 
//add json object array, first item
ljson1 = ljson.addarrayitem( 'data')
ljson1.setattribute( 'colid', 1)
ljson1.setattribute( 'colname', 'aaaaaa')
ljson1.setattribute( 'coladdr', '')
//add second item of the array
ljson1 = ljson.addarrayitem( 'data')
ljson1.setattribute( 'colid', 2)
ljson1.setattribute( 'colname', 'bbbbbbbb')
setnull(ls)
ljson1.setattribute( 'coladdr', ls)
//add third item of the array
ljson1 = ljson.addarrayitem( 'data')
ljson1.setattribute( 'colid', 3)
ljson1.setattribute( 'colname', 'cccccc')
 
ljson.setattribute( 'creattime', string(now(), 'yyyymmdd.hhmmss'))
 
ls_content =  ljson.getformatjson('' )
destroy ljson

/*Ejemplo de Uso del API con el Log de Errores*/
sailjson ljson, ljson1 
ljson = create sailjson
//add json object array, first item
ljson1 = ljson.addarrayitem( 'errors')
ljson1.setattribute( 'error_code', '-1')
ljson1.setattribute( 'error_description', 'Error actualizando base de datos')
ljson1.setattribute( 'error_line', '100')
ljson1.setattribute( 'error_method', 'SystemError')
ljson1.setattribute( 'error_tracer', '')
//add second item of the array
ljson1 = ljson.addarrayitem( 'errors')
ljson1.setattribute( 'error_code', '-10')
ljson1.setattribute( 'error_description', 'Error general del sistema')
ljson1.setattribute( 'error_line', '101')
ljson1.setattribute( 'error_method', 'SystemError')
ljson1.setattribute( 'error_tracer', 'SystemOutMemoryError')
//Consumir Log de Errores con traza en formato json
guo_app.of_log_error( ).of_add_log("EJEMPLO_CODE", 10, lson, true, SQLCA)

Para las aplicaciones desarrolladas en las tecnologías (Web):

• Java
• .Net
• PHP

el log de sesión será implementado por medio de un Servicio Web el cual deberá considerar las reglas de Columna: WS

←Volver atras