Блоки "Чтение записи/записей из списка"

Данные блоки используются для того, чтобы выводить в бота информацию, сохраненную в виде списков (списки - это инструмент в конструкторе, аналогичный эксель таблице). Настройки блоков состоят из: 1. Поле с выбором бота, в личном кабинете которого создан список 2. Поле с выбором нужного списка 3. Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока "цепочка сообщений")

Чтобы начать использовать блоки "вывод записей списка", списки нужно для начала создать.

Для создания списка в настройках в левой части экрана нажимаем на кнопку "списки":

На данном экране выводятся все списки, имеющиеся в данном боте. У каждого бота есть список под названием "контакты". Этот список создается автоматически и в нем записываются все пользователи бота, которые хоть один раз перешли в бота. Список контактов можно просмотреть в любой момент (в нем содержаться данные о пользователе боте - имя, телефон, username, присвоенные теги, дата первого захода в бота) и выгрузить в виде excel таблицы.

Чтобы создать свой собственный список, нажимаем кнопку "создать список":

Задаем имя для списка.

Далее переходим к настройкам полей в списке: 1. Выбираем тип информации - которая будет отражаться в поле №1. Если проводить аналогию с эксель таблицей, то поле в конструкторе - это как столбцы в эксель таблице.

В конструкторе мы можем выбрать тип информации, которая будет отображаться в поле.

1. Имя - задаем имя для поля

2. Ползунок "Обязательность заполнения поля"

   Когда мы начнем заполнять создаваемый нами список (т.е. заполнять таблицу данными), то данное поле (=данный столбец) будет являться обязательным для заполнения, если стоит включено

3. Переключатель "Скрыть поле из интерфейса" - это поле для отображения будет доступно только через API

4. Добавить еще одно поле (=столбец в таблицу)

После того, как все поля созданы нажимаем "создать" список и переходим к заполнению списка.

Создадим для примера список, в котором будет следующая информация:

1ый столбец - название страны

2ой столбец - столица этой страны

3ий столбец - количество населения в стране

4ый столбец - фотография флага

Создаем 1ое поле (для данных по странам): - выбираем тип поля - "текст", т.к. название страны - это текстовая информация - задаем имя для поля - например "Название страны"

Добавляем 2ое поле (для данных по столицам): - выбираем тип поля - "текст", т.к. название столицы - это текстовая информация - задаем имя для поля - например "Столица"

Добавляем 3е поле (для данных по населению): - выбираем тип поля - "число", т.к. количество населения - это числовая информация - задаем имя для поля - например "Население"

Добавляем 4ое поле (для флага): - выбираем тип поля - "картинка" - задаем имя для поля - например "Флаг"

Нажимаем кнопку "Создать" и список создается. Переходим в раздел со списками и видим новый созданный список.

Заходим с созданный список - он пустой, т.к. мы еще не добавляли записи.

Добавить записи можно 2му способами: 1. Добавить записи по одной вручную, нажав кнопку "+добавить запись" 2. Импортировать записи из excel файла

Добавим вручную, для примера. Нажимаем кнопку "+добавить запись" и попадаем в меню добавления записи в список.

Здесь необходимо заполнить четыре поля, которые мы с Вами задали ранее для этого списка и нажать кнопку "создать" после заполнения.

Таким образом, данные вносятся в список.

Давайте внесем 5 стран и посмотрим, как выводить эти данные в бота.

После добавление всех стран, список выглядит таким образом. Любую запись можно отредактировать/удалить или добавить новую запись в список

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

Например, мы решили, что хотим добавить в наш список еще поле - "президент": Заходим в настройки списка, добавляем новое поле "президент" (с типом данных - "текст"). Не забываем заполнить поле "президент" у записей, которые уже существует (т.к. у них это поле будет пустым).

Еще решили добавить следующие поля:

1. Добавить поле "ВВП страны". Заходим в настройки списка, добавляем новое поле "ВВП" (с типом данных - "денежный"). Не забываем заполнить поле "ВВП" у записей, которые уже существует (т.к. у них это поле будет пустым)

2. Добавить поле "О стране" - где будет краткая информация о стране Заходим в настройки списка, добавляем новое поле "о стране" (с типом данных - "текст"). Не забываем заполнить поле "о стране" у записей, которые уже существует (т.к. у них это поле будет пустым)

После добавления всех данных - список обновляется, отображаются новые поля и показывается дата обновления списка.

