Crear un nuevo registro en la tabla con los valores especificados
Crea un nuevo registro en una tabla con los valores especificados.
new_record(table_id, data)
Respuesta: nuevo ID de registro
Ejemplo
Editar un registro existente en la tabla
edit_record(table_id, record_id, data)
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)
Respuesta:
{'message': 'Deleted records: 1'}
Buscar un registro en la tabla por el valor especificado
find_record(table_id, value, find_in, return_from)
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 los datos completos del registro encontrado en la respuesta, por ejemplo: {"column_name1": "value3", "column_name2": "value4"}.
Ejemplo
Obtener un valor del registro especificado
get_record_data(table_id, record_id)
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 dicha columna existe, solo se devolverá el valor de esa columna.
¿Dónde puedo encontrar el ID de la 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.
A continuación, 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:
Obtener un registro de la tabla
get_records_from_table(table_id, start_row, count, start_col, end_col) - obtener 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 cual comenzar a leer (inclusive). Escríbelo sin comillas. |
| count | Parámetro opcional, un entero. Especifica el número de filas 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 cual comenzar a leer (inclusive). 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 cual leer los valores de la tabla (inclusive). Escríbelo entre comillas. |
Si especificas solo el inicio del rango de filas o columnas, se devolverán todos los datos desde ese punto en adelante. También puedes omitir el inicio y especificar solo el final para obtener datos hasta ese punto.
Ejemplo
En el bloque donde necesitas obtener registros de la tabla, ve a la sección "Calculadora" en la configuración del bloque e ingresa la función con los parámetros requeridos.
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. Debido a que hicimos referencia a 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.
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 o descripción del error"}
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 usando la función y el rango especificado:
Si los nombres de las columnas son diferentes (por ejemplo, "Producto", "Número", "Cantidad"), debes especificar el rango usando el formato {"Producto1":"Cantidad3"}, donde:
• Producto es el nombre de la primera columna
• 1 indica que es la columna número 1
• Cantidad es el nombre de la tercera columna
• 3 indica que es la columna número 3
