Izveidot jaunu ierakstu tabulā ar norādītajām vērtībām
Izveido jaunu ierakstu tabulā ar norādītajām vērtībām.
new_record(table_id, data)
| Parametri | Apraksts |
|---|---|
| table_id | Tabulas ID |
| data | vārdnīca ar datiem, kas jāieraksta. Piemērs: {"column_name1": "value1", "column_name2": "value2"}. Ja kolonna neeksistē, tā tiek izveidota. |
Atbilde: jaunā ieraksta ID
Piemērs
Rediģēt esošu ierakstu tabulā
edit_record(table_id, record_id, data)
| Parametri | Apraksts |
|---|---|
| table_id | Tabulas ID |
| record_id | Rediģējamā ieraksta ID |
| data | vārdnīca ar datiem, kas jārediģē. Piemērs: {"column_name1": "value3", "column_name2": "value4"}. Ja kolonna neeksistē, tā NAV izveidota. |
Atbilde:
Atgriež pilnus rediģētā ieraksta datus formātā: {"column_name1": "value3", "column_name2": "value4"}.
Piemērs
Dzēst ierakstu no tabulas pēc tā ID
delete_record(table_id, record_id)
| Parametri | Apraksts |
|---|---|
| table_id | Tabulas ID |
| record_id | Dzēšamā ieraksta ID |
Atbilde:
{'message': 'Deleted records: 1'}
Atrast ierakstu tabulā pēc norādītās vērtības
find_record(table_id, value, find_in, return_from)
| Parametri | Apraksts |
|---|---|
| table_id | Tabulas ID |
| value | vērtība, kas jāatbilst |
| find_in - | neobligāts parametrs. Kolonnas nosaukums, pēc kuras meklēt. Ja nav norādīts, meklēšana tiks veikta visās kolonnās. |
| return_from | neobligāts parametrs. Kolonnas nosaukums, no kuras atgriezt vērtību. |
Atbilde:
Ja ir norādīts return_from, tiks atgriezta vērtība no norādītās kolonnas (ja tā pastāv tabulā). Ja return_from nav norādīts vai kolonna neeksistē, atbildē tiks atgriezti pilni atrastā ieraksta dati, piemēram: {"column_name1": "value3", "column_name2": "value4"}.
Piemērs
Iegūt vērtību no norādītā ieraksta
get_record_data(table_id, record_id)
| Parametri | Apraksts |
|---|---|
| table_id | Tabulas ID |
| record_id | Ieraksta ID, no kura tiek iegūtas vērtības |
| return_column | neobligāts parametrs. Kolonnas nosaukums, no kuras jāatgriež vērtība. |
Atbilde: Ja ieraksts ir atrasts, tiek atgriezta vārdnīca, piemēram, {"column_name1": "value1", "column_name2": "value2"}. Ja ir norādīts return_column parametrs un šāda kolonna pastāv, tiks atgriezta tikai vērtība no šīs kolonnas.
Kur var atrast tabulas ID?
Lai strādātu ar čatbota funkcijām, jums būs nepieciešams tabulas ID. Atrodiet vēlamo tabulu sarakstā un noklikšķiniet uz tās.
Pēc tam noklikšķiniet uz adreses joslas.
Adreses joslā jūs redzēsiet URL, piemēram, https://salebot.pro/projects/11111/table/2, kur varat atrast vēlamās tabulas ID:
Iegūt ierakstu no tabulas
get_records_from_table(table_id, start_row, count, start_col, end_col) - ieraksta iegūšana no tabulas.
| Parametrs | Apraksts | Piezīme |
|---|---|---|
| table_id | Tabulas ID | |
| start_row | Neobligāts parametrs, vesels skaitlis. Norāda rindu diapazona sākumu. | Rindas numurs, no kura sākt lasīšanu (ieskaitot). Rakstiet bez pēdiņām. |
| count | Neobligāts parametrs, vesels skaitlis. Norāda iegūstamo rindu skaitu. | Pēc noklusējuma vērtība ir 1000, maksimāli 5000. Norādiet bez pēdiņām. |
| start_col | Neobligāts parametrs, virkne. Norāda kolonnu diapazona sākumu. | Kolonnas nosaukums, no kuras sākt lasīšanu (ieskaitot). Rakstiet pēdiņās. |
| end_col | Neobligāts parametrs, virkne. Norāda kolonnu diapazona beigas. | Kolonnas nosaukums, līdz kurai lasīt tabulas vērtības (ieskaitot). Rakstiet pēdiņās. |
Ja norādāt tikai rindu vai kolonnu diapazona sākumu, tiks atgriezti visi dati no šī punkta. Varat arī izlaist sākumu un norādīt tikai beigas, lai iegūtu datus līdz šim punktam.
Piemērs
Blokā, kurā nepieciešams iegūt ierakstus no tabulas, dodieties uz sadaļu "Kalkulators" bloka iestatījumos un ievadiet funkciju ar nepieciešamajiem parametriem.
Apskatīsim, kā dati tiek parādīti tabulā.
Tagad izpildiet bloku "Sākums" testa režīmā.
Mēs varam redzēt datus, kas tika ierakstīti mainīgajā no tabulas, botā nosūtītajā ziņojumā. Tā kā mēs atsaucāmies uz mainīgo ziņojumā, izmantojot #{} sintaksi, tajā saglabātie dati tika parādīti bota tērzēšanā.
Iegūt datus no tabulas norādītajā diapazonā
table_read_cells(table_id, cell_data) - ļauj iegūt datus no tabulas, norādot diapazonus.
| Parametrs | Apraksts |
|---|---|
| **!** table_id | obligāts parametrs, tabulas ID |
| **!** cell_data | obligāts parametrs, vārdnīca ar diapazoniem. cell_data piemērs: '{"a1":"a1", "a3": "b4", "c1": "c3"}'
|
Ja pieprasījuma laikā neradās problēmas, atbilde būs vārdnīca, kas satur statusu un visas šūnas ar to vērtībām:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"vai, kļūdas gadījumā: {"status": false, "err": "Kļūdas ziņojums vai apraksts"}
Piemērs kalkulatorā
Piemēram, tabulas šūnās ir norādītas šādas vērtības:
Lai iegūtu datus no tabulas caur botu, nododiet nepieciešamos diapazonus funkcijām Kalkulatorā.
Piemērā konstrukcija #{res}, kas satur mainīgo, palīdz ziņojumā parādīt datus, kas iegūti, izmantojot funkciju un norādīto diapazonu:
Ja kolonnu nosaukumi ir atšķirīgi (piemēram, "Produkts", "Skaits", "Summa"), jums jānorāda diapazons, izmantojot formātu {"Product1":"Amount3"}, kur:
• Product ir pirmās kolonnas nosaukums
• 1 norāda, ka tā ir 1. kolonna
• Amount ir trešās kolonnas nosaukums
• 3 norāda, ka tā ir 3. kolonna
