Создание новой записи в таблице с указанными значениями
Создает новую запись в таблице с указанными значениями.
new_record(table_id, data)
Ответ: ID новой записи
Пример
Редактирование существующей записи в таблице
edit_record(table_id, record_id, data)
Ответ:
Возвращает полные данные отредактированной записи в формате: {"column_name1": "value3", "column_name2": "value4"}.
Пример
Удаление записи из таблицы по ее ID
delete_record(table_id, record_id)
Ответ:
{'message': 'Deleted records: 1'}
Поиск записи в таблице по указанному значению
find_record(table_id, value, find_in, return_from)
Ответ:
Если указан return_from, будет возвращено значение из указанного столбца (если он существует в таблице). Если return_from не указан или столбец не существует, в ответе будут возвращены полные данные найденной записи, например: {"column_name1": "value3", "column_name2": "value4"}.
Пример
Получение значения из указанной записи
get_record_data(table_id, record_id)
Ответ: Если запись найдена, возвращается словарь вида {"column_name1": "value1", "column_name2": "value2"}. Если указан параметр return_column и такой столбец существует, будет возвращено только значение из этого столбца.
Где найти ID таблицы?
Для работы с функциями чат-бота вам понадобится ID таблицы. Найдите нужную таблицу в списке и нажмите на нее.
Затем нажмите на адресную строку.
В адресной строке вы увидите URL вида
https://salebot.pro/projects/11111/table/2,
где можно найти ID нужной таблицы:
Получение записи из таблицы
get_records_from_table(table_id, start_row, count, start_col, end_col) - получение записи из таблицы.
| Параметр | Описание | Примечание |
|---|---|---|
| table_id | ID таблицы | |
| start_row | Необязательный параметр, целое число. Указывает начало диапазона строк. | Номер строки, с которой начать чтение (включительно). Указывайте без кавычек. |
| count | Необязательный параметр, целое число. Указывает количество строк для получения. | По умолчанию значение равно 1000, максимум 5000. Указывайте без кавычек. |
| start_col | Необязательный параметр, строка. Указывает начало диапазона столбцов. | Название столбца, с которого начать чтение (включительно). Указывайте в кавычках. |
| end_col | Необязательный параметр, строка. Указывает конец диапазона столбцов. | Название столбца, до которого читать значения таблицы (включительно). Указывайте в кавычках. |
Если указать только начало диапазона строк или столбцов, будут возвращены все данные, начиная с этой точки. Также можно опустить начало и указать только конец, чтобы получить данные до этой точки.
Пример
В блоке, где нужно получить записи из таблицы, перейдите в раздел "Калькулятор" в настройках блока и введите функцию с необходимыми параметрами.
Посмотрим, как данные отображаются в таблице.
Теперь выполните блок "Старт" в тестовом режиме.
Мы видим данные, которые были записаны в переменную из таблицы, в сообщении, отправленном ботом. Поскольку мы сослались на переменную в сообщении с помощью синтаксиса #{}, данные, хранящиеся в ней, отобразились в чате бота.
Получение данных из таблицы в заданном диапазоне
table_read_cells(table_id, cell_data) - позволяет получать данные из таблицы, указывая диапазоны.
Если в ходе запроса не возникло проблем, ответом будет словарь, содержащий статус и все ячейки с их значениями:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"или, в случае ошибки: {"status": false, "err": "Сообщение или описание ошибки"}
Пример в Калькуляторе
Например, в ячейках таблицы указаны следующие значения:
Чтобы получить данные из таблицы через бота, передайте необходимые диапазоны в функции в Калькуляторе.
В примере конструкция #{res}, содержащая переменную, помогает отобразить в сообщении данные, полученные с помощью функции и указанного диапазона:
Если названия столбцов отличаются (например, "Продукт", "Количество", "Сумма"), необходимо указать диапазон в формате {"Product1":"Amount3"}, где:
• Product — название первого столбца
• 1 — указывает, что это столбец номер 1
• Amount — название третьего столбца
• 3 — указывает, что это столбец номер 3
