Izveidot / noņemt etiķeti
create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()
Apraksts
MaviBot etiķetes tiek attēlotas klienta profilā šādi:

un sadaļā "Saraksti" :

create_label(etiķetes_nosaukums)
izveido MaviBot birku ar norādīto nosaukumu
Parametri:\ ! etiķetes_nosaukums- birgas nosaukums, norādīts vienpēdiņās ('').
add_label(etiķetes_nosaukums, klienta_id)
pievieno MaviBot birku klientam
Parametri:\ ! etiķetes_nosaukums - birgas nosaukums, norādīts vienpēdiņās ('')
klienta_id klienta ID. Ja izlaists, tiek izmantots pašreizējā klienta ID
remove_label(etiķetes_nosaukums, klienta_id)
noņem birku no klienta
Parametri:\ ! etiķetes_nosaukums - birgas nosaukums, norādīts vienpēdiņās ('')
klienta_id - klienta ID. Ja izlaists, tiek izmantots pašreizējā klienta ID
has_label(etiķetes_nosaukums, klienta_id) - pārbauda, vai klientam ir birka
Parametri:\ ! etiķetes_nosaukums - birgas nosaukums, norādīts vienpēdiņās ('')
klienta_id - klienta ID. Ja izlaists, tiek izmantots pašreizējā klienta ID
remove_label_everywhere(etiķetes_nosaukums)
noņem birku no visiem klientiem
Parametri:\ ! etiķetes_nosaukums- birgas nosaukums, norādīts vienpēdiņās ('')
count_of_clients_with_label(etiķetes_nosaukums)
iegūst kopējo klientu skaitu ar birku
Parametri:\ ! etiķetes_nosaukums- birgas nosaukums, norādīts vienpēdiņās ('')
Piemērs
Tātad, apskatīsim, kā tiek izveidota MaviBot birka.
Jums vienkārši vienreiz jāizpilda izveides funkcija pelēkajā blokā (bezstāvokļa blokā), piemēram:

Tajā pašā laikā mainīgo a var izmantot, lai analizētu birgas izveides funkcijas veiksmi:

Tālāk jūs varat piešķirt birku jebkuram klientam, pievienojot funkciju add_label() attiecīgajā jūsu piltuves blokā:



Jūs varat pārbaudīt, vai klientam ir birka, izmantojot funkciju has_label():

Funkcija atgriež loģisku vērtību: True vai False.

Citas ar birku saistītas darbības tiek veiktas līdzīgi — birgas noņemšana no konkrēta klienta vai birgas pilnīga noņemšana no visiem klientiem.
Varat arī saskaitīt klientu skaitu ar noteiktu birku, izmantojot funkciju count_of_clients_with_label().

Koda piemērs kopēšanai
/Izveidot birku/ a=create_label('birka1')
/Piešķirt birku klientam/ a=add_label('1. posms')
/Pārbaudīt, vai klientam ir birka/ a=has_label('1. solis','73704021')
/Saskaitīt klientu skaitu ar noteiktu birku/ solis1=count_of_clients_with_label('1. posms') prece1=count_of_clients_with_label('1')
Birgas izveide
Apraksts
create_label(etiķetes_nosaukums) - izveido MaviBot birku ar norādīto nosaukumu
Parametri:
! etiķetes_nosaukums- birgas nosaukums, norādīts vienpēdiņās ('')
Birgas izveide bez dublikātiem
Apraksts
create_label_if_not_exist(nosaukums, krāsa) - izveido jaunu birku, ja tāda ar tādu pašu nosaukumu vēl neeksistē, un atgriež tās identifikatoru; pretējā gadījumā atgriež esošās birgas identifikatoru
nosaukums — birgas nosaukums
krāsa — birgas krāsa (noklusējums: 0)
Krāsu tabula parametram krāsa:
0 — gaiši pelēks
1 — dzeltens
2 — zils
3 — sarkans
4 — rozā
5 — bēšs
6 — violets
7 — gaiši zils
8 — pelēks
9 - zaļš
Iegūt visas klienta birgas
Apraksts
get_all_client_labels(klienta_id)
Parametri:
klienta_id - neobligāts; ja nav norādīts, tiks iegūtas pašreizējā klienta birgas.
Funkcija atgriež atbildi JSON formātā: {"161":"birka1","228":"birka2"}, kur: atslēga ir birgas ID, un vērtība ir birgas nosaukums
Piemērs

