Cipta rekod baharu dalam jadual dengan nilai yang ditentukan
Cipta rekod baharu dalam jadual dengan nilai yang ditentukan.
new_record(table_id, data)
Respons: ID rekod baharu
Contoh
Edit rekod sedia ada dalam jadual
edit_record(table_id, record_id, data)
Respons:
Mengembalikan data penuh rekod yang diedit dalam format: {"column_name1": "value3", "column_name2": "value4"}.
Contoh
Padam rekod daripada jadual mengikut ID
delete_record(table_id, record_id)
Respons:
{'message': 'Deleted records: 1'}
Cari rekod dalam jadual mengikut nilai yang ditentukan
find_record(table_id, value, find_in, return_from)
Respons:
Jika return_from dinyatakan, nilai dari lajur yang ditentukan (jika wujud dalam jadual) akan dikembalikan. Jika return_from tidak dinyatakan atau lajur tidak wujud, data penuh rekod yang ditemui akan dikembalikan dalam respons, contohnya: {"column_name1": "value3", "column_name2": "value4"}.
Contoh
Mendapatkan nilai daripada rekod yang ditentukan
get_record_data(table_id, record_id)
Respons: Jika rekod ditemui, kamus seperti {"column_name1": "value1", "column_name2": "value2"} dikembalikan. Jika parameter return_column disediakan dan lajur tersebut wujud, hanya nilai dari lajur itu akan dikembalikan.
Di mana saya boleh mencari ID jadual?
Untuk bekerja dengan fungsi chatbot, anda memerlukan ID jadual. Cari jadual yang dikehendaki dalam senarai dan klik padanya.
Seterusnya, klik bar alamat.
Dalam bar alamat, anda akan melihat URL seperti
https://salebot.pro/projects/11111/table/2,
di mana anda boleh mencari ID jadual yang dikehendaki:
Mendapatkan rekod daripada jadual
get_records_from_table(table_id, start_row, count, start_col, end_col) - mendapatkan rekod daripada jadual.
| Parameter | Penerangan | Nota |
|---|---|---|
| table_id | ID jadual | |
| start_row | Parameter pilihan, integer. Menentukan permulaan julat baris. | Nombor baris untuk mula membaca (termasuk). Tulis tanpa tanda petik. |
| count | Parameter pilihan, integer. Menentukan bilangan baris untuk diambil. | Secara lalai, nilai adalah 1000, dengan maksimum 5000. Nyatakan tanpa tanda petik. |
| start_col | Parameter pilihan, rentetan. Menentukan permulaan julat lajur. | Nama lajur untuk mula membaca (termasuk). Tulis dalam tanda petik. |
| end_col | Parameter pilihan, rentetan. Menentukan penghujung julat lajur. | Nama lajur untuk membaca nilai jadual sehingga (termasuk). Tulis dalam tanda petik. |
Jika anda hanya menentukan permulaan julat baris atau lajur, semua data dari titik itu akan dikembalikan. Anda juga boleh meninggalkan permulaan dan hanya menentukan penghujung untuk mendapatkan data sehingga titik itu.
Contoh
Dalam blok di mana anda perlu mendapatkan rekod daripada jadual, pergi ke bahagian "Kalkulator" dalam tetapan blok dan masukkan fungsi dengan parameter yang diperlukan.
Mari lihat bagaimana data dipaparkan dalam jadual.
Sekarang, laksanakan blok "Mula" dalam mod ujian.
Kita boleh melihat data yang ditulis ke dalam pembolehubah dari jadual dalam mesej yang dihantar oleh bot. Kerana kita merujuk pembolehubah dalam mesej menggunakan sintaks #{}, data yang disimpan di dalamnya dipaparkan dalam sembang bot.
Dapatkan data daripada jadual dalam julat yang ditentukan
table_read_cells(table_id, cell_data) - membolehkan mendapatkan data daripada jadual dengan menentukan julat.
Jika tiada masalah berlaku semasa permintaan, respons akan menjadi kamus yang mengandungi status dan semua sel dengan nilainya:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"atau, sekiranya berlaku ralat: {"status": false, "err": "Mesej atau penerangan ralat"}
Contoh dalam Kalkulator
Sebagai contoh, sel jadual mengandungi nilai yang ditentukan berikut:
Untuk mendapatkan data daripada jadual melalui bot, hantar julat yang diperlukan kepada fungsi dalam Kalkulator.
Dalam contoh, binaan #{res}, yang memegang pembolehubah, membantu memaparkan dalam mesej data yang diperoleh menggunakan fungsi dan julat yang ditentukan:
Jika nama lajur berbeza (contohnya, "Produk", "Nombor", "Jumlah"), anda mesti menentukan julat menggunakan format {"Product1":"Amount3"}, di mana:
• Product adalah nama lajur pertama
• 1 menunjukkan ia adalah lajur nombor 1
• Amount adalah nama lajur ketiga
• 3 menunjukkan ia adalah lajur nombor 3
