Instructivo para integración NO CODE - Configuración

Configuración NO-CODE

Introducción

Objetivo de la integración por archivo - mantener una sincronización entre las bases de datos del Cliente con TECNOM.

Comenzamos a trabajar: 

Para ordenar un poco como sería la integración por archivo podríamos decir que está compuesta de 3 partes:

Parte 1 - Sincronización de los archivos del cliente, desde un dispositivo local o servidor, con la nube del Drive (cuenta Google del cliente). 

Parte 2 - Aplicar lógica en ese Drive, mediante un script de Google hecho por TECNOM, para que los archivos que se suben al Drive se procesen y se reflejen en un Spreadsheet único. 

En este tipo de integración ese Spreadsheet único se comporta como BBDD, donde cada hoja es análoga a una tabla/vista que guarda la información de cada entidad/recurso. 

Parte 3 - Lio (aplicación interna de TECNOM) se encarga de realizar el procesamiento de los datos y mantener esa sincronización entre el Spreadsheet y la base del CRM en TECNOM.

Cómo sincronizar localmente los archivos con la nube 

1- Bajar la aplicación de Google Drive Desktop

El Cliente sincroniza sus archivos locales con el Drive. Para esto el cliente deberá bajarse la aplicación de Google Drive Desktop en la máquina o en el servidor, para el sistema operativo que corresponda. Deberá seguir la guía del instalador.
Una vez instalado la aplicación pedirá que se logueen en su cuenta de google.

2- Configuración de las carpetas locales de la maquina del cliente que se tienen que reflejar en el Drive 

Primero debemos ir al Drive. Luego a la carpeta Ordenadores. Allí aparecerá el nombre de la máquina del cliente (en el ej. se llama Mi Portatil) como ven por ahora no hay nada sincronizado.

Lo que haremos ahora es añadir una carpeta a sincronizar con el diver.
Para ello, teniendo la aplicación de Google Drive Desktop abierta -> Presionar en el botón <Añadir carpeta> (parados en la solapa de nuestro ordenador, como dice el ej. “Mi Portatil”) como lo indica la imagen que se encuentra a continuación.

Nos posicionamos y seleccionamos la carpeta de nuestro ordenador que queremos sincronizar con Drive (en nuestro Ej Sync TECNOM). Luego presionaremos el botón <Seleccionar Carpeta> 

Nos aparecerá la imagen que se muestra a continuación: validar que esté seleccionada la opción Sincronizar con Google Drive. Luego presionar el botón <Hecho>

Seguidamente, como aparece en la imagen que se muestra, la carpeta local ha sido correctamente añadida para ser sincronizada. Para finalizar presionamos el botón <Guardar>

Como se muestra en la imagen siguiente ya se encuentra la carpeta local seleccionada (en nuestro ejemplo “Sync Tecnom”) sincronizada con el Drive.

Entidades que se podran integrar: 

Importante - Cada entidad debe tener un ID único e Irrepetible

• Usuarios / Vendedores
  
• Sucursales / Talleres / Ubicaciones-Depósitos
• Clientes
  
• Ventas
  
  Este recurso depende obligatoriamente de los clientes (es decir que se deben sincronizar clientes previamente para poder sincronizar ventas); y opcionalmente de los vendedores y las sucursales.
  
  
• Unidades - Este recurso, opcionalmente, puede vincularse con ventas, clientes y sucursales.
• Servicios - Este recurso depende obligatoriamente de los clientes, de las unidades y de los talleres; opcionalmente de los usuarios/vendedores (conocidos, para este caso, como asesores de taller).

Dentro de la carpeta principal que se creó para sincronizar los archivos se deberán crear 3 sub-carpetas con los siguiente nombres: Inbox, Invalid y Processed.
Estas sub-carpetas se crearán en nuestro dispositivo local, dentro de la carpeta sincronizada, y al pasar un momento aparecerán automáticamente también sincronizadas en el Drive. 

La única sub-carpeta con la que el cliente interactuará será con la de Inbox. Allí es donde deberá ir dejando los archivos de cada entidad.
Por su parte, será el script de TECNOM el que detectará la presencia de esos archivos en la carpeta Inbox en el Drive y al procesarlos los moverá entre las carpetas Invalid y Processed según corresponda.

En las siguientes imágenes se ejemplifica la subida de un archivo de clientes.
El archivo, de extensión “.csv”, se dejá en la carpeta LOCAL de Inbox y al pasar un momento lo veremos reflejado en la carpeta de Inbox del Drive. 

Importante - El Cliente debe respetar lo que se detalla a continuación como un contrato 

• La carpeta externa se puede llamar como quiera el Cliente (Ej - Sync TECNOM)
• Las carpetas Interna (Inbox, Processed, Invalid), debe respetar los nombres que se ven en la imagen ya que las mismas marcan el estado del archivo. Todos los archivos que el cliente quiera subir deben ingresar a la carpeta Inbox y el cliente no deberá hacer más nada. 

Las carpetas Invalid y Processed son carpetas que se usan en la integración de forma interna, el cliente no debe hacer nada, el sincronizador moverá el archivo a la carpeta Invalid en caso que haya salido mal o a Processed en caso que la integración haya salido bien.

• Los archivos que dejará el cliente en la carpeta a Sincronizar deberán ser de extensión .CSV por ahora.
• El nombre de los archivos debe ser exactamente igual a lo que TECNOM defina
• Se deberá subir un archivo por entidad o recurso (Ver Entidades)

Por último el archivo que se suba debe ser histórico debe contener el 100% de los datos siempre (por ahora NO SE PUEDEN subir solo NOVEDADES)