Herramientas de usuario

Herramientas del sitio


ada:sicoferp:rentas:herramientas:ws.bancos

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

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 ​propagación ​de errores ​en aplicaciones JavaConsta ​de una clase abstracta para el control centralizado del log en los diferentes niveles de severidad.+Servicio web bajo arquitectura SOAP para la consulta ​pago de facturas de Banco de Bogotá ​en línea de facturas del cliente BelloEste 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 casosconsta ​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]]
ada/sicoferp/rentas/herramientas/ws.bancos.1630341261.txt.gz · Última modificación: 2021/08/30 16:34 por 192.168.177.37