====== Fábrica - Servicios Web - Integraciones - Carga de Archivos ====== 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. ===== Descripción del Servicio ===== ^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| ^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]]| ^Dependencias^^^^^^^^ ^groupId^artifactId^^version^scope^optional^Descripción^^ |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-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-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.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|| |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.springframework.boot|spring-boot-starter-tomcat||N/A|provided|N/A|Core Spring|| |org.apache.maven.plugins|maven-compiler-plugin||3.8.1|N/A|N/A|Gestor de dependnecias|| |io.springfox|springfox-swagger2||2.9.2|N/A|N/A|Core Documentación Web Services RESTful|| |io.springfox|springfox-swagger-ui||2.9.2|N/A|N/A|GUI Documentación Web Services RESTful|| ^Operaciones^^^^^^^^ ^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]].|| ^Ambientes de Despliegue^^^^^^^^ ^Tipo^Url^^Observaciones^^^^^ |Desarrollo:|http://10.1.140.1:2691||Ambiente de desarrollo||||| |Calidad:|http://10.1.140.1:2691||Ambiente de validación||||| |Producción:|http://10.1.140.1:2691||Ambiente de producción||||| ===== Información Adicional ===== ===== Accesos ===== ^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| ===== Despliegue ===== ==== Pasos Previos: Generar jar (IDE Eclipse y Spring Tools) ==== El proyecto está configurado para generar compilable jar. 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 package** para generar el jar. Tambien puede utilizar en su lugar la insttrucción **clean package -DskipTests** si no desea ejecutar las pruebas unitarias. * Al finalizar el proceso si no hay errores se generará el jar en el directorio target del proyecto. === Nota === Para ubicar el jar en el directorio del equipo desde el proyecto seleccione el jar con click derecho y vaya a propiedades al visualizar la ventana emergente se verá la ubicación del archivo. ==== Despliegue en el servidor ==== Actualmente no hay servidor de desarrollo ni QA por lo tanto el despliegue se realiza directamente en producción. Para generar el despliegue siga los siguientes pasos: - Acceder al servidor de despliegue por WSCP o SSH: IP: **10.1.140.1**, Usuario:**tomcat07**, Password:**mUp5NbwvfU** - Identifique el proceso actual en el cual corre la solución con el siguiente comando: **ps -ef | grep WsCargarArchivo2-0.0.1-SNAPSHOT.jar** donde **WsCargarArchivo2-0.0.1-SNAPSHOT.jar** es el nombre del jar generado a la fecha. Se recomienda utilizar SSH. - Si el despliegue está ejecutandose se devolverá una linea similar a la siguiente: //tomcat07 **14558** 1 0 oct21 ? 00:01:28 java -jar WsCargarArchivo2-0.0.1-SNAPSHOT.jar// De esta linea debe identificar el numero del proceso el cual es el código **14558**((Este es el proceso actual ejecutandose y cambiará siempre que reinicie el servidor o actualice el despliegue)). Se recomienda utilizar SSH. - Mate el proceso con el comando kill -9 **14558** Se recomienda utilizar SSH. - Copie el nuevo jar en la ruta **/opt/tomcat07/integraciones** se recomienda utilizar WSCP por su interfaz gráfica. - Desde la consola((Se recomienda utilizar SSH)) ejecute el comando **nohup java -jar WsCargarArchivo2-0.0.1-SNAPSHOT.jar &** donde el **WsCargarArchivo2-0.0.1-SNAPSHOT.jar** es el nombre del jar previamente generado. - Por último desde un navegador ingrese la url **http://10.1.140.1:2691/cargarArchivo** y debera visualizar un formulario de carga de archivo. Lo cual indica que el despliegue fué realizado correctamente. === Notas === * Debe contar con VPN * El numero del proceso cambiará cada vez que se actualice el despliegue * Si se reinicia el servidor se debe volver a generar el despliegue ya que actualmente el proceso no está como un servicio sino como ejecutable. [[ada:howto:sicoferp:factory:integrations|←Volver atrás]]