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]] | ||