Iniciación a SherpaBots

Ahora que ya sabemos qué es y cómo se puede utilizar un Upload, vamos a aprender a hacer uno. 

Para ello necesitaremos saber:

1. Qué es un “moduform”
2. Qué es una tabla hall o vestíbulo
3. Cómo utilizar el moduform “CREAR UPLOAD”
4. Los cuatro pasos básicos para la configuración de un Upload.

 

3.1 Qué es un Moduform

Para empezar, debemos saber qué es este concepto en SherpaBots. Un moduform es un formulario gracias al cual podemos ejecutar un proceso a partir de los campos del mismo. Más adelante, veremos en profundidad cómo configurarlo y cómo generar uno para ejecutar un proceso.

De momento necesitamos saber que al utilizar este concepto nos referimos a un formulario en SherpaBots que ejecuta un proceso.

La mayoría de moduforms los podemos encontrar en las aplicaciones: Configuración SherpaBots o Soporte, pero pueden estar en cualquier aplicación.

Está muy correlacionado con el concepto “Bloque” ya que son éstos los que contienen los moduforms.

Lo mejor, un ejemplo en el que vemos un formulario sencillo en el que se rellenan unos campos para establecer los días de ausencia de los empleados de Modulooper.

En la app Soporte en el bloque CONTROL AUSENCIAS MODULOOPER, al hacer clic en el botón “Subir” desplegamos un moduform que vemos a continuación.

En este ejemplo vemos como se han de rellenar los 4 campos que nos pide de manera obligatoria (marcados con asterisco: *). Como vemos, aquí se están configurando unas vacaciones que se insertarán en una tabla para controlar las ausencias de un/a empleado/a, este proceso tendrá en cuenta los fines de semana y los días festivos para no incluirlos como ausencias.

 

3.2 QUÉ ES UNA TABLA HALL O VESTÍBULO

Otro de los conceptos que tenemos que conocer es el de la tabla hall o vestíbulo. Ésta es una tabla en la base de datos donde llega la información en bruto. Sobre esta tabla pueden hacerse modificaciones de formato y algún formateo, pero nunca será la tabla final donde se guarde la información. Cada Upload tiene su tabla vestíbulo (raras excepciones comparten tabla hall).

Estas tablas se “renuevan” con cada carga por eso los datos no se acumulan, en el caso de cargas donde los datos se van acumulando se hace un INSERT en una tabla final que mantiene la información. En ocasiones, la información se renueva según la singularidad con la que se cargue la información, pero eso ya lo veremos más adelante.

 

3.3 MODUFORM “CREAR UPLOAD”

Ahora vamos a lo que nos atañe que es la configuración de un Upload. En este caso tendremos que usar el moduform CREAR UPLOAD en el bloque del mismo nombre de la aplicación Configuración SherpaBots.

Al hacer clic en el botón subir se nos despliega el moduform de este bloque que nos servirá para configurar nuestro Upload. Para ello es recomendable tener abierto el archivo que vamos a cargar. En el ejemplo usaremos un archivo de Excel.

Moduform del Bloque CREAR UPLOAD

 

A continuación explicaremos campo por campo qué es lo que tenemos que poner.

MasterExcel: aquí cargaremos el archivo tipo que tenemos para configurar. Gracias a él el proceso leerá todas las columnas y las convertirá en campos en la base de datos.

Fila de cabecera: tendremos que indicar en qué fila se encuentra la cabecera para dar nombre a cada uno de los campos que se generarán en la tabla vestíbulo de la base de datos. En este punto tendremos que tener en cuenta que si los nombres de las columnas del archivo tienen caracteres raros: Ñ/á/? (eñes, tildes, interrogantes o similar). Si es así, tendremos que cambiarlos a caracteres normales para que nos generen nombres de campos sin errores en la base de datos.

Hoja: en este campo escribiremos o el nombre de la hoja o el orden en el que se encuentra, siendo la primera posición un 0. Para este punto tendremos que tener claro que la hoja se llamará siempre igual o que estará siempre en la misma posición.

Crear tabla: aquí hace referencia a la creación de la tabla hall o vestíbulo que hemos comentado en el apartado 3.2. Como nuestro ejemplo es un Upload de nueva creación indicaremos que “sí”.

Base de datos: aquí seleccionaremos del desplegable la base de datos donde se creará la tabla hall.

Nombre tabla: indicaremos el nombre que tendrá la tabla vestíbulo.

Nombre Upload: se indicará el nombre que queremos asignar a esta carga. Normalmente coincidirá también con el nombre del Bloque y con el del Modulooper.

Sobreescribir: éste es un campo que marcaremos como si, por las razones que sea, volvemos a realizar la configuración de este Upload.

App: señalaremos la aplicación donde se insertará el bloque que contiene el Upload que estamos creando.

Modulooper: como hemos dicho antes, este campo normalmente coincidirá con el nombre del Upload y del Bloque. Más adelante hablaremos largo y tendido sobre esto.

Bloque: como en el caso anterior normalmente coincidirá con el nombre del Upload y con el Modulooper. Será el nombre del bloque que contiene el Upload.

Separador y Delimitador: serán campos que rellenaremos solamente en las cargas de los archivos de texto.

 

3.4 LOS CUATRO PASOS BÁSICOS PARA CREAR UN UPLOAD

Tras rellenar el moduform CREAR UPLOAD haremos la magia dándole al botón “Subir”. Esperaremos a que el proceso nos de el OK.

Recapitulamos los 4 pasos básicos:

1. Abrir el bloque CREAR UPLOAD en la app Configuración Square
2. Rellenar los campos del moduform
3. Hacer click en subir y esperar el OK
4. Realizar las comprobaciones para asegurarnos de la correcta creación del Upload.

 

Centrémonos en el último de estos pasos: Comprobar que todo ha funcionado. Para ello:

A. Iremos a la App indicada para crear el bloque para nuestro Upload y comprobaremos que está.

B. Realizaremos una carga del archivo tipo y esperaremos a que nos del el OK

C. Comprobaremos en la base de datos que la información se han cargado.

Una vez hemos comprobado que la información carga, podremos probar algún otro archivo con la misma estructura de datos.

Si no tienes acceso a la base de datos, no te preocupes en el siguiente tema vamos a ver cómo visualizar los datos gracias al los Exceles de SherpaBots.