[HOWTO] Configuracin perfilado Proyecto PISCO

1. Objetivo
El objetivo del documento es realizar una serie de recomendaciones de configuracin que permitan asegurar que los distintos componentes del proyecto Pisco se comportan de una manera correcta y sincronizada entre ellos, estas recomendaciones se centran exclusivamente en la funcionalidad del proceso de perfilado y del identificador de sesin hidatsa/Terminal contable.

2. Escenario Pisco
El escenario al que aplican las recomendaciones en la configuracin del proceso de Perfilado es el correspondiente al proyecto Pisco, describimos los componentes y se presenta un esquema del escenario del proyecto.

2.1.

Componentes del proyecto Pisco impactados por el documento

Los componentes del proyecto Pisco que se ven impactados por las recomendaciones del documento son: Portal ATPI - Core, Aplicaciones Nacar Ligeras y Escritorio Nacar Pesado 2.0

2.1.1. Portal ATPI Core Arquitectura Nacar ATPI, este componente es el que se despliega en entornos Pisco para dar servicio a las operaciones de la Vista del portal implementada por el propio Pas. 2.1.2. Aplicaciones Nacar Ligeras (KSZT/KJJQ/KJTP/etc.) Aplicaciones Nacar ligeras desplegadas por el proyecto Pisco o bien accedidas desde el portal ATPI del proyecto Pisco. 2.1.3. Escritorio Nacar Pesado 2.0 Aplicacin que se ejecuta desde los puestos de la red de oficinas y desde la que se accede a las diferentes aplicaciones. El escritorio Nacar Pesado se corresponde con la Arquitectura Nacar ATAE.

2.2.

Esquema del escenario Pisco

En el esquema que presentamos a continuacin, graficamos la comunicacin entre los componentes descriptos en punto 2.1. El dato representativo del esquema es el ejemplo de comunicacin que se puede presentar desde puestos Nacar Pesados (Oficinas) hacia algunas aplicaciones ligeras (KSZT/KJID en el CPD) y entre Puestos de Areas Centrales hacia la vista del Portal ATPI que implica el acceso a las aplicaciones ligeras menurizadas en este.

3. Portal ATPI Core

3.1. Descripcin general

Para ejecutar el proceso de perfilado en el Core del Portal ATPI, se tienen que configurar una serie de claves de configuracin, esta toman un valor segn el mecanismo elegido. Hasta el momento, en entornos Latam (Mexico/Peru/Chile), el mecanismo seleccionado para cargar el perfil de los usuarios es ejecutando la carga desde un fichero de perfil inicial (xml con datos comunes a todos los perfiles) y un Flujo perfilador (flujo Nacar).

* Flujo perfilador: es un flujo aplicativo que se desarrolla dentro de una aplicacin Nacar Ligero que cumple con una serie de requerimientos (contexto de entrada/salida, etc.).

Este flujo Nacar recupera los valores del perfil de un usuario segn el entorno en el que se ejecute (LDAP u otro origen) y carga los datos recuperados en el contexto de salida del flujo (NOMBRE / APELLIDO / BANCO_OPERATIVO / CODAUT / etc.). * Fichero perfil inicial (XML): es un fichero en el que se definen valores comunes a todos los perfiles del entorno (BANCO_OPERATIVO / IDIOMA / etc.).

3.2.
3.2.1.

Flujo aplicativo Perfilador

Menurizacin de la operacin del Flujo Perfilador

Fichero "ataeoperacionesescritorio.properties" # Flujo Perfilador CFG.ESCRITORIO.PERFIL01=*,1,,XXXXFL99999,true, Fichero "variables.atpi.%ENTORNO%.properties" # Operacin que menuriza el flujo de perfilado VAR.PERFILADOR.EXTERNALIZACION_OPERACION_LOGON=PERFIL01

