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

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

<div data-with-frame="true"><figure><img src="/files/4753ddbef960852688c2bf3ef5f5d58cd6d6fc07" alt="" width="563"><figcaption></figcaption></figure></div>

**الميزات:**

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

**المزايا:**

* **يبسّط إدارة البيانات:** يمكنك إدخال المعلومات في جدول مباشرة من الروبوت.&#x20;
* **مرن وسهل الاستخدام:** أنشئ ما تشاء من الجداول وخصّصها لمهام عملك.

{% hint style="success" %}

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

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

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

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

<div data-with-frame="true"><figure><img src="/files/60d13f7dfc34d7be097cd198970f571b340a9f0c" alt="" width="222"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/6f6c644c25f036d8868f9952c3e0197304b31491" alt="" width="563"><figcaption></figcaption></figure></div>

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

### إعدادات Sheets

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

<div data-with-frame="true"><figure><img src="/files/d8076c1e7505d595cec15aa0c730c4be21890214" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e1c316181a63dbebb22ba346d57ed053b2eb8a8b" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/10ddae1bff13416f060f39230cd966b0fd7fbfc2" alt="" width="350"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/f54418dec90deee3d96c8faa37dcee9a21912b68" alt="" width="339"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/5d517a60e06e71d0bce67ae74d5f4ae592725eba" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/5f306d484c75ad98969965bea48a5a39252987d5" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/54c7a4f2b7089ead96ca8532fcf2695c7298dd84" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/4efdb9bd6b6e4f8b0a62f6d979b9ac687557c81d" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/f72529dc8a0940d656d0dcdb2803f16cb3f5e064" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/3b1a04baa20fd6677fbf480942048212b59b3bf8" alt="" width="563"><figcaption></figcaption></figure></div>

### ميزات أخرى

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

<div data-with-frame="true"><figure><img src="/files/c9b9f8334a5d8fc009ae5f2310ae68fbfafabf49" alt=""><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/4f86fd4f9277ff5c67833039d1ff50384bccefb0" alt=""><figcaption></figcaption></figure></div>

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

{% hint style="danger" %}
تحذير!

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

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

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

<div data-with-frame="true"><figure><img src="/files/8afcbf386126edb0f577668bb29c8b71b057a311" alt="" width="513"><figcaption></figcaption></figure></div>

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

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

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

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

<div data-with-frame="true"><figure><img src="/files/95ede85939f828d9f085bcc0cd9e40c88ddb14ff" alt="" width="563"><figcaption></figcaption></figure></div>

3. **مثال:**\
   في رابط مثل `https://mavibot.ai/projects/11111/table/2`\
   يكون معرّف الجدول هو **`2`**.
4. **انسخ المعرف**\
   حدد هذا الرقم وانسخه من شريط العنوان لاستخدامه في إعدادات روبوت المحادثة.

<div data-with-frame="true"><figure><img src="/files/54c43c201193fbd7587c18988423ce50136074ff" alt="" width="563"><figcaption></figcaption></figure></div>

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

new\_record(table\_id, data) – إنشاء إدخال جديد في الجدول بالقيم المحددة.

table\_id – معرّف الجدول

data – قاموس يحتوي على البيانات المراد إدخالها. مثال: {"column\_name1": "value1", "column\_name2": "value2"}. إذا لم يكن العمود موجودًا، فسيتم إنشاؤه. الاستجابة: معرّف الإدخال الجديد

### مثال

<div data-with-frame="true"><figure><img src="/files/6e129987dfaf9097a884a55d77589b5de43cb73f" alt="" width="375"><figcaption></figcaption></figure></div>

### كيفية تعديل سجل موجود في الجدول

edit\_record(table\_id, record\_id, data)

table\_id – معرّف الجدول

record\_id – معرّف الإدخال المراد تعديله

data – قاموس يحتوي على البيانات المراد تحديثها. مثال: {"column\_name1": "value3", "column\_name2": "value4"}. إذا لم يكن العمود موجودًا، فلن يتم إنشاؤه.

الاستجابة: تُرجع البيانات الكاملة للإدخال المعدل بالصيغة {"column\_name1": "value3", "column\_name2": "value4"}

### مثال

<div data-with-frame="true"><figure><img src="/files/833fa585cb4630d59a1d90d34cffb85e3dc78725" alt="" width="375"><figcaption></figcaption></figure></div>

### كيفية حذف سجل من الجدول باستخدام معرّفه

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

### مثال

<div data-with-frame="true"><figure><img src="/files/7f61784fbf51b139eb7c9691e2b6ca9ffea6efb0" alt="" width="375"><figcaption></figcaption></figure></div>

### كيفية الحصول على القيم من سجل محدد

get\_record\_data(table\_id, record\_id, return\_column )&#x20;

table\_id – معرّف الجدول

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

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

الاستجابة: إذا تم العثور على الإدخال، فسيُرجع قاموسًا مثل {"column\_name1": "value1", "column\_name2": "value2"}. إذا تم توفير return\_column وكان العمود موجودًا، فسيتم إرجاع القيمة من ذلك العمود فقط.

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

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

<div data-with-frame="true"><figure><img src="/files/85705252dd415314e6f9e1e327e90455edd59bce" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/d4083e969e4093513bfe6303368cd9e64ac51c6b" alt="" width="563"><figcaption></figcaption></figure></div>

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/sheets/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.