Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 33 additions & 5 deletions ar/api-doc/oauth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,22 @@ description: "أنشئ عمليات تكامل تتيح للمستخدمين ا
| المورد | النطاقات |
|----------|--------|
| **التطبيق** | `app\|create`, `app\|read`, `app\|update`, `app\|delete` |
| **المشروع** | `base\|read`, `base\|read_all`, `base\|update`, `base\|table_import`, `base\|table_export`, `base\|query_data` |
| **الجدول** | `table\|create`, `table\|delete`, `table\|export`, `table\|import`, `table\|read`, `table\|update`, `table\|trash_read`, `table\|trash_update`, `table\|trash_reset` |
| **المشروع** | `base\|create`, `base\|delete`, `base\|read`, `base\|read_all`, `base\|update`, `base\|table_import`, `base\|table_export`, `base\|query_data`, `base\|authority_matrix_config` |
| **الجدول** | `table\|create`, `table\|delete`, `table\|export`, `table\|import`, `table\|read`, `table\|update`, `table\|trash_read`, `table\|trash_update`, `table\|trash_reset`, `table\|archive_read`, `table\|archive_manage` |
| **طريقة العرض** | `view\|create`, `view\|delete`, `view\|read`, `view\|update` |
| **الحقل** | `field\|create`, `field\|delete`, `field\|read`, `field\|update` |
| **السجل** | `record\|comment`, `record\|create`, `record\|delete`, `record\|read`, `record\|update` |
| **السجل** | `record\|comment`, `record\|create`, `record\|delete`, `record\|read`, `record\|update`, `record\|archive` |
| **الأتمتة** | `automation\|create`, `automation\|delete`, `automation\|read`, `automation\|update` |
| **المستخدم** | `user\|email_read`, `user\|integrations` |
| **الروتين** | `routine\|create`, `routine\|delete`, `routine\|read`, `routine\|update` |
| **المستخدم** | `user\|email_read`, `user\|integrations`, `user\|spaces_read`, `user\|self_hosted_licenses_read`, `user\|notifications_send` |

تُستخدم نطاقات المستخدم التالية لقراءة معلومات الحساب أو للوصول إلى المستخدم:

