Как работать с таблицами 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': 'Удалённые записи: 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": "Ошибка или описание"}
Последнее обновление