Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:integrations:sicofmobile [2021/10/21 19:16] administraidor creado |
ada:howto:sicoferp:factory:integrations:sicofmobile [2022/09/01 22:00] (actual) 181.143.29.58 |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | ====== Fábrica - Servicios Web - Integraciones - Carga de Archivos ====== | + | ====== Fábrica - Servicios Web - Integraciones - SicofMobileServiceADA ====== |
- | Este servicio tiene la funcionalidad de cargar información de los ticket del [[https://otrs.adacsc.co/otrs/index.pl|Otrs]] para la gestión de los mismos mediante una aplicación de gerencia para realizar estadísticas y análisis internos. | + | Este servicio provee las siguientes funcionalidades de SICOF ERP. |
+ | |||
+ | * Consultar Tareas Pendientes | ||
+ | * Aprobar/Rechazar Compromisos | ||
+ | * Aprobar/Rechazar Disponibilidades | ||
+ | * Aprobar/Rechazar Ordenes de Pago | ||
+ | * Aprobar/Rechazar Anticipos | ||
+ | * Gestión de Comprobantes de Egreso | ||
+ | * Descargar Colillas de Pago | ||
+ | * Descargar Certificado Laboral | ||
+ | * Consulta de Bienes | ||
===== Descripción del Servicio ===== | ===== Descripción del Servicio ===== | ||
^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^ | ^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^ | ||
- | |CargarArchivo|Funcionalidad de carga de informacion de los ticket del otrs para la gestion de los mismos mediante una aplicacion de gerencia para realizar estadisticas y analisis internos.|Rest|SpringBoot 4.4|Java 11.0.315|Nuevo|11.0.1.0|application.properties| | + | |SicofMobileServiceADA|Servicio que provee las funcionalidades soportadas en la app mobile de Sicof ERP.|Rest|SpringBoot 2.5.5|Java 11.0.315|Migrado de JSP|11.0.1.0|application.properties| |
^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^ | ^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^ | ||
- | |jar|Maven 3.8.1|Tomcat 6|Eclipse 2021-03|Subversión|[[http://adacsc.co:1443/svn/repository/ADA/WEB_SERVICES/INTEGRACIONES/Otrs/CargaDeArchivos/Fuentes/branches/branches 11.0.1.0|SVN branches]]|[[http://adacsc.co:1443/svn/repository/ADA/WEB_SERVICES/INTEGRACIONES/Otrs/CargaDeArchivos/Fuentes/trunk/trunk 11.0.1.0|SVN trunk]]|[[http://adacsc.co:1443/svn/repository/ADA/WEB_SERVICES/INTEGRACIONES/Otrs/CargaDeArchivos/Fuentes/tags/tags 11.0.1.0|SVN tags]]| | + | |war|Maven 3.8.1|Tomcat 6|SpringTools 4.6|Subversión|[[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/integracion/SicofMobileServiceADA |
+ | |SVN branches]]|[[|SVN trunk]]|[[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/tags/development/integracion/SicofMobileServiceADA | ||
+ | |SVN tags]]| | ||
^Dependencias^^^^^^^^ | ^Dependencias^^^^^^^^ | ||
^groupId^artifactId^^version^scope^optional^Descripción^^ | ^groupId^artifactId^^version^scope^optional^Descripción^^ | ||
+ | |org.springframework.boot|spring-boot-starter-actuator||N/A|N/A|N/A|API de actualización del servicio|| | ||
|org.springframework.boot|spring-boot-starter-data-jpa||N/A|N/A|N/A|API de persistencia|| | |org.springframework.boot|spring-boot-starter-data-jpa||N/A|N/A|N/A|API de persistencia|| | ||
- | |org.springframework.boot|spring-boot-starter-thymeleaf||N/A|N/A|N/A|Motor de plantillas|| | + | |org.springframework.boot|spring-boot-starter-data-rest||N/A|N/A|N/A|API de mapeo de rutas|| |
- | |org.springframework.boot|spring-boot-starter-validation||N/A|N/A|N/A|Validador de información|| | + | |
|org.springframework.boot|spring-boot-starter-web||N/A|N/A|N/A|Core Servicios Web|| | |org.springframework.boot|spring-boot-starter-web||N/A|N/A|N/A|Core Servicios Web|| | ||
|org.springframework.boot|spring-boot-devtools||N/A|runtime|true|Recarga de aplicaciones|| | |org.springframework.boot|spring-boot-devtools||N/A|runtime|true|Recarga de aplicaciones|| | ||
- | |mysql|mysql-connector-java||N/A|runtime|N/A|Driver DB MySQL|| | ||
|org.projectlombok|lombok||N/A|N/A|true|API de anotaciones para reducción de código|| | |org.projectlombok|lombok||N/A|N/A|true|API de anotaciones para reducción de código|| | ||
|org.springframework.boot|spring-boot-starter-test||N/A|test|N/A|Core Springboot|| | |org.springframework.boot|spring-boot-starter-test||N/A|test|N/A|Core Springboot|| | ||
- | |org.apache.poi|poi||3.15|N/A|N/A|API de lectura de archivos Excel|| | ||
- | |org.apache.poi|poi-ooxml||3.15|N/A|N/A|API de lectura de archivos Excel XML|| | ||
|org.springframework.boot|spring-boot-starter-data-jdbc||N/A|N/A|N/A|API JDBC para conexión a Base de Datos|| | |org.springframework.boot|spring-boot-starter-data-jdbc||N/A|N/A|N/A|API JDBC para conexión a Base de Datos|| | ||
- | |com.microsoft.sqlserver|mssql-jdbc||N/A|runtime|N/A|Driver DB SQL Server|| | ||
|org.apache.tomcat.embed|tomcat-embed-jasper||N/A|provided|N/A|Servidor embebido tomcat|| | |org.apache.tomcat.embed|tomcat-embed-jasper||N/A|provided|N/A|Servidor embebido tomcat|| | ||
|org.springframework.boot|spring-boot-starter-tomcat||N/A|provided|N/A|Core Spring|| | |org.springframework.boot|spring-boot-starter-tomcat||N/A|provided|N/A|Core Spring|| | ||
Línea 29: | Línea 37: | ||
^Operaciones^^^^^^^^ | ^Operaciones^^^^^^^^ | ||
^Tipo Petición Http^Nombre operación^^Descripción^^^Documentación^^ | ^Tipo Petición Http^Nombre operación^^Descripción^^^Documentación^^ | ||
- | |POST|cargarArchivo||Se encarga de procesar e insertar la información de un archivo excel en la tabla dbo.Tbl_Carga_Archivo||| documentación del Formulario del servicio y la Plantilla de Carga de Información se debe utilizar la siguiente sección:[[ada:howto:sicoferp:factory:integrations:templateservice|Formulario]].|| | + | |Get|GetServicio||Método orquestador que procesa las peticiones de las funcionalidades soportadas.|||La documentación del consumo se debe consultar.|| |
^Ambientes de Despliegue^^^^^^^^ | ^Ambientes de Despliegue^^^^^^^^ | ||
^Tipo^Url^^Observaciones^^^^^ | ^Tipo^Url^^Observaciones^^^^^ | ||
- | |Desarrollo:|http://10.1.140.1:2690||Ambiente de desarrollo||||| | + | |Desarrollo:|http://10.1.20.84:3131/SicofMobileServiceADA/api/||Ambiente de desarrollo||||| |
|Calidad:| ||Ambiente de validación||||| | |Calidad:| ||Ambiente de validación||||| | ||
|Producción:| ||Ambiente de producción||||| | |Producción:| ||Ambiente de producción||||| | ||
Línea 39: | Línea 47: | ||
===== Información Adicional ===== | ===== Información Adicional ===== | ||
- | ===== Accesos ===== | + | ===== Repositorio DB ===== |
+ | |||
+ | ^Tipo^Ruta^Versión^ | ||
+ | |Base|[[http://adacsc.co:1443/svn/repository/ADA/SICOF_MOBILE_WEB/ScriptsDB|SVN]]|Versión 3.4.0| | ||
+ | |Documentación|[[http://adacsc.co:1443/svn/repository/ADA/SICOF_MOBILE_WEB/ScriptsDB/Model|Doc Model]]|Versión 3.4.0| | ||
+ | |||
+ | ===== Despliegue ===== | ||
+ | |||
+ | ==== Requisitos Técnicos Servidor ==== | ||
+ | |||
+ | * Servidor Wildlfy 20 o superior | ||
+ | * Java 11 o OpenJDK 11 | ||
+ | * S.O. Linux | ||
+ | * Ram 4GB o superior | ||
+ | * Disco Duro 64 GB | ||
+ | * Publicar la URL y Puerto del WildFly | ||
+ | |||
+ | ==== Pasos Previos: Generar war (IDE Eclipse y Spring Tools) ==== | ||
+ | El proyecto está configurado para generar compilable war. Siga los siguientes pasos para generarlo((Se asume que el lector tiene conocimeintos previos del uso del lenguaje Java e IDE utilizado)). | ||
+ | |||
+ | * Ubiquese en la reaíz del proyecto, click derecho -> Run as... -> Maven builds... | ||
+ | * En la casilla **Goals** ingrese el comando: **clean install** para generar el war. Tambien puede utilizar en su lugar la insttrucción **clean install -DskipTests** si no desea ejecutar las pruebas unitarias. | ||
+ | * Al finalizar el proceso si no hay errores se generará el war en el directorio target del proyecto. | ||
+ | |||
+ | === Notas === | ||
+ | * Para ubicar el war en el directorio del equipo desde el proyecto seleccione el war con click derecho y vaya a propiedades al visualizar la ventana emergente se verá la ubicación del archivo. | ||
+ | * El servicio se genera con el nombre SicofMobileServiceADA-0.0.1-SNAPSHOT.war, se debe editar el nombre eliminando el siguiente texto: -0.0.1-SNAPSHOT quedando el nombre simplificado SicofMobileServiceADA.war esto con el fin de generar un path del servicio más simple. | ||
+ | |||
+ | ==== Despliegue en el servidor ==== | ||
+ | Actualmente solo hay servidor de desarrollo: | ||
+ | |||
+ | - Acceder al servidor de despliegue por WSCP o SSH: IP: **10.1.20.84**, Usuario:**wildfly23**, Password:**vwdf5ELGR5j7v** | ||
+ | - Borre el archivo SicofMobileServiceADA.war y espere que el archivo de despliegue quede inválido. | ||
+ | - Borre el archivo de despliegue SicofMobileServiceADA.war.undeploy | ||
+ | - Copie el nuevo war en la ruta **/opt/wildfly23/standalone/deployments** se recomienda utilizar WSCP por su interfaz gráfica. Debe esperar mientras se sube el despliegue al servidor el cual terminará correctamente si se crea el archivo SicofMobileServiceADA.war.deployed Si falla este proceso debe ir al paso 2. | ||
+ | - Por último desde un navegador ingrese la url **http://10.1.20.84:3131/SicofMobileServiceADA/api/** y debera visualizar el mensaje **Online!!!** indicando que el despliegue fué realizado correctamente. | ||
+ | |||
+ | === Producción === | ||
+ | Se deben seguir los mismos pasos del ambiente de desarrollo para desplegar en produccion cambiando el acceso al servidor http://10.1.20.84:3131 por el que se utilice. Ademas tener presente que se deben actualizar los path en las configuraciones de los clientes. | ||
+ | |||
+ | === Notas === | ||
+ | |||
+ | * Debe contar con VPN | ||
+ | * Ejemplo de Consumo Login Multiempresa: http://10.1.20.84:3131/SicofMobileServiceADA/api/GetServicio?ping=desarrollo&nombreServicio=Login&callback=__ng_jsonp__.__req0.finished&separador=,¶metros=SICOF,1234,null,null,null&codigoMEmpresa=9999999999 | ||
+ | * Ejemplo de consumo Empresas: http://10.1.20.84:3131/SicofMobileServiceADA/api/GetServicio?ping=fosemed&nombreServicio=GetEmpresas&callback=__ng_jsonp__.__req0.finished&separador=,¶metros= | ||
+ | |||
+ | |||
+ | |||
+ | === Documentos despliegues Android e IOS === | ||
+ | |||
+ | {{ :ada:howto:sicoferp:factory:integrations:documento_de_ayuda_de_despliegues_sicof_app.docx |}} | ||
+ | |||
+ | {{ :ada:howto:sicoferp:factory:integrations:despliegue_apps_-_android.docx |}} | ||
+ | |||
+ | {{ :ada:howto:sicoferp:factory:integrations:despliegue_apps_-_ios.docx |}} | ||
- | ^Descripción^Tipo Acceso^IP^Usuario^Contraseña^Notas/Observaciones^ | ||
- | |Maquina utiliza para acceder al ambiente de Datos|Escritorio Remoto|10.1.20.86|Administrator|4rc4ng3l*|Usuario de Acceso Integrado con PBI: Indicadores - Contraseña: 4rc4ng8l| | ||
[[ada:howto:sicoferp:factory:integrations|←Volver atrás]] | [[ada:howto:sicoferp:factory:integrations|←Volver atrás]] | ||