Importaciones Automáticas

Revisión 1.6 – 31/01/2022

Introducción.

Mediante las opciones de importaciones automáticas podremos colocar unos ficheros en un directorio concreto del ordenador que tenga en marcha el servicio de importación y dicho servicio los detectará y los importará automáticamente a XgestEvo.

Directorios de importación.

Directorio desde donde se importarán los datos:

C:\AplicacionesXgest\Importaciones

Este directorio contendrá dos directorios, uno llamado Procesado y otro llamado Errores, donde se almacenarán los ficheros que se procesen, dependiendo del resultado.

En el directorio Importaciones se reciben los ficheros a importar con un nombre estricto ya definido (imp_art_001.csv, imp_fam_003.csv, etc.), cuyo nombre al final tendrá los tres dígitos de la empresa a la que se van a incorporar. En la definición de los campos disponibles para cada fichero siempre se indicará la empresa 001 como ejemplo, pero cuando se generen los ficheros hay que tener en cuenta que si la empresa es otra habrá que cambiar ese 001 por el número de la empresa (002, 003, etc.).

Para dar el servicio de importaciones, se usa el mismo servidor que para Movilidad, debiendo ponerlo en marcha en el ordenador donde vayamos a poner los ficheros a procesar.

De cada tabla se indican los campos disponibles para importar. No es necesario enviarlos todos. El código principal de cada tabla (normalmente el primer campo) es OBLIGATORIO, ya que es por el que localiza cada registro y sabe si puede importarlo o no. Como mínimo usaremos el código principal y al menos uno de los otros campos.

Si necesita algún campo no especificado, puede ser solicitado por e-mail y si está disponible su importación se lo indicaremos para su uso.

Uso de la aplicación.

Desde la opción Gestión / SAT/RMA/Trabajos / Importaciones Automáticas abrimos el formulario de gestión de esta utilidad:

Arrancar Servidor de Movilidad y de Importaciones Automáticas.

Desde aquí podemos arrancar el servidor de movilidad, que ahora da también servicio a las importaciones automáticas si están activadas. Cada pocos segundos revisará el directorio de importaciones y si encuentra algún fichero de importación lo procesa, guarda un registro en el LOG con el resultado y lo mueve a la carpeta de ficheros procesados o de errores. Cada vez que procesa uno espera unos segundos y procesa el siguiente, así hasta procesarlos todos.

Importar UN FICHERO del directorio de importaciones.

También podemos importar directamente un fichero directamente pulsando esta opción si no deseamos usar el servidor de movilidad, porque vamos a incorporar algún fichero de forma puntual. Si hay varios, importará uno cada vez que pulsemos. Una vez procesado abrirá automáticamente el formulario de revisar LOGs para ver el resultado.

Revisar LOG de Registro de Resultados de Importaciones Automáticas.

En este formulario podemos revisar los resultados de los ficheros que hemos enviado a importar. Podemos filtrar para ver todos, solo los correctos o solo los que han tenido errores. Muestra los últimos primero para mayor agilidad.

A la derecha de la rejilla muestra el detalle de cada fichero procesado (empresa, fecha y hora de proceso, si ha sido correcto o no, el resultado y el nombre de archivo original y la ruta donde lo ha guardado). Si pulsamos el botón Abrir disponible junto a la ruta del archivo procesado, abrirá dicho archivo para poder revisarlo (solo en lectura) si aún está disponible en el disco (podemos haberlo borrado o haberlo procesado en otro ordenador, en cuyo caso nos avisará de que no está disponible).

Descripción de la estructura de los archivos para importar tipo CSV.

Los ficheros para importar serán en formato .CSV, conteniendo en la primera línea los nombres de los campos y en las siguientes líneas el contenido de los mismos separados por coma ó punto y coma.

Es obligatorio que incluya el campo ó campos principales, para poder identificar los registros, más los campos que deseemos importar. No es necesario incluirlos todos, solo los que necesitemos, es decir, por ejemplo, si queremos importar los precios base de la tabla de artículos, solo tendremos que importar los campos ACODAR y APREBASE a la empresa 003, crearíamos el fichero imp_art_003 y un ejemplo del contenido sería:

acodar,adescr,aprebase

“1”,“FAROLA LED 25 W CON PROTECCIONES DESMONTABLES (ORIGINAL)“,90.00

“10”,“ARTICULO 10”,0.00

“1000”,“articulo 1000 bloqueado”,0.00

“10001”,“portes sp”,0.00

“2”,“LAMPARA MESA VERDE VINTAGE MODELO CONGRESS”,26.25

“3”,“TOMATE TRITURADO LA CAMPESINA 300 GR.”,0.89

“4”,“QUESO MIRALMAR SEMICURADO CUÑA 250 G.”,3.25

“5”,“TELEVISOR SAMSUNG 40 PULGADAS UHD 4K MOD. SAM5265LL”,523.20

A continuación tenemos otro ejemplo de la tabla de tarifas de proveedor/artículo, que incluye campos numéricos enteros y con decimales, campos texto y fechas. El fichero de ejemplo se llamaría imp_dpr_001.csv y un ejemplo de su contenido sería:

gscodpro,gscodar,gspcompra,gsprcdto,gscompmin,gsfecha,gstock

60003,“02017”,9.22,0.00,1.00,25/07/2017,1.00

60003,“02024”,35.59,0.00,1.00,20/03/2018,1.00

60003,“02081”,46.75,0.00,1.00,25/07/2017,1.00

60003,“02108-84”,70.00,0.00,1.00,25/08/2017,1.00

60005,“000260”,10.50,0.00,1.00,18/09/2018,1.00

60005,“001946”,1.00,0.00,1.00,09/07/2018,1.00

60005,“002803”,66.00,0.00,1.00,11/10/2017,1.00

Como Podemos ver, los enteros van como números sin comillas, los decimales se separan con el punto (.), las fechas van sin comillas con formato dd/mm/aaaa y los campos tipo texto van entre comillas, todo ello separado por comas ó punto y coma.