كيفية العمل مع جداول Mavibot

الـ "Sheets" قسم "Sheets" في MaviBot هو أداة لتخزين البيانات وإدارتها بسهولة داخل المنصة. لم تعد بحاجة إلى التبديل بين خدمات مختلفة — أصبحت جميع جداولك متاحة الآن ضمن مشروع واحد.

الميزات:

• إنشاء جداول بأي عدد من الصفوف والأعمدة.

• تخزين البيانات وتعديلها دون أدوات أو خدمات خارجية.

• إدخال القيم، أو تعديل الصفوف والأعمدة، أو حذفها مباشرة عبر روبوت المحادثة باستخدام الوظائف.

المزايا:

• يبسّط إدارة البيانات: يمكنك إدخال المعلومات في جدول مباشرة من الروبوت.

• مرن وسهل الاستخدام: أنشئ ما تشاء من الجداول وخصّصها لمهام عملك.

إدارة جداولك دون مغادرة Mavibot

تساعد الجداول الشركات على تنظيم بياناتها وتسريع العمليات.

كيفية إنشاء الجداول

للبدء، انتقل إلى "Sheets" القسم في المشروع المطلوب:

بعد ذلك، سترى "إنشاء جدول" الزر. انقر عليه لفتح نافذة منبثقة تحتاج فيها إلى إدخال اسم الجدول:

أدخل اسمًا للجدول وانقر "تم". عندها سيتم إنشاء الجدول الجديد في المشروع وسيظهر في "Sheets" .

إعدادات Sheets

بعد إنشاء الجدول، تحتاج إلى إضافة صفوف وأعمدة. للقيام بذلك، ابحث عن زر "انتقل إلى" في الجدول المطلوب وانقر عليه:

سترى الإعدادات التالية:

1. وظيفة إضافة الأعمدة:

أ) لإضافة أعمدة بحروف

يضيف الزر أعمدة من A إلى Z إلى الجدول.

ب) لإضافة أعمدة بأسماء مخصصة

يؤدي النقر على الزر إلى فتح نافذة منبثقة يمكنك فيها تسمية العمود الجديد.

أدخل اسمًا وانقر "تم" لإضافة العمود إلى الجدول.

1. زر لإضافة الصفوف:

1. تصدير الجدول

يتيح لك تصدير الجدول بصيغة CSV مع جميع البيانات والقيم، على سبيل المثال لنقل الجدول إلى مشروع Mavibot آخر أو إلى خدمة جداول بيانات أخرى.

1. الـ استيراد CSV تتيح لك هذه الميزة تحميل البيانات من خدمة خارجية.

ميزات أخرى

توجد قائمة منسدلة تتيح لك استعراض الجداول بسرعة دون مغادرة القسم الرئيسي.

يمكنك أيضًا إنشاء جداول جديدة مباشرة من القائمة الجانبية.

لحذف جدول، انتقل إلى القسم الرئيسي:

ثم ابحث عن حذف الزر الموجود على بطاقة الجدول الذي تريد إزالته.

تحذير!

لا يمكن استعادة الجداول المحذوفة.

كيفية إدخال القيم في الجدول

يمكنك إدخال القيم في الجدول يدويًا:

أو باستخدام الوظائف في روبوت المحادثة.

كيفية العثور على معرّف الجدول

ستحتاج إلى معرّف الجدول لاستخدام وظائف روبوت المحادثة المتعلقة بهذا الجدول.

1. انتقل إلى الجدول الخاص بك. ابحث عن الجدول المطلوب في القائمة وانقر على اسمه لفتحه.

2. حدد معرّف الجدول في شريط العنوان. انقر على شريط العنوان في المتصفح — معرّف الجدول هو السلسلة الفريدة من الأحرف في نهاية الرابط.

1. مثال: في رابط مثل https://mavibot.ai/projects/11111/table/2 يكون معرّف الجدول هو 2.

2. انسخ المعرف حدد هذا الرقم وانسخه من شريط العنوان لاستخدامه في إعدادات روبوت المحادثة.

كيفية إنشاء سجل جديد في الجدول

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 entries: 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, return_column )

