Створення нового запису в таблиці з вказаними значеннями
Створює новий запис у таблиці з вказаними значеннями.
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}, яка містить змінну, допомагає відобразити в повідомленні дані, отримані за допомогою функції та вказаного діапазону:
Якщо назви стовпців відрізняються (наприклад, "Товар", "Кількість", "Сума"), необхідно вказати діапазон у форматі {"Товар1":"Сума3"}, де:
• Товар - назва першого стовпця
• 1 вказує, що це стовпець номер 1
• Сума - назва третього стовпця
• 3 вказує, що це стовпець номер 3