3.2.2. Configuracin Bsqueda de recursos Para completar la configuracin Nacar ligera, es importante tener correctamente definida la clave que especifica la/las rutas en donde la Arquitectura busca los flujos a ejecutar segn la aplicacin y pas en el que se ejecuta. Esta clave es CFG.FLUJO.DIRECTORIO y se configura en el fichero ligeros.%APLICACION%.properties La clave, tiene que ser definida teniendo en cuenta la ruta donde se distribuye el flujo de perfilado y para configurar esta, preferentemente se tienen que utilizar las variables %PAIS% / %APLICACION% / %DIRBASE%

3.3.

Perfil inicial XML

3.3.1. Fichero "variables.atpi.%ENTORNO%.properties" VAR.PERFILADOR.ESTRUCTURA_INICIAL_BAD=%DIRBASE%/atpi/online/%PAIS%/multicana l/cfg/entorno/xxxx_perfil.xml

3.4.

Configuracin Nacar - Proceso de perfilado

3.4.1. Fichero "ligeros.atpi.%PORTAL%.properties" Dentro del fichero de arranque del core del portal ATPI, se tienen que personalizar las siguientes claves de configuracin:

###################################################################### # Perfilado por XML # ###################################################################### 8010000=atae.thin.segu.identificacion.AtaeSvIdentificacionThinPerfilador CFG.PERFILADOR.IMPLEMENTACION_OBTENCION_DATOS=atae.segu.perfilador.obtencion. base.AtaeSvObtencionDatosEstructuraXML CFG.PERFILADOR.IMPLEMENTACION_EXTERNALIZACION=atae.segu.perfilador.externalizac ion.base.AtaeSvExternalizacionObjetoEscritorio CFG.PERFILADOR.IMPLEMENTACION_TRATAMIENTO_DATOS= atae.segu.perfilador.tratamiento.base.AtaeSvTratamientoOperacionNacarEscritorio CFG.PERFILADOR.ESTRUCTURA_INICIAL_BAD=@VAR.PERFILADOR.ESTRUCTURA_INICI AL_BAD@ CFG.PERFILADOR.EXTERNALIZACION_OPERACION_LOGON=@VAR.PERFILADOR.EXTER NALIZACION_OPERACION_LOGON@ CFG.PERFILADOR.IMPLEMENTACION_FILTRADO_DATOS=atae.segu.perfilador.filtrado.base. AtaeSvFiltradoDatosAplicativoNulo CFG.PERFILADOR.CACHE_ACTIVAR_COMPROBACION_COOKIE_SESION=true ###################################################################### #Configuracin sesin ASTA # ###################################################################### CFG.THIN.ID_ASTA.REQUIERE_ESTABLECIMIENTO=true CFG.THIN.ID_ASTA.SD_ESTABLECIMIENTO_SESION:"nombreserviciodatosqueobtienesesion ASTA"

3.4.2. Fichero "portal.cfg" Dentro del fichero de arranque del core del portal ATPI, se tienen que personalizar las siguientes claves de configuracin:
ATPI_GESTORDATOSUSUARIO_CACHE_JERARQUIA=false ATPI_TIPO_ENVIO_SESION_ASTA=1

3.4.3. Valores por defecto de la Arquitectura Nacar La configuracin que especificamos a continuacin, se corresponde con claves que la propia Arquitectura define y que se ajustan al proceso de perfilado seleccionado para la aplicacin ATPI. Esta configuracin se distribuye en ficheros de la Arquitectura ATCL (ligeros.properties, nacar.properties, etc.). Dividimos la configuracin por defecto segn el fichero de Arquitectura del que se toma el valor por defecto en el arranque del portal ATPI a configurar. IMPORTANTE: la configuracin que se presenta a continuacin no tiene que ser modificada de los propios ficheros de Arquitectura ni sobrescritos en el fichero properties del core ATPI a configurar.

