> For the complete documentation index, see [llms.txt](https://help.cleverapp.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cleverapp.pro/magazin-v-telegram/bloki-chtenie-zapisei-zapisi-iz-spiska.md).
# Блоки “Чтение записей/записи из списка”
Данные блоки используются для того, чтобы выводить в бота информацию, сохраненную в виде списков (списки – это инструмент в конструкторе, аналогичный эксель таблице).
**Настройки блоков состоят из:**\
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:**\
\- в поле "бот" - выбираете бот, в личном кабинете которого был создан список (можно выбрать список из любого бота в личном кабинете Вашего конструктора)\
\- с поле "список" - выбирается список, данные из которого Вы хотите вывести в бота
-“Поле для поиска” – если пользователь отправляет боту команды текстом (а не нажимает на кнопки в телеграм боте) – то в данном поле выбирается то поле, по которому осуществляется поиск в списке.
Например: мы выбрали в “Поле для поиска” – столица. Пользователь бота ввел слово “Париж”. Бот находит в поле “Столица” (в столбце) ту запись, у которой столица равна “Париж” и выводит данные из этой строки. Т.е. в нашем случае, если пользователь введет слово “Париж” бот отправит ему информацию из строки про Францию.
1. **Дополнительные фильтры:**
Вы можете задать дополнительные фильтры для выборки по указанному списку. И/ИЛИ: используется только, если задано несколько фильтров. при “и” – и один и второй фильтр должны выполняться при “или” – или один, или второй фильтр должны выполняться
Выбор поля (фильтра) для отображения : выбираем поле, по которому будет идти фильтрация (проверка) значений Оператор сравнения: стандартные математические символы (равно, больше, меньше и т.д.)
Значение, с которым сравнивается: значение для фильтрации.
**3. Сортировка**\
Сортировка выводимых данных\
\
Поле - выбор поля (столбца) по которому будет происходить сортировка\
По возрастанию/по убыванию
**4. Шаблон цепочки сообщений**\
Здесь настраивается, какие именно значения из списка и в каком порядке, бот будет выводить.
**5. Сообщение перед/после отправки списка**\
Здесь можно задать сообщения, которые бот выведет пользователю бота перед тем, как выведет все данные из списка. И после того, как выведет все данные из списка\
\
Эти поля можно оставлять пустыми.
Так же в них можно писать информационные сообщения для пользователя, например: для перехода на нужную страница отправьте боту “Страница n”, где n – номер страницы.
**6. Настройки**
1. Включить пагинацию Если в Вашем списке много записей, их можно выводить в бота постранично, а не весь список сразу. При включении ползунка – вывод будет постранично
2. Количество записей в сообщении Когда Вы включите постраничный вывод записей, то в данном поле задается какое именно количество записей выводить на одну страницу
3. Шаблон команды выбора страницы Чтобы переключаться между выводимыми страницами, боту нужно отправить команду. Здесь задается шаблон команды, где {n} это номер страницы В данном случае, если пользователь отправить боту фразу “Страница 5” – бот выведет пятую страницу
4. Имя кнопки выбора элемента списка При выводе всех записей их списка, рядом с каждой записью выводится кнопка, по которой можно посмотреть подробности данной записи. В этом поле задается текст данной кнопки.
5. Корзина товаров Когда Вы создаете магазин в мессенджере, при включенном данном ползунке, выбранная запись будет добавлена в корзину
**Остальные настройки блока – стандартные для блоков**
Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока “цепочка сообщений”)
**Теперь наконец-то посмотрим, как данные из созданных списков выводить в бота:**
Стартовый блок – это обычный текстовый блок “цепочка сообщений” с одной кнопкой. Эта кнопка соединяется с блоком “чтение записей из списка”. В настройках блока “чтение записей из списка” выбираем:
1. Выбираем своего бота, в личном кабинете которого создавался список
2. Выбираем созданный нами список, данные из которого мы хотим выводить
3. “Поле для поиска” пока можно не заполнять
4. Функции фильтры и сортировка – пока тоже не трогаем
5. В “шаблоне цепочки сообщений” задаем шаблон сообщения, которое мы хотим получить от бота с выводом информации из списка. В данном случае мы выбрали – “название страны” (просто нажав на кнопку под текстовым полем и переменная сама подтягивается в текст).
Написали обычным текстом “столица:” и подтянули переменную “столица”. Тоже самое с населением.
Далее:
Создаем блок “Чтение записи из списка” и соединяем с кнопкой “любая другая фраза” из блока “Чтение записей из списка”.
В настройках блока “чтение записи из списка” выбираем:
1. Выбираем своего бота, в личном кабинете которого создавался список
2. Выбираем созданный нами список, данные из которого мы хотим выводить
3. “Поле для поиска” – выбираете поле, по которому будет происходить поиск, если пользователь отправит боту команду текстом (а не нажмет на кнопки в телеграм боте). Когда у Вас большие списки с данными, Вы можете задавать и фильтрацию и сортировку одновременно, в зависимость от того, что пользователь хочет видеть в боте.
Вы можете предоставить пользователю бота самому выбрать по каким параметрам он хочет сделать фильтрацию или сортировку данных. А так же можете уточнить у него конкретное значение для подстановки этого значение фильтр.