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

Возможности:

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

Преимущества:

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

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

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

Как создать таблицу

Для начала перейдите в раздел "Таблицы" в нужном проекте:

Затем вы увидите кнопку "Создать таблицу". Нажмите на неё, чтобы открыть модальное окно, в котором нужно ввести название таблицы:

Введите название таблицы и нажмите "Готово". Новая таблица будет создана в проекте и появится в разделе "Таблицы".

Настройки таблицы

После создания таблицы необходимо добавить строки и столбцы. Для этого найдите кнопку "Перейти" на нужной таблице и нажмите её:

Вы увидите следующие настройки:

  1. Функция добавления столбцов:

а) для добавления столбцов с буквенными обозначениями

Кнопка добавляет в таблицу столбцы с обозначениями от A до Z.

б) для добавления столбцов с пользовательскими названиями

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

Введите название и нажмите "Готово", чтобы добавить столбец в таблицу.

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

Как получить первое значение при поиске по нескольким столбцам

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