3.4.3.1. Fichero "ligeros.properties" CFG.PERFILADOR.IMPLEMENTACION_OPERACIONES=atae.segu.perfilador.operaciones. AtaeSvOperacionesUsuarioAtpc CFG.PERFILADOR.IMPLEMENTACION_CACHE=atae.segu.perfilador.cache.base.AtaeSvC acheFicheroUsuario CFG.PERFILADOR.IMPLEMENTACION_FILTRADO_APLICACION=ncsc.apli.ruticomunes.b coOficinaOpe.NcscBcoOficinaOperativosLigeros CFG.PERFILADOR.IMPLEMENTACION_VALIDADOR=atae.segu.perfilador.validador.base. AtaeSvValidacionNula #Activacin del mdulo de cach. CFG.PERFILADOR.CACHE=true CFG.PERFILADOR.CACHE_RUTA=%DIRBASE%/atcl/online/multipais/multicanal/tmp/%US UARIO%/ #Nombre de los ficheros de cach CFG.PERFILADOR.CACHE_NOMBRE_FICHERO=ficheroCache.tmp 90C0002 = atae.segu.altamira.datos.ucm.AtaeSvSeguridadDatosUCM 3.4.3.2. Fichero " nacar.properties" 8030000=atae.segu.perfilador.base.AtaeSvGestorPerfilado

4. Aplicaciones Nacar Ligeras (KSZT/KJJQ/KJTP/etc.)

4.1. Descripcin general

Las aplicaciones Nacar ligeras se tienen que configurar para que ejecuten el proceso de perfilado de forma similar a la Arquitectura ATPI Core. Las aplicaciones ligeras, cuando se ejecuten, intentarn obtener el perfil de la cache que pudo haber generado algn acceso anterior desde el propio portal ATPI u otra aplicacin ligera (configuracin cache ATCL que ya viene por defecto en la propia Arquitectura Nacar). Cuando la cache del perfil no exista se tiene que ejecutar el proceso de perfilado de la misma forma que se ejecuta en ATPI; de esta forma, se ejecutar el flujo aplicativo de perfilado para obtener el perfil y este perfil obtenido se guardar en la cache de la Arquitectura ATCL.

4.2.

Menurizacin de la operacin del Flujo Perfilador

Respecto de la configuracin del flujo perfilador, se tienen que tomar en cuenta las mismas recomendaciones realizadas en 3.2.1 Menurizacin de la operacin del Flujo Perfilador y 3.2.2 Configuracin Bsqueda de recursos. Estas recomendaciones son, definir la operacin en PERFIL01 en el fichero "ataeoperacionesescritorio.properties" y la variable VAR.PERFILADOR.EXTERNALIZACION_OPERACION_LOGON en fichero "variables.%APLICACION%.%EQUIPO%.properties.

4.3.

Configuracin del fichero Perfil inicial XML

Respecto de la configuracin del fichero Perfil inicial XML, se tienen que tomar en cuenta las mismas recomendaciones realizadas en 3.3 - Configuracin del fichero Perfil inicial XML. La recomendacin es la de definir la variable VAR.PERFILADOR.ESTRUCTURA_INICIAL_BAD en fichero "variables.%APLICACION%.%EQUIPO%.properties.

4.4.

Configuracin Nacar - Proceso de perfilado