Dzēst klienta birgas pēc masīva
Apraksts
remove_multiple_client_labels(birgu_masīvs, nosaukumi) - dzēš masīvā norādītās birgas
birgu_masīvs - birgu masīvs. VAI ID masīvs****,**** VAI nosaukumu masīvs.
Ja tiek nodots nosaukumu masīvs, tad**❗obligāti jānodod otrais parametrs (nosaukumi), kas iestatīts uz 1.**
nosaukumi - Iestatīt uz 1, ja masīvs satur birgu nosaukumus, nevis ID. Tas norāda, ka masīvs sastāv no nosaukumiem.
Nav atļauts vienā funkcijā apvienot gan birgu ID, gan birgu nosaukumus!
Piemērs
/*Dzēst birgas pēc ID*/
r = remove_multiple_client_labels('[138,169,166]')
/*Dzēst birgas pēc birgas nosaukuma*/
r2 = remove_multiple_client_labels('["newTestTag","tag2"]', 1)
Mainīgais saglabā funkcijas izpildes rezultātu: vai nu kļūdas ziņojumu, vai skaitli, kas norāda, cik birgas tika dzēstas.

Atrast klientus pēc vairākām birkām
Apraksts
find_clients_by_multiple_labels(birgu_masīvs, nosaukumi) - atrod klientus pēc vairākām birkām
SVARĪGI! Tas atrod tikai tos klientus, kuriem ir VISAS norādītās birgas.
Parametri:
birgu_masīvs - birgu masīvs. VAI ID masīvs****,**** VAI nosaukumu masīvs.
Ja tiek nodots nosaukumu masīvs, tad**❗obligāti jānodod otrais parametrs (nosaukumi), kas iestatīts uz 1.**
nosaukumi - Iestatīt uz 1, ja masīvs satur birgu nosaukumus, nevis ID. Tas norāda, ka masīvs sastāv no nosaukumiem.
Nav atļauts vienā funkcijā apvienot gan birgu ID, gan birgu nosaukumus!
Atgriež klientu ID masīvu (klienta_id): [41121, 41192, 41522]
Piemērs
/*Atrast klientus, kuriem ir visas norādītās birgas pēc ID*/
r = find_clients_by_multiple_labels('[138,169,166]')
/*Atrast klientus, kuriem ir visas norādītās birgas pēc birgu nosaukumiem*/
r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)

Pārbaudīt klienta birgu masīvu
Apraksts
has_client_multiple_labels(birgu_masīvs, nosaukumi) - pārbauda klienta birgu masīvu
SVARĪGI! Tas atgriež True, ja klientam ir visas norādītās birgas!
Parametri:
birgu_masīvs - birgu masīvs. VAI ID masīvs****,**** VAI nosaukumu masīvs.
Ja tiek nodots nosaukumu masīvs, tad**❗obligāti jānodod otrais parametrs (nosaukumi), kas iestatīts uz 1.**
nosaukumi - Iestatīt uz 1, ja masīvs satur birgu nosaukumus, nevis ID. Tas norāda, ka masīvs sastāv no nosaukumiem.
Nav atļauts vienā funkcijā apvienot gan birgu ID, gan birgu nosaukumus!
Atgriež vai nu kļūdu, vai True, ja klientam ir visas birgas no masīva, vai False, ja klientam nav visas birgas.
Piemērs
/*Pārbaudīt, vai klientam ir visas norādītās birgas pēc ID*/
r = has_client_multiple_labels('[138,169,166]')
/*Pārbaudīt, vai klientam ir visas norādītās birgas pēc birgu nosaukumiem*/
r2 = has_client_multiple_labels('["newTestTag","tag2"]', 1)

Iegūt visus klienta birgu ID
Apraksts
get_all_client_label_ids(klienta_id) — atgriež masīvu, kas satur visu klientam piešķirto birgu ID.
Ja klientam nav birgu, funkcija atgriež tukšu masīvu: [].
Parametri:
-
klienta_id— Mavibot klienta ID. Ja izlaists, tiek izmantots pašreizējā klienta ID.