Trabajar con listas
Crear una nueva lista
create_list()
Introduzca la función en el "Calculadora" campo en la configuración del bloque:
create_list(name) - crea una nueva lista. El resultado es el ID de la lista.
Parámetros:
! name - nombre de la lista. El nombre se especifica entre comillas simples.
list_id = create_list("registered")
Crear una lista desde el bloque sin duplicados
create_list_if_not_exist()
create_list_if_not_exist('list_name') - crea una nueva lista si aún no existe una con el nombre dado y devuelve su identificador, o devuelve el identificador de la lista existente.
Parámetro obligatorio:
list_name - nombre de la nueva lista que se va a crear.
new_list = create_list_if_not_exist('Lista de participantes')Añadir un cliente a la lista
add_to_list()
add_to_list(list_id, client_id) - añade un cliente a una lista. La función no devuelve nada.
Parámetros:
! list_id - ID de la lista
client_id - ID de cliente de MaviBot. Si no se proporciona, se usa el ID del cliente actual.
Mover un cliente a la lista
move_to_list()
move_to_list(list_id, client_id) - mueve un cliente a la lista (¡Importante! El cliente se elimina de todas las demás listas y se mueve a la especificada). El resultado es un valor booleano (True o False).
Parámetros:
! list_id - ID de la lista
client_id - ID de cliente de MaviBot. Si no se proporciona, se usa el ID del cliente actual.
Eliminar un cliente de la lista
remove_from_list()
remove_from_list(list_id, client_id) - elimina de la lista a un cliente con el client_id especificado.
Parámetros:
! list_id - ID de la lista
client_id - ID de cliente de MaviBot. Si no se proporciona, se usa el ID del cliente actual.
Eliminar listas
remove_list_from_project(list_id, clear_list)
! list_id - parámetro obligatorio; el ID de la lista que se va a eliminar.
clear_list — parámetro opcional; acepta dos valores: True o False (el valor predeterminado es False).
Si no proporciona este parámetro y la lista contiene clientes, recibirá la siguiente respuesta: "No se puede eliminar la lista, la lista no está vacía"
Si la lista está vacía, se eliminará sin problemas. Sin embargo, si establece clear_list en True, la lista se eliminará independientemente de si contiene clientes o no.
Eliminar etiquetas
remove_label_from_project(list_id, clear_list)
! list_id - parámetro obligatorio; el ID de la etiqueta que se va a eliminar.
clear_list - parámetro opcional; acepta dos valores: True o False (el valor predeterminado es False).
Si este parámetro no se proporciona y la etiqueta está asignada a clientes, recibirá la siguiente respuesta: "No se puede eliminar la lista, la lista no está vacía"
Si la etiqueta no está asignada a ningún cliente, se eliminará sin problemas. Sin embargo, si clear_list se establece en True, la etiqueta se eliminará independientemente de si está asignada a clientes o no.
Vaciar la lista de clientes
clear_list()
clear_list(list_id) - vacía la lista de clientes
Parámetros:
! list_id - ID de la lista. Después de usarla, todos los clientes se eliminarán de la lista especificada.
Obtener el número de clientes en la lista
list_size()
list_size(list_id) – cuenta el número total de clientes en la lista
Parámetros:
! list_id- ID de la lista
Contar el número de entradas de clientes únicos en varias listas
lists_joint_count()
lists_joint_count(massive_list) – cuenta el número total de entradas de clientes únicos en varias listas. La función toma como entrada un array de IDs de lista y devuelve un número.
Parámetros:
! massive_list - un array que contiene los IDs de las listas en las que se contarán las entradas de clientes únicos. El formato es: ['list_id1', 'list_id2', ..., 'list_idN']
Comprobar si un cliente está en la lista
inlist()
inlist(list_id,client_id) - comprueba si un cliente está en la lista. El resultado es un valor booleano (True o False).
Parámetros:
! list_id - ID de la lista
client_id - ID de cliente de MaviBot. Si no se proporciona, se usa el ID del cliente actual.
Comprobar si un participante del chat está en una lista específica
some_client_in_list()
some_client_in_list(list_id, recepient)
Parámetros:
! list_id - ID de la lista;
! recepient - ID de usuario de mensajería que se está comprobando (platform_id). Para chats, el valor de la variable es chat_member_id.
Devuelve valores:
True - el cliente está en la lista;
False - el cliente no está en la lista especificada.
Recuperar elementos de una lista
count_occurrences()
count_occurrences(array, element) - devuelve el número de elementos especificados contenidos en la lista.
Parámetros:
arreglo - parámetro obligatorio; lista de elementos
element - parámetro obligatorio; elemento a contar
Obtener un ID de cliente aleatorio de la lista
random_list_member(list_id)
random_list_member(list_id) - devuelve un ID de cliente aleatorio en la lista especificada.
list_id - parámetro obligatorio, ID de la lista.
El ID de la lista, que contiene a sus clientes, se puede encontrar en "Listas" :
Ejemplo de trabajo con listas en la Calculadora
ejemplo
Veamos un ejemplo de uso de funciones en la "Calculadora" para trabajar con listas.
¡Importante! Necesita guardar un nuevo ID de lista para poder usarlo más tarde. Para ello, asigne el resultado de la función a una variable, es decir, list_id = ...
Ahora puede realizar fácilmente otras operaciones con la lista: comprobar si un cliente está en la lista, añadir, mover o eliminar un cliente.
Por ejemplo, comprobemos si un cliente está en la lista con ID 12333:
Es muy conveniente usar listas al mostrar datos estadísticos:
A menudo es necesario obtener el número total de entradas únicas en un conjunto de listas; esto se puede hacer fácilmente usando la lists_joint_count() función.
a
Última actualización