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

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

new_record(table_id, data)

المعلمات الوصف
table_id معرف الجدول
data قاموس يحتوي على البيانات المراد تسجيلها.

مثال: {"column_name1": "value1", "column_name2": "value2"}. إذا كان العمود غير موجود، يتم إنشاؤه.

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

مثال

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

edit_record(table_id, record_id, data)

المعلمات الوصف
table_id معرف الجدول
record_id معرف السجل المراد تعديله
data قاموس يحتوي على البيانات المراد تعديلها. مثال: {"column_name1": "value3", "column_name2": "value4"}. إذا كان العمود غير موجود، لا يتم إنشاؤه.

الاستجابة:

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

مثال

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

delete_record(table_id, record_id)

المعلمات الوصف
table_id معرف الجدول
record_id معرف السجل المراد حذفه

الاستجابة:

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

العثور على سجل في الجدول بواسطة قيمة محددة

find_record(table_id, value, find_in, return_from)

المعلمات الوصف
table_id معرف الجدول
value القيمة المراد مطابقتها
find_in - معلمة اختيارية. اسم العمود المراد البحث فيه. إذا لم يتم تحديدها، سيتم البحث عبر جميع الأعمدة.
return_from معلمة اختيارية. اسم العمود الذي سيتم إرجاع القيمة منه.

الاستجابة:

إذا تم تحديد return_from، سيتم إرجاع القيمة من العمود المحدد (إذا كان موجودًا في الجدول). إذا لم يتم تحديد return_from أو كان العمود غير موجود، سيتم إرجاع البيانات الكاملة للسجل الذي تم العثور عليه في الاستجابة، على سبيل المثال: {"column_name1": "value3", "column_name2": "value4"}.

مثال

استرجاع قيمة من السجل المحدد

get_record_data(table_id, record_id)

المعلمات الوصف
table_id معرف الجدول
record_id معرف السجل الذي يتم استرجاع القيم منه
return_column معلمة اختيارية. اسم العمود الذي يجب إرجاع القيمة منه.

الاستجابة: إذا تم العثور على سجل، يتم إرجاع قاموس مثل {"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) - يسمح باسترجاع البيانات من الجدول عن طريق تحديد النطاقات.

المعلمة الوصف
**!** table_id معلمة مطلوبة، معرف الجدول
**!** cell_data معلمة مطلوبة، قاموس يحتوي على النطاقات.
cell_data مثال: '{"a1":"a1", "a3": "b4", "c1": "c3"}'

إذا لم تحدث أي مشكلات أثناء الطلب، ستكون الاستجابة قاموسًا يحتوي على الحالة وجميع الخلايا بقيمها:

{"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