Таблицы в Salebot

Раздел «Таблицы» в Сейлбот— инструмент для удобного хранения и управления данными внутри платформы. Теперь не нужно переключаться между разными сервисами : все таблицы доступны в одном проекте.

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

• Создание таблиц с любым количеством строк и столбцов.

• Хранение и редактирование данных без сторонних инструментов и сервисов.

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

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

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

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

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

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

Пропишите название для таблицы и кликните на кнопку "Готово". Тогда новая таблица будет создана в проекте и появится в разделе "Таблицы":

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

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

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

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

а) Для добавления буквенных столбцов:

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

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

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

После того как вы прописали название столбца, кликните по кнопке "Готово", тогда новый столбец добавится в таблицу:

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

а) можно добавить фиксированное количество строк (100) в таблицу:

б) или заданное количество строк:

1. Экспорт таблицы

Поможет экспортировать таблицу в формате csv со всеми данными и значениями, например, чтобы перенести таблицу в другой проект Сейлбот или в другой сервис для таблиц.

1. Импорт таблицы - для загрузки таблицы из иных сервисов.

Другие возможности

Существует выпадающее меню, с помощью которого вы быстро можете просматривать таблицы, не выходя в основной раздел.

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

Чтобы удалить таблицу, перейдите в основной раздел:

И на плашке с ненужной таблицей найдите кнопку для удаления.

Как вводить значения в таблицу

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

Также с помощью функций в чат-боте.

Где найти ID таблицы?

Чтобы работать с функциями для чат-бота, понадобится ID таблицы.

Для начала перейдите в нужную таблицу: для этого найдите в списке искомую таблицу и кликните по ней:

Далее кликните по адресной строке:

В адресной строке вы увидите адрес вида "https://salebot.pro/projects/11111/table/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 для гугл таблиц)

• 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 = {"возраст": "26", "город": "Москва"}

return_col = "имя"

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 - Илья\n3 - Раиса"}

• status — результат поиска

• rows_index — массив с номерами найденных строк

• quantity — количество найденных строк

• list — строка со всеми значениями из выбранного столбца

Если возникла ошибка, то вернется статус false и описание ошибки {"status":false,"error":"Ошибка или описание"}

Получение первого значения при поиске по нескольким колонкам

find_first_record_multiple_cols_row(table_id, column_data, algorithm) — Если возникла необходимость искать по нескольким колонкам сразу и получить первую найденную строку, то нужно использовать следующую функцию (Аналог функции sheet_search_in_multiple_cols_return_row для гугл таблиц)

• table_id — ид таблицы

• columns — поисковый запрос, то что нужно найти

• algorithm — алгоритм поиска (F - полное совпадение, K - наличие ключевых слов, R - регулярное выражение, 1-100 - процент похожести (подробнее выше))

Пример

table_id = 7

data = {"возраст": "26", "город": "Москва"}

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["имя"]

row_age = row_data["возраст"]

Если проблем при выполнении запроса не возникло, то в ответ приходит словарь содержащий статус и все ячейки со значениями

{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"имя":"Илья","возраст":"26","город":"Москва"},"row":2}

• status — результат поиска

• rows_index — массив с номерами найденных строк

• row_data — данные из найденной строки

• row — номер найденной строки

Если возникла ошибка, то вернется статус false и описание ошибки {"status":false,"error":"Ошибка или описание"}