# Блоки “Чтение записей/записи из списка”

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2Ftrou7IpRLDMVvSFfdnjt%2Fmagaz.jpg?alt=media&#x26;token=bce8f312-029d-49e8-9f81-1b4824eb616d" alt=""><figcaption></figcaption></figure>

Данные блоки используются для того, чтобы выводить в бота информацию, сохраненную в виде списков (списки – это инструмент в конструкторе, аналогичный эксель таблице).

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FLnL6Wom5DLwpQThl9dOr%2Fnastr_blokov.jpg?alt=media&#x26;token=d80d75c2-ed03-484b-831c-bd5a7c793a36" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FCNNeHherDIBURqYPH8Pp%2Fspis.jpg?alt=media&#x26;token=4fd1dc7c-f133-472c-b9e7-9f1e98c926ea" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FKSqsbXVtaYMws4HCtqwu%2F69.jpg?alt=media&#x26;token=4f4f4ce5-3ea3-40a5-a8a0-64348feb743d" alt=""><figcaption></figcaption></figure>

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

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

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

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

1. Имя – задаем имя для поля
2. Ползунок “Обязательность заполнения поля” Когда мы начнем заполнять создаваемый нами список (т.е. заполнять таблицу данными), то данное поле (=данный столбец) будет являться обязательным для заполнения, если стоит включено
3. Переключатель “Скрыть поле из интерфейса” – это поле для отображения будет доступно только через API
4. Добавить еще одно поле (=столбец в таблицу) После того, как все поля созданы нажимаем “создать” список и переходим к заполнению списка

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FXNxJLjhVA9M8KokXWLJE%2F70.jpg?alt=media&#x26;token=7750270a-13d1-4f24-bb4c-3a40ae8016a4" alt=""><figcaption></figcaption></figure>

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

1-ый столбец – название страны 2-ой столбец – столица этой страны 3-ий столбец – количество населения в стране 4-ый столбец – фотография флага

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FgWXULtwMs006t72BdJ5S%2F71.jpg?alt=media&#x26;token=1ec2dbe1-3456-4b5d-9beb-454b50623d20" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FzYIR2eOko083jTrIExye%2F72.jpg?alt=media&#x26;token=38e98741-e898-495a-9cff-0d502ade52c1" alt=""><figcaption></figcaption></figure>

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

Добавить записи можно 2му способами:

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FsWkOIqDmMshu9t73YTAg%2F73.jpg?alt=media&#x26;token=8bfb0f15-7231-4b29-a463-37bd57769ac6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2Fk8jCGmjd8GaswttDhTEB%2F75.jpg?alt=media&#x26;token=82b43e75-9717-43a6-aae9-e3ea5a0fcd95" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FKVD7XFQuQ5e44YCiGgB2%2F76.jpg?alt=media&#x26;token=3919102f-f58d-46d7-b5d2-267d9d8a3461" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2F4cZDgoWJBXk6EqYlqLTP%2F77.jpg?alt=media&#x26;token=9acf43c1-f84f-429f-a80c-2a5c7f27574f" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2Fo55bnFDnI1zQFNsUT6D9%2F78.jpg?alt=media&#x26;token=42502a96-0769-4d6f-8013-3cf2ecc8d34a" alt=""><figcaption></figcaption></figure>

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

### Настройка блоков "Чтение записей/записи из списка"

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FY02jw6BDhBpqcIebwTh5%2Fspisa.jpg?alt=media&#x26;token=9eec8d53-7950-4526-9efc-93907d854b44" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FECHNkPDRhvACNoJqxgXH%2F80.jpg?alt=media&#x26;token=36acfcbe-e1e5-48c9-b3cb-b0040d57982d" alt=""><figcaption></figcaption></figure>

1. **Дополнительные фильтры:**

Вы можете задать дополнительные фильтры для выборки по указанному списку. И/ИЛИ: используется только, если задано несколько фильтров. при “и” – и один и второй фильтр должны выполняться при “или” – или один, или второй фильтр должны выполняться

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

Значение, с которым сравнивается: значение для фильтрации.

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FFV9P2uuRjM3pa3qUvpwG%2Fspisan.jpg?alt=media&#x26;token=9d3d2a5b-ddd5-4bdb-81bd-4eaccbb2e269" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2F0xaDwj3nhO44b72Glzna%2F82.jpg?alt=media&#x26;token=aa28e0e9-058d-403a-a2a5-ae45536faf6c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FlZSyiVIE15rnKFz9muLO%2F83.jpg?alt=media&#x26;token=ea54b999-dffd-4780-b019-0c718f109186" alt=""><figcaption></figcaption></figure>

**5. Сообщение перед/после отправки списка**\
Здесь можно задать сообщения, которые бот выведет пользователю бота перед тем, как выведет все данные из списка. И после того, как выведет все данные из списка\
\
Эти поля можно оставлять пустыми.

Так же в них можно писать информационные сообщения для пользователя, например: для перехода на нужную страница отправьте боту “Страница n”, где n – номер страницы.

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2FpWi8a4QFPoUhafKsjqnH%2Fspisani.jpg?alt=media&#x26;token=2c7dbcee-ac94-4296-888b-67cb172953cd" alt=""><figcaption></figcaption></figure>

**6. Настройки**

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

**Остальные настройки блока – стандартные для блоков**

Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока “цепочка сообщений”)

<figure><img src="https://142807269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgURoHjOREu7lpbgVXmo%2Fuploads%2Fe3JcIHgTxakTtQFa6yUZ%2Fspisanie.jpg?alt=media&#x26;token=f0304b6b-2146-4e4d-b375-913715b89a9a" alt=""><figcaption></figcaption></figure>

**Теперь наконец-то посмотрим, как данные из созданных списков выводить в бота:**

Стартовый блок – это обычный текстовый блок “цепочка сообщений” с одной кнопкой. Эта кнопка соединяется с блоком “чтение записей из списка”. В настройках блока “чтение записей из списка” выбираем:

1. Выбираем своего бота, в личном кабинете которого создавался список
2. Выбираем созданный нами список, данные из которого мы хотим выводить
3. “Поле для поиска” пока можно не заполнять
4. Функции фильтры и сортировка – пока тоже не трогаем
5. В “шаблоне цепочки сообщений” задаем шаблон сообщения, которое мы хотим получить от бота с выводом информации из списка. В данном случае мы выбрали – “название страны” (просто нажав на кнопку под текстовым полем и переменная сама подтягивается в текст).

Написали обычным текстом “столица:” и подтянули переменную “столица”. Тоже самое с населением.

Далее:

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

В настройках блока “чтение записи из списка” выбираем:

1. Выбираем своего бота, в личном кабинете которого создавался список
2. Выбираем созданный нами список, данные из которого мы хотим выводить
3. “Поле для поиска” – выбираете поле, по которому будет происходить поиск, если пользователь отправит боту команду текстом (а не нажмет на кнопки в телеграм боте). Когда у Вас большие списки с данными, Вы можете задавать и фильтрацию и сортировку одновременно, в зависимость от того, что пользователь хочет видеть в боте.

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