Fábrica - Servicios Web - Integraciones - Carga de Archivos

Este servicio tiene la funcionalidad de cargar información de los ticket del 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	SVN branches	SVN trunk	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: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¹⁾.

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²⁾. 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³⁾ 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.

←Volver atrás

¹⁾

Se asume que el lector tiene conocimeintos previos del uso del lenguaje Java e IDE utilizado

²⁾

Este es el proceso actual ejecutandose y cambiará siempre que reinicie el servidor o actualice el despliegue

³⁾

Se recomienda utilizar SSH

Wiki

Herramientas de usuario

Herramientas del sitio

Tabla de Contenidos