| النطاق | الاستخدام |
|------|------|
| `user\|spaces_read` | يضيف `spaces` إلى استجابة نقطة نهاية معلومات المستخدم `GET /api/auth/user`: المساحات التي يشغل فيها المستخدم مقعدًا، مع مستوى الاشتراك وعدد المقاعد وما إذا كانت تجريبية لكل مساحة. تُرجَع على Teable Cloud فقط |
| `user\|self_hosted_licenses_read` | يضيف `selfHostedLicenses` إلى استجابة نقطة نهاية معلومات المستخدم: تراخيص النشر ذاتي الاستضافة التي اشتراها المستخدم ولا تزال سارية، مع مستوى الاشتراك وعدد المقاعد وما إذا كانت تجريبية. تُرجَع على Teable Cloud فقط |
| `user\|notifications_send` | يرسل إشعارات داخل التطبيق إلى المستخدم المفوِّض. راجع [إرسال الإشعارات إلى المستخدمين](#إرسال-الإشعارات-إلى-المستخدمين) |

<Tip>لا تطلب إلا النطاقات التي يحتاج إليها تطبيقك فعليًا. سيرى المستخدمون الأذونات المطلوبة أثناء التفويض.</Tip>

Expand Down Expand Up @@ -92,7 +101,7 @@ https://app.teable.ai/api/oauth/authorize?response_type=code&client_id=YOUR_CLIE
- الأذونات المطلوبة (النطاقات)
- خياري الموافقة على الوصول أو رفضه

إذا سبق للمستخدم تفويض تطبيقك (خلال 7 أيام افتراضيًا)، فستتم إعادة توجيهه فورًا من دون رؤية صفحة التفويض مرة أخرى.
إذا سبق للمستخدم تفويض تطبيقك (خلال 7 أيام افتراضيًا) وكانت جميع النطاقات المطلوبة هذه المرة قد وافق عليها من قبل، فستتم إعادة توجيهه فورًا من دون رؤية صفحة التفويض مرة أخرى. وإذا طلبت نطاقات جديدة، فعلى المستخدم التأكيد من جديد، وتبقى النطاقات التي وافق عليها سابقًا محفوظة بعد التأكيد.

### الخطوة 3: معالجة معاودة الاتصال

Expand Down Expand Up @@ -305,6 +314,25 @@ curl https://app.teable.ai/api/base/access/all \

تُرجع نقطة النهاية هذه جميع المشاريع التي يملك المستخدم الحالي إذنًا للوصول إليها. ويمكنك استخدام `baseId` من الاستجابة في استدعاءات API اللاحقة.

## إرسال الإشعارات إلى المستخدمين

بعد الحصول على النطاق `user|notifications_send`، يستطيع تطبيقك استخدام رمز الوصول لإرسال إشعارات داخل التطبيق إلى ذلك المستخدم. تظهر الإشعارات في مركز الإشعارات لدى المستخدم مع بيان التطبيق الذي أرسلها.

```bash
curl -X POST https://app.teable.ai/api/notifications \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"externalId": "order-1024-shipped", "text": "تم شحن الطلب 1024", "url": "https://yourapp.com/orders/1024"}'
```

| المعلمة | مطلوبة | الوصف |
|------|------|------|
| `externalId` | نعم | معرّف الإشعار الخاص بتطبيقك، من 1-128 حرفًا من الأحرف أو الأرقام أو `_` `.` `:` `-`. إرسال المعرّف نفسه مرة أخرى إلى المستخدم نفسه لا ينشئ إشعارًا جديدًا |
| `text` | نعم | نص الإشعار، نص عادي بحد أقصى 500 حرف. لا يترجمه Teable، لذا اكتبه بلغة المستخدم |
| `url` | لا | العنوان الذي يُفتح عند النقر على الإشعار. يجب أن يستخدم https وأن يكون مضيفه مطابقًا للصفحة الرئيسية للتطبيق أو لأحد عناوين URL لمعاودة الاتصال |

تعني قيمة `status` في الاستجابة `created` أن الإشعار قد سُلِّم، و`duplicate` أن `externalId` هذا أُرسل من قبل، و`muted` أن المستخدم أوقف الإشعارات من هذا التطبيق. يستطيع كل تطبيق إرسال 30 إشعارًا في الدقيقة كحد أقصى إلى المستخدم الواحد، و600 في الدقيقة لجميع المستخدمين مجتمعين. وعند تجاوز الحد تُرجَع الاستجابة 429 مع الترويسة `Retry-After`.

## تحديث رموز الوصول

عند انتهاء صلاحية رمز الوصول، استخدم رمز التحديث للحصول على رمز جديد:
Expand Down
4 changes: 4 additions & 0 deletions ar/basic/admin-panel/users.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ description: "أدر جميع المستخدمين في نسختك عبر لوح
* **تعطيل**: لا يمكن للمستخدم تسجيل الدخول، مع الاحتفاظ بالبيانات
* **تنشيط**: استعادة الوصول لمستخدم معطّل

#### جلسات تسجيل الدخول

افتح قائمة إجراءات مستخدم واختر **Sessions** لعرض الأجهزة التي سجّل المستخدم الدخول عليها حاليًا وسجل تسجيل الدخول الخاص به. انقر **Sign out** على جهاز واحد، أو **Sign out all devices**، لإجبار المستخدم على تسجيل الدخول من جديد. وما دام الحساب غير معطّل، يستطيع المستخدم تسجيل الدخول مرة أخرى.

#### إعادة تعيين كلمة المرور

افتح قائمة إجراءات مستخدم واختر **إعادة تعيين كلمة المرور**. بعد التأكيد، ينشئ Teable رابطًا صالحًا لمرة واحدة يمكنك نسخه وإرساله إلى المستخدم. وإذا كان بريد الإشعارات مهيأً، يرسل Teable الرابط بالبريد الإلكتروني أيضًا.
Expand Down
2 changes: 1 addition & 1 deletion ar/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -229,7 +229,7 @@ Cuppy، يرجى قراءة ذاكرة المشروع ذي المعرّف bsexxx
اضبط **من يمكنه العرض** على **أي شخص لديه الرابط**، أو على **أعضاء المساحة** حتى لا يتمكن من فتحه إلا أعضاء المساحة الذين سجّلوا الدخول.
</Step>
<Step title="إضافة كلمة مرور (اختياري)">
ضمن الإعدادات المتقدمة، فعّل **الحماية بكلمة مرور** وعيّن كلمة مرور. يجب على المشاهدين إدخالها قبل تحميل النتيجة التفاعلية.
ضمن الإعدادات المتقدمة، فعّل **الحماية بكلمة مرور**، فينشئ Teable كلمة مرور تلقائيًا. يجب على المشاهدين إدخالها قبل تحميل النتيجة التفاعلية. انقر **نسخ الرابط وكلمة المرور** لنسخهما معًا.
</Step>
<Step title="إرسال الرابط">
استخدم **نسخ الرابط** لنسخه. إذا انتشر الرابط على نطاق أوسع من المطلوب، فإن **إعادة تعيين الرابط** ينشئ رابطًا جديدًا ويوقف الرابط القديم عن العمل.
Expand Down
2 changes: 1 addition & 1 deletion ar/basic/ai/routine.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور

محادثة التشغيل للقراءة فقط. ويستطيع الأعضاء الذين يملكون تعديل الروتين متابعتها في آخرها لتتبّع كيف جرى تشغيل بعينه.

تظهر محادثة كل تشغيل أيضًا في سجل المحادثات، وتعود ملكيتها إلى آخر من حدّث الروتين، وتحمل اسم الروتين. ولا يحذف حذفُ الروتين هذه المحادثات: فهي تحتفظ بأسمائها وتصبح محادثات عادية.
تظهر محادثة كل تشغيل أيضًا في سجل المحادثات، وتعود ملكيتها إلى آخر من حدّث الروتين. تحمل محادثات التشغيل المجدول واليدوي اسم الروتين؛ أما التشغيلات الناتجة عن حدث فتُعاد تسميتها تلقائيًا بناءً على المطالبة والحدث المستلَم، ليسهل التمييز بين كل حدث وآخر في السجل. ولا يحذف حذفُ الروتين هذه المحادثات: فهي تحتفظ بأسمائها وتصبح محادثات عادية.

<Info>يتطلّب الاطلاع على سجل التشغيل صلاحية تعديل الروتين. ويستطيع مالك المشروع ومنشئه إنشاء الروتينات وتعديلها وحذفها، بينما يملك بقية المتعاونين صلاحية الاطلاع فقط.</Info>

Expand Down
2 changes: 1 addition & 1 deletion ar/basic/base.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ description: "أنشئ المشاريع وأدرها واستوردها وصدّ
| **مشاركة المشروع كاملًا** | يشارك جميع العناصر في المشروع الحالي. وتُضمّن تلقائيًا الجداول والمجلدات الجديدة المضافة لاحقًا. |
| **مشاركة العنصر المحدد** | يشارك العنصر المحدد حاليًا. وعند مشاركة مجلد، تُضمّن عناصره الفرعية. |

في إعدادات المشاركة، يمكنك تهيئة صلاحيات الرابط، و**السماح للمشاهدين بنسخ البيانات**، والوصول بكلمة مرور، وإعادة إنشاء الرابط، وحذف رابط المشاركة، أو نسخ تهيئة التضمين.
في إعدادات المشاركة، يمكنك تهيئة صلاحيات الرابط، و**السماح للمشاهدين بنسخ البيانات**، والوصول بكلمة مرور، وإعادة إنشاء الرابط، وحذف رابط المشاركة، أو نسخ تهيئة التضمين. عند تفعيل الوصول بكلمة مرور، ينشئ Teable كلمة مرور عشوائية تلقائيًا، ويمكنك النقر على **نسخ الرابط وكلمة المرور** لإرسالهما معًا إلى المشاهدين. راجع [حماية روابط المشاركة](/ar/basic/security#حماية-روابط-المشاركة).

<img
src="/images/docs/base/2026-05-22-base-share-settings.png"
Expand Down
18 changes: 17 additions & 1 deletion ar/basic/security.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,23 @@ description: "تعرّف إلى بنية أمان Teable وحماية البيا

### حماية روابط المشاركة

احمِ طرق العرض المشتركة بالمصادقة بكلمة مرور. عند تمكينها، يجب على المستلمين إدخال كلمة المرور الصحيحة قبل الوصول إلى المحتوى المشترك.
احمِ طرق العرض أو المشاريع أو النتائج التفاعلية المشتركة بالمصادقة بكلمة مرور. عند تمكينها، يجب على المستلمين إدخال كلمة المرور الصحيحة قبل الوصول إلى المحتوى المشترك.

عند تفعيل الحماية بكلمة مرور، ينشئ Teable كلمة مرور عشوائية تسري فورًا. انقر **نسخ الرابط وكلمة المرور** بجوار كلمة المرور لنسخ الرابط وكلمة المرور معًا في سطر واحد، ثم أرسله مباشرة إلى المشاهدين. ولتغييرها، انقر زر التعديل وأدخل كلمة مرور جديدة، أو انقر **إنشاء كلمة مرور عشوائية** للحصول على أخرى.

لا تظهر كلمة المرور بنص واضح إلا في لوحة المشاركة مباشرة بعد تعيينها. وعند إعادة فتح إعدادات المشاركة تكون مخفية؛ ولنسخها مرة أخرى، عيّن كلمة مرور جديدة.

## الحساب وتسجيل الدخول

### أجهزة تسجيل الدخول

افتح صورتك الرمزية أسفل اليسار ← **الإعدادات** ← **Devices** لمعرفة الأجهزة التي سُجِّل الدخول إلى حسابك عليها حاليًا، والاطلاع على **Login history** لآخر 30 يومًا. يعرض كل جهاز المتصفح أو تطبيق الهاتف المحمول، ونظام التشغيل، وطريقة تسجيل الدخول، وعنوان IP، ووقت آخر نشاط.

إذا وجدت جهازًا لا تعرفه، فانقر **Sign out** على ذلك الجهاز ثم غيّر كلمة المرور. وانقر **Sign out all other devices** لتسجيل الخروج من جميع الأجهزة عدا الجهاز الحالي دفعة واحدة. وتحتاج الأجهزة التي سُجِّل خروجها إلى تسجيل الدخول من جديد لمتابعة الاستخدام.

### القفل بعد فشل تسجيل الدخول

بعد إدخال كلمة مرور خاطئة 5 مرات متتالية للبريد الإلكتروني نفسه، يُقفل الحساب لمدة 15 دقيقة، وتُرفض أي محاولات خاطئة إضافية خلال هذه المدة.

## إدارة البيانات

Expand Down
2 changes: 1 addition & 1 deletion ar/basic/view/toolbar.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ description: "استخدم عوامل التصفية والمجموعات وال
| السماح للمشاهدين بنسخ البيانات من طريقة العرض هذه | طريقة عرض الشبكة | يتحكم في ما إذا كان بإمكان الزوار نسخ البيانات من طريقة عرض الشبكة المشتركة |
| إظهار جميع الحقول في السجلات الموسعة | طريقة عرض الشبكة | يتحكم في ما إذا كان بإمكان الزوار رؤية الحقول المخفية عند فتح تفاصيل السجل |
| السماح للمشاهدين المسجّلين بتحرير البيانات الظاهرة | جميع طرق العرض | يتيح للزوار المسجّلين تحرير السجلات والحقول ضمن نطاق طريقة العرض المشتركة |
| التقييد بكلمة مرور | جميع مشاركات طرق العرض | يضيف كلمة مرور إلى رابط المشاركة. ويجب على الزوار إدخال كلمة المرور الصحيحة قبل فتحه |
| التقييد بكلمة مرور | جميع مشاركات طرق العرض | يضيف كلمة مرور إلى رابط المشاركة. ويجب على الزوار إدخال كلمة المرور الصحيحة قبل فتحه. وعند التفعيل تُنشأ كلمة مرور عشوائية تلقائيًا، ويمكن نسخهما معًا باستخدام **نسخ الرابط وكلمة المرور** |
| اشتراط تسجيل الدخول للإرسال | طريقة عرض النموذج | يفرض على الزوار تسجيل الدخول قبل إرسال النموذج |

عند تفعيل **السماح للمشاهدين المسجّلين بتحرير البيانات الظاهرة**، يظل الزوار المجهولون في وضع القراءة فقط ويظهر لهم طلب تسجيل الدخول. ويمكن للزوار المسجّلين إنشاء السجلات أو تحديثها أو حذفها ضمن البيانات الظاهرة في طريقة العرض المشتركة فقط. ولا يمكن تحرير السجلات الواقعة خارج عامل تصفية طريقة العرض الحالية أو الحقول المخفية عنها من خلال رابط المشاركة.
Expand Down
Loading
Loading