Теперь данные из списка можно выводить в бота - для этого используются блоки "чтение записи/записей из списка".

НАСТРОЙКИ БЛОКОВ "Чтение записи/записей из списка"

1. В разделе настроек, обозначенных на скриншоте цифрой 1: - в поле "бот" - выбираете бот, в личном кабинете которого был создан список (можно выбрать список из любого бота в личном кабинете Вашего конструктора) - с поле "список" - выбирается список, данные из которого Вы хотите вывести в бота

-"поле для поиска" - если пользователь отправляет боту команды текстом (а не нажимает на кнопки в телеграм боте) - то в данном поле выбирается то поле, по которому осуществляется поиск в списке.

Например: мы выбрали в "поле для поиска" - столица. Пользователь бота ввел слово "Париж". Бот находит в поле "Столица" (в столбце) ту запись, у которой столица равна "Париж" и выводит данные из этой строки. Т.е. в нашем случае, если пользователь введет слово "Париж" бот отправит ему информацию из строки про Францию.

2. Дополнительные фильтры: Вы можете задать дополнительные фильтры для выборки по указанному списку. И/ИЛИ: используется только, если задано несколько фильтров. при "и" - и один и второй фильтр должны выполняться при "или" - или один, или второй фильтр должны выполняться Выбор поля (фильтра) для отображения : выбираем поле, по которому будет идти фильтрация (проверка) значений Оператор сравнения: стандартные математические символы (равно, больше, меньше и т.д.) Значение, с которым сравнивается: значение для фильтрации.

3. Сортировка Сортировка выводимых данных Поле - выбор поля (столбца) по которому будет происходить сортировка По возрастанию/по убыванию

4. Шаблон цепочки сообщений Здесь настраивается, какие именно значения из списка и в каком порядке, бот будет выводить.

5. Сообщение перед/после отправки списка Здесь можно задать сообщения, которые бот выведет пользователю бота перед тем, как выведет все данные из списка. И после того, как выведет все данные из списка Эти поля можно оставлять пустыми. Так же в них можно писать информационные сообщения для пользователя, например: для перехода на нужную страница отправьте боту "Страница n", где n - номер страницы.

6. Настройки 1. Включить пагинацию Если в Вашем списке много записей, их можно выводить в бота постранично, а не весь список сразу. При включении ползунка - вывод будет постранично 2. Количество записей в сообщении Когда Вы включите постраничный вывод записей, то в данном поле задается какое именно количество записей выводить на одну страницу 3. Шаблон команды выбора страницы Чтобы переключаться между выводимыми страницами, боту нужно отправить команду. Здесь задается шаблон команды, где {n} это номер страницы В данном случае, если пользователь отправить боту фразу "Страница 5" - бот выведет пятую страницу 4. Имя кнопки выбора элемента списка При выводе всех записей их списка, рядом с каждой записью выводится кнопка, по которой можно посмотреть подробности данной записи. В этом поле задается текст данной кнопки. 5. Корзина товаров Когда Вы создаете магазин в мессенджере, при включенном данном ползунке, выбранная запись будет добавлена в корзину. Остальные настройки блока (меню, теги, уведомления и т.д.) - стандартные для блоков Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока "цепочка сообщений")

Теперь наконец-то посмотрим, как данные из созданных списков выводить в бота: Стартовый блок - это обычный текстовый блок "цепочка сообщений" с одной кнопкой. Эта кнопка соединяется с блоком "чтение записей из списка". В настройках блока "чтение записей из списка" выбираем: 1. Выбираем своего бота, в личном кабинете которого создавался список 2. Выбираем созданный нами список, данные из которого мы хотим выводить 3. "Поле для поиска" пока можно не заполнять 4. Функции фильтры и сортировка - пока тоже не трогаем 5. В "шаблоне цепочки сообщений" задаем шаблон сообщения, которое мы хотим получить от бота с выводом информации из списка. В данном случае мы выбрали - "название страны" (просто нажав на кнопку под текстовым полем и переменная сама подтягивается в текст). Написали обычным текстом "столица:" и подтянули переменную "столица". Тоже самое с населением.

Создаем блок "чтение записи из списка" и соединяем с кнопкой "любая другая фраза" из блока "чтение записей".

В настройках блока "чтение записи из списка" выбираем: 1. Выбираем своего бота, в личном кабинете которого создавался список 2. Выбираем созданный нами список, данные из которого мы хотим выводить 3. "Поле для поиска" - выбираете поле, по которому будет происходить поиск, если пользователь отправит боту команду текстом (а не нажмет на кнопки в телеграм боте).

