Arbeiten mit Listen

Neue Liste erstellen

create_list()

Beschreibung

Geben Sie die Funktion im Feld "Rechner" in den Blockeinstellungen ein:

create_list(name) - erstellt eine neue Liste. Das Ergebnis ist die Listen-ID.

Parameter:

! name - Listenname. Der Name wird in einfachen Anführungszeichen angegeben.

Beispiel

list_id = create_list("registered")

Liste aus dem Block ohne Duplikate erstellen

create_list_if_not_exist()

Beschreibung

create_list_if_not_exist('list_name') - erstellt eine neue Liste, falls noch keine mit dem angegebenen Namen existiert, und gibt deren Kennung zurück, oder gibt die Kennung der vorhandenen Liste zurück.

Erforderlicher Parameter:

list_name - Name für die zu erstellende neue Liste.

Beispiel

new_list = create_list_if_not_exist('List of participants')

Einen Kunden zur Liste hinzufügen

add_to_list()

Beschreibung

add_to_list(list_id, client_id) - fügt einen Kunden zu einer Liste hinzu. Die Funktion gibt "none" zurück.

Parameter:

! list_id - Listen-ID

client_id - MaviBot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.

Einen Kunden in die Liste verschieben

move_to_list()

Beschreibung

move_to_list(list_id, client_id) - verschiebt einen Kunden in die Liste (Wichtig! Der Kunde wird aus allen anderen Listen entfernt und in die angegebene verschoben). Das Ergebnis ist ein boolescher Wert (True oder False).

Parameter:

! list_id - Listen-ID

client_id - MaviBot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.

Einen Kunden aus der Liste entfernen

remove_from_list()

Beschreibung

remove_from_list(list_id, client_id) - entfernt einen Kunden mit der angegebenen client_id aus der Liste.

Parameter:

! list_id - Listen-ID

client_id - MaviBot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.

Listen löschen

remove_list_from_project(list_id, clear_list)

Beschreibung
! list_id - erforderlicher Parameter; die ID der zu löschenden Liste.

clear_list — optionaler Parameter; akzeptiert zwei Werte: True oder False (Standard ist False).

Wenn Sie diesen Parameter nicht angeben und die Liste Kunden enthält, erhalten Sie die folgende Antwort:
"Can't delete list, list not empty"

Wenn die Liste leer ist, wird sie problemlos gelöscht. Wenn Sie jedoch clear_list auf True setzen, wird die Liste unabhängig davon gelöscht, ob sie Kunden enthält oder nicht.

Tags löschen

remove_label_from_project(list_id, clear_list)

Beschreibung
! list_id - erforderlicher Parameter; die ID des zu löschenden Tags.

clear_list - optionaler Parameter; akzeptiert zwei Werte: True oder False (Standard ist False).

Wenn dieser Parameter nicht angegeben wird und das Tag Kunden zugewiesen ist, erhalten Sie die folgende Antwort:
"Can't delete list, list not empty"

Wenn das Tag keinem Kunden zugewiesen ist, wird es problemlos gelöscht. Wenn jedoch clear_list auf True gesetzt ist, wird das Tag unabhängig davon gelöscht, ob es Kunden zugewiesen ist oder nicht.

Kundenliste leeren

clear_list()

Beschreibung

clear_list(list_id) - leert die Kundenliste

Parameter:

! list_id - Listen-ID. Nach der Verwendung werden alle Kunden aus der angegebenen Liste entfernt.

Anzahl der Kunden in der Liste abrufen

list_size()

Beschreibung

list_size(list_id) – zählt die Gesamtzahl der Kunden in der Liste

Parameter:

! list_id- Listen-ID

Anzahl der eindeutigen Kundeneinträge über mehrere Listen hinweg zählen

lists_joint_count()

Beschreibung

lists_joint_count(massive_list) – zählt die Gesamtzahl der eindeutigen Kundeneinträge über mehrere Listen hinweg. Die Funktion nimmt ein Array von Listen-IDs als Eingabe und gibt eine Zahl zurück.

Parameter:

! massive_list - ein Array, das die Listen-IDs enthält, in denen die eindeutigen Kundeneinträge gezählt werden. Das Format ist: ['list_id1', 'list_id2', ..., 'list_idN']

Codebeispiel zum Kopieren

/*Creating a list*/
list_id = create_list('New list')

/*Check if the client is in the list*/
k=inlist(list_id, client_id)

/*Get the size of the list — total number of clients in the list*/
razm=list_size(1)

/*Get the total number of unique client entries across multiple lists*/
k=lists_joint_count('[144636,144634]')

Prüfen, ob ein Kunde in der Liste ist

inlist()

Beschreibung

inlist(list_id,client_id) - prüft, ob ein Kunde in der Liste ist. Das Ergebnis ist ein boolescher Wert (True oder False).

Parameter:

! list_id - Listen-ID

client_id - MaviBot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.

Prüfen, ob ein Chat-Teilnehmer in einer bestimmten Liste ist

some_client_in_list()

Beschreibung

some_client_in_list(list_id, recepient)

Parameter:

! list_id - Listen-ID;

! recepient - zu prüfende Messenger-Benutzer-ID (platform_id). Für Chats ist der Wert der Variable chat_member_id.

Rückgabewerte:

True - Kunde ist in der Liste;

False - Kunde ist nicht in der angegebenen Liste.

Beispiel

Codebeispiel zum Kopieren

/*Example of checking if a chat participant is in the list, where the first parameter is the list ID, and the second is the user's chat ID*/

r = some_client_in_list(123456, chat_member_id)

Elemente aus einer Liste abrufen

count_occurrences()

Beschreibung

count_occurrences(array, element) - gibt die Anzahl der angegebenen Elemente zurück, die in der Liste enthalten sind.

Parameter:

array - erforderlicher Parameter; Liste von Elementen

element - erforderlicher Parameter; zu zählendes Element

Zufällige Kunden-ID aus der Liste abrufen

random_list_member(list_id)

Beschreibung

random_list_member(list_id) - gibt eine zufällige Kunden-ID in der angegebenen Liste zurück.

list_id - erforderlicher Parameter, Listen-ID.

Die Listen-ID, die Ihre Kunden enthält, finden Sie im Abschnitt "Listen":

Beispiel für die Arbeit mit Listen im Rechner

Schauen wir uns ein Beispiel für die Verwendung von Funktionen im "Rechner" für die Arbeit mit Listen an.

Wichtig! Sie müssen eine neue Listen-ID speichern, um sie später verwenden zu können. Weisen Sie dazu das Funktionsergebnis einer Variable zu, d.h. list_id = ...

Jetzt können Sie problemlos andere Operationen mit der Liste durchführen – prüfen, ob ein Kunde in der Liste ist, einen Kunden hinzufügen, verschieben oder entfernen.

Prüfen wir zum Beispiel, ob ein Kunde in der Liste mit der ID 12333 ist:

Es ist sehr praktisch, Listen bei der Anzeige von statistischen Daten zu verwenden:

Häufig ist es notwendig, die Gesamtzahl der eindeutigen Einträge über eine Reihe von Listen zu erhalten – dies kann einfach mit der Funktion lists_joint_count() erfolgen.

Alle Kundenlisten-IDs abrufen

get_all_client_label_ids(client_id)

Beschreibung

get_all_client_list_ids(client_id) — gibt ein Array zurück, das die IDs aller Listen enthält, zu denen der Kunde gehört.

Wenn der Kunde zu keiner Liste gehört, gibt die Funktion ein leeres Array zurück: [].

Parameter:

client_id — die Mavibot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.