Trabajar con tablas de MaviBot

Crear un nuevo registro en la tabla con los valores especificados

Crear un nuevo registro en una tabla con los valores especificados.

new_record(table_id, data)

Parámetros	Descripción
table_id	ID de la tabla
data	un diccionario con los datos que se van a registrar. Ejemplo: {"column_name1": "value1", "column_name2": "value2"}. Si la columna no existe, se crea.

Respuesta: ID del nuevo registro

Ejemplo

Editar un registro existente en la tabla

edit_record(table_id, record_id, data)

Parámetros	Descripción
table_id	ID de la tabla
record_id	ID del registro editado
data	un diccionario con los datos que se van a editar. Ejemplo: {"column_name1": "value3", "column_name2": "value4"}. Si la columna no existe, NO se crea.

Respuesta:

Devuelve los datos completos del registro editado en el formato: {"column_name1": "value3", "column_name2": "value4"}.

Ejemplo

Eliminar un registro de la tabla por su ID

delete_record(table_id, record_id)

Parámetros	Descripción
table_id	ID de la tabla
record_id	ID del registro eliminado

Respuesta:

{'message': 'Registros eliminados: 1'}

Encontrar un registro en la tabla por el valor especificado

find_record(table_id, value, find_in, return_from)

Parámetros	Descripción
table_id	ID de la tabla
value	el valor que coincida
find_in -	parámetro opcional. El nombre de la columna por la que se debe buscar. Si no se especifica, la búsqueda se realizará en todas las columnas.
return_from	parámetro opcional. El nombre de la columna de la que se devolverá el valor.

Respuesta:

Si se especifica return_from, se devolverá el valor de la columna especificada (si existe en la tabla). Si no se especifica return_from o la columna no existe, se devolverán en la respuesta los datos completos del registro encontrado, por ejemplo: {"column_name1": "value3", "column_name2": "value4"}.

Ejemplo

Obtención de un valor del registro especificado

get_record_data(table_id, record_id)

Parámetros	Descripción
table_id	ID de la tabla
record_id	ID del registro del que se obtienen los valores
return_column	parámetro opcional. El nombre de la columna de la que se debe devolver el valor.

Respuesta: Si se encuentra un registro, se devuelve un diccionario como {"column_name1": "value1", "column_name2": "value2"}. Si se proporciona el parámetro return_column y existe dicha columna, solo se devolverá el valor de esa columna.

¿Dónde puedo encontrar el ID de una tabla?

Para trabajar con las funciones del chatbot, necesitarás el ID de la tabla. Encuentra la tabla deseada en la lista y haz clic en ella.

Luego, haz clic en la barra de direcciones.

En la barra de direcciones, verás una URL como https://salebot.pro/projects/11111/table/2, donde puedes encontrar el ID de la tabla deseada:

Obtención de un registro de la tabla

get_records_from_table(table_id, start_row, count, start_col, end_col) - obtención de un registro de la tabla.

Parámetro	Descripción	Nota
table_id	ID de la tabla
start_row	Parámetro opcional, un entero. Especifica el inicio del rango de filas.	El número de fila desde el que se comenzará a leer (incluido). Escríbelo sin comillas.
count	Parámetro opcional, un entero. Especifica la cantidad de filas que se van a obtener.	Por defecto, el valor es 1000, con un máximo de 5000. Especifica sin comillas.
start_col	Parámetro opcional, una cadena. Especifica el inicio del rango de columnas.	El nombre de la columna desde la que se comenzará a leer (incluida). Escríbelo entre comillas.
end_col	Parámetro opcional, una cadena. Especifica el final del rango de columnas.	El nombre de la columna hasta la que se leerán los valores de la tabla (incluida). Escríbelo entre comillas.

Si especificas solo el inicio del rango de filas o columnas, se devolverán todos los datos a partir de ese punto. También puedes omitir el inicio y especificar solo el final para obtener los datos hasta ese punto.

Ejemplo

En el bloque donde necesitas obtener registros de la tabla, ve a la "Calculadora" sección en la configuración del bloque e introduce la función con los parámetros necesarios.

Veamos cómo se muestran los datos en la tabla.

Ahora, ejecuta el bloque "Inicio" en modo de prueba.

Podemos ver los datos que se escribieron en la variable desde la tabla en el mensaje enviado por el bot. Como referenciamos la variable en el mensaje usando la #{} sintaxis, los datos almacenados en ella se mostraron en el chat del bot.

Obtener datos de la tabla dentro de un rango especificado

table_read_cells(table_id, cell_data) - permite obtener datos de la tabla especificando rangos.

Parámetro	Descripción
! table_id	parámetro requerido, ID de la tabla
! cell_data	parámetro requerido, un diccionario con rangos. cell_data ejemplo: '{"a1":"a1", "a3": "b4", "c1": "c3"}'

Si no ocurrieron problemas durante la solicitud, la respuesta será un diccionario que contiene el estado y todas las celdas con sus valores:

{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd" o, en caso de error: {"status": false, "err": "Mensaje de error o descripción"}

Ejemplo en la Calculadora

Por ejemplo, las celdas de la tabla contienen los siguientes valores especificados:

Para obtener datos de la tabla a través del bot, pasa los rangos requeridos a las funciones en la Calculadora.

En el ejemplo, la construcción #{res}, que contiene una variable, ayuda a mostrar en el mensaje los datos obtenidos mediante la función y el rango especificado:

Si los nombres de las columnas son diferentes (por ejemplo, "Product", "Number", "Amount"), debes especificar el rango usando el formato {"Product1":"Amount3"}, donde:

• Product es el nombre de la primera columna • 1 indica que es la columna número 1 • Importe es el nombre de la tercera columna • 3 indica que es la columna número 3