Для работы со списками
Пример работы со спискам в Калькуляторе блока
Рассмотрим пример работы с функциями в Калькуляторе для работы со списками.
Важно! Нам необходимо сохранить номер нового списка, чтобы работать с ним далее. Для этого функцию присвойте переменной, т.е. list_id=...
Теперь мы с легкостью можем выполнять и иные действия над списком - проверить наличие клиента в списке, добавить, переместить или удалить клиента из списка.
Например, проверим состоит ли клиент в списке с номером 12333:
Очень удобно использовать списки при выводе статистических данных:
Часто возникает необходимость получить общее количество уникальных записей в наборе списков - это легко достичь применением функции lists_joint_count()
Создать новый список
create_list()
Укажите в поле Калькулятор в настройках блока функцию
create_list(spisok) - создание нового списка. Результат - номер списка
Параметры:
! spisok - наименование списка. Наименование задается в одинарных кавычках
Создание списка из блока без создания дубля
create_list_if_not_exist()
create_list_if_not_exist('list_name') - создает новый список, если с таким именем еще нет и возвращает идентификатор или вернет идентификатор существующего
Обязательный параметр:
list_name - Название для создания нового списка
Добавление клиента в список
add_to_list()
add_to_list(spisok, client_id)- добавление клиента в список. Результат функции - none
Параметры:
! spisok - номер списка
client_id - идентификатор клиента Salebot. Если не передан, то используется идентификатор текущего клиента
Перемещение клиента в список
move_to_list()
move_to_list(spisok, client_id) – перемещение клиента в список (Важно! клиент удаляется из всех других списков и перемещается в указанный). Результат - булево значение (True или False)
Параметры:
! spisok - номер списка
client_id - идентификатор клиента Salebot. Если не передан, то используется идентификатор текущего клиента
Удаление клиента из списка
remove_from_list()
remove_from_list(spisok, client_id) – удаление из списка клиента с заданным client_id
Параметры:
! spisok - номер списка
client_id - идентификатор клиента Salebot. Если не передан, то используется идентификатор текущего клиента
Удаление списков
remove_list_from_project(list_id, clear_list)
! list_id — обязательный параметр, это id списка, который нужно удалить
clear_list — необязательный параметр, принимает 2 значения True или False (по умолчанию False), если не передавать его и если список содержит клиентов, вы получите ответ следующего вида: «Can't delete list, list not empty» если список пустой, то список спокойно удалиться, если же в clear_list установить значение True, то список удалиться в независимости от того, есть там клиенты или нет.
Очистить список клиентов
clear_list()
clear_list(list_id) - очистка списка клиентов
Параметры:
! list_id - номер списка. После использования все клиенты будут удалены из указанного списка.
Узнать количество клиентов в списке
list_size()
list_size(spisok) – для подсчета общего количества клиентов в списке
Параметры:
! spisok - номер списка
Подсчитать количество уникальных записей о клиентах в нескольких списках
lists_joint_count()
lists_joint_count(massive_list) – для подсчета общего количества уникальных записей о клиентах, которые находятся в нескольких списках. На вход функция принимает массив с номерами списков. Результат - число.
Параметры:
! massive_list - массив с перечнем списков, в котором будем производить подсчет уникальных записей клиента. Записывается в формате: '[list_id1, list_id2, ..., listidN]'
Проверить есть ли клиент в списке
inlist()
inlist(spisok,client_id) - для проверки наличия пользователей в списке. Результат - булево значение (True или False)
Параметры:
! spisok - номер списка
client_id - идентификатор клиента Salebot. Если не передан, то используется идентификатор текущего клиента
Проверить состоит ли участник чата в определенном списке
some_client_in_list()
some_client_in_list(list_id, recepient)
Параметры: ! list_id - номер списка; ! recepient - это значение id в мессенджере проверяемого (platform_id). Для чатов значение переменной chat_member_id.
Возвращаемый результат: True - клиент есть в списке; False - клиента нет в указанном списке.
Возвращение элементов из списка
count_occurrences()
count_occurrences(array, element) - возвращает число указанных элементов, содержащихся в списке
array - обязательный параметр, список элементов
element - обязательный параметр, элемент, который необходимо посчитать
Last updated
