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.