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