# 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 , 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

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/es/chatbot/functions/calculadora/tables.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.