Для работы с Salebot-таблицами

Создать новую запись в таблице с указанными значениями

Создать новую запись в таблице с указанными значениями.

new_record(table_id, data)

- table_id - id таблицы

- data - словарь с данными, которые нужно записать. пример: {"column_name1": "value1", "column_name2": "value2"}. Если колонка не существует, она создается

Ответ: ID новой записи

Пример

Редактировать существующую запись в таблице

edit_record(table_id, record_id, data)

- table_id - id таблицы

- record_id - id редактируемой записи

- data - словарь с данными, которые нужно изменить. пример: {"column_name1": "value3", "column_name2": "value4"}. Если колонка не существует, она НЕ создается

Ответ:

Возвращает полные данные по отредактированной записи в формате {"column_name1": "value3", "column_name2": "value4"}

Пример

Удалить запись в таблице по id записи

delete_record(table_id, record_id)

- table_id - id таблицы

- record_id - id записи на удаление

Ответ:

{'message': 'Удалено записей: 1'}

Найти запись по указанному значению в таблице

find_record(table_id, value, find_in, return_from)

- table_id - id таблицы

- value - значение, по которому ищем совпадение

- find_in - необязательный параметр. Название столбца, по которому ведём поиск. если не указан, ищем запись по всем столбцам

- return_from - необязательный параметр. Название столбца из которого нужно вернуть значение.

Ответ:

Если return_from указан, вернется значение указанного столбца, если он есть в таблице. Если return_from не указан или такого столбца нет, в ответе будут полные данные по найденной записи {"column_name1": "value3", "column_name2": "value4"}

Пример

Получение значения из указанной записи

get_record_data(table_id, record_id)

- table_id - id таблицы

- record_id - id записи, из которой берем значения

- return_column - необязательный параметр. Название столбца из которого нужно вернуть значение.

Ответ: Если запись найдена, возвращает словарь типа {"column_name1": "value1", "column_name2": "value2"}. Если при этом передан параметр return_column, и такой столбец существует, в ответе будет значение только по этому столбцу.

Где найти ID таблицы?

Чтобы работать с функциями для чат-бота, понадобится ID таблицы.

Для начала перейдите в нужную таблицу: для этого найдите в списке искомую таблицу и кликните по ней:

Далее кликните по адресной строке:

В адресной строке вы увидите адрес вида "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

необязательный параметр, строка. Указывает конец диапазона столбцов

Передается название колонки, до которой включительно необходимо прочесть значения таблицы. Указывается в кавычках.

Если указать только начало диапазона строк/столбцов, то будут получены все данные от указанного значения без ограничения по концу диапазона. Аналогично можно не указывать начало диапазона, указав только конец.

Пример в калькуляторе

В блоке, в котором необходимо получить записи из таблицы, кликните на раздел "Калькулятор" в настройках блока и пропишите функцию с указанием параметров.

Чтобы параметры были переданы в качестве переменной проекта, перед названием переменной с функцией укажите project.

Ответ бота будет следующим:

Last updated

Was this helpful?