Cómo trabajar con las hojas de MaviBot
El "Hojas" La sección "Sheets" en MaviBot es una herramienta para el almacenamiento y la gestión convenientes de datos dentro de la plataforma. Ya no necesitas cambiar entre distintos servicios: todas tus hojas están ahora disponibles en un solo proyecto.
Funciones:
Crea hojas con cualquier número de filas y columnas.
Almacena y edita datos sin herramientas ni servicios de terceros.
Introduce valores, edita filas y columnas, o elimínalas directamente a través del chatbot usando funciones.
Ventajas:
Simplifica la gestión de datos: puedes introducir información en una tabla directamente desde el bot.
Flexible y fácil de usar: crea tantas tablas como necesites y personalízalas para las tareas de tu negocio.
Gestiona tus tablas sin salir de Mavibot
Las tablas ayudan a las empresas a estructurar sus datos y acelerar los procesos.
Cómo crear hojas
Para comenzar, ve a la "Hojas" sección en el proyecto requerido:
A continuación, verás el "Crear una hoja" botón. Haz clic en él para abrir una ventana modal donde debes introducir el nombre de la tabla:
Introduce un nombre para la tabla y haz clic en "Hecho". Luego, la nueva tabla se creará en el proyecto y aparecerá en la "Hojas" sección.
Configuración de hojas
Después de crear la hoja, necesitas añadir filas y columnas. Para ello, busca el botón "Ir a" en la tabla deseada y haz clic en él:
Verás la siguiente configuración:
Función para añadir columnas:
a) para añadir columnas con letras
El botón añade columnas etiquetadas de la A a la Z a la tabla.
b) para añadir columnas con nombres personalizados
Al hacer clic en el botón, se abre una ventana modal donde puedes poner nombre a la nueva columna.
Introduce un nombre y haz clic en "Hecho" para añadir la columna a la tabla.
Botón para añadir filas:
Exportación de la hoja
Te permite exportar la hoja en formato CSV con todos los datos y valores, por ejemplo, para mover la hoja a otro proyecto de Mavibot o a otro servicio de hojas de cálculo.
El Importar CSV la función te permite cargar datos desde un servicio externo.
Otras funciones
Hay un menú desplegable que te permite navegar rápidamente por las hojas sin salir de la sección principal.
También puedes crear nuevas tablas directamente desde el menú lateral.
Para eliminar una hoja, ve a la sección principal:
Luego, encuentra el Eliminar botón en la tarjeta de la tabla que quieres quitar.
¡Advertencia!
Las tablas eliminadas no se pueden restaurar.
Cómo introducir valores en la hoja
Puedes introducir valores en la hoja manualmente:
O usando funciones en el chatbot.
Cómo encontrar el ID de una hoja
Necesitarás un ID de hoja para usar las funciones del chatbot relacionadas con esta tabla.
Ve a tu tabla. Busca la tabla deseada en la lista y haz clic en su nombre para abrirla.
Localiza el ID de la tabla en la barra de direcciones. Haz clic en la barra de direcciones de tu navegador: el ID de la tabla es la cadena única de caracteres al final de la URL.
Ejemplo: En una URL como
https://mavibot.ai/projects/11111/table/2el ID de la tabla es2.Copiar el ID Selecciona y copia este número de la barra de direcciones para usarlo en la configuración de tu chatbot.
Cómo crear un nuevo registro en la hoja
new_record(table_id, data) – crea una nueva entrada en la tabla con los valores especificados.
table_id – el ID de la tabla
data – un diccionario que contiene los datos a introducir. Ejemplo: {"column_name1": "value1", "column_name2": "value2"}. Si una columna no existe, se creará. Respuesta: el ID de la nueva entrada
Ejemplo
Cómo editar un registro existente en la hoja
edit_record(table_id, record_id, data)
table_id – el ID de la tabla
record_id – el ID de la entrada que se va a editar
data – un diccionario que contiene los datos que se actualizarán. Ejemplo: {"column_name1": "value3", "column_name2": "value4"}. Si una columna no existe, NO se creará.
Respuesta: devuelve los datos completos de la entrada editada en el formato {"column_name1": "value3", "column_name2": "value4"}
Ejemplo
Cómo eliminar un registro de la hoja por su ID
delete_record(table_id, record_id)
table_id – el ID de la tabla
record_id – el ID de la entrada que se va a eliminar
Respuesta:
{'message': 'Entradas eliminadas: 1'}
Cómo encontrar el primer registro con el valor especificado en una hoja
find_record(table_id, value, find_in, return_from)
table_id – el ID de la tabla
value – el valor que se va a buscar
find_in – opcional. El nombre de la columna en la que buscar. Si no se especifica, la búsqueda se realizará en todas las columnas
return_from – opcional. El nombre de la columna desde la que devolver el valor
Respuesta: Si se especifica return_from, se devolverá el valor de la columna indicada (si existe en la tabla). Si no se especifica return_from o la columna no existe, se devolverán los datos completos de la entrada encontrada: {"column_name1": "value3", "column_name2": "value4"}
Ejemplo
Cómo obtener valores del registro especificado
get_record_data(table_id, record_id, return_column )
table_id – el ID de la tabla
record_id – el ID de la entrada de la que se van a recuperar valores
return_column – opcional. El nombre de la columna desde la que devolver el valor
Respuesta: Si se encuentra la entrada, devuelve un diccionario como {"column_name1": "value1", "column_name2": "value2"}. Si se proporciona return_column y la columna existe, solo se devolverá el valor de esa columna.
Cómo recuperar todos los valores al buscar en varias columnas
find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – usa esta función cuando necesites buscar en varias columnas a la vez y recuperar una lista de valores de una columna en las filas donde se encuentran todos los valores. (Esto es similar a la función sheet_search_in_multiple_cols_return_list de Google Sheets.)
table_id — el ID de la tabla
column_data — la consulta de búsqueda, es decir, lo que quieres encontrar
return_col — el número de la columna de la que se devolverán los valores
with_index — índice o numeración en la lista de valores encontrados (0 – numeración (1, 2, 3,…); 1 – índice de fila; "" – lista de valores en nuevas líneas sin índices ni numeración)
delimiter — separador entre el índice y el valor
algorithm — algoritmo de búsqueda (F – coincidencia exacta, K – coincidencia por palabra clave, R – expresión regular, 1–100 – porcentaje de similitud (ver detalles arriba))
Ejemplo:
table_id = 7
data = {"age": "26", "city": "New York"}
return_col = "name"
with_index = 1
delimiter = " - "
algorithm = "F"
res = find_records_multiple_cols_list(table_id, data, return_col, with_index, delimiter, algorithm)
res_list = res["list"]
Si la consulta se ejecuta correctamente, la respuesta es un diccionario que contiene el estado y todas las celdas con valores:
{"status":true,"rows_index":[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}
status — el resultado de la búsqueda
rows_index — un array con los números de las filas encontradas
quantity — el número de filas encontradas
list — una cadena con todos los valores de la columna seleccionada
Si ocurre un error, la respuesta será status: false junto con una descripción del error: {"status": false, "error": "Error o descripción"}
Cómo recuperar el primer valor al buscar en varias columnas
find_first_record_multiple_cols_row(table_id, column_data, algorithm) – usa esta función cuando necesites buscar en varias columnas a la vez y recuperar la primera fila coincidente. (Esto es similar a la función sheet_search_in_multiple_cols_return_row de Google Sheets.)
table_id — el ID de la tabla
columns — la consulta de búsqueda, es decir, lo que quieres encontrar
algorithm — el algoritmo de búsqueda (F – coincidencia exacta, K – coincidencia por palabra clave, R – expresión regular, 1–100 – porcentaje de similitud (ver detalles arriba))
Ejemplo:
table_id = 7
data = {"age": "26", "city": "New York"}
algorithm = "F"
res = find_first_record_multiple_cols_row(table_id, data, algorithm)
row_data = res["row_data"]
row_id = row_data["ID"]
row_name = row_data["name"]
row_age = row_data["age"]
Si la consulta se ejecuta correctamente, la respuesta es un diccionario que contiene el estado y todas las celdas con valores.
{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}
status — el resultado de la búsqueda
rows_index — un array con los números de las filas encontradas
row_data — datos de la fila encontrada
row — el número de la fila encontrada
Si ocurre un error, la respuesta será status: false junto con una descripción del error: {"status": false, "error": "Error o descripción"}
Última actualización