Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
ada:sicoferp:rentas:herramientas:ws.bancos [2021/08/30 16:34] 192.168.177.37 creado |
ada:sicoferp:rentas:herramientas:ws.bancos [2023/10/27 21:41] (actual) 192.168.177.78 |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
====== WebserviceRecaudoIFXBello ====== | ====== WebserviceRecaudoIFXBello ====== | ||
- | API para la escritura, notificación, registro y propagación de errores en aplicaciones Java. Consta de una clase abstracta para el control centralizado del log en los diferentes niveles de severidad. | + | Servicio web bajo arquitectura SOAP para la consulta y pago de facturas de Banco de Bogotá en línea de facturas del cliente Bello. Este web service consta de los servicios: |
- | * Escritura en el log del servidor a través de la API log4j. | + | * consultaFactura |
- | * Notificación vía WS para registro de errores en DDBB, según implementación del servicio de [[ada:howto:sicoferp:factory:logmodels:registryerrors|Log de Registro de Errores | + | <code xml> |
- | ]]. | + | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rec="http://recaudo.webservice.ada.com/"> |
- | * Propagación de excepciones al usuario (front-end) a través de la implementación del método abstracto, el cual debe propagar de cara al usuario por el uso de las herramientas de mensajería utilizadas por el framework del front-end de cada aplicativo. | + | <soapenv:Header/> |
+ | <soapenv:Body> | ||
+ | <rec:consultaFactura>?</rec:consultaFactura> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </code> | ||
+ | * consultarFacturaPorNumero | ||
+ | <code xml><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rec="http://recaudo.webservice.ada.com/"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <rec:consultarFacturaPorNumero>?</rec:consultarFacturaPorNumero> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </code> | ||
+ | * notificarPagoFactura | ||
+ | <code xml><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rec="http://recaudo.webservice.ada.com/"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <rec:notificarPagoFactura>?</rec:notificarPagoFactura> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </code> | ||
- | Esta API está escrita y compilada en ''Java 6'' y definida bajo los criterios de configuración y dependencias gestionadas a través de Maven escritas en el archivo [[ada:sicoferp:rentas:herramientas:logger:pom.xml|pom.xml]]. | + | Para todos los casos, consta de un único parámetro el cual es el número de la factura en formato entero numérico. |
- | + | ||
- | El código fuente está disponible en versión branch en el [[http://adacsc.co:1443/svn/repository/ADA/SITU/CARTERAYRECAUDO/FUENTES/branches/development/logger|respositorio SVN]] | + | |
- | + | ||
- | ===== Log ===== | + | |
- | + | ||
- | Implementación de los diferentes métodos de llamado a escritura en el servidor de aplicaciones a través de la API ''log4j'' en su versión ''1.2.11'', según los diferentes niveles de severidad: | + | |
- | + | ||
- | * Debug: Se realizará la escritura en el log sólo si está habilitada en este modo. | + | |
- | * Info: registra en el log del servidor cualquier notificación en este nivel de severidad. | + | |
- | * Warn: registra en el log del servidor cualquier notificación en este nivel de severidad. | + | |
- | * **Error**: registra en el log del servidor y a través del servicio de registro de log cualquier notificación en este nivel de severidad. | + | |
- | * **Fatal**: registra en el log del servidor y a través del servicio de registro de log cualquier notificación en este nivel de severidad. | + | |
- | + | ||
- | **NOTA**: Los dos últimos métodos harán uso de la notificación vía WS para registro en DDBB. | + | |
- | + | ||
- | Esta funcionalidad hará uso de la configuración definida en [[ada:sicoferp:rentas:herramientas:logger:log.json|log.json]]. Tal como se puede observar, dicha configuración está escrita en ese formato, para lo cual se ha definido la clase abstracta [[ada:sicoferp:rentas:herramientas:logger:alogger|com.ada.utilidades.situ.log.ALogger]]. | + | |
- | + | ||
- | ===== Notificación ===== | + | |
- | + | ||
- | A través del consumo del servicio de registro de errores en base de datos, se hará registro de los niveles de severidad Error y Fatal. | + | |
- | + | ||
- | ===== Propagación de excepciones ===== | + | |
- | + | ||
- | En todo momento, se realizará el llamado a la implementación del método | + | |
- | + | ||
- | <code java> | + | |
- | /*** | + | |
- | * Método abastracto para ser implementado en la clase desendiente, el cual | + | |
- | * tiene el propósito de notificar visualmente al usuario acerca los eventos que | + | |
- | * están siendo reportados. En la implementación de este método, se usará | + | |
- | * cualquier tecnología de mensajería con la cual esté familiarizado el | + | |
- | * front-end del aplicativo, permitiendo así la portabilidad a cualquier | + | |
- | * framework | + | |
- | */ | + | |
- | public abstract void addMessage(final String idMessage, final int severity, final String resume, | + | |
- | final String detail); | + | |
- | </code> | + | |
- | el cual al ser un método abstracto será de obligatoria implementación en la clase que extiende de la abstracta [[ada:sicoferp:rentas:herramientas:logger:alogger|com.ada.utilidades.situ.log.ALogger]] para garantizar de forma limpia, la notificación de los eventos presentados hasta el usuario. | + | La configuración completa del servicio se encuentra en en al archivo [[ada:sicoferp:rentas:herramientas:ws.bancos.wsdl|wsdl]]. |
- | Un ejemplo de la implementación de la clase [[ada:sicoferp:rentas:herramientas:logger:alogger|ALogger]] puede ser [[ada:sicoferp:rentas:herramientas:logger:log|Log]], previa adición de la API ''logger'' al ''.classpath'' del sistema cliente. | ||
- | **NOTA**: En el archivo de configuración del servidor o en una variable de entorno la llave ''LOG_CONFIGURATION_PATH'', con valor por ejemplo de ''C:\co\ada\situ\log.json'', se deberá configurar la ruta de ubicación del archivo [[ada:sicoferp:rentas:herramientas:logger:log.json|log.json]]. El cual es el insumo principal del proceso para darle control a las excepciones. | + | LA URL del ?wsdl en producción actualmente es http://10.1.20.84:28080/WebserviceRecaudoIFX/RecaudosServicePort?wsdl |
[[ada:sicoferp:rentas|<< regresar]] | [[ada:sicoferp:rentas|<< regresar]] |