4.4.1. Fichero "ligeros.%APLICACION%.properties" Dentro del fichero de arranque de la aplicacin nacar ligero, se tienen que personalizar las claves de configuracin de manera similar al descripto en el Portal ATPI (punto 3.4 Configuracin Nacar - Proceso de perfilado). Remarcamos en rojo la nica clave de configuracin que vara respecto de la configuracin del Portal. ###################################################################### # Perfilado por XML # ###################################################################### 8010000=atae.thin.segu.identificacion.AtaeSvIdentificacionThinPerfilador CFG.PERFILADOR.IMPLEMENTACION_OBTENCION_DATOS=atae.segu.perfilador.obtencion. base.AtaeSvObtencionDatosEstructuraXML CFG.PERFILADOR.IMPLEMENTACION_EXTERNALIZACION=atae.segu.perfilador.externalizac ion.base.AtaeSvExternalizacionObjeto CFG.PERFILADOR.IMPLEMENTACION_TRATAMIENTO_DATOS= atae.thin.segu.perfilador.tratamiento.base.AtaeSvTratamientoInformacionExtendidoBase CFG.PERFILADOR.ESTRUCTURA_INICIAL_BAD=@VAR.PERFILADOR.ESTRUCTURA_INICI AL_BAD@ CFG.PERFILADOR.EXTERNALIZACION_OPERACION_LOGON=@VAR.PERFILADOR.EXTER NALIZACION_OPERACION_LOGON@ CFG.PERFILADOR.IMPLEMENTACION_FILTRADO_DATOS=atae.segu.perfilador.filtrado.base. AtaeSvFiltradoDatosAplicativoNulo CFG.PERFILADOR.CACHE_ACTIVAR_COMPROBACION_COOKIE_SESION=true ###################################################################### #Configuracin sesin ASTA # ###################################################################### CFG.THIN.ID_ASTA.REQUIERE_ESTABLECIMIENTO=true CFG.THIN.ID_ASTA.SD_ESTABLECIMIENTO_SESION:"nombreserviciodatosqueobtienesesion ASTA" 4.4.2. Valores por defecto de la Arquitectura Nacar Valen las mismas recomendaciones que se realizan en el punto Valores por defecto de la Arquitectura Nacar del punto 3.4.2 Valores por defecto de la Arquitectura Nacar.

5. Personalizacin aplicacin Nacar Ligera KJID

5.1. Descripcin general
La aplicacin KJID se configura con todas las recomendaciones realizadas en el punto 4. Aplicaciones Nacar Ligeras (KSZT/KJJQ/KJTP/etc.), en este apartado, mencionamos la configuracin que difiere del resto de las aplicaciones Nacar Ligera.

5.2.

Configuracin Nacar - Proceso de perfilado

5.2.1. Fichero "ligeros.%APLICACION%.properties" Dentro del fichero de arranque de la aplicacin nacar ligero, se tienen que personalizar las claves de configuracin ya mencionadas en punto anterior y se personaliza la clave que a continuacin se detalla. ###################################################################### # Perfilado por XML # ###################################################################### CFG.PERFILADOR.IMPLEMENTACION_TRATAMIENTO_DATOS=atae.segu.perfilador.trata miento.base.AtaeSvTratamientoOperacionNacarEscritorio CFG.PERFILADOR.CACHE_ACTIVAR_COMPROBACION_COOKIE_SESION=false

6. Escritorio Nacar Pesado 2.0

6.1. Descripcin general

En el escritorio Nacar Pesado, se configura las claves de configuracin que permiten ejecutar el servicio genrico ATAESG00012 Operaciones ligeras desde pesados adjuntando en la p eticin los datos del entorno pesado. Los datos que se agregarn en las peticiones a aplicaciones ligeras son: perfil, cdigos de autorizacin, hidatsa, terminal contable.

6.2.

Configuracin Nacar Propia del pas

6.2.1. Fichero "...\atae\online\%PAIS%\ofi\cfg\nacar.%PAIS%.ofi.properties" Las modificaciones a realizar en este fichero properties, se tienen que solicitar mediante la generacin de una peticin Remedy al equipo de Arquitectura America. ###################################################################### # Configuracin servicio genrico ATAESG00012 ###################################################################### CFG.OPERACIONLIGERA.ENVIAR_PERFIL=true

CFG.OPERACIONLIGERA.ENVIAR_COD_AUT_PERFIL=true CFG.OPERACIONLIGERA.ENVIAR_SESION=true CFG.OPERACIONLIGERA.ENVIAR_TERMINALCONTABLE=true