Herramientas de usuario

Herramientas del sitio


ada:howto:sicoferp:factory:integrations:cargadearchivos

Diferencias

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

Enlace a la vista de comparación

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
ada:howto:sicoferp:factory:integrations:cargadearchivos [2021/06/18 18:49]
192.168.177.29
ada:howto:sicoferp:factory:integrations:cargadearchivos [2021/10/22 12:08] (actual)
administraidor
Línea 2: Línea 2:
 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 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.
  
-^Nombre^Descripción^Tipo^Tecnología^Lenguaje^^^^^^^^^^^^^^^ +===== 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|||||
  
  
-Desarrollo del microservicio. ​+===== Información Adicional =====
  
-1.- se crea la tabla de nombre dbo.Tbl_Carga_Archivo en el servidor: +===== Accesos =====
-  * Nombre de la Instancia:​BI escritorio remoto +
-  * Ip Escritorio Remoto: 10.1.20.86 +
-  * Usuario:​Administrator +
-  * Contraseña:​ 4rc4ng3l*+
  
-Usuario de Acceso Integrado con PBI +^Descripción^Tipo Acceso^IP^Usuario^Contraseña^Notas/​Observaciones^ 
- Usuario: Indicadores +|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|
- Clave: 4rc4ng8l+
  
-2.- Se creo el Web Service mediante:  +===== Despliegue =====
-  * Spring Boot 11 +
-  * dependencias Maven +
-  * se agrega la librería POI, para poder leer la información del archivo excel,  +
-  * la dependencia thymeleaf para generar el formulario  +
-  * la dependencia para el motor SQL+
  
-3.-  ​Se crea la entidad relaciona con la tabla: " **dbo.Tbl_Carga_Archivo** "+==== Pasos Previos: Generar jar (IDE Eclipse y Spring Tools) ==== 
 +El proyecto está configurado para generar compilable jarSiga los siguientes pasos para generarlo((Se asume que el lector tiene conocimeintos previos del uso del lenguaje Java e IDE utilizado)).
  
-4.- Método POST: se leen las columnas del archivo excel se setean a las variables que se +  * Ubiquese en la reaíz del proyecto, click derecho -> Run as... -> Maven builds..
- envían al insert directamente de la tabla  ​ +  ​* 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. 
-    ​Método READ:  ​para ​realizar ​la consulta de la información insertada.+  * Al finalizar el proceso si no hay errores se generará el jar en el directorio target del proyecto.
  
-5.- Se crea la plantilla ​del formulario en thymeleaf spring boot+=== 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.
  
-6.- Se despliga ​el servicio en la direccion: http://​10.1.140.1:​2690/​cargarArchivo +==== Despliegue en el servidor ==== 
- Ambiente: DESARROLLO +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:
- IP:​10.1.140.1  +
- Puerto:​2690 (puerto fijo de la aplicación, ​en el archivo application.properties) +
- contenedortomcat06 +
  
-7.El servicio tiene 2 metodos: +  ​Acceder al servidor de despliegue por WSCP o SSHIP**10.1.140.1**, Usuario:**tomcat07**,​ Password:**mUp5NbwvfU** 
-   * http://10.1.140.1:2690/​consultar ​este metodo consulta ​la informacion insertada ​contenida ​en la tabla en formato Json(opcional no se utilizara)+  - 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 ​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.
  
-   * http://​10.1.140.1:​2690/​cargarArchivo/​ : este metodo es el que se encarga de procesar e inserta la información en la tabla+=== Notas ===
  
-8.- Ruta de la Documentación Swagger: http://​localhost:​2690/​swagger-ui.html#/​carga-archivo-controller/​readOperationCrudUsingGET+  * 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]]
- +
-[[ada:​howto:​sicoferp:​factory:​integrations|←Volver ​atras]]+
  
ada/howto/sicoferp/factory/integrations/cargadearchivos.1624042194.txt.gz · Última modificación: 2021/06/18 18:49 por 192.168.177.29