Например: мы выбрали в "поле для поиска" - название страны. Пользователь бота ввел слово "Россия". Бот находит в поле "Страна" (в столбце) ту запись, у которой страна равна "Россия" и выводит данные из этой строки. Т.е. в нашем случае, если пользователь введет слово "Россия" бот отправит ему всю информацию из строки про Россию. 4. Функции фильтры и сортировка - пока тоже не трогаем 5. В "шаблоне цепочки сообщений" задаем шаблон сообщения, которое мы хотим получить от бота с выводом информации из списка. В данном случае мы выводим все переменные, которые есть у нас в списке и добавляем текст от себя 6. Так же мы хотим выводить не только текст, но и картинку, которую мы сохранили в списках (т.е. фото флага страны). Нажимаем кнопку "фото" и в поле выбираем "флаг".

"текст" и "фото" можно менять между собой местами, в зависимости от того, что Вы хотите выводить первым.

При запуске боте это выглядит таким образом:

Бот выводит "стартовое сообщение", в котором у нас только одна кнопка "список".

При нажатии на кнопку "список" срабатывает блок "чтение записей из списка" и выводятся все записи по очереди.

Если нажать кнопку "смотреть подробности", например у записи Испания - то сработает блок "чтение записи из списка" и выведется информация из списка по шаблону, который мы задали в настройках блока (т.е. сначала фото флага, далее страна, население и т.д.)

Та же самая запись выведется, если бы мы написали боту слово "Испания", а не нажали кнопку (т.к. в настройках блока "чтение записи из списка" в "поле для поиска" мы выбрали - "название страны", соответственно бот ищет во всем списке в поле (столбце) "название страны" совпадение по слову "Испания" и выводит нужную запись.

Если в настройках блока "чтение записи из списка" в "поле для поиска" выбрать - "столица", то при вводе вручную в бота слова "Испания" бот выдаст "запись не найдена". Т.к. в данном случае бот ищет совпадения по слову "Испания" в столбце "Столица", а там такого слова нет. Соответственно бот ожидает увидеть слово из столбца "столица", чтобы вывести нужную запись (т.е. если нам нужна запись по Испании - нужно отправить слово "Мадрид").

Данная особенность работает только при ручном вводе от пользователя, если пользователь будет нажимать кнопку "смотреть подробности" под записью, то все будет работать, независимо от выбранного значения в "поле для поиска"

Рассмотрим функцию "дополнительные фильтры": Допустим перед нами стоит задача отфильтровать данные в списке и вывести только определенные, подходящие под наши условия. Например, мы хотим вывести список стран, с населением больше какого-то значения и меньше этого значения 1. В первом сообщении сделаем 2 кнопки: "население> 65 млн человек" и "население< 65 млн человек" - чтобы дать пользователю выбор 2. Создадим копию блока "чтение записей из списка". 3. В одном из блоков "чтение записей из списка". в "дополнительных фильтрах" выберем фильтр по "населению", выберем "оператор" сравнения ">" (т.е. больше какого-то значения") и в поле "Значение" введем 65 4. В во втором блоке "чтение записей из списка". в "дополнительных фильтрах" выберем фильтр по "населению", выберем "оператор" сравнения "<" (т.е. меньше какого-то значения") и в поле "Значение" введем 65 5. Соединим кнопки из "стартового блока" с соответствующими блоками "чтение записей"

В результате: В боте, при выборе кнопки "население > 65" нам отобразится только нужный список стран.

Можно задавать сразу несколько фильтров одновременно и выбирать способ их взаимной работы (через операторы и/или) при "и" - и один и второй фильтр должны выполняться, при "или" - или один, или второй фильтр должны выполняться. Сортировка: При выводе записей мы видим, что записи выводятся не по порядку, а хаотично. В конструкторе можно настроить сортировку вывода данных. Давайте зададим "сортировку" выводимых данных по возрастанию ВВП.

Вот так это выглядит в боте:

Когда у Вас большие списки с данными, Вы можете задавать и фильтрацию и сортировку одновременно, в зависимость от того, что пользователь хочет видеть в боте. Вы можете предоставить пользователю бота самому выбрать по каким параметрам он хочет сделать фильтрацию или сортировку данных. А так же можете уточнить у него конкретное значение для подстановки этого значение фильтр.