إنشاء سجل جديد في الجدول بالقيم المحددة

إنشاء سجل جديد في جدول بالقيم المحددة.

new_record(table_id, data)

الاستجابة: معرف السجل الجديد

مثال

تعديل سجل موجود في الجدول

edit_record(table_id, record_id, data)

الاستجابة:

تعيد البيانات الكاملة للسجل المعدل بالتنسيق: {"column_name1": "value3", "column_name2": "value4"}.

مثال

حذف سجل من الجدول بواسطة معرفه

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 وكان هذا العمود موجودًا، سيتم إرجاع القيمة من ذلك العمود فقط.

أين يمكنني العثور على معرف الجدول؟

للعمل مع وظائف chatbot، ستحتاج إلى معرف الجدول. ابحث عن الجدول المطلوب في القائمة وانقر عليه.

بعد ذلك، انقر على شريط العناوين.

في شريط العناوين، سترى رابطًا مثل
https://salebot.pro/projects/11111/table/2،
حيث يمكنك العثور على معرف الجدول المطلوب:

استرجاع سجل من الجدول

get_records_from_table(table_id, start_row, count, start_col, end_col) - استرجاع سجل من الجدول.

المعلمة الوصف ملاحظة
table_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