====== Fábrica - Modelos Logs - Log de Sesión de Aplicaciones ======
Este es el log utilizado para registrar los inicios y fin de sesión de las aplicaciones de la compañía. Esta compuesto por una tabla la cuál se describe a continuación.

===== ¿Donde usar el Servicio? =====
Este servicio debe consumirse en los inicios y fin de sesión de las aplicaciones:

  * Aplicaciones Java
  * Aplicaciones .Net
  * 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.

===== Diccionario de Datos =====
^OWNER |SICOF ^TABLE |LOG_REGISTER_SESSION_APP ^COMMENTS | Registra el inicio y fin de sesión de las aplicaciones de ADA ||
^# ^NAME ^NULL ^TYPE ^COMMENTS ^HOW TO USE ^WS((Define las reglas que debe aplicar el Web Service)) ^  
|1 |ID |N |VARCHAR2(32) |Identificador de Registro (automático)| Inicio|Interno Autoincremental|
|2 |FECHA_REGISTRO |Y |DATE |Fecha de Registro (automático)| Inicio|Interno, Formato dd/mm/yyyy hh:mm:ss, Requerido|
|3 |USUARIO_DB |Y |VARCHAR2(32) |Usuario de Sesión en la BD | Inicio|Externo, Requerido|
|4 |CODIGO_USUARIO |Y |NUMBER |Código de Usuario en la Aplicación en Sesión | Inicio|Externo, Requerido |
|5 |CODIGO_MEMPRESA |Y |NUMBER |Código de la Empresa de la Sesión iniciada | Inicio|Externo, Requerido |
|6 |CODIGO_DEPENDENCIA |Y |NUMBER |Código de la Dependencia de la Sesión iniciada | Inicio|Externo |
|7 |TIPO_APP |Y |VARCHAR2(32) |Tipo de Aplicación en Sesión (PB/WEB/MOVIL) | Inicio|Externo, Requerido |
|8 |CODIGO_APLICACION |N |NUMBER |Código de la Aplicación de la Sesión iniciada | Inicio|Externo, Requerido |
|9 |TIPO_REGISTRO |Y |VARCHAR2(32) |Tipo de Registro del Log(LOGIN/SQL...) | Inicio|Externo, Requerido |
|10 |SESSION_ID |Y |VARCHAR2(64) |Identificador de la Sesión de la base de datos | Inicio|Externo |
|11 |FECHA_LOGOUT |Y |DATE |Fecha de fin de Sesión | Fin|Externo, Requerido |
|12 |SESSION_IP |Y |VARCHAR2(32) |IP del host de la Sesión iniciada | Inicio|Externo, Requerido |
|13 |SESSION_MAC |Y |VARCHAR2(64) |MAC de la maquina de la Sesión iniciada | Inicio|Externo |
|14 |SESSION_BROWSERVERSION |Y |VARCHAR2(32) |Versión y Navegador del host de la Sesión iniciada | Inicio|Externo, Requerido |
|15 |SESSION_OSTYPE |Y |VARCHAR2(32) |Tipo de Sistema Operativo del host de la Sesión iniciada | Inicio|Externo, Requerido |
|16 |FECHA_SESSION_ACTIVA |Y |DATE |Fecha de ping en la Sesión iniciada | Frecuente|Obsoleto, Externo|

==== Columna: How to use  ====
Esta columna se expone para indicar el modo de uso de la columna la cual debe ser diligencia según la siguiente clasificación:

  * **Inicio**: Indica que la columna debe ser diligenciada al momento de iniciar sesión un usuario en la aplicación.
  * **Fin**: Indica que la columna debe ser diligenciada al momento de cerrar la sesión un usuario en la aplicación. (Este modo sólo considera cierres de sesión normales).
  * **Frecuente**: Este modo indica que la columna puede ser actualizada frecuentemente para indicar actualización de estado o fecha. (El uso de este modo es opcional).

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

==== Modo de uso: Powerbuilder ====
En las Aplicaciones Powerbuilder el log de sesión ya está implementado de forma automática por medio del API **n_cst_context**((Esta clase se encuentra en la librería sf00util del Framework Objetos SICOF)) la cuál controla los proceso de Inicio y Fin de Sesión.

==== 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: How to use|Columna: How to use]] y [[#Columna: WS|Columna: WS]]

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