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

الميزات:

  • إنشاء جداول بأي عدد من الصفوف والأعمدة.
  • تخزين البيانات وتحريرها دون الحاجة لأدوات أو خدمات خارجية.
  • إدخال القيم، وتحرير الصفوف والأعمدة، أو حذفها مباشرة عبر chatbot باستخدام الدوال.

المزايا:

  • تبسيط إدارة البيانات: يمكنك إدخال المعلومات في الجدول مباشرة من البوت.
  • مرن وسهل الاستخدام: أنشئ أي عدد من الجداول التي تحتاجها وخصصها لمهام عملك.

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

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

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

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

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

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

إعدادات الجداول

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

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

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

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

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

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

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

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

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

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

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

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

ميزات أخرى

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

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

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

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

تحذير!

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

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

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

أو باستخدام الدوال في chatbot.

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

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

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

  1. مثال:
    في URL مثل https://mavibot.ai/projects/11111/table/2
    معرف الجدول هو 2.
  2. انسخ المعرف
    حدد وانسخ هذا الرقم من شريط العناوين لاستخدامه في تكوين chatbot الخاص بك.

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

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.)

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.)

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