Herramientas de usuario
ada:howto:sicoferp:factory:integrations:cargadearchivos
Diferencias
Muestra las diferencias entre dos versiones de la página.
| Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
|
ada:howto:sicoferp:factory:integrations:cargadearchivos [2021/06/18 20:03] 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 Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^ | + | ===== Descripción del Servicio ===== |
| - | |CargaArchivo|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| | + | |
| + | ^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^ | ^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]]| | |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]]| | ||
| Línea 22: | Línea 24: | ||
| |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|| | ||
| - | </dependency> | + | |org.apache.maven.plugins|maven-compiler-plugin||3.8.1|N/A|N/A|Gestor de dependnecias|| |
| - | <!-- https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-compiler-plugin --> | + | |io.springfox|springfox-swagger2||2.9.2|N/A|N/A|Core Documentación Web Services RESTful|| |
| - | <dependency> | + | |io.springfox|springfox-swagger-ui||2.9.2|N/A|N/A|GUI Documentación Web Services RESTful|| |
| - | <groupId>org.apache.maven.plugins</groupId> | + | ^Operaciones^^^^^^^^ |
| - | <artifactId>maven-compiler-plugin</artifactId> | + | ^Tipo Petición Http^Nombre operación^^Descripción^^^Documentación^^ |
| - | <version>3.8.1</version> | + | |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]].|| |
| - | </dependency> | + | ^Ambientes de Despliegue^^^^^^^^ |
| - | + | ^Tipo^Url^^Observaciones^^^^^ | |
| - | <dependency> | + | |Desarrollo:|http://10.1.140.1:2691||Ambiente de desarrollo||||| |
| - | <groupId>io.springfox</groupId> | + | |Calidad:|http://10.1.140.1:2691||Ambiente de validación||||| |
| - | <artifactId>springfox-swagger2</artifactId> | + | |Producción:|http://10.1.140.1:2691||Ambiente de producción||||| |
| - | <version>2.9.2</version> | + | |
| - | </dependency> | + | |
| - | <dependency> | + | |
| - | <groupId>io.springfox</groupId> | + | |
| - | <artifactId>springfox-swagger-ui</artifactId> | + | |
| - | <version>2.9.2</version> | + | |
| - | </dependency> | + | |
| - | + | ||
| - | </dependencies></code>| | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | Desarrollo del microservicio. | + | |
| - | 1.- se crea la tabla de nombre dbo.Tbl_Carga_Archivo en el servidor: | ||
| - | * 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 | + | ===== Información Adicional ===== |
| - | Usuario: Indicadores | + | |
| - | Clave: 4rc4ng8l | + | |
| - | 2.- Se creo el Web Service mediante: | + | ===== Accesos ===== |
| - | * 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** " | + | ^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| | ||
| - | 4.- Método POST: se leen las columnas del archivo excel se setean a las variables que se | + | ===== Despliegue ===== |
| - | envían al insert directamente de la tabla. | + | |
| - | Método READ: para realizar la consulta de la información insertada. | + | |
| - | 5.- Se crea la plantilla del formulario en thymeleaf spring boot | + | ==== 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)). | ||
| - | 6.- Se despliga el servicio en la direccion: http://10.1.140.1:2690/cargarArchivo | + | * Ubiquese en la reaíz del proyecto, click derecho -> Run as... -> Maven builds... |
| - | Ambiente: DESARROLLO | + | * 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. |
| - | IP:10.1.140.1 | + | * Al finalizar el proceso si no hay errores se generará el jar en el directorio target del proyecto. |
| - | Puerto:2690 (puerto fijo de la aplicación, en el archivo application.properties) | + | |
| - | contenedor: tomcat06 | + | |
| - | 7.- El servicio tiene 2 metodos: | + | === Nota === |
| - | * http://10.1.140.1:2690/consultar : este metodo consulta la informacion insertada o contenida en la tabla en formato Json(opcional no se utilizara) | + | 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. |
| - | * http://10.1.140.1:2690/cargarArchivo/ : este metodo es el que se encarga de procesar e inserta la información en la tabla | + | ==== 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: | ||
| - | 8.- Ruta de la Documentación Swagger: http://localhost:2690/swagger-ui.html#/carga-archivo-controller/readOperationCrudUsingGET | + | - 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 atras]] | + | [[ada:howto:sicoferp:factory:integrations|←Volver atrás]] |
ada/howto/sicoferp/factory/integrations/cargadearchivos.1624046611.txt.gz · Última modificación: 2021/06/18 20:03 por 192.168.177.29
Herramientas de la página
