Розділ "Таблиці" у MaviBot — це інструмент для зручного зберігання та керування даними в межах платформи. Вам більше не потрібно перемикатися між різними сервісами — усі ваші таблиці тепер доступні в одному проєкті.

Можливості:

  • Створюйте таблиці з будь-якою кількістю рядків і стовпців.
  • Зберігайте та редагуйте дані без сторонніх інструментів або сервісів.
  • Вводьте значення, редагуйте рядки та стовпці або видаляйте їх безпосередньо через чат-бота за допомогою функцій.

Переваги:

  • Спрощує керування даними: ви можете вводити інформацію в таблицю безпосередньо з бота.
  • Гнучкий та простий у використанні: створюйте стільки таблиць, скільки потрібно, і налаштовуйте їх під свої бізнес-завдання.

Керуйте своїми таблицями, не виходячи з Mavibot

Таблиці допомагають бізнесу структурувати дані та прискорювати процеси.

Як створити таблиці

Щоб розпочати, перейдіть до розділу "Таблиці" у потрібному проєкті:

Далі ви побачите кнопку "Створити таблицю". Натисніть її, щоб відкрити модальне вікно, де потрібно ввести назву таблиці:

Введіть назву таблиці та натисніть "Готово". Нова таблиця буде створена в проєкті та з'явиться в розділі "Таблиці".

Налаштування таблиці

Після створення таблиці потрібно додати рядки та стовпці. Для цього знайдіть кнопку "Перейти" на потрібній таблиці та натисніть її:

Ви побачите такі налаштування:

  1. Функція додавання стовпців:

а) додавання стовпців з літерами

Кнопка додає до таблиці стовпці з позначками від A до Z.

b) додавання стовпців з власними назвами

Натискання кнопки відкриває модальне вікно, де ви можете назвати новий стовпець.

Введіть назву та натисніть "Готово", щоб додати стовпець до таблиці.

  1. Кнопка додавання рядків:

  1. Експорт таблиці

Дозволяє експортувати таблицю у форматі CSV з усіма даними та значеннями, наприклад, щоб перенести таблицю в інший проєкт Mavibot або в інший сервіс електронних таблиць.

  1. Функція Імпорт CSV дозволяє завантажити дані із зовнішнього сервісу.

Інші функції

Існує випадаюче меню, яке дозволяє швидко переглядати таблиці, не виходячи з основного розділу.

Ви також можете створювати нові таблиці безпосередньо з бічного меню.

Щоб видалити таблицю, перейдіть до основного розділу:

Потім знайдіть кнопку Видалити на картці таблиці, яку потрібно видалити.

Увага!

Видалені таблиці неможливо відновити.

Як ввести значення в таблицю

Ви можете вводити значення в таблицю вручну:

Або за допомогою функцій у чат-боті.

Як знайти ID таблиці

Вам знадобиться ID таблиці для використання функцій чат-бота, пов'язаних з цією таблицею.

  1. Перейдіть до вашої таблиці. Знайдіть потрібну таблицю в списку та натисніть на її назву, щоб відкрити її.
  2. Знайдіть ID таблиці в адресному рядку. Натисніть на адресний рядок вашого браузера — ID таблиці — це унікальний рядок символів у кінці URL.

  1. Приклад:
    У URL, як-от https://mavibot.ai/projects/11111/table/2
    ID таблиці — це 2.
  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 Таблиць.)

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": "Error or description"}

Як отримати перше значення під час пошуку по кількох стовпцях

find_first_record_multiple_cols_row(table_id, column_data, algorithm) – використовуйте цю функцію, коли потрібно шукати одночасно по кількох стовпцях і отримати перший відповідний рядок. (Це схоже на функцію sheet_search_in_multiple_cols_return_row для Google Таблиць.)

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": "Error or description"}