Як працювати з таблицями Mavibot
Поле "Аркуші" розділ у MaviBot — це інструмент для зручного зберігання та керування даними всередині платформи. Вам більше не потрібно перемикатися між різними сервісами — усі ваші аркуші тепер доступні в одному проєкті.
Можливості:
Створюйте аркуші з будь-якою кількістю рядків і стовпців.
Зберігайте та редагуйте дані без сторонніх інструментів або сервісів.
Вводьте значення, редагуйте рядки та стовпці або видаляйте їх безпосередньо через чатбот за допомогою функцій.
Переваги:
Спрощує керування даними: ви можете вводити інформацію в таблицю безпосередньо з бота.
Гнучкий і простий у використанні: створюйте стільки таблиць, скільки потрібно, і налаштовуйте їх під свої бізнес-завдання.
Керуйте своїми таблицями, не виходячи з Mavibot
Таблиці допомагають бізнесу структурувати дані та пришвидшувати процеси.
Як створити аркуші
Щоб почати, перейдіть до "Аркуші" розділу в потрібному проєкті:
Далі ви побачите кнопку "Створити аркуш" . Натисніть її, щоб відкрити модальне вікно, де потрібно ввести назву таблиці:
Введіть назву таблиці та натисніть "Готово". Після цього нова таблиця буде створена в проєкті та з’явиться в "Аркуші" розділі.
Налаштування аркушів
Після створення аркуша потрібно додати рядки та стовпці. Для цього знайдіть кнопку "Перейти" на потрібній таблиці та натисніть її:
Ви побачите такі налаштування:
Функція додавання стовпців:
а) щоб додати стовпці з літерами
Кнопка додає до таблиці стовпці з позначеннями від A до Z.
б) щоб додати стовпці з власними назвами
Натискання кнопки відкриває модальне вікно, де можна задати назву нового стовпця.
Введіть назву та натисніть "Готово" щоб додати стовпець до таблиці.
Кнопка для додавання рядків:
Експорт аркуша
Дозволяє експортувати аркуш у форматі CSV з усіма даними та значеннями, наприклад, щоб перенести аркуш до іншого проєкту Mavibot або до іншого сервісу електронних таблиць.
Поле Імпорт CSV функція дає змогу завантажувати дані із зовнішнього сервісу.
Інші можливості
Є випадаюче меню, яке дає змогу швидко переглядати аркуші, не виходячи з головного розділу.
Також ви можете створювати нові таблиці безпосередньо з бокового меню.
Щоб видалити аркуш, перейдіть до головного розділу:
Потім знайдіть Видалити кнопку на картці таблиці, яку потрібно прибрати.
Увага!
Видалені таблиці неможливо відновити.
Як вводити значення в аркуш
Ви можете вводити значення в аркуш вручну:
Або за допомогою функцій у чатботі.
Як знайти ID аркуша
Для використання функцій чатбота, пов’язаних із цією таблицею, вам знадобиться ID аркуша.
Перейдіть до своєї таблиці. Знайдіть потрібну таблицю в списку та натисніть на її назву, щоб відкрити її.
Знайдіть ID таблиці в адресному рядку. Натисніть на адресний рядок вашого браузера — ID таблиці це унікальний рядок символів у кінці URL.
Приклад: У такому URL, як
https://mavibot.ai/projects/11111/table/2ID таблиці — це2.Скопіюйте ID Виділіть і скопіюйте цей номер з адресного рядка, щоб використати його в конфігурації вашого чатбота.
Як створити новий запис в аркуші
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': 'Deleted entries: 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, return_column )
table_id – ID таблиці
record_id – ID запису, з якого потрібно отримати значення
return_column – необов’язково. Назва стовпця, з якого потрібно повернути значення
Відповідь: Якщо запис знайдено, повертає словник на кшталт {"column_name1": "value1", "column_name2": "value2"}. Якщо вказано return_column і стовпець існує, буде повернено лише значення з цього стовпця.
Як отримати всі значення під час пошуку по кількох стовпцях
find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – використовуйте цю функцію, коли потрібно одночасно шукати по кількох стовпцях і отримати список значень зі стовпця в рядках, де всі значення знайдено. (Це аналог функції sheet_search_in_multiple_cols_return_list для Google Sheets.)
table_id — ID таблиці
column_data — пошуковий запит, тобто те, що ви хочете знайти
return_col — номер стовпця, з якого потрібно повернути значення
with_index — індекс або нумерація в списку знайдених значень (0 – нумерація (1, 2, 3,…); 1 – індекс рядка; "" – список значень на нових рядках без індексів або нумерації)
delimiter — роздільник між індексом і значенням
algorithm — алгоритм пошуку (F – точне співпадіння, K – пошук за ключовим словом, R – регулярний вираз, 1–100 – відсоток схожості (див. деталі вище))
Приклад:
table_id = 7
data = {"age": "26", "city": "New York"}
return_col = "name"
with_index = 1
delimiter = " - "
algorithm = "F"
res = find_records_multiple_cols_list(table_id, data, return_col, with_index, delimiter, algorithm)
res_list = res["list"]
Якщо запит виконується успішно, відповідь — це словник, що містить статус і всі клітинки зі значеннями:
{"status":true,"rows_index":[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}
status — результат пошуку
rows_index — масив із номерами знайдених рядків
quantity — кількість знайдених рядків
list — рядок з усіма значеннями з вибраного стовпця
Якщо виникає помилка, відповідь матиме status: false разом з описом помилки: {"status": false, "error": "Помилка або опис"}
Як отримати перше значення під час пошуку по кількох стовпцях
find_first_record_multiple_cols_row(table_id, column_data, algorithm) – використовуйте цю функцію, коли потрібно одночасно шукати по кількох стовпцях і отримати перший відповідний рядок. (Це аналог функції sheet_search_in_multiple_cols_return_row для Google Sheets.)
table_id — ID таблиці
columns — пошуковий запит, тобто те, що ви хочете знайти
algorithm — алгоритм пошуку (F – точне співпадіння, K – пошук за ключовим словом, R – регулярний вираз, 1–100 – відсоток схожості (див. деталі вище))
Приклад:
table_id = 7
data = {"age": "26", "city": "New York"}
algorithm = "F"
res = find_first_record_multiple_cols_row(table_id, data, algorithm)
row_data = res["row_data"]
row_id = row_data["ID"]
row_name = row_data["name"]
row_age = row_data["age"]
Якщо запит виконується успішно, відповідь — це словник, що містить статус і всі клітинки зі значеннями.
{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}
status — результат пошуку
rows_index — масив із номерами знайдених рядків
row_data — дані з знайденого рядка
row — номер знайденого рядка
Якщо виникає помилка, відповідь матиме status: false разом з описом помилки: {"status": false, "error": "Помилка або опис"}
Останнє оновлення