สร้างระเบียนใหม่ในตารางด้วยค่าที่ระบุ

สร้างระเบียนใหม่ในตารางด้วยค่าที่ระบุ

new_record(table_id, data)

การตอบกลับ: ID ของระเบียนใหม่

ตัวอย่าง

แก้ไขระเบียนที่มีอยู่ในตาราง

edit_record(table_id, record_id, data)

การตอบกลับ:

ส่งคืนข้อมูลทั้งหมดของระเบียนที่ถูกแก้ไขในรูปแบบ: {"column_name1": "value3", "column_name2": "value4"}

ตัวอย่าง

ลบระเบียนออกจากตารางตาม ID

delete_record(table_id, record_id)

การตอบกลับ:

{'message': 'Deleted records: 1'}

ค้นหาระเบียนในตารางตามค่าที่ระบุ

find_record(table_id, value, find_in, return_from)

การตอบกลับ:

หากระบุ return_from จะส่งคืนค่าจากคอลัมน์ที่ระบุ (ถ้ามีอยู่ในตาราง) หากไม่ระบุ return_from หรือคอลัมน์ไม่มีอยู่ จะส่งคืนข้อมูลทั้งหมดของระเบียนที่พบในรูปแบบ เช่น {"column_name1": "value3", "column_name2": "value4"}

ตัวอย่าง

ดึงค่าจากระเบียนที่ระบุ

get_record_data(table_id, record_id)

การตอบกลับ: หากพบระเบียน จะส่งคืนพจนานุกรมเช่น {"column_name1": "value1", "column_name2": "value2"} หากระบุพารามิเตอร์ return_column และคอลัมน์ดังกล่าวมีอยู่ จะส่งคืนเฉพาะค่าจากคอลัมน์นั้น

จะหา ID ของตารางได้ที่ไหน?

ในการทำงานกับฟังก์ชันของแชทบอท คุณจะต้องใช้ ID ของตาราง ค้นหาตารางที่ต้องการในรายการแล้วคลิกที่ตารางนั้น

จากนั้นคลิกที่แถบที่อยู่

ในแถบที่อยู่ คุณจะเห็น URL เช่น
https://salebot.pro/projects/11111/table/2,
ซึ่งคุณสามารถหา ID ของตารางที่ต้องการได้:

ดึงระเบียนจากตาราง

get_records_from_table(table_id, start_row, count, start_col, end_col) - ดึงระเบียนจากตาราง

พารามิเตอร์ คำอธิบาย หมายเหตุ
table_id ID ของตาราง
start_row พารามิเตอร์เสริม จำนวนเต็ม ระบุจุดเริ่มต้นของช่วงแถว หมายเลขแถวที่เริ่มอ่าน (รวม) ระบุโดยไม่ต้องใส่เครื่องหมายคำพูด
count พารามิเตอร์เสริม จำนวนเต็ม ระบุจำนวนแถวที่จะดึง ค่าเริ่มต้นคือ 1000 สูงสุด 5000 ระบุโดยไม่ต้องใส่เครื่องหมายคำพูด
start_col พารามิเตอร์เสริม สตริง ระบุจุดเริ่มต้นของช่วงคอลัมน์ ชื่อของคอลัมน์ที่เริ่มอ่าน (รวม) ระบุในเครื่องหมายคำพูด
end_col พารามิเตอร์เสริม สตริง ระบุจุดสิ้นสุดของช่วงคอลัมน์ ชื่อของคอลัมน์ที่อ่านค่าตารางจนถึง (รวม) ระบุในเครื่องหมายคำพูด

หากคุณระบุเฉพาะจุดเริ่มต้นของช่วงแถวหรือคอลัมน์ ข้อมูลทั้งหมดตั้งแต่จุดนั้นจะถูกส่งคืน คุณยังสามารถละจุดเริ่มต้นและระบุเฉพาะจุดสิ้นสุดเพื่อรับข้อมูลจนถึงจุดนั้น

ตัวอย่าง

ในบล็อกที่คุณต้องการดึงระเบียนจากตาราง ให้ไปที่ส่วน "เครื่องคิดเลข" ในการตั้งค่าบล็อกและป้อนฟังก์ชันพร้อมพารามิเตอร์ที่ต้องการ

มาดูกันว่าข้อมูลแสดงในตารางอย่างไร

ตอนนี้ ให้รันบล็อก "เริ่มต้น" ในโหมดทดสอบ

เราสามารถเห็นข้อมูลที่ถูกเขียนไปยังตัวแปรจากตารางในข้อความที่บอทส่ง เนื่องจากเราอ้างอิงตัวแปรในข้อความโดยใช้ไวยากรณ์ #{} ข้อมูลที่เก็บไว้ในตัวแปรจึงแสดงในแชทของบอท

ดึงข้อมูลจากตารางภายในช่วงที่ระบุ

table_read_cells(table_id, cell_data) - ช่วยให้ดึงข้อมูลจากตารางโดยระบุช่วง

หากไม่มีปัญหาเกิดขึ้นระหว่างการร้องขอ การตอบกลับจะเป็นพจนานุกรมที่มีสถานะและเซลล์ทั้งหมดพร้อมค่าของมัน:

{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"หรือในกรณีที่เกิดข้อผิดพลาด: {"status": false, "err": "ข้อความหรือคำอธิบายข้อผิดพลาด"}

ตัวอย่างในเครื่องคิดเลข

ตัวอย่างเช่น เซลล์ของตารางมีค่าที่ระบุต่อไปนี้:

ในการดึงข้อมูลจากตารางผ่านบอท ให้ส่งช่วงที่ต้องการไปยังฟังก์ชันใน เครื่องคิดเลข

ในตัวอย่าง โครงสร้าง #{res} ซึ่งเก็บตัวแปร ช่วยแสดงในข้อความถึงข้อมูลที่ดึงมาโดยใช้ฟังก์ชันและช่วงที่ระบุ:

หากชื่อคอลัมน์แตกต่างกัน (เช่น "สินค้า", "จำนวน", "ยอดรวม") คุณต้องระบุช่วงโดยใช้รูปแบบ {"Product1":"Amount3"} โดยที่:

• Product คือชื่อของคอลัมน์แรก
• 1 ระบุว่าเป็นคอลัมน์หมายเลข 1
• Amount คือชื่อของคอลัมน์ที่สาม
• 3 ระบุว่าเป็นคอลัมน์หมายเลข 3