Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Fábrica - Modelos Logs - Log de Cargas de Procesos (Archivos) ======
Este es el log utilizado para registrar las notificaciones que puedan presentar en los procesos de cargas de información.

===== Tipos de Notificaciones =====
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

===== ¿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 ([[#Nota: 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.

==== 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_LINEA ====
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:

<code yaml>
{
  "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"}
        ]
    }
  ]
}
</code>

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:

<code yaml>
{
  "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"}
        ]
    }
  ]
}
</code>

==== Modo de uso: Powerbuilder - Documentación ====
Para visualizar la documentación debe descargar el siguiente repositorio [[http://adacsc.co:1443/svn/repository/ADA/SICOF/Objetos%20SICOF/FUENTES/branches/branches%2012.5.2.5.0/doc/documentacion|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

==== Modo de uso: Java ====
Para las aplicaciones desarrolladas en las tecnologías (Web):

* Java 
  * .Net
  * PHP

el log de sesión será implementado por medio de un [[http://10.1.20.89/doku.php?id=ada:howto:sicoferp:factory:integrations:logs|Servicio Web]] el cual deberá considerar las reglas de [[#Columna: WS|Columna: WS]]

[[ada:howto:sicoferp:factory:logmodels|←Volver atras]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página