====== Fábrica - Servicios Web - Integraciones ====== Esta sección esta dedicada a los Servicios Web que proveen integraciones. ===== Documentos Relacionados ===== Para diligenciar la documentación de los servicios web se anexan las siguientes plantillas o procesos los cuales deben utilizarse como referencia: ^Fecha ^Versión ^Estado ^Tipo ^Proceso^ |01/07/2021|1.0|Vigente|Plantilla|[[ada:howto:sicoferp:factory:integrations:template|Plantilla para diligenciamiento de Servicios Web]]| |22/03/2022|1.0|Vigente|Documento|[[ada:howto:sicoferp:factory:integrations:deployspringboot|Despliegue Springboot]]| |22/03/2022|1.0|Vigente|Documento|[[ada:howto:sicoferp:factory:integrations:docjavadoc|Consultar Javadoc]]| |22/03/2022|1.0|Vigente|Documento|[[ada:howto:sicoferp:factory:integrations:docswagger|Consultar Swagger]]| ===== Listado de Servicios Web ===== ^Nombre Servicio((Nombre del servicio web)) ^Descripción((Descripción general de la funcionalidad del servicio web.)) ^Versión((Última versión liberada.)) ^Fecha Release((Última fecha de liberación de versión.)) ^Tecnología((Tecnología en la cuál se implementó el servicio web.)) ^Estado((Estado del servicio web (Activo, Inactivo)) ^ |[[ada:howto:sicoferp:factory:integrations:cargadearchivos|WsCargarArchivos]]|Funcionalidad de carga de información de los ticket del otrs para la gestion de los mismos mediante una aplicacion de gerencia para realizar estadisticas y analisis internos.|11.0.1.0|01/07/2021|SpringBoot 4.4|Activo | |[[ada:howto:sicoferp:factory:integrations:clientecsj|WsEfinominaCsj]]|Funcionalidad que consume los metodos expuestos por el web service del cliente Efinomina.|11.0.1.0|01/07/2021|SpringBoot 4.4|Activo | |[[ada:howto:sicoferp:factory:integrations:pagoautomatico|WsPagoAutomatico]]|Funcionalidad que genera el pago automático de la Nomina y Seguridad Social, llenando las tablas actuales de nomina.|11.0.1.0|01/07/2021|SpringBoot 4.4|Activo | |[[ada:howto:sicoferp:factory:integrations:logs|WsLogs]]|Funcionalidad de este servicio es exponer microservicios para llevar registro de logs (transacción, error, sesión, carga de archivo).|11.0.1.0|28/07/2021|SpringBoot 4.4|Activo | |[[ada:howto:sicoferp:factory:integrations:logs|WebServiceRecaudoIFX]]|Servicio web de bancos para recaudo en línea del cliente Bello.|1.0|-|SOAP|Activo | |[[ada:howto:sicoferp:factory:integrations:portal.contribuyente:ws|WsPortal]]|Servicios del portal del contribuyente.|-|-|RESTFull|Activo | |[[ada:howto:sicoferp:factory:integrations:sicofmobile|SicofMobileServiceADA]]|Servicios backend utilizados por la app de SICOF ERP.|11.0.1.0|21/10/2021|SpringBoot 2.5.5|Activo | |[[ada:howto:sicoferp:factory:integrations:sicofws|SicofWS]]|Servicios Web backend para la creación/actualización de terceros, creación facturas y recaudos|8.0.1.0|19/11/2021|SpringBoot 1.5.2|Activo | |[[ada:howto:sicoferp:factory:integrations:msconfigapps|MicroservicioConfigApp]]|Servicio que gestiona configuraciones y parámetros centralizados para aplicaciones.|11.6.0.1|25/02/2022|SpringBoot 2.6.3|Activo | |[[ada:howto:sicoferp:factory:integrations:msadaemailservice|AdaEmailService]]|Servicio genérico de envío de correos.|11.6.0.1|18/03/2022|SpringBoot 2.6.4|Activo | |[[ada:howto:sicoferp:factory:integrations:msbloquearusuariosinactivos|MicroservicioBloquearUsuariosInactivos]]|Servicio que gestiona el bloqueo de usuarios que no ingresan a SICOFERP por un determinado tiempo|11.0.0.1|27/01/2022|SpringBoot 2.6.3|Activo | |[[ada:howto:sicoferp:factory:integrations:msadadeploymentservice|AdaDeploymentService]]|Servicio que realiza despliegues de aplicaciones Appeon/Powerbuilder|11.0.0.1|04/04/2022|SpringBoot 2.6.4|Activo | |[[ada:howto:sicoferp:factory:integrations:mssicofdownloaddocumentdb|SicofDownloadDocumentoDB]]|Servicio que Extrae archivos de documentos generados en los procesos de la DIAN (Factura Electrónica y Documento Soporte)|1.0.0|01/06/2023|SpringBoot 2.7.6|Activo | |[[ada:howto:sicoferp:factory:ecosystem-ws|Ecosistema de Servicios Web]]|Nuevos componentes|0.0.1|01/11/2023|SpringBoot 3.1.5|Activo | ===== Testando Servicio con Postman (Web) ===== Ingrese a la url: https://identity.getpostman.com/login y digite las credenciales de acceso. {{ :ada:howto:sicoferp:factory:integrations:postman001.png?600 |}} Tambien puede ingresar con una cuenta google: {{ :ada:howto:sicoferp:factory:integrations:postman002.png?600 |}} Sera dirigido al dashboard de la cuenta {{ :ada:howto:sicoferp:factory:integrations:postman003.png?600 |}} Antes de empezar a probar servicios debe crear un workspace asociado a la cuenta de ingreso {{ :ada:howto:sicoferp:factory:integrations:postman004.png?600 |}} Posteriormente debe crear las colecciones que desee y adicionar las request de las operaciones que desea probar. ===== Notas de Despliegue ===== ==== Compilar war ==== Para compilar un war ejecute el siguiente código en entorno maven (Ejemplo Eclipse, Springtools) clean install -DskipTests ==== Compilar jar ==== Para compilar un jar ejecute el siguiente código en entorno maven (Ejemplo Eclipse, Springtools) clean package -DskipTests ==== Desplegar war en Jboos/WildFly (Modo Directo) ==== * Acceder al servidor por winscp * Ubicarse en el directorio deployments * Si existe un despliegue previo (borrar el arcgivo war) * Luego borrar el archivo de despliegue el cual es el mismo nombre del war con la extensión undeployed * Copiar el nuevo war * Por último revisar el log del servidor para ver si generó algún error y/o conocer el contexto de despliegue ==== Desplegar jar en Window ==== java -jar archivo.jar ==== Desplegar jar en Linux (en segundo plano) ==== nohup java -jar archivo.jar & ==== Utilerias Linux ==== Buscar jar desplegado: ps aux | grep java Matar Proceso: sudo kill PID [[ada:howto:sicoferp:factory|←Volver atras]] [[ada:howto:sicoferp:factory:goodsoftwaredevelopmentpractices|-> Ir a Buenas prácticas de desarrollo de software]]