table_id – معرّف الجدول

record_id – معرّف الإدخال الذي سيتم استرجاع القيم منه

return_column – اختياري. اسم العمود الذي سيتم إرجاع القيمة منه

الاستجابة: إذا تم العثور على الإدخال، فسيُرجع قاموسًا مثل {"column_name1": "value1", "column_name2": "value2"}. إذا تم توفير return_column وكان العمود موجودًا، فسيتم إرجاع القيمة من ذلك العمود فقط.

كيفية استرجاع جميع القيم عند البحث عبر عدة أعمدة

find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – استخدم هذه الوظيفة عندما تحتاج إلى البحث عبر عدة أعمدة دفعة واحدة واسترجاع قائمة بالقيم من عمود في الصفوف التي تم العثور على جميع القيم فيها. (تشبه هذه وظيفة sheet_search_in_multiple_cols_return_list في Google Sheets.)

table_id — معرّف الجدول

column_data — استعلام البحث، أي ما الذي تريد العثور عليه

return_col — رقم العمود الذي سيتم إرجاع القيم منه

with_index — الفهرس أو الترقيم في قائمة القيم التي تم العثور عليها (0 – ترقيم (1، 2، 3،...)؛ 1 – فهرس الصف؛ "" – قائمة القيم في أسطر جديدة بدون فهارس أو ترقيم)

delimiter — الفاصل بين الفهرس والقيمة

algorithm — خوارزمية البحث (F – تطابق تام، K – تطابق بالكلمة المفتاحية، R – تعبير نمطي، 1–100 – نسبة التشابه (راجع التفاصيل أعلاه))

مثال:

table_id = 7

data = {"age": "26", "city": "New York"}

return_col = "name"

with_index = 1

delimiter = " - "

algorithm = "F"

res = find_records_multiple_cols_list(table_id, data, return_col, with_index, delimiter, algorithm)

res_list = res["list"]

إذا نُفِّذ الاستعلام بنجاح، فستكون الاستجابة قاموسًا يحتوي على الحالة وجميع الخلايا ذات القيم:

{"status":true,"rows_index":[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

status — نتيجة البحث

rows_index — مصفوفة تحتوي على أرقام الصفوف التي تم العثور عليها

quantity — عدد الصفوف التي تم العثور عليها

list — سلسلة تحتوي على جميع القيم من العمود المحدد

إذا حدث خطأ، فستكون الاستجابة status: false مع وصف للخطأ: {"status": false, "error": "Error or description"}

كيفية استرجاع أول قيمة عند البحث عبر عدة أعمدة

find_first_record_multiple_cols_row(table_id, column_data, algorithm) – استخدم هذه الوظيفة عندما تحتاج إلى البحث عبر عدة أعمدة دفعة واحدة واسترجاع أول صف مطابق. (تشبه هذه وظيفة sheet_search_in_multiple_cols_return_row في Google Sheets.)

table_id — معرّف الجدول

columns — استعلام البحث، أي ما الذي تريد العثور عليه

algorithm — خوارزمية البحث (F – تطابق تام، K – تطابق بالكلمة المفتاحية، R – تعبير نمطي، 1–100 – نسبة التشابه (راجع التفاصيل أعلاه))

مثال:

table_id = 7

data = {"age": "26", "city": "New York"}

algorithm = "F"

res = find_first_record_multiple_cols_row(table_id, data, algorithm)

row_data = res["row_data"]

row_id = row_data["ID"]

row_name = row_data["name"]

row_age = row_data["age"]

إذا نُفِّذ الاستعلام بنجاح، فستكون الاستجابة قاموسًا يحتوي على الحالة وجميع الخلايا ذات القيم.

{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

status — نتيجة البحث

rows_index — مصفوفة تحتوي على أرقام الصفوف التي تم العثور عليها

row_data — البيانات من الصف الذي تم العثور عليه

row — رقم الصف الذي تم العثور عليه

إذا حدث خطأ، فستكون الاستجابة status: false مع وصف للخطأ: {"status": false, "error": "Error or description"}