"2007 - Año de la Seguridad Vial" INTERFACE GUARANI QUILMES Actualizado a v2.5.2 Junio 2007 Santa Fe 1548 piso 11 Frente Ciudad Autónoma de Buenos Aires - República Argentina Telefax: (++5411) 4129-1800 interno 1955 Web Site: www.siu.edu.ar SIU PÁGINA 1 DE 23
INTERFACE GUARANI QUILMES...1 Actualizado a v2.5.2...1 Versiones compatibles...4 Objetivo...4 Qué datos se pasan...5 Forma de pasar los datos...5 Opción manual...6 Opción automática...6 Anexo 1 - Stored procedures...7 Stored Procedures...8 Sp_qui_datos_per...8 Sp_qui_datos_cen...8 Sp_qui_insc_carr...8 Sp_qui_cestado_alu...8 Triggers...8 Anexo 2 - Tablas de interfaz con SIU-Quilmes...9 INT_QUI_PERSONAS...10 INT_QUI_PER_MAILS...10 INT_QUI_ PER_DOC...10 INT_QUI_PER_DOM...10 INT_QUI_PER_TEL...10 INT_QUI_REFERENCIA...10 INT_QUI_CAMBIO_EST...10 INT_QUI_TIPOS_REFE...10 INT_QUI_CON_REFE...10 INT_QUI_ESTADOSCLI...10 Tablas de interfaz Vs abm en siu-quilmes...11 int_qui_tipos_refe Tablas Globales : Tipos de Referencias...11 Detalle de cada tabla:...12 Int_qui_personas...12 Int_qui_per_mail...12 Int_qui_per_dom...12 Int_qui_per_doc...13 Int_qui_per_tel...13 Int_qui_referencias...13 Int_qui_con_refe...14 Int_qui_tipos_refe...14 Int_qui_cambio_est...14 Int_qui_estadoscli...15 Anexo 3 - Archivo de configuración...16 Anexo 4 Operaciones...16 Admin005 Módulos Conexiones a bases de datos...16 ifz00020 Exportación de datos a SIU-Quilmes. Error al Procesar....18 Prueba realizada...19 Inscripción a carreras La primer persona con los triggers descomentados...19 Exporto los datos con ifz00020:...22 Inscripción a carreras otra persona------pendiente de probar...23 PÁGINA 2 DE 23
PÁGINA 3 DE 23
Versiones compatibles Guaraní: v2.03.0 - v2.03.1 - v2.04.0 Quilmes: V1. 3.0 v1. 3.1 Guaraní: v2.5.0 Quilmes: v1.5.0 Objetivo Permite pasar los datos de un aspirante a SIU-Quilmes y también conocer en qué estado se encuentra un alumnos en cuanto a los pagos que debe efectuar. Este módulo surge en la v2.03.0 y el requerimiento de clear quest es el GUARA00004629. El sistema de gestión SIU-Guaraní le genera al sistema de facturación SIU Quilmes actividades. Las actividades previstas en esta primera versión son: Cobro de matrícula inicial. (Derecho de inscripción a carreras para los ingresantes) Cobro de matrícula anual Cobro de cuotas mensuales. El circuito sería de esta forma: PÁGINA 4 DE 23
MODULO DE CONSUMOS en SIU_QUILMES: Objetivo Administrar el proceso por el cual las actividades de las personas se traducen en los correspondientes conceptos de facturación. Prestaciones principales: Interactuar con los sistemas de gestión para importar datos de personas y sus actividades Procesar las actividades informadas por los sistemas de gestión y generar los conceptos asociados Administrar los eventos que pueden informarse en las actividades. Administrar las referencias (datos asociados a las actividades) Administrar las distintas variantes de facturación: Servicio fijo, Valor fijo en cuotas, etc Administrar las tablas de relación entre actividades y conceptos de facturación Administrar los estados de los clientes Qué datos se pasan En guarani en esta primera versión se generan 5 actividades: Inscripción a carreras Reinscripciones a carrera. Registra los datos personales de la persona Registra los datos de: Teléfonos, E-mails, Domicilios, Documentos. Registra los cambios de estado del alumno (Egresado, Pasivo, Abandono por cambio de carrera, No Regular, Regular ) SIU-Quilmes por cada una de estas actividades que reciba generará consumos de acuerdo a las reglas definidas en el mismo sistema (que cobrar, cantidad de cuotas, etc) Siu-Quilmes informa a los sistemas de gestión el estado de los clientes, su morosidad. Consultar el Anexo 2. Forma de pasar los datos Existen dos opciones para pasar los datos de Guaraní a Quilmes: A demanda Automática En ambas opciones la conexión a la base de datos utilizada por SIU-Quilmes se define en el modulo de Administración del sistema de la interface de gestión de SIU-Guaraní con la operación PÁGINA 5 DE 23
El módulo se llama: INT_QUILMES ( ver anexo 1) Aquí se define el tipo de conexión, servidor, motor de base de datos, base de datos, el usuario, password de la base de datos de SIU-Quilmes. Opción manual Es la operación Ifz00020 Exportación de datos a SIU-Quilmes. Se selecciona la operación y presionando el botón Procesar del menú, automáticamente se actualizan las tablas correspondientes de ambos sistemas. ( ver anexo 4) Opción automática Esta opción esta desarrollada a través de una pequeña aplicación que se conecta a la base de datos de guaraní. De allí recupera los datos para conectarse a la base de datos de SIU-Quilmes (definida en el módulo INT_QUILMES). Esta aplicación esta compuesta por una sola librería de Power Builder: interface_guarani_quilmes.pbl Tanto la app de gestión como esta app usan el mismo objeto de power para realizar el pasaje de datos entre Guaraní y Quilmes (uo_interface_quilmes) Se debe generar el ejecutable de esta aplicación y ejecutarla. Si no se definen los parámetros dbuser y dbpass en el archivo de configuración (INTERFACE_GUARANI_QUILMES.INI) la aplicación abrirá una ventana para que el usuario ingrese el usuario y clave para realizar la conexión con la base de datos de Guaraní. Este usuario deberá tener permisos de INSERT, SELECT y DELETE sobre las tablas de interface con Quilmes (int_qui_xxxxxxx) y permisos sobre las tablas de interface en la base de datos de Quilmes. En el archivo de configuración de esta aplicación se le define el tiempo de delay entre las conexiones entre ambas bases y el pasaje de datos. Este archivo debe estar en el mismo directorio que el siu_guarani.ini. (Anexo 3) PÁGINA 6 DE 23
Anexo 1 - Stored procedures Procesos utilizados para registrar en las tablas de interface con Quilmes los cambios producidos en Guaraní. PÁGINA 7 DE 23
Stored Procedures Proceso Descripción Se llama desde Registra los datos personales de Alta de datos personales. Sp_qui_datos_per la persona. Actualización de datos Sp_qui_datos_cen Sp_qui_insc_carr Sp_qui_cestado_alu Registra los datos de: Teléfonos, E-mails, Domicilios, Documentos Registra las inscripciones a carreras y Reinscripciones a carrera Registra los cambios de estado del Alumno. Egresado, Baja en la carrera, etc personales. Alta de datos censales Actualización de datos censales. Inscripción a una carrera Reinscripción a una carrera Actualización de la calidad del alumno. Cambio de Regularidad de un alumno. Triggers Los triggers que disparan los procesos que cargan las tablas de interface en la base de Guaraní (tablas int_qui_xxxx) tienen comentado en su código la ejecución de dichos procesos. Quien decida utilizar SIU-Quilmes, debería descomentar el código para la ejecución de estos procesos. Tabla Triggers Proceso que ejecuta sga_alumnos tu_alumnos sp_qui_cestado_alu sga_personas ti_personas sp_qui_datos_per tu_personas sp_qui_datos_per sga_datos_censales ti_datos_censales sp_qui_datos_cen tu_datos_censales sp_qui_datos_cen sga_carrera_aspira ti_carrera_aspira sp_qui_insc_carr PÁGINA 8 DE 23
Anexo 2 - Tablas de interfaz con SIU-Quilmes Se crearon tablas en Guaraní especialmente para esta interface. SIU-Quilmes con tablas especiales para interactuar con SIU-Guaraní u otra aplicación que desee relacionarse. Tablas Descripción creada Ult Mod PÁGINA 9 DE 23
INT_QUI_PERSONAS INT_QUI_PER_MAILS INT_QUI_ PER_DOC INT_QUI_PER_DOM INT_QUI_PER_TEL INT_QUI_REFERENCIA Registra los datos personales. Registra los datos E-mails de la persona Documentos de la persona incluyendo el Nro de Inscripción Domicilio del periodo lectivo, de persona allegada y de procedencia V2.04.0 Teléfono particular, celular Registra la inscripción a una carrera. El tipo de referencia puede ser Carrera o Curso. Guaraní solamente usa Carrera. La referencia es el código de la carrera. INT_QUI_CAMBIO_EST Registra los cambios de estado que puede sufrir un alumno (Alumno regular, Pérdida de regularidad, Reincorporación, Egresado, Sancionado, Moroso, atrasado en el pago, Baja en la carrera, Abandonó). Algunos de estos valores los escribe Guaraní y otros los escribe Quilmes. Por esa razón hay un campo sistema que indica cuál de los dos insertó el dato. V2.5.2 V2.5.2 cambió INT_QUI_TIPOS_REFE Registra los tipos de referencia que puede usar un alumno. Para Guaraní el único valor es Carrera. INT_QUI_CON_REFE Registra las referencias. En el caso de Guaraní las referencias son las carreras a las que se puede inscribir un alumno. INT_QUI_ESTADOSCLI Registra los cambios de estado de los clientes. V2.5.2: En la v1.4.0 del SIU-Quilmes cambió el nombre de la columna tipo de documento en la tabla PÁGINA 10 DE 23
select * from int_qui_personas; select * from int_qui_per_mails; select * from int_qui_per_doc; select * from int_qui_per_dom; select * from int_qui_per_tel; select * from int_qui_referencia; select * from int_qui_cambio_est; select * from int_qui_tipos_refe; select * from int_qui_con_refe; select * from int_qui_estadoscli; con_cambios_de_estado. Se llamaba cod_tipo_de_documento, y ahora se llama cod_tipo_documento. Este cambio afectó a la dw 'dk_int_qui_con_cambios_de_estado' ya que accede a la base del quilmes para recueprar los estados de los clientes. Tablas de interfaz Vs abm en siu-quilmes int_qui_tipos_refe Tablas Globales : Tipos de Referencias PÁGINA 11 DE 23
Detalle de cada tabla: Int_qui_personas Int_qui_per_mail Int_qui_per_dom PÁGINA 12 DE 23
Int_qui_per_doc Int_qui_per_tel Int_qui_referencias PÁGINA 13 DE 23
Int_qui_con_refe Int_qui_tipos_refe Int_qui_cambio_est PÁGINA 14 DE 23
Int_qui_estadoscli PÁGINA 15 DE 23
Anexo 3 - Archivo de configuración INTERFACE_GUARANI_QUILMES.INI En la sección [Aplicacion] esta la clave tiempo en el cual se define el tiempo en segundos. tiempo=7600 modulo_interface=int_quilmes En la sección [Base de Datos] se define los datos de conexión a la base de datos de Guaraní, idem a lo definido en la misma sección del archivo de configuración de Guaraní Gestión: SIU_GUARNI.INI [Base de Datos] dbms=in9 I-Net v9.x database=desarrollo dbuser=usr_interface dbpass=xxxxxxxx logid= logpass= servername=@ol_guarani dbparm=connectstring="disablebind=0,scroll=1,pbcatalogowner="dba"" Anexo 4 Operaciones Admin005 Módulos Conexiones a bases de datos PÁGINA 16 DE 23
PÁGINA 17 DE 23
ifz00020 Exportación de datos a SIU-Quilmes. Error al Procesar. Requisito: Tener descomentados el código en los triggers mencionados anteriormente donde se llama a los SP que cargan las tablas de interface (ver triggers) Seleccionar la operación y luego ejecutar el proceso con clic en el icono del menú PÁGINA 18 DE 23
Prueba realizada Por evento se mostrará el impacto sobre las tablas de interface int_qui_personas; int_qui_per_mails; int_qui_per_doc; int_qui_per_dom; int_qui_per_tel; int_qui_referencia; int_qui_cambio_est; int_qui_tipos_refe; int_qui_con_refe; int_qui_estadoscli; Inscripción a carreras La primer persona con los triggers descomentados int_qui_personas; int_qui_per_mails; int_qui_per_doc; int_qui_referencia; int_qui_tipos_refe; La primer vez que se ejecuta genera todos los registros con los tipos de referencias válidos. int_qui_con_refe; La primer vez que se ejecuta genera todos los registros con los distintos códigos de carrera y la referencia Carrera que es la que tiene implementado Guaraní en esta primera interfase. PÁGINA 19 DE 23
PÁGINA 20 DE 23
PÁGINA 21 DE 23
Exporto los datos con ifz00020: PÁGINA 22 DE 23
Inscripción a carreras otra persona------pendiente de probar int_qui_personas; int_qui_per_mails; int_qui_per_doc; int_qui_referencia; int_qui_tipos_refe; int_qui_con_refe; int_qui_per_dom; int_qui_per_tel; int_qui_cambio_est; int_qui_estadoscli; PÁGINA 23 DE 23